Re: [Fwd: Fix to Debian GNU/Linux System Administrator's Manual]
Jens Seidel <jensseidel@users.sf.net> writes:
> Hi Oliver, Yannick
>
> On Mon, Sep 11, 2006 at 10:24:35PM +0100, Oliver Elphick wrote:
>> It is some years since I had anything to do with the manuals. I am
>> forwarding this to the documentation list.
>> [...]
> thanks for reporting this, I fixed the link. Nevertheless there are more
> issues even in this paragraph. It would be very nice if you could
> provide more corrections ...
Here is a quick diff (still full of typos) against the CVS. Yeah the
chapter on backups need a massive update, I'll see if I can find time
to reshape it a bit.
--
Yannick Gingras
Index: backup.sgml
===================================================================
RCS file: /cvs/debian-doc/ddp/manuals.sgml/system-administrator/backup.sgml,v
retrieving revision 1.12
diff -u -r1.12 backup.sgml
--- backup.sgml 12 Sep 2006 19:35:16 -0000 1.12
+++ backup.sgml 15 Sep 2006 20:42:15 -0000
@@ -485,90 +485,68 @@
-->
<p>In an enterprise environment there may be a backup server running
-some network backup software. If there are Linux clients available for
-that software, its possible to install the Linux client, configure the
-client machine on the backup server and start taking backups over the
-LAN.</p>
-
-<p>This is a low cost solution. If the backup server is already there,
-Linux clients usually are free to download. Legato Networker and HP
-Omniback have Linux clients available, but no technical support is
-available from the vendor.
+some network backup software. If there are GNU/Linux clients available
+for that software, its possible to install them, configure the client
+machine on the backup server and start taking backups over the
+network. This is a low cost solution. If the backup server is already
+there, GNU/Linux clients are sometimes free to download.</p>
+<!-- I can't find a place to download Omniback clients so I comment this out
<taglist compact>
<tag>Legato
-<!-- <item><url id="http://www.legato.com/exchange/documents/NetWorker/CG-SW.html"; name="Legato Networker"> -->
-<item><url id="ftp://ftp.legato.com/pub/Unsupported/Linux_Client/"; name="Legato Networker 4.x and 5.1 Linux clients">
+<item><url id="ftp://ftp.legato.com/pub/support/"; name="Legato Networker GNU/Linux client">
<tag>HP Omniback
<item><url id="http://www.hp.com/openview/products/omniback.html"; name="HP Omniback">
</taglist>
</p>
+ -->
<sect2>
- <heading>Installing Legato 5.1 Client</heading>
+ <heading>Installing EMC NetWorker Client</heading>
-<p>Legato supplies Networker Client versions 4.2 and 5.1 for Linux,
-but with no technical support from Legato. The applications are available
-as source packages from <url
-id="ftp://ftp.legato.com/pub/NetWorker/Unix/"; name="Legato FTP
-Site">. The files to get for Legato 5.1 Linux Clients for Intel
-prosessors are <file>lgtoman-rh-5.1.0-2.i386.rpm</file> for the
-manual pages and <file>lgtoclnt-rh-5.1.0-2.i386.rpm</file> for
-the binary files. </p>
-
- <p>If you need support, <url
-id="http://www.feral.com/NetWorker.html"; name="http://www.feral.com/NetWorker.html";> is everything there
-is, unless your Legato consultant knows Linux Legato. </p>
-
-<p>To be able to use the client, you must have a Legato server in
-the network. You can not do backups with only a client. You do not
-need a Client Pak license from Legato for Linux clients, so the server
-can be any supported platform, like Solaris, HP-UX or Windows NT. </p>
+<p><url id="http://software.emc.com/products/product_family/networker_family.htm"; name="EMC NetWorker">
+
+is a backup system formerly known as Legato. EMC supplies NetWorker
+Client for GNU/Linux, but with almost no technical support. The
+applications are available in RPM binary packages from the <url
+id="ftp://ftp.legato.com/pub/support"; name="Legato FTP Site">. The
+tarball will uncompress to several RPM packages. A system that will
+only send files to the backup server will need
+<file>lgtoclnt-7.3-1.i686.rpm</file> and <file>lgtoman-7.3-1.i686.rpm</file>.
+
+<p>The client package will allow the backup server to connect to your
+system and to request the files that need to be backup to. The
+configuration is almost all done on the backup server. The client
+system only need to know which backup server to allow. Your contract
+should allow you install the client packages on your system as long as
+you have the server licence but please check with your EMC
+representative if you have doubts.</p>
<p>To install these packages on a Debian GNU/Linux system, they
-must be converted to Debian packages. The files supplied by Legato are
+must be converted to Debian .deb format. The files supplied by Legato are
relocatable <tt>.rpm</tt> files, and
<package>alien</package> version 6.27 and smaller can not correctly
convert these. Use <package>alien</package> version 6.28 or later. </p>
- <p>Converting the packages goes like this:
+<p>Converting the packages goes like this:
<example>
- <!-- title>Converting <file>.rpm</file> to
- <file>.deb</file></title>-->
-vendredi:/tmp/Legato# dpkg --list | grep alien
-ii alien 6.28 Install Red Hat, Stampede, and Slackware Pac
-vendredi:/tmp/Legato# ls -l
-total 2404
--rw-r--r-- 1 root root 2181383 Jan 21 15:10 lgtoclnt-rh-5.1.0-2.i386.rpm
--rw-r--r-- 1 root root 267904 Jan 21 15:10 lgtoman-rh-5.1.0-2.i386.rpm
-vendredi:/tmp/Legato# alien --to-deb lgtoman-rh-5.1.0-2.i386.rpm
-vendredi:/tmp/Legato# alien --to-deb lgtoclnt-rh-5.1.0-2.i386.rpm
-vendredi:/tmp/Legato# ls -l
-total 4876
--rw-r--r-- 1 root root 2181383 Jan 21 15:10 lgtoclnt-rh-5.1.0-2.i386.rpm
--rw-r--r-- 1 root root 2179998 Jan 21 15:12 lgtoclnt-rh_5.1.0-3_i386.deb
--rw-r--r-- 1 root root 267904 Jan 21 15:10 lgtoman-rh-5.1.0-2.i386.rpm
--rw-r--r-- 1 root root 337454 Jan 21 15:11 lgtoman-rh_5.1.0-3_i386.deb
-vendredi:/tmp/Legato#
- </example>
+vendredi:/tmp# alien --to-deb lgtoclnt-7.3-1.i686.rpm
+lgtoclnt_7.3-2_i386.deb generated
+vendredi:/tmp# alien --to-deb lgtoman-7.3-1.i686.rpm
+lgtoman_7.3-2_i386.deb generated
+</example>
</p>
-<p>The following example assumes the ready made <file>.deb</file> packages are in
-<file>/net/linux/export/mirror/local/Legato/</file> -directory,
-install them from there like this:
+<p>You can then install the packages like this
<example>
-<!-- <title>Installing Legato Client</title> -->
-vendredi:/tmp/Legato# dpkg --install /net/linux/export/mirror/local/Legato/lgtoclnt-rh_5.1.0-3_i386.deb
-Selecting previously deselected package lgtoclnt-rh.
-(Reading database ... 40535 files and directories currently installed.)
-Unpacking lgtoclnt-rh (from .../lgtoclnt-rh_5.1.0-3_i386.deb) ...
-Setting up lgtoclnt-rh (5.1.0-3) ...
-vendredi:/tmp/Legato#
- </example>
-The manual pages packgage is installed similarly, but you may not
-need Legato manual pages on a client only system.
+# dpkg --install lgtoclnt-7.3-1.i686.rpm
+# dpkg --install lgtoman-7.3-1.i686.rpm
+</example>
+
+The conversion from RPMs is not perfect and you will have to perform
+a few steps by hand to have everything running.
</p>
</sect2>
@@ -581,6 +559,34 @@
other Legato prosesses are not needed, <prgn>nsrexecd</prgn>
starts them as needed. </p>
+<p>You need to tell <prgn>nsrexecd</prgn> from which backup server it
+can accept connection. This can be done from the command line or from
+a resource file. The preferred way is from a resource file:
+<example>
+# mkdir -p /nsr/res
+# echo "backup-server.example.com" > /nsr/res/servers
+# echo "other.example.net" >> /nsr/res/servers
+</example>
+
+Note that NetWorker uses a non lsb compliant directory
+<file>/nsr/</file>. There is no documented way to tell it to look in
+<file>/etc/</file>.
+</p>
+
+<p>If you are using a firewall, you need to open the NetWorker ports.
+NetWorker uses remote procedure calls based on Sun RPCs with its own
+portmapper. You need to open the portmapper ports (7937:7938) and the
+RPC port range (10001:10100). With shorewall you would do it by
+putting those rules in <file>/etc/shorewall/rules</file>
+
+<example>
+# EMC NetWorker (Backups)
+ACCEPT net fw udp 7937:7938
+ACCEPT net fw tcp 7937:7938
+ACCEPT net fw tcp 10001:10100
+</example>
+</p>
+
<p>To check the installation, start <prgn>nsrexecd</prgn>
manually, check that it is running and test what the backup server can
do with this new client. </p>
@@ -645,54 +651,56 @@
<p>The remaining configuration on the Linux host is to add starting
of <prgn>nsrexecd</prgn> to the boot scripts, for example like
-this: (the hostnames lehmus and tammi are two Legato backup servers,
-replace them with your own servers)
+this:
<example>
-<!-- <title>Adding <prgn>nsrexecd</prgn> to boot scripts</title> -->
-vendredi:/etc/init.d# cat /etc/init.d/networker
-#!/bin/sh
-# installed by postinstall on Wed Dec 16 15:29:08 EET 1998
-case $1 in
-'start')
-(echo 'starting NetWorker daemons:') > /dev/console
-if [ -f /usr/sbin/nsrexecd ]; then
- (/usr/sbin/nsrexecd -s lehmus -s tammi) > /dev/console 2>&1
- (echo ' nsrexecd') > /dev/console
- (echo '') > /dev/console
-fi
-if [ -f /usr/sbin/nsrd ]; then
- (/usr/sbin/nsrd) > /dev/console 2>&1
- (echo ' nsrd') > /dev/console
- (echo '') > /dev/console
-fi
- ;;
-'stop')
-(echo 'stopping NetWorker daemons:') > /dev/console
-if [ -f /usr/sbin/nsr_shutdown ]; then
- (/usr/sbin/nsr_shutdown -a -q&) > /dev/console 2>&1
- (echo ' nsr_shutdown -a -q') > /dev/console
- (echo '') > /dev/console
-fi
- ;;
-*)
-echo "usage: `basename $0` {start|stop}"
- ;;
+#! /bin/sh
+#
+# Script to start EMC Networker backup daemon
+
+PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
+DAEMON=/usr/sbin/nsrexecd
+NAME=nsrexecd
+DESC="legato backup daemon"
+NICE=15
+
+test -f $DAEMON || exit 0
+
+set -e
+
+case "$1" in
+ start)
+ echo -n "Starting $DESC: $NAME"
+ start-stop-daemon --start -N $NICE -o --exec $DAEMON
+ echo "."
+ ;;
+ stop)
+ echo -n "Stopping $DESC: $NAME"
+ start-stop-daemon --stop -o --name $NAME --exec $DAEMON
+ echo "."
+ ;;
+ restart|force-reload)
+ echo -n "Restarting $DESC: $NAME"
+ start-stop-daemon --stop -o --name $NAME --exec $DAEMON
+ sleep 1
+ start-stop-daemon --start -N $NICE -o --exec $DAEMON
+ echo "."
+ ;;
+ *)
+ echo "Usage: /etc/init.d/$NAME {start|stop|restart|force-reload}"
+ exit 1
+ ;;
esac
-vendredi:/etc/init.d#
-vendredi:/etc/init.d# chmod a+x networker
-vendredi:/etc/init.d# cd /etc/rc2.d
-vendredi:/etc/rc2.d# ln -s ../init.d/networker S95networker
-vendredi:/etc/rc2.d# cd ../rc0.d
-vendredi:/etc/rc0.d# ln -s ../init.d/networker K05networker
-vendredi:/etc/rc0.d#
- </example>
-</p>
-<p>There is also a startup script for Red Hat systems in file
-<file>/usr/sbin/networker.rh</file> , but Red Hat Linux uses a
-different system for boot scripts, so that script would need some
-modification to work on a Debian system. The above script worked for
-me. </p>
+exit 0
+</example>
+
+You then have to add the backup service to your startup sequence:
+
+<example>
+# update-rc.d networker defaults 90
+</example>
+
+</p>
<p>Now Legato should be setup up properly, and automatic backups
run as configured on the server. </p>
Reply to: