Tivoli Header

Tivoli Storage Manager for Windows Backup-Archive Clients Installation and User's Guide

Using the Client Service Configuration Utility

This section provides the following:

This example illustrates the use of the Tivoli Storage Manager scheduler.

When the Tivoli Storage Manager backup-archive client is registered with a Tivoli Storage Manager server, the procedure involves the following steps:

  1. On the server:
    1. Define a schedule for the policy domain to which the backup-archive client is registered.
    2. Associate the backup-archive client node to the defined schedule.
  2. On the backup-archive client:
    1. Install the Tivoli Storage Manager scheduler client as a Windows service for the backup-archive client.
    2. Start the scheduler service installed for the backup-archive client.

Automating Backups

The example below uses the following assumptions:

This method is flexible because you can define a command file with any set of commands you choose.

On the server:

  1. Enter the following command on the server console or from an administrative client to define the schedule. The administrative client does not have to be running on the same system as the Tivoli Storage Manager server.
    def sched bacliwnt wnt_daily_incr desc="Daily Incremental Backup"
    priority=2 starttime=21:00 duration=15 durunits=minutes period=1
    perunits=days dayofweek=any
    

    Tivoli Storage Manager displays this message:

    ANR2500I Schedule WNT_DAILY_INCR defined in policy domain BACLIWNT.
    
  2. To associate the backup-archive client to this schedule, issue the following command:
    define association bacliwnt wnt_daily_incr  mars
    

    Tivoli Storage Manager displays this message:

    ANR2510I Node MARS associated with schedule WNT_DAILY_INCR in
     policy domain BACLIWNT.
    

    At this point, a schedule that performs an incremental backup is defined on the Tivoli Storage Manager server. The schedule starts around 9:00 pm. The schedule is re-executed once a day and can start on any day of the week.

    Note:
    If you want to confirm that the schedule and association are set correctly, you can use the Query Schedule command.

On the backup-archive client:

This example assumes that you installed the Tivoli Storage Manager backup-archive client in the c:\program files\tivoli\tsm directory. It is also assumes that the options files in each of these directories are updated so that the communication parameters point to the Tivoli Storage Manager server.

  1. Login using an account with administrative privileges.
  2. Open a command prompt window and issue the following command:
       cd /d c:\"program files"\tivoli\tsm\baclient 
    

    If the path contains a space, for example c:\program files\tivoli\tsm\baclient, enclose the name in double quotes.

  3. In the window, issue the following command:
    dsmcutil inst /name:"TSM Client Scheduler" /node:mars
    /password:marspswd /clientdir:"c:\program files\
    tivoli\tsm\baclient" /optfile:"c:\program files\tivoli\tsm\
    baclient\dsm.opt" /autostart:yes
    

    Your system is now ready to run automatic daily incremental backups. The /autostart:yes option specifies that the scheduler service starts automatically each time the system is rebooted. You can use the /startnow:[Yes|No] option to specify whether to start the scheduler service after executing the command; the default is Yes. If you specify /startnow:No you must start the service manually using the services control panel applet on NT, or issue the following command:

      net start "TSM Client Scheduler"
    

    For additional information about these options, see Dsmcutil Options.

  4. The scheduler uses the backup-archive client options file to validate the node and password, and to contact the server for schedule information. This example assumes that the dsm.opt file is updated so that the communication parameters point to the Tivoli Storage Manager server.

    If you see the following message:

       A communications error occurred connecting to the TSM server
    

    You should ensure that the options file contains entries that point to the correct Tivoli Storage Manager server. You should also ensure that the server is running. If you have to correct one of the installed scheduler services, issue the following command:

      dsmcutil  remove /name:"TSM Client Scheduler" 
    

    Then reissue the dsmcutil inst command.

Notes:

  1. If any changes that affect the scheduler service are made to the backup-archive client options file, the scheduler service has to be restarted to pick up the changes. An example of this is the Tivoli Storage Manager server address or the schedule mode. This can be done by issuing the following commands:
      net stop "TSM Client Scheduler"
      net start "TSM Client Scheduler" 
    

  2. The dsmsched.log file contains status information for the Tivoli Storage Manager scheduler service. In this example, the file is located in this path:
      c:\program files\tivoli\tsm\baclient\dsmsched.log
    

    You can override this file name by specifying the schedlogname option in the options file, dsm.opt.

  3. Output from scheduled commands is sent to the log file. After scheduled work is performed, check the log to ensure the work completed successfully.

    When a scheduled command is processed the schedule log may contain the following entry:

       Scheduled event eventname completed successfully
     
    

    This is merely an indication that Tivoli Storage Manager successfully issued the scheduled command associated with the eventname. No attempt is made to determine the success or failure of the command. You should assess the success or failure of the command by evaluating the return code from the scheduled command in the schedule log. The schedule log entry for the command's return code is prefaced with the following text:

       Finished command. Return code is:
    

Configuring the CAD to Manage an Existing Scheduler Service

The example below assumes that the scheduler service name is TSM Central Scheduler Service and the CAD service name is TSM Client Acceptor, which are the default names. You can use the dsmcutil /name option to specify different names. See Dsmcutil Commands and Dsmcutil Options for more information about dsmcutil commands and options.

To configure the CAD to manage an existing scheduler service:

  1. Stop the scheduler service and the CAD, as follows:
    dsmcutil stop /name:"tsm central scheduler service"
    dsmcutil stop /name:"tsm client acceptor"
    
  2. Set the managedservices option to schedule in the client options file dsm.opt.
  3. Update the scheduler service so that it does not start automatically after a reboot:
    dsmcutil update /name:"tsm central scheduler service"
    /autostart:no
    
  4. Associate the scheduler service with the CAD:
    dsmcutil update cad /name:"tsm client acceptor"
    /cadschedname:"tsm central scheduler service" /autostart:yes
    
    Note:
    If this command is successful, the dsmwebcl.log file will include this message: Command will be executed in 1 minute. After one minute, the CAD will start the scheduler and you will see information regarding the next scheduled event in the dsmwebcl.log file.

Creating a New Scheduler and Associating a CAD to Manage the Scheduler

To create a new scheduler and associate a CAD to manage the scheduler:

  1. Set the managedservices option to schedule in the client options file dsm.opt.
  2. Create the scheduler service:
     dsmcutil install /name:"NEW_SCHEDULE_NAME" /node:yournode /password:xxxxx
     /autostart:yes /startnow:no 
    
  3. Create the cad service:
    dsmcutil install cad /node:yournode /password:xxxxx
    /autostart:yes /startnow:no
     
    
  4. Associate the scheduler with the CAD:
    dsmcutil update cad /name:"tsm client acceptor"
    /cadschedname:"NEW_SCHEDULE_NAME"
    
  5. Start the CAD:
    dsmcutil start /name:"tsm client acceptor"
    
Note:
The CAD and scheduler will start, as described above. Note that since the CAD is controlling the scheduler, you will not see the scheduler running as a service, either through the Services applet or the NET START command. To stop the scheduler, you must stop the CAD.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]