Set the client scheduler process to run as a background task and start automatically at startup

This is true whether you use the client acceptor daemon (CAD) to manage the scheduler or whether you use the traditional method to start the scheduler client scheduler.

When you are running a client acceptor daemon-managed schedule, only the client acceptor daemon process should be set to start automatically at startup time; not the scheduler process. For the traditional method, the scheduler process should be set up to start automatically at startup time.

You can configure the client acceptor daemon to run as a background system task which starts automatically when your system is started. To configure the client acceptor daemon to manage scheduled backups, you use the managedservices option to specify whether the CAD manages only the scheduler, only the web client, or both the scheduler and web client. The method for setting up the client acceptor daemon as a system task varies for each platform.

For the scheduler to start unattended, you must enable the client to store its password by setting the passwordaccess option to generate, and store the password by running a simple Tivoli Storage Manager client command such as dsmc query session. Note that for testing purposes, you can always start the scheduler in the foreground by running dsmc sched from a command prompt (without a managedservices stanza set).

To start the scheduler automatically at startup time, use either the CAD managed method or the traditional method.

Client acceptor daemon managed method

1. In your dsm.sys file, set the managedservices option to schedule or schedule webclient.
2. Start the client acceptor daemon.
   1. 
      On AIX®, HP-UX, and Solaris clients, 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

   2. 
      On Linux clients, the installation program creates a startup script for the client acceptor daemon (dsmcad) in /etc/init.d. The client acceptor daemon (dsmcad) must be started before it can manage scheduler tasks, or manage the web client. As root, use the following command to start, stop, or restart the daemon, or check its status:

      
      >>-service dsmcad--+-start---+---------------------------------><
                         +-stop----+   
                         +-restart-+   
                         '-status--'   
      
      

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

      # chkconfig --add dsmcad

   3. On Mac OS X, the Tivoli Storage Manager client acceptor daemon must be installed as a Startup Item. A system administrator must use the Tivoli Storage Manager Tools for Administrators to install and start the client acceptor daemon. To start, stop, or restart the daemon, use the following command:

      
      >>-sudo /sbin/SystemStarter--+-start---+--dsmcad---------------><
                                   +-stop----+           
                                   '-restart-'           
      
      

3. In your dsm.sys file, set the passwordaccess option to generate.
4. Run a command like dsmc query sess to store the node password.

Traditional method:

1. Set the managedservices option.
   • On AIX, HP-UX, Linux, and Solaris clients, either remove the option entirely (it defaults to webclient) or set it to webclient.
   • On Mac OS X clients, set the managedservices option to either webclient or none. Do not set the option to schedule.
2. On AIX, HP-UX, Linux, and Solaris, add the following entry into the system startup file, for example, /etc/inittab, where it is supported:

   tsmsched::once:/usr/bin/dsmc sched > /dev/null 2>&1 # TSM scheduler

3. In your dsm.sys file, set the passwordaccess option to generate.
4. Run a command like dsmc query sess to store the node password.
5. To start the client scheduler on your client node and connect to the server schedule, enter the following command:

      dsmc schedule

   If the current directory is not in your PATH environment variable, enter the following command:

      ./dsmc schedule 

   When you start the client scheduler, it runs continuously until you close the window, end the process, or log off your system.

   To run the schedule command in the background and to keep the client scheduler running, even if you log off your system, enter the following command:

      nohup dsmc schedule 2> /dev/null &

On Windows platforms, the scheduler and the client acceptor daemon run as services. You can create and manage these services by using either the setup wizard or the Tivoli Storage Manager Client Service Configuration Utility, dsmcutil.exe.

• To start the setup wizard, select Utilities > Setup Wizard in the Tivoli Storage Manager backup-archive GUI and select a Help me configure option for the appropriate service. Follow the prompts to install, configure, and start the service.
• To start the Tivoli Storage Manager Client Service Configuration Utility, open a command prompt window and issue the following command to change to the directory that contains dsmcutil.exe:

  cd /d "c:\program files\tivoli\tsm\baclient" 

  Use dsmcutil to manage the client acceptor service or the scheduler service. Full documentation on how to use dsmcutil is available by entering dsmcutil help.

The Tivoli Storage Manager client scheduler can be managed by the client acceptor daemon. When setting up Tivoli Storage Manager scheduler services to run with client acceptor daemon management, two services must be created: the scheduler service and the client acceptor daemon service. When you install the client acceptor daemon service with dsmcutil.exe, use the /cadschedname: parameter to identify which Tivoli Storage Manager scheduler service the client acceptor daemon manages. If you use the setup wizard to install the scheduler, you can select the Use the CAD to manage the scheduler check box, which automatically creates both services and associates them.

Using the Client Service Configuration Utility, you can use either of the following methods:

Client acceptor daemon-managed method

1. In your client options file (dsm.opt), either set the managedservices option to schedule or schedule webclient.
2. In your client options file (dsm.opt), set the passwordaccess option to generate.
3. Create the scheduler service:

   dsmcutil inst /name:"TSM Client Scheduler" /node:tsmclient1
   /password:secret /autostart:no /startnow:no

4. Create the client acceptor daemon and associate scheduler service with the client acceptor daemon:

   dsmcutil inst CAD /name:"TSM Client Acceptor" /cadschedname:
   "TSM Client Scheduler" /node:tsmclient1 /password:secret /autostart:yes 

5. Manually start the client acceptor daemon service:

   net start "TSM Client Acceptor"

Traditional method

1. In your client options file (dsm.opt), either remove the managedservices entirely (it defaults to webclient) or set it to webclient.
2. In your client options file (dsm.opt), set the passwordaccess option to generate.
3. Create the scheduler service:

   dsmcutil inst /name:"TSM Client Scheduler" /node:tsmclient1
   /password:secret /autostart:yes

To increase the reliability of the Tivoli Storage Manager client scheduler service on Windows, you should set the services to automatically recover from a failure, as follows:

• Start the Windows services management console (Start > Settings > Control Panel > Administrative Tools > Services)
• Right-click the TSM Client Scheduler service and select Properties.
• Click the Recovery tab.
• Define the recovery action as Restart the service for first, second, and subsequent failures.

If you are using the client acceptor daemon to manage the scheduler, you must set the recovery properties for the TSM Client Acceptor service, but leave the recovery settings for the TSM Client Scheduler as Take No Action for the first, second, and subsequent failures. The same recovery settings can also be defined to increase the reliability of the TSM Journal Service.