To add a client delegate server to an NFM-P system

Purpose
CAUTION 

CAUTION

Service Disruption

This procedure requires a restart of each main server in the NFM-P system, which is service-affecting.

Perform this procedure only during a scheduled maintenance period.

The following steps describe how to add a new client delegate server to an existing NFM-P system.

Note: In order to install a client delegate server, you must specify the client delegate server address and installation location in each main server configuration, as described in the procedure.

Note: You require the following user privileges on each main server station:

Note: CLI commands use the following to represent the CLI prompt:

Do not type the leading # symbol or bash$ when you enter a command.

Steps
 
1 

If the system is deployed in a standalone configuration, go to Step 7.

2 

Perform Step 7 to Step 19 on the standby main server.

3 

Perform Step 7 to Step 19 on the primary main server.

4 

Perform Step 20 on the primary main server station.

5 

When the primary main server is fully operational, perform Step 20 on the standby main server station.

6 

Go to Step 21.

7 

Log in to the main server station as the root user.

8 

Open a console window.

9 

If you plan to use a hostname rather than an IP address for the client delegate server, add an entry to the /etc/hosts file on the main server that maps the client delegate server hostname to the IP address.

10 

Stop the main server.

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

    # su - nsp ↵

  2. Enter the following:

    bash$ cd /opt/nsp/nfmp/server/nms/bin ↵

  3. Enter the following:

    bash$ ./nmsserver.bash stop ↵

  4. Enter the following:

    bash$ ./nmsserver.bash appserver_status ↵

    The server status is displayed; the server is fully stopped if the status is the following:

    Application Server is stopped

    If the server is not fully stopped, wait five minutes and then repeat this step. Do not perform the next step until the server is fully stopped.

  5. Enter the following to switch to the root user:

    bash$ su ↵

  6. If the NFM-P is not part of a shared-mode NSP deployment, enter the following to display the nspOS service status:

    # nspdctl status ↵

    Information like the following is displayed.

    Mode:     redundancy_mode

    Role:     redundancy_role

    DC-Role:  dc_role

    DC-Name:  dc_name

    Registry: IP_address:port

    State:    stopped

    Uptime:   0s

    SERVICE           STATUS

    service_a         inactive

    service_b         inactive

    service_c         inactive

    You must not proceed to the next step until all NSP services are stopped; if the State is not ‘stopped’, or the STATUS indicator of each listed service is not ‘inactive’, repeat this substep.

11 

Enter the following:

# samconfig -m main ↵

The following is displayed:

Start processing command line inputs...

<main> 

12 

Enter the following:

<main> configure client ↵

The prompt changes to <main configure client>.

13 

Enter the following:

<main configure client> show ↵

The client configuration of the main server is displayed. The delegates parameter lists the current client delegate servers.

14 

Enter the following:

<main configure client> delegates current_list,new_address;path ↵

where

current_list is the comma-separated list of client delegate servers in the current main server configuration

new_address is the IP address or hostname of the new client delegate server

path is the absolute file path of the client installation location on the client delegate server station

15 

Enter the following:

<main configure client> back ↵

The prompt changes to <main configure>.

16 

Enter the following:

<main configure> show-detail ↵

The main server configuration is displayed.

17 

If the configuration is correct, enter the following:

<main configure> back ↵

The prompt changes to <main>.

18 

Enter the following:

<main> apply ↵

The configuration is applied.

19 

Enter the following:

<main> exit ↵

The samconfig utility closes.

20 

Start the main server.

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

    # su - nsp ↵

  2. Enter the following:

    bash$ cd /opt/nsp/nfmp/server/nms/bin ↵

  3. Enter the following:

    bash$ ./nmsserver.bash start ↵

  4. Enter the following:

    bash$ ./nmsserver.bash appserver_status ↵

    The server status is displayed; the server is fully initialized if the status is the following:

    Application Server process is running.  See nms_status for more detail.

    If the server is not fully initialized, wait five minutes and then repeat this step. Do not perform the next step until the server is fully initialized.

21 

Close the open console windows.

End of steps