Configuring the client

The client user-options file (dsm.sys) contains options that enable LAN-free communication and defines the communication parameters that are required to pair with the storage agent. The enablelanfree, lanfreecommmethod, and lanfreeshmport options enable processing between the client and the SAN-attached storage device. The vmmc and vmctlmc options are required to force the separation of data and control files by using the two classes that were defined on the Tivoli® Storage Manager server.

Example

The following is an example of a backup-archive client system-options file, which contains the required options for one backup instance on the vStorage backup server:
* TSM server communication options
TCPSERVERADDRESS  scorpio2.acme.com
TCPP              1500
NODENAME          zergling
PASSWORDACCESS    GENERATE

* VMware related options
VMCHOST           vcenter.acme.com
VMCUSER           administrator
VMCPW ****
VMBACKUPTYPE      full
VMFULLTYPE        vstor

* LAN-free options
enablelanfree     yes
lanfreecommm      sharedmem
lanfreeshmport    1512

* Management class control options
VMMC              lanfree
VMCTLMC           control

* Transport control (optionally uncomment one of the following)
* CAUTION: use of non-default settings for the VMVSTORTRANSPORT
* option can result in undesirable backup failures.
* VMVSTORTRANSPORT san:nbd   * prevent the use of NBDSSL
* VMVSTORTRANSPORT san       * prevent the use of all LAN transports
Commenting out the VMVSTORTRANSPORT option in this example means that data is transferred through the SAN. If a failure occurs on the SAN path, the client uses its LAN connection to the Tivoli Storage Manager server and moves the data over the LAN. However, if this option is enabled, you can prevent the switch to LAN-based transport. Also, the VMCPW option is the result of generating the option from the preferences editor of the Tivoli Storage Manager client. Alternatively, you can use the following command:
dsmc set password -type=vm administrator adminPW