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

Purpose

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:

root
nsp

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

#—the prompt for the root user
bash$—the prompt for the nsp user

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. Enter the following to switch to the nsp user: `#` `su - nsp ↵` Enter the following: `bash$` `cd /opt/nsp/nfmp/server/nms/bin ↵` Enter the following: `bash$` `./nmsserver.bash stop ↵` 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. Enter the following to switch to the root user: `bash$` `su ↵`
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. Enter the following to switch to the nsp user: `#` `su - nsp ↵` Enter the following: `bash$` `cd /opt/nsp/nfmp/server/nms/bin ↵` Enter the following: `bash$` `./nmsserver.bash start ↵` 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