TSM Maintenance Mode - bnw4cristie/TSM-Tricks GitHub Wiki

Starting the TSM server in Maintenance mode

staring with TSM 7 you can start a TSM intance in maintenance mode which suppresses client session, automatically starting scripts …

Linux

There are at least two ways to start the server in maint mode -- with or without an interactive console shell. As it makes no big difference, I suggest not to disable the console:

  • starting the instance as root in the quite mode, so without an admin shell: add option -q to startup

    /opt/tivoli/tsm/server/bin/rc.dsmserv -u <USER> -i <Instance Home> -q MAINT

  • starting the instance as root with console / admin shell in the foreground:

    /opt/tivoli/tsm/server/bin/rc.dsmserv -u <USER> -i <Instance Home> MAINT

the more simple way

there's also a quite more simple way to run a server in Maintenance mode:

  1. I suggest to run it in a screen, so first start a screen by screen -S <Name>, e.g. screen -S <Instance-Name>

  2. become instance user:

    sudo - <Instance user's account name>

    IMPORTANT:

    the - triggers a login console, so executing all the necessary scripts to prepare and start up e.g. db2

  3. switch to folder containing the server's config files (where the dsmserv.opt is located):

    cd <path to config files>

  4. run directly

    dsmserv MAINT

so for instance TSM123 it may look like

screen -S "TSM123"

and then

su - tsm123
cd ~/config
dsmserv MAINT

Windows

Due to the ISP documentation windows should work in the same way as Linux

Let's assume,

  • the server config is located in D:\TSM123-Config
  • the server name is tsm123
  1. run Windows-Commandline as admin:

How to Run Windows CMD in Admin mode

  1. you need to remind the different commandline options, espcially giving the Instance by issuing the registry key, e.g.

    C:\Windows\system32>d:
    
    D:\>cd TSM123-Config
    
    D:\SM123-Config>"c:\Program Files\Tivoli\TSM\server\dsmserv.exe" -k tsm123 MAINT
    ANR7800I DSMSERV generated at 10:27:11 on Nov 17 2023.
    
    IBM Spectrum Protect for Windows
    Version 8, Release 1, Level 20.000
    
    Licensed Materials - Property of IBM
    
    (C) Copyright IBM Corporation 1990, 2023.
    All rights reserved.
    U.S. Government Users Restricted Rights - Use, duplication or disclosure
    restricted by GSA ADP Schedule Contract with IBM Corporation.
    
    ANR0900I Processing options file D:\SM123-Config\dsmserv.opt.
    ANR3339I Default Label in key data base is TSM Server SelfSigned SHA Key.
    ANR4726I The ICC support module has been loaded.
    ANR0990I Server restart-recovery in progress.
    ...
    

(Output incomplete)

CAUTION

Starting the instance without the '-k ' seems to work, but right at the beginning some error messages

 ```
 C:\Windows\system32>d:
 
 D:\>cd TSM123-Config
 
 D:\TSM123-Config>"c:\Program Files\Tivoli\TSM\server\dsmserv.exe" MAINT
 The server has not been properly installed.
 Could not find the output logfile key.
 Issue dsmserv -help for a usage statement
 
 ANR7800I DSMSERV generated at 10:27:11 on Nov 17 2023.
 
 IBM Spectrum Protect for Windows
 Version 8, Release 1, Level 20.000
 
 Licensed Materials - Property of IBM
 
 (C) Copyright IBM Corporation 1990, 2023.
 All rights reserved.
 U.S. Government Users Restricted Rights - Use, duplication or disclosure
 restricted by GSA ADP Schedule Contract with IBM Corporation.
 
 ANR0900I Processing options file D:\SM123-Config\dsmserv.opt.
 ANR3339I Default Label in key data base is TSM Server SelfSigned SHA Key.
 ANR4726I The ICC support module has been loaded.
 ANR0990I Server restart-recovery in progress.
 
 DBI1306N    Das Instanzprofil ist nicht definiert.
 
 Erlõuterung:
 
 Die Instanz ist in der Registry der Zielmaschine nicht definiert.
 
 Benutzeraktion:
 
 Geben Sie einen vorhandenen Instanznamen an oder erstellen Sie die erforderliche Instanz.
 
 
 ANR0152I Database manager successfully started.
 ANR1628I The database manager is using port 52123 for server connections.
 ANR1635I The server machine GUID, 32.84.a0.c0.6d.7d.16.eb.20.4a.3c.ec.e5.0c.cf.b2, has initialized.
 ANR2100I Activity log process has started.
 ANR4726I The NAS-NDMP support module has been loaded.
 ANR1794W IBM Spectrum Protect SAN discovery is disabled by options.
 ANR7808W Oracle Library Attach module libacs.dll is not available from the system.
 ANR2803I License manager started.
 ANR8598I Outbound SSL Services were loaded.
 ANR8273I Shared memory driver ready for connection with clients on port 6123.
 ANR8200I TCP/IP Version 4 driver ready for connection with clients on port 2123.
 ANR8206I TCP/IP Version 4 administrative driver ready for connection with clients on port 4123.
 ANR2718W Schedule manager disabled.
 ANR0281I Servermon successfully started during initialization, using process 22643.
 IBM Spectrum Protect:TSM123>
 ANR0993I Server initialization complete.
 ANR0916I IBM Spectrum Protect distributed by International Business Machines is now ready for use.
 ```

further readings

⚠️ **GitHub.com Fallback** ⚠️