Jens Seidel <[EMAIL PROTECTED]> 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>
