vserver-copy(8)
NAME
vserver-copy - copy/move a virtual server.
SYNTAX
vserver-copy [options] vserver newname
vserver-copy [options] vserver host:[newname]
DESCRIPTION
- vserver-copy makes a copy of a virtual server using rsync.
- It will rewrite the vserver.conf configuration file with the new
- hostname and IP information when given. If the destination name
- contains a host specification then ssh/rsh will be used for the
- data transfer.
- vserver-copy can used on a running vserver, although natu
- rally the consistency of open database files and the like cannot
- be guaranteed. A running vserver can however be safely moved
- from one root host to another using the -s flag.
- If downtime is an issue when moving a virtual server
- across hosts you should first run vserver without the -s flag.
- This will pre-populate the destination filesystem requiring only
- updates to be made on the next invocation.
OPTIONS
- -h,--help
- output usage information and exit
- -V,--version
- output version information and exit
- -v,--verbose
- show all output (normally only informational mes
- sages and warnings)
- -q,--quiet
- suppress all output
- -d,--domain domain
- the new DNS domain when changing name. Overwrites
- /etc/hosts. Must be used with -i
- -i,--ip address
- the new IP address when changing name. Overwrites
- /etc/hosts. Must be used with -d
- -r,--vsroot
- directory containing virtual servers. Defaults to
- "/vserver"
- -R,--rsh
- use rsh instead of the default ssh for network
- transfer
- -s,--stopstart
- stop the virtual server before copying and start
- the new vserver afterwards. This really only makes sense if you
- are copying across root hosts and not changing names or IP ad
- dresses.
FILES
/etc/vservers/vserver.conf
EXAMPLES
# Copy a template vserver (same IP addresses etc)
/usr/sbin/vserver-copy template web01
# Copy webserver with change in configuration
- /usr/sbin/vserver-copy -i 192.168.5.62 -d example.com tem
- plate web62
- # Move a running vserver to another roothost
- /usr/sbin/vserver-copy -s web62 roothost02:
BUGS
- If a virtual server is moved from one root host to another
- a gratuitious ping should be sent to inform other devices on the
- local area network of the change in MAC address.
- Without this ping the devices will continue to attempt to
- reach the old MAC address for the length of their arp-cache time
- out (10 minute default on Suns!).
- This functionality should probably be implmemented during
- the "vserver <name> start" process.
AUTHOR
Mark Lawrence <nomad@null.net>
SEE ALSO
- vserver(8)
- Mark Lawrence <nomad@null.net> 0.3