vserver-copy(8)

1vserver-copy(8)              System Administration             vserver-copy(8)
2
3
4

NAME

6       vserver-copy - copy/move a virtual server.
7

SYNTAX

9       vserver-copy [options] vserver newname
10
11       vserver-copy [options] vserver host:[newname]
12

DESCRIPTION

14       vserver-copy  makes a copy of a virtual server using rsync. It will re‐
15       write the vserver.conf configuration file with the new hostname and  IP
16       information  when given. If the destination name contains a host speci‐
17       fication then ssh/rsh will be used for the data transfer.
18
19       vserver-copy can used on a running vserver, although naturally the con‐
20       sistency  of  open database files and the like cannot be guaranteed.  A
21       running vserver can however be safely  moved  from  one  root  host  to
22       another using the -s flag.
23
24       If  downtime  is an issue when moving a virtual server across hosts you
25       should first run vserver without the -s flag.  This  will  pre-populate
26       the  destination  filesystem  requiring  only updates to be made on the
27       next invocation.
28

OPTIONS

30       -h,--help
31              output usage information and exit
32
33       -V,--version
34              output version information and exit
35
36       -v,--verbose
37              show all output (normally only informational messages and  warn‐
38              ings)
39
40       -q,--quiet
41              suppress all output
42
43       -d,--domain domain
44              the  new  DNS  domain when changing name. Overwrites /etc/hosts.
45              Must be used with -i
46
47       -i,--ip address
48              the new IP address when changing  name.  Overwrites  /etc/hosts.
49              Must be used with -d
50
51       -r,--vsroot
52              directory containing virtual servers. Defaults to "/vserver"
53
54       -R,--rsh
55              use rsh instead of the default ssh for network transfer
56
57       -s,--stopstart
58              stop the virtual server before copying and start the new vserver
59              afterwards.  This really only makes sense  if  you  are  copying
60              across root hosts and not changing names or IP addresses.
61

FILES

63       /etc/vservers/vserver.conf
64

EXAMPLES

66       # Copy a template vserver (same IP addresses etc)
67
68       /usr/sbin/vserver-copy template web01
69
70       # Copy webserver with change in configuration
71
72       /usr/sbin/vserver-copy -i 192.168.5.62 -d example.com template web62
73
74       # Move a running vserver to another roothost
75
76       /usr/sbin/vserver-copy -s web62 roothost02:
77
78

BUGS

80       If  a  virtual  server  is moved from one root host to another a gratu‐
81       itious ping should be sent to inform other devices on  the  local  area
82       network of the change in MAC address.
83
84       Without this ping the devices will continue to attempt to reach the old
85       MAC address for the  length  of  their  arp-cache  timeout  (10  minute
86       default on Suns!).
87
88       This  functionality should probably be implmemented during the "vserver
89       <name> start" process.
90

AUTHOR

92       Mark Lawrence <nomad@null.net>
93