Table of Contents

Debug TSM server using servmon

SP debug servermon

Servmon process is running by default on Spectrum Protect server since version 8.1.10

[root@tsm01 ~]# /opt/tivoli/tsm/server/bin/servermon # ps -ef | grep serv
ispprd1  18352  18273 91 Apr28 ?        23:40:07 /opt/tivoli/tsm/server/bin/dsmserv -i /ispprd1 -q
ispprd1  18434  18352  0 Apr28 ?        00:00:05 /opt/tivoli/tsm/server/bin/servermon/servermon -path=/ispprd1/ -dbalias=TSMDB1 -schema=TSMDB1 -instance=ispprd1 -optFile=/ispprd1/dsmserv.opt -installdir=/opt/tivoli/tsm/server/bin/servermon -dsmservId=18352

Start the servermon command with option -list to list all collected logs

[ispprd1@tsm01 ~]$ /opt/tivoli/tsm/server/bin/servermon/servermon -path=/ispprd1/ -dbalias=TSMDB1 -schema=TSMDB1 -instance=ispprd1 -optFile=/ispprd1/dsmserv.opt -installdir=/opt/tivoli/tsm/server/bin/servermon -dsmservId=18352 -list
List of archives
Index   Date Created                        Zipped Size
49      2020-09-04-00:00                    10.633 MB
147     2020-10-19-12:14                    13.923 MB
196     2020-12-06-00:00                    23.159 MB
245     2021-01-22-00:01                    25.646 MB
723     2022-04-26-00:00                    14.550 MB
...

Extract a specific log using -extract argument Ex ID 723

[ispprd1@tsm01 ~]$ /opt/tivoli/tsm/server/bin/servermon/servermon -path=/ispprd1/ -dbalias=TSMDB1 -schema=TSMDB1 -instance=ispprd1 -optFile=/ispprd1/dsmserv.opt -installdir=/opt/tivoli/tsm/server/bin/servermon -dsmservId=18352 -extract -id 723

The .zip ouptput file will be located into the homedir of the instance, into the srvmon folder

[ispprd1@tsm01 ~]$ ll srvmon
total 15172
-rw-r----- 1 ispprd1 ispsrv    30836 Apr 25 11:11 commands.ini
-rw-r----- 1 ispprd1 ispsrv       11 Apr 28 08:44 lock
-rw------- 1 ispprd1 ispsrv 15256693 Apr 29 11:03 servermonFile-ISPPRD1-20220426.zip
-rw-r----- 1 ispprd1 ispsrv     2505 Jul 23  2019 servermon.ini
-rw------- 1 ispprd1 ispsrv    23749 Apr 29 11:03 servermon.log

Automatically collects debug information to help resolve issues

Runs continuously in the background collecting info for 10/20/60 minute intervals
Archives this information in the database
Negligible performance hit  - could turn off with dsmserv.opt “alwaysonservermon=no”
Easy for the customer to retrieve information 
Information already exists about the server's status at the time of the problem (and perhaps before) 
Can send in to IBM support

* Simply runs in the background  
Collections stored temporarily in srvmon directory which is a staging area
Compressed and consolidated as archiveFile-[date].zip
Stored in SERVERMON_ARCHIVES table in the SP db
servermon executable automatically prunes archives from database
dailyretention (number of daily collections to keep default 90 days)
weeklyretention (number of additional collections one/week to keep default 30 weeks)
servermon:  will run servermon until interrupted
servermon –debug: will run the servermon with enhanced logging
servermon –list: will list archives of data that have been stored in Db2 by servermon
servermon –remove -id <ID>: will delete a stored archive based on the provided ID
servermon –extract –id <ID>: will extract an archive from Db2 and leave it in the srvmon directory as a date stamped zip file that can be extracted for analysis
servermon –prune: will remove archives from Db2 that are determined to be no longer necessary by configurable options (this occurs automatically once per day during normal servermon execution)