====== Debug TSM server using servmon ======

====== SP debug servermon ======

Servmon process is running by default on Spectrum Protect server since version 8.1.10
<cli prompt='#'>
[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
</cli>

Start the **servermon** command with option **-list** to list all collected logs
<cli prompt='$'>
[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
...
</cli>

Extract a specific log using **-extract** argument Ex ID 723
<cli prompt='$'>
[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
</cli>

The .zip ouptput file will be located into the homedir of the instance, into the **srvmon** folder
<cli prompt='$'>
[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
</cli>

===== Automatically collects debug information to help resolve issues =====

  * Continuously collects a configurable set of information on server health, configuration, environment

  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”
 
  * If the server encounters any problems

  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)

<code>
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)
</code>