| 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) |
|---|