Collecting statistics from the servermon component for problem resolution

The servermon component automatically collects statistics about the IBM Storage Protect storage environment and archives the data. The statistics provide wide-ranging information that can facilitate problem resolution. If you cannot resolve issues in your storage environment by using statistics from the servermon component, you can provide the statistics to IBM Software Support.

About this task

Starting with IBM Storage Protect 8.1.10, the servermon component is automatically installed and enabled when the IBM Storage Protect server is installed. The servermon component collects data at regular intervals by taking snapshots of the storage environment and archiving the statistics daily.

Procedure

To share data that is collected by the servermon component with IBM Software Support, complete the following steps:

  1. Obtain a list of available archive files by issuing the following command from the instance directory:
    servermon –list
    The output of this command provides the index identifier to use for extraction, the date and time that the archive was created, and the size of the compressed file. The compressed file includes data from a single day of collection and is available at the end of each 24-hour cycle of data collection.
  2. Select a data archive file by issuing the following command and specifying the ID that you want to extract for analysis:
    servermon –extract –id id_to_extract
    where id_to_extract specifies the ID of the data archive that you identified in step 1.
    Optionally, to extract the latest data archive file, you can issue the following command without specifying the ID:
    servermon -extract
    Tip:

    You can use the -outpath option when you start the servermon component to specify the directory where servermon stores its output files. By default, servermon uses /home/tsminst1/srvmon as the output directory.

    If you want to use a different location, specify a custom path with the -outpath option when you start servermon. Ensure that the specified directory exists and that the server instance user has write access to it.

    The following example shows how to start servermon with a custom output directory:

    servermon -outpath "file_path"

    where file_path is the directory where servermon stores its output files and extracted data archives.

    When data is extracted by the servermon component, the output is written to the directory that is configured with the -outpath option. If no custom path is specified, the default directory /home/tsminst1/srvmon is used.

  3. Go to the srvmon subdirectory and locate the extract folder zip file. The file name follows the pattern servermonFile-server_name-YYYYMMDD.zip, for example, servermonFile-SERVER1-20260709.zip.
  4. Send the archive file to IBM Software Support.

What to do next

To set the servermon component to collect additional statistics, see Updating the commandscustom.ini file for additional data collection.