man/vserver-copy.8

   1 .TH "vserver-copy" "8" "0.3" "Mark Lawrence <nomad@null.net>" "System Administration"
   2 .SH "NAME"
   3 .LP
   4 vserver-copy \- copy/move a virtual server.
   5 .SH "SYNTAX"
   6 .LP
   7 vserver-copy [\fIoptions\fP] \fIvserver\fP \fInewname\fP
   8 .LP
   9 vserver-copy [\fIoptions\fP] \fIvserver\fP \fIhost\fP:[\fInewname\fP]
  10 .SH "DESCRIPTION"
  11 .LP
  12 vserver-copy makes a copy of a virtual server using rsync. It will
  13 rewrite the vserver.conf configuration file with the new hostname and
  14 IP information when given. If the destination name contains a host
  15 specification then ssh/rsh will be used for the data transfer.
  16
  17 vserver-copy can used on a running vserver, although naturally the
  18 consistency of open database files and the like cannot be guaranteed.
  19 A running vserver can however be safely moved from one root host to another
  20 using the \-s flag.
  21
  22 If downtime is an issue when moving a virtual server across hosts you
  23 should first run vserver without the \-s flag. This will pre\-populate the
  24 destination filesystem requiring only updates to be made on the next
  25 invocation.
  26 .SH "OPTIONS"
  27 .LP
  28 .TP
  29 \fB\-h\fR,\fB-\-help\fR
  30 output usage information and exit
  31 .TP
  32 \fB\-V\fR,\fB-\-version\fR
  33 output version information and exit
  34 .TP
  35 \fB\-v\fR,\fB-\-verbose\fR
  36 show all output (normally only informational messages and warnings)
  37 .TP
  38 \fB\-q\fR,\fB-\-quiet\fR
  39 suppress all output
  40 .TP
  41 \fB\-d\fR,\fB-\-domain\fR domain
  42 the new DNS domain when changing name. Overwrites /etc/hosts. Must be
  43 used with \-i
  44 .TP
  45 \fB\-i\fR,\fB-\-ip\fR address
  46 the new IP address when changing name. Overwrites /etc/hosts. Must be
  47 used with \-d
  48 .TP
  49 \fB\-r\fR,\fB-\-vsroot\fR
  50 directory containing virtual servers. Defaults to "/vserver"
  51 .TP
  52 \fB\-R\fR,\fB-\-rsh\fR
  53 use rsh instead of the default ssh for network transfer
  54 .TP
  55 \fB\-s\fR,\fB-\-stopstart\fR
  56 stop the virtual server before copying and start the new vserver afterwards.
  57 This really only makes sense if you are copying across root hosts and not
  58 changing names or IP addresses.
  59 .SH "FILES"
  60 .LP
  61 \fI/etc/vservers/vserver.conf\fP
  62 .SH "EXAMPLES"
  63 .LP
  64 # Copy a template vserver (same IP addresses etc)
  65
  66 /usr/sbin/vserver-copy template web01
  67
  68 # Copy webserver with change in configuration
  69
  70 /usr/sbin/vserver-copy -i 192.168.5.62 -d example.com template web62
  71
  72 # Move a running vserver to another roothost
  73
  74 /usr/sbin/vserver-copy -s web62 roothost02:
  75
  76 .SH "BUGS"
  77 .LP
  78 If a virtual server is moved from one root host to another a gratuitious
  79 ping should be sent to inform other devices on the local area network
  80 of the change in MAC address.
  81
  82 Without this ping the devices will continue to attempt to reach the old
  83 MAC address for the length of their arp-cache timeout (10 minute default
  84 on Suns!).
  85
  86 This functionality should probably be implmemented during the
  87 "vserver <name> start" process.
  88 .SH "AUTHOR"
  89 .LP
  90 Mark Lawrence <nomad@null.net>
  91 .SH "SEE ALSO"
  92 .LP
  93 vserver(8)