Tivoli Header

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

Dsmcutil Options

The following options are valid:

/autostart:[Yes|No]
Specifies whether the Scheduler Service starts automatically at system boot time. The default is No.

/cadschedname:schedulername
Specifies the name of the scheduler service to manage with the CAD. Use this option when the managedservices option is set to schedule in the client options file dsm.opt. You can specify this option only with the CAD service.

/clientdir:clientdir
The fully qualified directory path where the Client Service files reside. This directory should be relative to the target machine where the service is installed. UNC names are not allowed. The default is the current directory.

/clustername:clustername
This option replaces the /group option.

The/clustername option specifies the cluster name to which the system belongs. The cluster name is determined by running the MSCS command, CLUSTER /LIST, from the command line. You can also use the Cluster Administrator utility to determine the cluster name. When the utility starts, it will display a tree-like structure with the cluster name at the top.

This option must be used with the /clusternode:Yes option. This option must be specified when using the INSTALL command in a cluster environment. It must also be specified when using the UPDATE command to modify the cluster settings (/clusternode and /clustername).

This option may also be specified when using the UPDATEPW command in a cluster environment. Normally this is not required. However, if more than one scheduler service with different cluster settings are defined for a particular node, the utility cannot determine which settings are correct. In this case, the recommended action is to correct the discrepancies between the services.

Alternatively, you can specify this option with /clusternode:Yes and /force:Yes, to force the utility to show or update the password with the specified cluster settings.

This option is not required if /clusternode:No is specified.

/clusternode:Yes|No
Specifies whether to enable support for cluster resources. The default value is No. You must be running the Microsoft Cluster Server (MSCS) to specify /clusternode:Yes. This option must be specified when using the INSTALL command in a cluster environment. This option must also be specified when using the UPDATE command to modify the cluster settings (/clusternode, /clustername).

This option may also be specified when using the UPDATEPW command in a cluster environment. Normally this is not required. However, if more than one scheduler service with different cluster settings are defined for a particular node, the utility cannot determine which settings are correct. In this case, the recommended action is to correct the discrepancies between the services.

Alternatively, you can specify this option with /clustername and /force:Yes, to force the utility to show or update the password with the specified cluster settings. If /clusternode:No is specified, /clustername is not required.

/commmethod:protocol
Specifies client communications protocol to communicate with a Tivoli Storage Manager server. Valid protocols are: TCP/IP and Named Pipes. If you do not specify a value, the value is obtained from the client options file or set to the default client value. You can also use this option with the UPDATEPW command to specify a communication protocol to connect to a server when updating passwords.

/commport:serverport
Specifies the protocol specific Tivoli Storage Manager server port. For TCP/IP, this is the port on the specified hostname. If this option is not specified, the value is obtained from the client options file or set to the default client value. You can also use this option with the UPDATEPW command to specify a protocol specific server port to connect to for updating passwords.

/commserver:servername
Specifies the protocol specific Tivoli Storage Manager server name. Depending on the protocol used, this can be a TCP/IP hostname or a Named Pipes name. If not specified, the value is obtained from the client options file or set to the default client value.

This option can also be used with the UPDATEPW command to specify a protocol specific server name to connect to for updating passwords.

/copyfiles
Specifies that the service installation is copied to another location prior to installing the service. Use the /srcdir option to specify the fully qualified source path.

/errorlog:errorlog
Specifies the fully qualified name of the client error log.

/eventlogging:[Yes|No]
Turns detailed event logging on or off for the specified scheduler service. The default is Yes.

/force:[Yes|No]
This option may also be specified when using the UPDATEPW command in a cluster environment. Normally this is not required. However, if more than one scheduler service with different cluster settings are defined for a particular node, the utility cannot determine which settings are correct. In this case, the recommended action is to correct the discrepancies between the services.

Alternatively, you can specify this option with /clusternode and /clustername (if /clusternode:Yes is specified), to force the utility to show or update the password with the specified cluster settings.

/httpport:httpport
Specifies a TCP/IP port address for the Web client.

/httpsport:httpsport
Specifies a TCP/IP port address for the HTTPS secure socket layer (SSL) interface to the Web client.

/machine:machinename
Specifies the name of a remote NT machine to connect to.

/name:servicename
Specifies the name of the Client service. The name must be quote delimited if it contains embedded spaces.

/node:nodename
Specifies the Tivoli Storage Manager node name the Client Service uses when connecting to the Tivoli Storage Manager server. Also used when displaying or updating the Tivoli Storage Manager registry password. The default is the NT machine name.

/ntaccount:ntaccount
Specifies the NT account which the service logs in as.

/ntdomain:ntdomain
Specifies the NT domain which the service logs in as.

/ntpassword:ntpassword
Specifies the NT password for the account under which the service logs in.

/oldpassword:oldpw
Current Tivoli Storage Manager server password. Used in conjunction with the /updateonserver option when updating a password on the server.

/optfile:optionsfile
The fully qualified path of the Tivoli Storage Manager options file. This is the options file the specified Client Service uses to connect to Tivoli Storage Manager. The utility also uses the file to connect to Tivoli Storage Manager to validate and update passwords. Note that although this option overrides the default option file in the current directory (dsm.opt), the Tivoli Storage Manager API requires that a default option file exists in the current directory. The default is dsm.opt in the /clientdir directory.

/partnername:partner service name
This option is used when installing a Remote Client Agent Service to specify the partner Client Acceptor Service.

/password:password
The Tivoli Storage Manager password which is generated (encrypted) into the registry.

/schedlog:schedlog
Specifies the fully qualified name of the client schedule log.

/srcdir:pathname
Use this option in conjunction with the /copyfiles option to specify the fully qualified source path to copy the service installation to another location prior to installing the service.

/startnow:[Yes|No]
Specifies whether dsmcutil starts the specified service after executing the command. If you specify No, you must start the service manually using the services control panel applet on NT, or the NET START name of the Tivoli Storage Manager service.

/updateonserver:[Yes|No]
Specifies whether the specified password is updated on the Tivoli Storage Manager server. Requires using the /oldpassword option.

/validate:[Yes|No]
Specifies whether to perform validation when displaying or updating the encrypted registry password. The default is Yes.

/webports: webports
Specifies the TCP/IP port number used by the Tivoli Storage Manager Client Acceptor service and the Tivoli Storage Manager Web client agent service for communications with the Web GUI.


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