Problem: Cannot start an NFM-P server, or unsure of NFM-P server status

Server status indicators

The NFM-P main or auxiliary server startup script provides server status indicators that include the following:

Steps
 

Log in to the NFM-P server as the nsp user.


Open a console window.


To check the status of an NFM-P main server, perform the following steps.

  1. Enter the following:

    /opt/nsp/nfmp/server/nms/bin/nmsserver.bash appserver_status ↵

    The general server status is displayed.

  2. Enter the following at the CLI prompt:

    /opt/nsp/nfmp/server/nms/bin/nmsserver.bash nms_status ↵

    Detailed NFM-P server information is displayed.

  3. To obtain more specific server status information, run the nmsserver script in step 3 using the appropriate option from the following table in place of the nms_status or appserver_status option.

    NFM-P main-server startup script options

    Option

    Description

    start

    Starts the NFM-P main server in a non-interactive mode

    stop

    Stops the NFM-P main server

    debug

    Starts the NFM-P server in an interactive mode. Note: The server shuts down if the console is closed or if Ctrl-C is pressed.

    appserver_status

    Returns information about the status of the NFM-P main server (both active and standby servers when the NFM-P is configured for redundancy)

    appserver_version

    Returns NFM-P software release information that includes the start time of the current NFM-P main server instance

    nms_status

    Returns the following information:
    • NFM-P standalone, primary, or standby server start time and running time

    • total used and available memory

    • NFM-P database connectivity status

    • redundancy configuration and status

    • NFM-P license information

    • JVM memory-usage information

    • alarm forwarding information

    • basic auxiliary server information

    • number and status of current process threads

    -v nms_status

    Verbose version of the nms_status option that returns the following additional information:
    • ID and status of the current process threads

    • general JMS server information

    • currently connected JMS subscribers, by topic

    -s nms_status

    Short version of the nms_status option that returns the following information:
    • system information

    • IP address

    • NFM-P database information

    • installation information

    nms_info

    Returns the following information from the NFM-P database:
    • number of managed devices by device type; for example, 7750 SR

    • number of MDA ports by type

    • number of equipped ports by type

    • number of services by type; for example, IES or VLL

    • number of access interfaces, connection termination points, and channels, by type

    • number of alarms, listed in order of severity

    • lists of enabled statistics, file, and accounting policies, including the counts and the polling frequency for different types of objects

    nms_version

    Returns NFM-P software release information

    jvm_version

    Returns version information about the currently running Java Virtual Machine environment

    script_env

    Returns main server script environment information

    read_config

    Rereads the nms-server.xml server configuration file while the server is running in order to put configuration file updates into effect

    force_restart

    Forces the NFM-P main server to restart

    force_stop

    Forces the NFM-P main server to stop

    passwd <username> <current> <new>

    where

    username is the NFM-P database username, for example, samuser

    current is the current password

    new is the new password

    Changes the NFM-P database user password

    read_metrics_config

    Reads the server metrics configuration file

    import_license

    Imports a new license zip file for the server

    threaddump

    Prints a thread dump for every SAM java process running on the station

    webstart

    Starts the web server

    webstop

    Stops the web server

    webstatus

    Prints web server status

    webforce_restart

    Forces the web server to restart

    webforce_stop

    Forces the web server to stop and not restart

    jmsstart

    Starts the JMS server in interactive mode

    jmsstop

    Stops the JMS server

    jmsstatus

    Returns information that includes the following:
    • general JMS server information

    • currently connected JMS subscribers, by topic

    jmsread_config

    Rereads the JMS server configuration file while the JMS server is running

    jmsforce_restart

    Forces the JMS server to restart

    jmsforce_stop

    Forces the JMS server to stop

    jmsjvm_version

    Returns version information about the currently running Java Virtual Machine environment

    jmsappserver_status

    Returns the JMS server status

    jmsscript_env

    Returns the JMS script environment

    no keyword, help, or ?

    Lists the available command options


To check the status of an NFM-P auxiliary server, perform the following steps.

  1. Enter the following at the CLI prompt:

    /opt/nsp/nfmp/auxserver/nms/bin/auxnmsserver.bash aux_status ↵

    The general server status is displayed.

  2. Enter the following at the CLI prompt:

    /opt/nsp/nfmp/auxserver/nms/bin/auxnmsserver.bash auxappserver_status ↵

    Detailed NFM-P server information is displayed.

  3. To obtain more specific server status information, run the nmsserver script using the appropriate option from the following table in place of the aux_status or appserver_status option.

    NFM-P auxiliary-server startup script options

    Option

    Description

    auxappserver_status

    Returns information about the operational status of the auxiliary server

    auxdebug

    Starts the auxiliary server in interactive mode

    auxforce_restart

    Forces the auxiliary server to restart

    auxforce_stop

    Forces the auxiliary server to stop

    auxjvm_version

    Returns the auxiliary server JVM version

    auxread_config

    Directs the auxiliary server to read and apply the settings in the general configuration file

    auxread_metrics_config

    Directs the auxiliary server to read and apply the settings in the metrics configuration file

    auxscript_env

    Returns auxiliary server script environment information

    auxstart

    Starts the NFM-P auxiliary server

    auxstatus

    Returns information about the auxiliary server that includes the following:
    • IP address

    • port number

    • NFM-P database connections

    • installed server software release ID

    auxstop

    Stops the NFM-P auxiliary server

    aux_version

    Returns auxiliary server software release information

    auxthreaddump

    Returns a thread dump for every auxiliary server process currently running on the station

    auxhelp, no keyword, or ?

    Lists the available command options


Review and record the displayed information for technical support, if required.


Close the console window.


View the NFM-P server logs for error messages using the LogViewer utility, as described in Chapter 5, Network troubleshooting using NSP functions.


Report the error messages that you find to a technical support representative.

End of steps