To install an NFM-P auxiliary server

Purpose

The following steps describe how to install the NFM-P auxiliary server software on a station. Ensure that you record the information that you specify, for example, directory names, passwords, and IP addresses.

Note: An auxiliary server is dedicated to only SNMP statistics collection.

Note: You require root user privileges on the auxiliary server station.

Note: Performing the procedure creates the nsp user account on the auxiliary server station.

Note: The following RHEL CLI prompts in command lines denote the active user, and are not to be included in typed commands:

Steps
 
1 

Log in as the root user on the auxiliary server station.

2 

Download the following installation files to an empty local directory:

  • nsp-nfmp-jre-R.r.p-rel.v.rpm

  • nsp-nfmp-config-R.r.p-rel.v.rpm

  • nsp-nfmp-aux-server-R.r.p-rel.v.rpm

  • nsp-nfmp-nodeexporter-R.r.p-rel.v.rpm

where

R.r.p is the NSP release identifier, in the form MAJOR.minor.patch

v is a version identifier

Note: In subsequent steps, the directory is called the NFM-P software directory.

3 

Navigate to the NFM-P software directory.

Note: Ensure that the directory contains only the installation files.

4 

Enter the following:

# chmod +x * ↵

5 

Enter the following:

# dnf install *.rpm ↵

The dnf utility resolves any package dependencies, and displays the following prompt:

Total size: nn G

Installed size: nn G 

Is this ok [y/d/N]: 

6 

Enter y. The following and the installation status are displayed as each package is installed:

Downloading Packages:

Running transaction check

Transaction check succeeded.

Running transaction test

Transaction test succeeded.

Running transaction

The package installation is complete when the following is displayed:

Complete!

7 

The initial NFM-P server installation on a station creates the nsp user account and assigns a randomly generated password.

If this is the first installation of an NFM-P main or auxiliary server on the station, change the nsp password.

  1. Enter the following:

    # passwd nsp ↵

    The following prompt is displayed:

    New Password:

  2. Enter a password.

    The following prompt is displayed:

    Confirm Password:

  3. Re-enter the password.

  4. Record the password and store it in a secure location.

8 

Enter the following:

# samconfig -m aux ↵

The following is displayed:

Start processing command line inputs...

<aux> 

9 

Enter the following:

<aux> configure ↵

The prompt changes to <aux configure>.

10 

Enter the following:

<aux configure> show-detail ↵

The auxiliary server configuration is displayed.

11 

If the default ip value is not the correct IP address of the auxiliary server, configure the ip parameter.

12 

Configure the fips parameter to specify whether FIPS security is enabled for network management.

See Enabling FIPS security for NFM-P network management for information about using FIPS security.

13 

Configure the main-server parameters in the following table, and then enter back ↵.

Table 14-63: Auxiliary server parameters — 
main-server

Parameter

Description

domain

The NFM-P system identifier

Default: NFM-P

ip-one

The primary main server IP address that the auxiliary server must use to reach the standalone main server, or the primary main server in a redundant system

Default: —

ip-two

The standby main server IP address that the auxiliary server must use to reach the standby main server in a redundant system

Default: —

14 

Configure the data-sync parameters in the following table, and then enter back ↵.

Table 14-64: Auxiliary server parameters — 
data-sync

Parameter

Description

local-ip

The IP address of the interface on this station that the other auxiliary server in an auxiliary server pair must use to reach this auxiliary server

Default: IP address of primary network interface

peer-ip

The IP address of the interface on the other auxiliary server station in an auxiliary server pair that this auxiliary server must use to reach the other auxiliary server

Default: —

15 

Configure the tls parameters in the following table, and then enter back ↵.

Table 14-65: Auxiliary server parameters — 
tls

Parameter

Description

keystore-file

The absolute path of the TLS keystore file

To enable automated TLS deployment, enter no keystore-file.

Default: —

keystore-pass

The TLS keystore password

Default: available from technical support

pki-server

One of the following in the platform—ingressApplications—ingressController section of the nsp-config.yml file on the local NSP deployer host:

In the internalAddresses subsection, if configured, otherwise, in the clientAddresses subsection:

  • if configured, the advertised value

  • otherwise, the virtualIp value

Default: —

pki-server-port

The TCP port on which the PKI server listens for and services requests

Default: 80

regenerate-certs

Whether to regenerate the internal TLS certificates

Certificate regeneration is required when the current certificates are about to expire, or a new internal root certificate is available.

Default: false

16 

As required, configure the oss parameters in the following table, and then enter back ↵.

Table 14-66: Auxiliary server parameters — 
oss

Parameter

Description

public-ip

The IP address that the XML API clients must use to reach the auxiliary server

Default: IP address of primary network interface

xml-output

The directory that is to contain the output of XML API file export operations

Default: /opt/nsp/nfmp/server/xml_output

17 

Verify the auxiliary server configuration.

  1. Enter the following:

    <aux configure> show-detail ↵

    The auxiliary server configuration is displayed.

  2. Review each parameter to ensure that the value is correct.

  3. Configure one or more parameters, if required.

  4. When you are certain that the configuration is correct, enter the following:

    <aux configure> back ↵

    The prompt changes to <aux>.

18 

Enter the following:

<aux> apply ↵

The configuration is applied.

19 

Enter the following:

<aux> exit ↵

The samconfig utility closes.

20 

Start the auxiliary server.

  1. Enter the following to switch to the nsp user.

    # su - nsp ↵

  2. Enter the following to start the auxiliary server:

    bash$ /opt/nsp/nfmp/auxserver/nms/bin/auxnmsserver.bash auxstart ↵

    The auxiliary server starts.

21 

Close the open console windows.

End of steps