How-to install the Oracle EL, SuSE and Red Hat EL NetWorker software for UTORrecover

Prerequisites

Access to the ITS Private Cloud (VSS) Users Storage (https://vskey-stor.eis.utoronto.ca) or fetch the installers via https://utoronto.sharepoint.com/sites/its-eis-UTORrecover
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.rpmor 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 later
nss-softokn-freebl.i686 0:3.15.4-2.el7 or later
libncursesw.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

Package

Location

Client (lgtoclnt)

/usr/lib /usr/sbin /usr/bin /opt/nsr

Man pages (lgtoman)

/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.

  1. Create the /nsr directory.

  1. Create another /nsr directory on a disk with sufficient space. For example:

    mkdir /disk3/nsr
  2. Link the new directory to the /nsr directory, by typing the following command:

    ln -s /disk2/nsr /nsr

 Instructions

  1. Log in to the target host and promote your account to super user.

  2. 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
  3. Fetch the installer from

    1. the VSS Users Storage with SCP or an equivalent SCP/SFTP client using the following settings:

      1. host: vskey-stor.eis.utoronto.ca

      2. VSS username and password.

    2. UTORrecover SharePoint site: https://utoronto.sharepoint.com/sites/its-eis-UTORrecover

  4. Navigate to /ut-vss-lib/networker/nix/ 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 nw191005_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/nix/ sftp> ls -tlhr drwxr-xr-x ? 0 0 6B Nov 1 14:50 nw191005_linux_x86_64
  1. Fetch nw191005_linux_x86_64/lgto*.rpm

    sftp> get nw191005_linux_x86_64/*rpm Fetching /ut-vss-lib/networker/nix/nw191005_linux_x86_64/lgtoclnt-19.10.0.5-1.x86_64.rpm to lgtoclnt-19.10.0.5-1.x86_64.rpm lgtoclnt-19.10.0.5-1.x86_64.rpm 100% 63MB 48.9MB/s 00:01 Fetching /ut-vss-lib/networker/nix/nw191005_linux_x86_64/lgtoman-19.10.0.5-1.x86_64.rpm to lgtoman-19.10.0.5-1.x86_64.rpm lgtoman-19.10.0.5-1.x86_64.rpm 100% 394KB 33.8MB/s 00:00 100% 320KB 2.4MB/s 00:00
  2. Install lgto software with by running:

    1. with yum

      yum localinstall --nogpgcheck lgto*.rpm
    2. with rpm:

      rpm -ivh lgto*.rpm
    3. To install the NetWorker software in a non-default location, type:

      rpm -ivh --relocate /usr=/path lgto*.rpm
  3. 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).

  1. Start the networker client process with:

    1. for systemd based:

      systemctl start networker
    2. for sysvinit based:

      /etc/init.d/networker start
  2. Check the status with:

    1. for systemd based:

      systemctl status networker
    2. for sysvinit based:

      /etc/init.d/networker status
  3. If you change SELinux value, you must revert the SELinux to default value, that is, the value before the installation of RPMs.

  4. Submit a request to backups@eis.utoronto.ca to with the following data:

    1. Hostname: hostname command.

    2. Fully Qualified Domain Name (FQDN)

    3. IP Address.

    4. Path(s) to Protect. i.e. /etc, /var, /home

  5. Submit an echo request by following this link How-to check NetWorker client connectivity for UTORrecover.

  6. The echo request result should be marked as Processed to be successful.

 Related articles

Related content

University of Toronto - Since 1827