vshost-util-vserver

Build script and sources for util-vserver.
git clone https://ccx.te2000.cz/git/vshost-util-vserver
Log | Files | Refs

vserver-copy.8 (2872B)

      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)