EMC NetWorker on AIX
EMC NetWorker is the backup solution of EMC. It was known as Legato NetWorker.
This page is about version 8.0.0.1 = Version 8.0 Service Pack 1.
Documentation
NetWorker 8.0 official documentation by EMC
EMC®NetWorker™ Release 8.0 Installation Guide
EMC® NetWorker Release 8.0 Administration Guide
EMC® NetWorker® 8.0 Licensing Guide
EMC® NetWorker® Release 8.0 Error Message Guide
EMC® NetWorker™ Release 8.0 Command Reference Guide
This document describes the EMC NetWorker Release 8.0 Documentation Set
Unofficial sources
General info and howtos by Preston de Guise
EMC NetWorker PDFs from the same site
Downloads
For AIX - An account is required
Installation - AIX filesets
Server
LGTOnmc.rte - NetWorker Management Console
LGTOnw.clnt.rte - NetWorker Client
LGTOnw.licm.rte - NetWorker License Manager
LGTOnw.man.rte - NetWorker Man Pages
LGTOnw.node.rte - NetWorker Storage Node
LGTOnw.serv.rte - NetWorker Server
Client
LGTOnw.clnt.rte - NetWorker Client
Unfortunately, both the server and the agents are running as root.
AIX processes
nsr as in "NetWorker Save and Recover"
# ps -eo ppid,comm | grep "[n]sr"
9568510 nsrmmd
13500434 nsrjobd
8585228 nsrlogd
9568510 nsrmmd
13500434 nsrindexd
9568510 nsrmmd
9568510 nsrmmd
1 nsrexecd
8585228 nsrsnmd
9568510 nsrmmd
9568510 nsrmmd
9568510 nsrmmd
9568510 nsrmmd
13500434 nsrmmdbd
1 nsrd
Processes in detail
nsrd
- "...provides an RPC-based save and recover service."
- server only
- init controlled
- starts the ansrd agent processes on demand
nsrexecd
- " ...is used by NetWorker servers to perform automatic operations on NetWorker clients."
- "...nsrexecd starts nsrmmd(8) daemons..."
- client and server
- "the" client daemon
- init controlled
nsrmmd
- "...is the storage node daemon and is responsible for network save and recover media multiplexing operations."
- client and server
- "Receives backup information from the NetWorker client."
- "Writes data to the devices (volumes)."
- "Sends tracking information to the NetWorker server... "
- "Reads the data from the devices (volumes) at the request of the client..."
- instances forked from nsrexecd
- standard process options: -b <lowest nsrmmd number> -N <nsrsnmd daemon number> -n <number> -s <server> -t <storage node>
nsrjobd
- "It is responsible for spawning and monitoring of 'jobs' of NetWorker client binaries."
- started by init -> nsrd
nsrlogd
- "... is a logging service that logs the NetWorker Security Audit Messages."
nsrsnmd
- "... provides an RPC-based service that manages all device operations nsrmmd processes on behalf of the nsrd NetWorker server."
nsrmmdbd
- "...provides an RPC-based database service to the nsrd(8) and nsrmmd(8) daemons, and query-only access to the NetWorker clients."
- see also: mminfo - information about the save sets
- started by init -> nsrd
msrindexd
- indexing, "... keeping information cached in the nsrindexd process address space."
- "...is started by the server nsrd(8) daemon."
- index is checked by nsrck
- started by init -> nsrd
Queries and administration
NSR server commands
# nsradmin [-s <servername>]
This is an interactive shell.
Short commands are allowed (like 'q' for 'quit').
---
Delete conflicting NSR peer information
Errors in daemon.log:
89879 04/03/2014 02:04:48 PM nsrexecd GSS critical An authentication request from <blah.blah.tld> was denied. The 'NSR peer information' provided did not match the one stored by <server>. To accept this request, delete the 'NSR peer information' resource with the following attributes from <server>'s NSRLA database: name: <blah>; NW instance ID: <instance id>; peer hostname: <blah.blah.tld>
# grep -w ^89879 /nsr/logs/daemon.log | sed 's/.* name\: \(.*\)\; NW.*/\1/g' | sort -u | while read host; do echo "## deleting peer info for: $host"; echo "delete type: NSR peer information; name: $host;" | nsradmin -p nsrexec -i - ; done
NSR client commands
# save [-c client] /path/to/
# recover [-s <servername>]
# recover -c <client's registered hostname>
This command provides an interactive shell except when the -a option is used. For example:
# recover [-c client] -a -d /tmp/ /etc/hosts
See also: http://www.aixhealthcheck.com/blog.php?id=273
The -c flag is requited when the client accesses the server from a different interface/address than the one registered on the server.
Various information
# nsrlic (-s server) - display license info
# nsr_shutdown -l - shows NetWorker process 'tree'
# nsradmin
...
nsradmin> show networker version
nsradmin> print
Starting and stopping - Server
Server starts by an inittab entry:
# lsitab rcnsr
rcnsr:2:wait:sh /etc/rc.nsr
Console output:
0 Mon May 13 10:41:20 CET 2013 starting NetWorker daemons:
0 Mon May 13 10:41:30 CET 2013 nsrexecd
0 Mon May 13 10:41:39 CET 2013 lgtolmd
0 Mon May 13 10:41:50 CET 2013 nsrd
Shutdown:
# nsr_shutdown
-f (force)
-l (only list daemons)
-n (dry run)
-q (quiet)
Environment and script variables
Configuration files
/etc/rc.nsr -> above variables
$NETWORKERRC
$NSRRC
$NSR_ENVEXEC
Filesystems, directories and files
The filesystem /nsr is required by a default NetWorker install.
Not listed:
/nsr/debug/
/nsr/dedup/
/nsr/lockbox/
See also:
Logfiles
/nsr/lic/logs/lgtolmd.log
/nsr/logs/
/nsr/logs/daemon.raw
/nsr/logs/nsrtask.raw
/nsr/logs/rap.log
/nsr/logs/sg/<policyname>/
NetWorker Management Console (Java applet)