To collect NFM-P log files

Purpose

Perform this procedure to collect the relevant log files for troubleshooting an NFM-P database, server, single-user client or client delegate server station.

Note: When an NFM-P log file reaches a predetermined size, the NFM-P closes, compresses, and renames the file to include a timestamp and sequence number in the following format:

EmsServer.yyyy-mm-dd_hh-mm-ss.n.log

During a system restart, NFM-P log files are backed up to directories that are named using a timestamp. A component that runs for a long time can generate multiple log files. Before you restart an NFM-P component, ensure that there is sufficient disk space to store the backup log files.

Steps
 
1 

To collect the logs for a problem specifically related to installation, perform the following steps.

  1. Navigate to the installation directory, which is one of the following:

    • NFM-P database—/opt/nsp/nfmp/db/install

    • main server—/opt/nsp/nfmp/server

    • auxiliary server—/opt/nsp/nfmp/auxserver

    • single-user client— typically /opt/nsp/client on RHEL, and C:\nsp\client on Windows

    • client delegate server—typically /opt/nsp/client on RHEL, and C:\nsp\client on Windows

  2. Collect the following files:

    • NFM-P_component.install.time.stderr.txt

    • NFM-P_component.install.time.stdout.txt

    • NFM-P_component_InstallLog.log

    where

    component is the NFM-P component type, such as Main_Server or Main_Database

    time is the installation start time

  3. Go to Step 7 .

2 

If required, collect the NFM-P database logs.

  1. Log on to the NFM-P database station as the Oracle management user.

  2. Collect the following files:

    • /opt/nsp/nfmp/db/install/config/dbconfig.properties

    • all files in /opt/nsp/nfmp/db/install/admin/diag/rdbms/instance/instance/alert

    • all files in /opt/nsp/nfmp/db/install/admin/diag/rdbms/instance/instance/trace

    • all files in /opt/nsp/nfmp/db/install/admin/diag/proxy

    • all files with a .log extension in the following directories:

      – /opt/nsp/nfmp/db/install

      – /opt/nsp/nfmp/db/install/config

    where instance is the database instance name, which is maindb1 in a standalone deployment, or maindb1 or maindb2 in a redundant deployment

3 

If required, collect the main or auxiliary server logs; the log files have a .log extension and are in the following directories:

  • main server—/opt/nsp/nfmp/server/nms/log

  • auxiliary server—/opt/nsp/nfmp/auxserver/nms/log

4 

If required, collect the RHEL single-user client or client delegate server log files:

  • install_dir/nms/config/nms-client.xml

  • all files and subdirectories in the install_dir/nms/log/client directory

where install_dir is the client software installation location, typically /opt/nsp/client

5 

If required, collect the Windows single-user client or client delegate server log files:

  • install_dir\nms\config\nms-client.xml

  • all files and subdirectories in the install_dir\nms\log\client directory

where install_dir is the client software installation location, typically C:\nsp\client

6 

If required, use a script to collect a comprehensive set of log files.

  1. Log in to the station as the root user.

  2. Open a console window.

  3. Enter one of the following:

    • On a main server station:

      # /opt/nsp/nfmp/server/nms/bin/getDebugFiles.bash output_dir days ↵

    • On an auxiliary server station:

      # /opt/nsp/nfmp/auxserver/nms/bin/getDebugFiles.bash output_dir days ↵

    • On an NFM-P database station:

      # /opt/nsp/nfmp/db/install/getSAMDebugFiles.bash output_dir days ↵

  4. Collect the output files:

    Note:

    On a station that hosts a collocated NFM-P database and main server, all files are present. On a station in a distributed deployment, only two files are present.

    • hostname_date.WsInfoFiles.checksum.tar.gz

      Contains station-specific information such as the hardware and network configuration

    • hostname_date.ServerLogFiles.checksum.tar.gz

      Contains server and JBoss logs, and configuration information

    • hostname_date.DBLogFiles.checksum.tar.gz

      Contains NFM-P database logs and configuration information

Note: In NSP Release 23.4 to 25.4, failures may occur when a user tries to capture server debug files using the getDebugFiles.bash command. To resolve this issue, please use the following workaround:

  1. Change root umask temporarily:

    umask 02

  2. Create output directory:

    mkdir /support

  3. Run the command:

    ./getDebugFiles.bash /support/

7 

Store the files in a secure location to ensure that the files are not overwritten. For example, if two NFM-P clients have problems, rename the files to identify each client and to prevent the overwrite of one file with another of the same name.

8 

Send the files to technical support, as required.

End of steps