===== Windows fileserver with DFS =====

Set the dfsbackupmntpnt option to yes in your client options file (dsm.opt).

===== Use the Dsmcutil command =====

The Tivoli® Storage Manager Client Service Configuration Utility, dsmcutil, allows Tivoli Storage Manager Client Services installation and configuration on local and remote Windows workstations.

You can install the following Tivoli Storage Manager services under a double-byte character set (DBCS) path:

    Backup-Archive Scheduler Service
    Client Acceptor Service (CAD)
    Remote Client Agent Service
    Journal Engine Service
    VMware Tools Service

The Client Service Configuration Utility must be run from an account that belongs to the Administrator/Domain Administrator group. The syntax of the utility is:

Read syntax diagramSkip visual syntax diagram
                         .-SCHEDuler---.   
>>-dsmcutil-- --command--+-service-----+-----------------------><
                         +-CAD---------+   
                         +-JOURnal-----+   
                         +-REMOTEagent-+   
                         '-VMWAREtools-'   

Note:

    For Windows Vista, you must right click on the command prompt and select "Run as administrator".
    Options that you specify with dsmcutil commands override those in your options file (dsm.opt).

The account running the utility must have the appropriate user rights for installing services and updating the Windows Registry on the target workstation.

If a remote workstation is specified, the account must be authorized to connect to the Windows Registry of the specified workstation.
Note: For the commands and options documented here, the minimum abbreviation is in upper case. Upper case letters denote the shortest acceptable truncation. If an item appears entirely in upper case letters, it cannot be truncated. You can type the item in any combination of upper case or lower case letters.


===== Dsmcutil commands: Required options and examples =====

==== INSTall ====

The INSTall command installs and configures a Tivoli® Storage Manager Service.

=== INSTall Scheduler ===

Installs and configures the Tivoli Storage Manager Scheduler Service.

These are the required INSTall command options:

    /name:servicename
    /password:password
    /clusternode:Yes|No (required if running the Microsoft Cluster Server (MSCS) or Veritas Cluster Server (VCS)).
    /clustername:clustername (required if running the MSCS or VCS).

Restriction: Do not specify a clustername of more than 64 characters. If you specify more than 64 characters and you are using Veritas Storage Foundation with High Availability or a Microsoft Cluster Server configuration, you might not be able to install or start the Tivoli Storage Manager scheduler service.

The /clientdir:clientdir option can also be used, the default is the current directory.

The following files must exist in the directory specified for /clientdir:clientdir:

    dsmcsvc.exe
    dscenu.txt
    dsm.opt
    dsmntapi.dll
    tsmutil1.dll

Note: If the service is being installed on a remote workstation, the fully qualified client directory path should be relative to the target workstation. UNC names are not allowed for the local system account. Multiple services can be installed on the same workstation.

Task
    Install a scheduler service named TSM Central Scheduler Service on the local workstation. Start the service automatically at system boot time. 
    All required files must reside in the current directory and the client options file must point to the Tivoli Storage Manager server where node ALPHA1 
    is defined with password nodepw. 
    The Tivoli Storage Manager server is contacted to verify that the specified node and password are valid. 
    When the password is validated it is generated (encrypted) into the Windows Registry:
    Command:

      dsmcutil install scheduler /name:"TSM Central Scheduler Service" 
      /node:ALPHA1 /password:nodepw /autostart:yes

Task
    Install a scheduler service named TSM Central Scheduler Service on remote workstation PDC. Start the service automatically at system boot time. 
    The required scheduler service files and the specified options file must reside on the remote workstation in the c:\tsm\baclient directory. 
    The password is encrypted into the Windows Registry. The Tivoli Storage Manager server is not contacted to validate the password.
    Command:

      dsmcutil install scheduler /name:"TSM Central Scheduler Service"
      /machine:PDC /clientdir:c:\tsm\baclient /optfile:c:\tsm\baclient\dsm.opt
      /node:PDC /validate:no /autostart:yes 
      /password:nodepassword

Task
    Install a scheduler service named TSM Central Scheduler Service on remote workstation PDC. Start the service automatically at system boot time. 
    The required scheduler service files and the specified options file must reside on the remote workstation in the c:\tsm\baclient directory. 
    The password is encrypted into the Windows Registry. The Tivoli Storage Manager server residing at the specified TCP/IP host and port is contacted 
    to validate the password.
    Command:

      dsmcutil install scheduler /name:"TSM Central Scheduler Service"
      /machine:PDC /clientdir:c:\tsm\baclient /optfile:c:\tsm\baclient\dsm.opt
      /node:PDC /autostart:yes /password:nodepassword
      /commmethod:tcpip /commserver:alpha1.sanjose.com
      /commport:1521

Task
    Install the TSM Central Scheduler Service on one node of a MSCS (or VCS) cluster. For group-a from workstation node-1, ensure that node-1 currently 
    owns group-a and then issue the command.
    Command:

      dsmcutil install scheduler /name:"TSM Central Scheduler Service:
      group-a" /clientdir:c:\tsm\baclient /optfile:q:\tsm\baclient\
      dsm.opt /node:mscs-cluster-group-a /password:n
      /validate:no /autostart:yes /startnow:yes
      /clusternode:yes /clustername:mscs-cluster

=== INSTall CAD ===

Installs and configures the Client Acceptor Service (CAD). Required options are:

    /name:servicename
    /node:nodename
    /password:password

Other valid options are:

    /optfile:optionsfile
    /httpport:httpport
    /webports:webports

Task
    Install a Client Acceptor Service called TSM CAD. TSM CAD uses a node called test to connect to the Tivoli Storage Manager server. 
    Use the options file c:\tsm\baclient\dsm.opt to connect to Tivoli Storage Manager.
    Command:

      dsmcutil install cad /name:"TSM CAD" /node:test
      /password:test /optfile:c:\tsm\baclient\dsm.opt

=== INSTall Journal ===

Installs a journaling engine service on all Windows clients. A journal database is created that stores information the client uses to determine which files are eligible for backup before an operation starts.

If necessary, you can use the nojournal option with the incremental command to specify that you want to perform a traditional full incremental backup.

The journaling engine service is named TSM Journal Service and uses the configuration file tsmjbbd.ini from the Tivoli Storage Manager installation directory.
Note: The Journal Service is supported in a Microsoft Cluster Server environment. Multiple journal services can be installed by specifying unique pipe names using the JournalPipe journal config setting and client options.

There are no valid options for this command.

Task
    Install the journaling engine service TSM Journal Service.
    Command:

      dsmcutil install journal                                      

=== INSTall REMOTEAgent ===

Installs and configures a Remote Client Agent Service. Required options are:

    /name:servicename
    /node:nodename
    /password:password
    /partnername:partner service name

Other valid options are:

    /optfile:optionsfile

Task
    Install a Remote Client Agent Service called TSM AGENT. TSM AGENT uses a node called test to connect to the Tivoli Storage Manager server. 
    The options file c:\tsm\baclient\dsm.opt is used to connect to Tivoli Storage Manager. The partner CAD service is TSM CAD.
    Command:

      dsmcutil install remoteagent /name:"TSM AGENT" /node:test 
      /password:test /optfile:c:\tsm\baclient\dsm.opt /partnername:
      "TSM CAD"

Note: Both the Remote Client Agent Service and the Client Acceptor Service must be installed to run the Web client. The Client Acceptor Service must be installed before the Remote Client Agent Service. Use the /partnername: option to specify the name of the partner Client Acceptor Service.

=== INSTall vmwaretools ===

Installs and configures the VMware tools service. There are no required options.
Command:

  dsmcutil install vmwaretools

==== REMove ====

Remove an installed Client Service. The required option is /name:servicename.

Task
    Remove the specified scheduler service from the local workstation.
    Command:

      dsmcutil remove /name:"TSM Central Scheduler Service"

Task
    Remove the journaling engine service TSM Journal Service from the local workstation.
    Command:

      dsmcutil remove /name:"TSM Journal Service"

REMove vmwaretools

Remove the VMware tools service. There are no required options.
Command:

  dsmcutil remove vmwaretools

==== UPDate ====

Updates Scheduler Service registry values. The required option for this command is /name:servicename, and the registry values to update. Other valid options are:

    /clientdir:clientdir
    /optfile:optionsfile
    /eventlogging:[Yes|No]
    /node:nodename
    /autostart:[Yes|No]
    /clusternode:Yes|No (required if running the MSCS or VCS).
    /clustername:clustername (required if running the MSCS or VCS).

Task
    Update the client directory and options file for the specified scheduler service. All required client service files must reside in the specified directory.
    Note: The communication options specified with the dsmcutil command here take precedence over those specified in the client options file.
    Command:

      dsmcutil update /name:"TSM Central Scheduler Service" 
      /clientdir:c:\tsmptf3\baclient /optfile:c:\tsmptf3\baclient\dsm.opt

Task
    Update the specified scheduler service to use the TCP/IP protocol to connect to a Tivoli Storage Manager server at the specified host name on the 
    specified port.
    Command:

      dsmcutil update /name:"TSM Central Scheduler Service" 
      /commserver:nt1.sanjose.com /commport:1521 /commmethod:
      tcpip

=== UPDate CAD ===

Updates Client Acceptor Service registry values. The required option for this command is /name:servicename, and the registry values to update. 
Other valid options are:

    /node:nodename
    /password:password
    /optfile:optionsfile
    /httpport:httpport
    /webports:webports
    /cadschedname:schedulername

Task
    Update the Client Acceptor Service to use the specified client password and options file. 
    All required client service files must reside in the specified directory.
    Command:

      dsmcutil update cad /name:"TSM CAD" /password:test 
      /optfile:c:\tsm\baclient\dsm.opt

=== UPDate REMOTEAgent ===

Updates Remote Client Agent Service registry values. The required option for this command is /name:servicename, and the registry values to update. 
Other valid options are:

    /node:nodename
    /password:password
    /optfile:optionsfile
    /partnername:partner service name

Task
    Update a Remote Client Agent Service called TSM AGENT. TSM AGENT uses a node called test to connect to the Tivoli Storage Manager server. 
    The options file c:\tsm\baclient\dsm.opt is used to connect to Tivoli Storage Manager. The partner CAD service is TSM CAD.
    Command:

      dsmcutil update remoteagent /name:"TSM AGENT" /node:test 
      /password:test /optfile:c:\tsm\baclient\dsm.opt /partnername:
      "TSM CAD"

==== Query ====

=== Query Scheduler ===

Query Scheduler Service registry values. Required options are: /name:servicename. Other valid options are:

    /machine:machinename
    /clientdir
    /optfile
    /eventlogging
    /node
    /commmethod
    /commport
    /commserver
    /errorlog
    /schedlog

Note: Do not specify a value for the non-required options. Tivoli Storage Manager returns option registry values for the scheduler service you specify.

Task
    Query registry settings for the scheduler service you specify.
    Command:

      dsmcutil query /name:"TSM Central Scheduler Service"

Task
    Query the client directory registry setting for the scheduler service you specify.
    Command:

      dsmcutil query /name:"TSM Central Scheduler Service"  

=== Query CAD ===

Queries Client Acceptor Service registry values. The required option for this command is /name:servicename. Other valid options are:

    /machine:machinename
    /node
    /optfile
    /httpport
    /webports
    /clientdir
    /partnername

Note: Do not specify a value for these options.

Task
    Query registry settings for the Client Acceptor Service you specify.
    Command:

      dsmcutil query cad /name:"TSM CAD"

=== Query Journal ===

Query the journaling engine service, TSM Journal Service on a Windows (32-bit). There are no valid options for this command.

Task
    Query the journaling engine service, TSM Journal Service.
    Command:

      dsmcutil query journal

=== Query REMOTEAgent ===

Queries Remote Client Agent Service registry values. The required option for this command is /name:servicename. Other valid options are:

    /machine:machinename
    /node
    /optfile
    /partnername
    /clientdir

Note: Do not specify a value for these options.

Task
    Query registry settings for the specified Remote Client Agent Service.
    Command:

      dsmcutil query remoteagent /name:"TSM AGENT"

==== List ====

Lists installed Client Services. There are no required options.

Task
    Locate and list the installed Tivoli Storage Manager client services on the local workstation.
    Command:

      dsmcutil list

Task
    List the installed Tivoli Storage Manager client services on remote workstation PDC.
    Command:

      dsmcutil list /MACHINE:PDC 

==== START ====

Use the Start command to start a client service. The Start command requires the /name:servicename option.

Task
    Start the journaling engine service, TSM Journal Service.
    Command:

      dsmcutil start /name:"TSM Journal Service"

==== STOP ====

Use the Stop command to stop a client service. The Stop command requires the /name:servicename option.

Task
    Stop the journaling engine service, TSM Journal Service.
    Command:

      dsmcutil stop /name:"TSM Journal Service"

==== UPDATEPW ====

Generate encrypted Tivoli Storage Manager registry password. The UPDATEPW command requires the /node:nodename and /password:password options. Optionally, you can use the following options:

    /validate:[Yes|No]
    /clusternode:Yes|No (required if running the MSCS or VCS).
    /clustername:clustername (required if running the MSCS or VCS).
    /force:[Yes|No]

The password is validated with the Tivoli Storage Manager server if the /validate:Yes option is specified. The password is updated on the server if you specify the /updateonserver:Yes option. If you specify this option, you must specify the current password with the /oldpassword option.

Task
    Update the encrypted registry password for the specified node. 
    Validate and update the password on the specified Tivoli Storage Manager server which resides on the specified TCP/IP hostname and port:
    Command:

      dsmcutil updatepw /node:alpha1 /commMethod:tcpip
      /commServer:alpha1.sanjose.ibm.com /commPort:1500
      /password:newpw /oldpassword:oldpw /updateonserver:yes

==== Location of password in Windows registry ====

Passord and Encryption key if used are stored in Windows Registry:
TSM client stores encrypted passwords in the following Registry Key:

  HKEY_LOCAL_MACHINE\SOFTWARE\IBM\ADSM\CurrentVersion\BackupClient\Nodes\<nodename>\<TSM servername>\