Linux operating systems

Server startup script: dsmserv.rc

You can use the dsmserv.rc script to stop a server instance, or to manually or automatically start a server.

Prerequisites

Before you issue the DSMSERV.RC command, complete the following steps:
  1. Ensure that the server instance runs under a non-root user ID with the same name as the instance owner.
  2. Copy the dsmserv.rc script to the /etc/rc.d/init.d directory. The dsmserv.rc script is in the server installation directory, for example, /opt/tivoli/tsm/server/bin.
  3. Rename the script so that it matches the name of the server instance owner, for example, tsminst1.
  4. If the server instance directory is not home_directory/tsminst1, locate the following line in the script copy:
    instance_dir="${instance_home}/tsminst1"
    Change the line so that it points to your server instance directory, for example:
    instance_dir="/tsminst1"
  5. In the script copy, locate the following line:
    # pidfile: /var/run/dsmserv_instancename.pid
    Change the instance name value to the name of the server instance owner. For example, if the server instance owner is tsminst1, update the line as shown:
    # pidfile: /var/run/dsmserv_tsminst1.pid
  6. Use tools such as the CHKCONFIG utility to configure the run level in which the server automatically starts. Specify a value that corresponds to a multiuser mode, with networking turned on. Typically, the run level to use is 3 or 5, depending on the operating system and its configuration. For details about run levels, see the documentation for your operating system.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-dsmserv.rc--+---------+-------------------------------------><
               +-start---+   
               +-stop----+   
               +-status--+   
               '-restart-'   

Parameters

start
Starts the server.
stop
Stops the server.
status
Shows the status of the server. If the status is started, the process ID of the server process is also shown.
restart
Stops the server and starts it again.