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