Starting and stopping the client service

Starting and stopping the client service can sometimes help to resolve client scheduling problems.

Tip: When you manage many clients that run scheduler processes, you also might want to be able to start and stop the client service from a remote computer. The client for Windows provides a utility to assist with remote management of the scheduler service. For other operating systems, standard operating system utilities are required.

To remotely manage the client scheduler service by using the DSMCUTIL command with the /computer: option, you must have administrative rights in the domain of the target computer. To determine whether the scheduler service is running on a remote computer, check the Current Status field from a query similar to the following query:

dsmcutil query /name:"TSM Client Scheduler" /computer:ntserv1.ibm.com

Issue the following queries to restart a scheduler service that is missing schedules:

dsmcutil stop /name:"TSM Client Scheduler" /computer:ntserv1.ibm.com
dsmcutil start /name:"TSM Client Scheduler" /computer:ntserv1.ibm.com

Therefore, if you use the client acceptor daemon (CAD) to manage the scheduler, you might have to restart the CAD service or stop the scheduler service and restart the CAD service with the following queries:

dsmcutil query /name:"TSM Client Scheduler" /computer:ntserv1.ibm.com
dsmcutil query /name:"TSM Client Acceptor" /computer:ntserv1.ibm.com
dsmcutil stop /name:"TSM Client Scheduler" /computer:ntserv1.ibm.com
dsmcutil stop /name:"TSM Client Acceptor" /computer:ntserv1.ibm.com
dsmcutil start /name:"TSM Client Acceptor" /computer:ntserv1.ibm.com

If you use the traditional method to manage the scheduler, you can write a shell script to search for and stop running IBM Storage Protect schedulers or client acceptor processes, and then restart the processes. The following example shell script shows you how to recycle the IBM Storage Protect scheduler process:

#!/bin/ksh
# Use the following script to kill the currently running instance
# of the TSM scheduler, and restart the scheduler in nohup mode.
#
# This script will not work properly if more than one scheduler 
# process is running.
# If necessary, the following variables can be customized to allow an
# alternate options file to be used.
# export DSM_DIR=
# export DSM_CONFIG=
# export PATH=$PATH:$DSM_DIR
# Extract the PID for the running TSM Scheduler
PID=$(ps -ef | grep "dsmc sched" | grep -v "grep" | awk {'print $2'});
print "Original TSM scheduler process using PID=$PID"
# Kill the scheduler
kill -9 $PID
# Restart the scheduler with nohup, redirecting all output to NULL
# Output will still be logged in the dsmsched.log
nohup dsmc sched 2>&1 > /dev/null &
# Extract the PID for the running TSM Scheduler
PID=$(ps -ef | grep "dsmc sched" | grep -v "grep" | awk {'print $2'});
print "New TSM scheduler process using PID=$PID"

Linux operating systems AIX operating systems Mac OS X operating
systems If you want to use the CAD managed method to manage the client scheduler, set the managedservices option to schedule or schedule webclient in the dsm.sys file. For Mac OS X, if you do not specify the managedservices option, the CAD manages both the scheduler and the web client, by default.

Add the following entry into the system startup file (/etc/inittab for most platforms):

tsm::once:/usr/bin/dsmcad > /dev/null 2>&1 # TSM Client 
Acceptor Daemon

The backup-archive client installation program creates a startup script for the CAD (dsmcad) in the /etc/init.d directory. You can start, stop, restart, and query the CAD by using the standard service command on Linux®. For example:

# service dsmcad start
# service dsmcad stop
# service dsmcad restart
# service dsmcad statis

To enable the CAD to start automatically after a system restart, add the service as follows, at a shell prompt:

# chkconfig --add dsmcad

You can start or stop the CAD with the launchd utility. To start the CAD, issue the following command in the Terminal window:

/bin/launchctl load -w com.ibm.tivoli.dsmcad

To stop the CAD, issue the following command in the Terminal window:

/bin/launchctl unload -w com.ibm.tivoli.dsmcad

You can also control the CAD with the TSM Tools for Administrators application.