Prerequisites
- Make sure you have reviewed the following KB https://eis-vss.atlassian.net/wiki/spaces/VSSPublic/pages/1889697894/UTORrecover+-+NetWorker+TCP+IP+and+Firewall+Checklist#TCP/IP-Requirements
- Access to the ITS Private Cloud (VSS) Users Storage (https://vskey-stor.eis.utoronto.ca)
- Ensure that the PATH variable for the root and user accounts contains the
/usr/sbin
directory. - If the SELinux on your Linux system is in “enforcing” mode then you must change is to “permissive” by running the command:
setenforce permissive
After the installation is complete, you must revert the SELinux to default value, that is, the value before the installation of RPMs
🐧 Linux x64 Installation Package Requirements
The NetWorker installation for all supported x64 Linux operating systems and versions requires two packages that the default OS installation might not include:
-
compat-libstdc++-33-3.2.3-68.1.x86_64.rpm
or later compat-libstdc++-33-3.2.3-68.1.i686.rpm
or later
🤠 RHEL 7 and later and CentOS Package Requirements
Manually download and install the following Linux OS packages. The NetWorker installation fails when these packages do not exist on the host:
ksh
glibc.i686 0:2.17-55.el7
or laternss-softokn-freebl.i686 0:3.15.4-2.el7
or laterlibncursesw.so.5
🦎 SuSE Package Requirements
When you use the rpm command to install the NetWorker software, the installation displays a list of missing required operating system packages. You must install the required packages before you install the NetWorker software.
compat-libstdc++-33-3.2.3-68.1.x86_64.rpm
libcap1-1.10-47.1.x86_64.rpm
For SLES 15, there is a dependency on libncursesw
.
Default Directory Locations
Before you install the NetWorker software, you should become aware of the default directory locations and space requirements for the binary files, the databases, and the log files on the target host.
Package | Location |
---|---|
Client ( | /usr/lib /usr/sbin /usr/bin /opt/nsr |
Man pages ( | /usr/share |
📁 Changing the Default Directory Locations
To store the configuration, log, and database files on file system that has more free disk space than the / file system, create a symbolic link from a new directory to the /nsr directory.
Create the
/nsr
directory.
Create another /nsr directory on a disk with sufficient space. For example:
mkdir /disk3/nsr
Link the new directory to the
/nsr
directory, by typing the following command:ln -s /disk2/nsr /nsr
\uD83D\uDCD8 Instructions
Log in to the target host and promote your account to super user.
Verify the contents of
/etc/hosts
contains an entry for the IPv4 loopback address and the first entry is the hostname, i.e.:27.0.0.1 host host-alias host.subdomain.utoronto.ca localhost
Fetch the installer from the VSS Users Storage with SCP or an equivalent SCP/SFTP client using the following settings:
host:
vskey-stor.eis.utoronto.ca
VSS username and password.
Navigate to
/ut-vss-lib/networker/pub/networker/LINUX
as shown below. Then download the right installer for your OS architecture.
If you are running on the ITS Private Cloud, you are likely to use nw191002_linux_x86_64
contents.
sftp $USER@vskey-stor.eis.utoronto.ca ($USER@vskey-stor.eis.utoronto.ca) Password: Connected to vskey-stor.eis.utoronto.ca. sftp> cd /ut-vss-lib/networker/pub/networker/LINUX sftp> ls -tlhr -rw-r--r-- ? 3884 20 1.2K Jun 19 13:49 RecoveryExample.txt drwxr-xr-x ? 0 0 5B Jul 10 12:18 nw191002_linux_x86 drwxr-xr-x ? 0 0 4B Jul 10 12:18 nw191002_linux_ppc64 drwxr-xr-x ? 0 0 3B Jul 10 12:18 nw191002_linuxs390x drwxr-xr-x ? 0 0 6B Jul 10 12:18 nw191002_linux_x86_64 drwxr-xr-x ? 0 0 4B Jul 10 12:18 nw191002_linux_ppc64le
Fetch
nw191002_linux_x86_64/lgto*.rpm
Fetching /ut-vss-lib/networker/pub/networker/LINUX/nw191002_linux_x86_64/lgtoclnt_19.10.0.2_amd64.deb to lgtoclnt_19.10.0.2_amd64.deb lgtoclnt-19.10.0.2-1.x86_64.rpm 100% 42MB 11.3MB/s 00:03 Fetching /ut-vss-lib/networker/pub/networker/LINUX/nw191002_linux_x86_64/lgtoman_19.10.0.2_amd64.deb to lgtoman_19.10.0.2_amd64.deb lgtoman-19.10.0.2-1.x86_64.rpm 100% 320KB 2.4MB/s 00:00
Install
lgto
software with by running:with
yum
yum localinstall --nogpgcheck lgto*.rpm
with
rpm
:rpm -ivh lgto*.rpm
To install the NetWorker software in a non-default location, type:
rpm -ivh --relocate /usr=/path lgto*.rpm
Before starting the
networker
service, make sure you have populated the UTORrecover NetWorker servers in/nsr/res/servers
.
The /nsr/res/servers
file contains a list of trusted NetWorker Servers. Review the list or download servers
file via the UTORrecover Portal (https://backups.eis.utoronto.ca) (UTORid required).
Start the
networker
client process with:for
systemd
based:systemctl start networker
for
sysvinit
based:/etc/init.d/networker start
Check the status with:
for
systemd
based:systemctl status networker
for
sysvinit
based:/etc/init.d/networker status
If you change SELinux value, you must revert the SELinux to default value, that is, the value before the installation of RPMs.
Submit a request to backups@eis.utoronto.ca to with the following data:
Hostname:
hostname
command.Fully Qualified Domain Name (FQDN)
IP Address.
Path(s) to Protect. i.e.
/etc
,/var
,/home
Submit an echo request by following this link How-to check NetWorker client connectivity for UTORrecover.
The echo request result should be marked as Processed to be successful.