Linux: Automatically starting servers on Linux systems

To automatically start a Tivoli® Storage Manager server on a Linux operating system, use the dsmserv.rc script.

Before you begin

Ensure that kernel parameters are set correctly. For instructions, see Tuning kernel parameters for Linux systems.

Ensure that the Tivoli Storage Manager server instance runs under the instance owner user ID.

Ensure that access rights and user limits are set correctly. For instructions, see Verifying access rights and user limits.

About this task

The dsmserv.rc script is in the server installation directory, for example, /opt/tivoli/tsm/server/bin.

The dsmserv.rc script can be used either to start the server manually or to start the server automatically by adding entries to the /etc/rc.d/init.d directory. The script works with Linux utilities such as CHKCONFIG and SERVICE.

Procedure

For each server instance that you want to automatically start, complete the following steps:

Place a copy of the dsmserv.rc script in the /init.d directory, for example, /etc/rc.d/init.d.
Ensure that you change only the copy of the script. Do not change the original script.
Rename the script copy so that it matches the name of the server instance owner, for example, tsminst1.
The script was created under the assumption that the server instance directory is home_directory/tsminst1, for example: /home/tsminst1/tsminst1.
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"
```
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 more information about multiuser mode and run levels, see the documentation for your operating system.
Optional: You can start or stop the server by issuing one of the following commands:
- To start the server:
```
service tsminst1 start
```
- To stop the server:
```
service tsminst1 stop
```

Example

This example uses the following values:

The instance owner is tsminst1.
The server instance directory is /home/tsminst1/tsminst1.
The dsmserv.rc script copy is named tsminst1.
The CHKCONFIG utility is used to configure the script to start at run levels 3, 4, and 5.

cp /opt/tivoli/tsm/server/bin/dsmserv.rc /etc/rc.d/init.d/tsminst1
chkconfig --list tsminst1
service tsminst1 supports chkconfig, but is not referenced in
any runlevel (run 'chkconfig --add tsminst1')
chkconfig --add tsminst1
chkconfig --list tsminst1
tsminst1 0:off 1:off 2:off 3:off 4:off 5:off 6:off
chkconfig --level 345 tsminst1 on
chkconfig --list tsminst1
tsminst1 0:off 1:off 2:off 3:on 4:on 5:on 6:off