[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

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
-<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>
-<!-- <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">
+ -->
-	<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:
-	<!-- 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
-	  </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
-<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
-<!--	    <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) ...
-	  </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
+The conversion from RPMs is not perfect and you will have to perform
+a few steps by hand to have everything running.
@@ -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:
+# mkdir -p /nsr/res
+# echo "backup-server.example.com" > /nsr/res/servers
+# echo "other.example.net"        >> /nsr/res/servers
+Note that NetWorker uses a non lsb compliant directory
+<file>/nsr/</file>.  There is no documented way to tell it to look in
+<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>
+# EMC NetWorker (Backups)
+ACCEPT          net fw udp      7937:7938
+ACCEPT          net fw tcp      7937:7938
+ACCEPT          net fw tcp     10001:10100
 <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)
-<!--	    <title>Adding <prgn>nsrexecd</prgn> to boot scripts</title> -->
-vendredi:/etc/init.d# cat /etc/init.d/networker
-# installed by postinstall on Wed Dec 16 15:29:08 EET 1998
-case $1 in
-(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
-if [ -f /usr/sbin/nsrd ]; then
-        (/usr/sbin/nsrd) > /dev/console 2>&1
-        (echo  ' nsrd') > /dev/console
-        (echo '') > /dev/console
-        ;;
-(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
-        ;;
-echo "usage: `basename $0` {start|stop}"
-        ;;
+#! /bin/sh
+# Script to start EMC Networker backup daemon
+DESC="legato backup daemon"
+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
+    ;;
-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
-	  </example>
-<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
+You then have to add the backup service to your startup sequence:
+# update-rc.d networker defaults 90
 <p>Now Legato should be setup up properly, and automatic backups
 run as configured on the server. </p>

Reply to: