12.4.1.1 Installing EMC NetWorker Client

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 Legato FTP Site. The
tarball will uncompress to several RPM packages. A system that will only send
files to the backup server will need lgtoclnt-7.3-1.i686.rpm and
lgtoman-7.3-1.i686.rpm.

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.

To install these packages on a Debian GNU/Linux system, they must be converted
to Debian .deb format. The files supplied by Legato are relocatable
.rpm files, and alien version 6.27 and smaller can
not correctly convert these. Use alien version 6.28 or later.

Converting the packages goes like this:

     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

You can then install the packages like this

     # dpkg --install lgtoclnt-7.3-1.i686.deb
# dpkg --install lgtoman-7.3-1.i686.deb

The conversion from RPMs is not perfect and you will have to perform a few
steps by hand to have everything running.

12.4.1.2 Setting up and Configuring

To get backups with Legato, there must be nsrexecd running on the
backup client host. This process communicates with the Legato server. On a
client only system, other Legato prosesses are not needed,
nsrexecd starts them as needed.

You need to tell nsrexecd 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 /nsr/.
There is no documented way to tell it to look in /etc/.

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
/etc/shorewall/rules

     # EMC NetWorker (Backups)
ACCEPT          net fw udp      7937:7938
ACCEPT          net fw tcp      7937:7938
ACCEPT          net fw tcp     10001:10100

To check the installation, start nsrexecd manually, check that it
is running and test what the backup server can do with this new client.

     vendredi:/tmp/Legato# /usr/sbin/nsrexecd
vendredi:/tmp/Legato# ps aux | grep nsr
root      4031  0.5  0.6  1132   768  ?  S    15:48   0:00 /usr/sbin/nsrexecd 
root      4033  0.0  0.2   848   344  p2 S    15:48   0:00 grep nsr 
vendredi:/tmp/Legato#

Next go to the backup server, and do a test run, where nothing is actually
saved to tape, but Legato server contacts the client and probes the file
systems. This way you can check most of the functionality and can see what
Legato would do when started for real.

     root@lehmus:/# savegrp -n -p -v -P hplp -c vendredi  Linux_Clients
vendredi:All                              level=incr
01/21/99 16:26:17 savegrp: Run up to 12 clients in parallel
01/21/99 16:26:17 savegrp: vendredi:probe                                started
savefs -s lehmus -g Linux_Clients -p -n -l full -R -v 
01/21/99 16:26:20 savegrp: vendredi:probe succeeded.
rcmd vendredi, user root: `savefs -s lehmus -g Linux_Clients -p -n -l full -R -v'
nsrexec: authtype nsrexec
type: NSR client description;
pools supported: Yes;
remote user: root;
groups: daemon, root, bin, sys, adm, tty, disk, lp, mail, news, daemon;
arch: i586;
client OS type: Linux;
CPUs: 1;
IP address: 172.19.13.36;
machine type: desktop;
MB used: 828;
NetWorker version: Utah.Build.MJFeral_8_11_98_SNAP;
OS: Linux 2.0.34;
version: Utah.Build.MJFeral_8_11_98_SNAP;
save set: path=/, level=full, diskno=0, max_sessions=3, stype=save,\
path=/var, level=full, diskno=0, max_sessions=3, stype=save,\
path=/export/home, level=full, diskno=0, max_sessions=3, stype=save ;
parallelism: 8
--- Probe Summary ---
vendredi:/                            level=full, dn=0, mx=3, vers=pools, p=4
vendredi:/              level=full, pool=SMT Workstation, save as of Thu Jan  1 03:00:00 GMT+0300 1970
vendredi:/var                         level=full, dn=0, mx=3, vers=pools, p=4
vendredi:/var           level=full, pool=SMT Workstation, save as of Thu Jan  1 03:00:00 GMT+0300 1970
vendredi:/export/home                 level=full, dn=0, mx=3, vers=pools, p=4
vendredi:/export/home   level=full, pool=SMT Workstation, save as of Thu Jan  1 03:00:00 GMT+0300 1970
vendredi:index                       level=full, dn=-1, mx=0, vers=pools, p=4
vendredi:index          level=full, pool=SMT Workstation, save as of Thu Jan  1 03:00:00 GMT+0300 1970
root@lehmus:/#

If the previous tests looked OK, you can set up automatic backups on the server
(or ask the backup administrator to do it).

The remaining configuration on the Linux host is to add starting of
nsrexecd to the boot scripts, for example like this:

     #! /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
exit 0

You then have to add the backup service to your startup sequence:

     # update-rc.d networker defaults 90

Now Legato should be setup up properly, and automatic backups run as configured
on the server.