Configuring the web client

To configure the web client from the command line, perform the following steps:

To install and configure the web client from the command line, perform the following steps:

1. If MANAGEDServices schedule is set, specify MANAGEDServices webclient schedule in the dsm.sys file.
2. If MANAGEDServices schedule is set, specify MANAGEDServices webclient schedule in the dsm.opt file.
3. Ensure that you specify passwordaccess generate in the dsm.sys file.
4. Ensure that you specify passwordaccess generate in the client options file (dsm.opt).
5. To generate the Tivoli® Storage Manager password, start the backup-archive client by entering the following command:

   dsmc query session

   When prompted, enter your user ID and password.

   Tip: On Mac OS X, you can also generate a password by selecting the TSM Tools for Administrators application and starting Tivoli Storage Manager.
6. Install the Client Acceptor Service by entering the following command, where nodename and password are your Tivoli Storage Manager node name and password.

   dsmcutil install cad /name:"TSM CAD" /node:nodename 
    /password:password /autostart:yes

   TSM CAD is an example name. You can use any name that you want. The default name is TSM Client Acceptor.

7. Install the Remote Client Agent Service by entering the following command, where nodename and password are your Tivoli Storage Manager node name and password.

   dsmcutil install remoteagent /name:"TSM AGENT" /node:nodename 
   /password:password /partnername:"TSM CAD"

   TSM AGENT is an example name. You can use any name that you want, but the name must be different from the CAD name. The default name is TSM Remote Client Agent. The /partnername option value must match the name of the CAD service. The default is name is TSM Client Acceptor.

8. Start the client acceptor daemon (CAD) by entering the following command:

   dsmcad

   Tip: On Mac OS X you can start the client acceptor with the TSM Tools for Administrators application, by selecting Start the TSM Connect Agent.
9. Start the client acceptor service (CAD) by entering: net start "TSM CAD" on the command line, or complete the following steps:
   1. Open the Windows Start menu and select Settings > Control Panel.
   2. Select Administrative Tools and then double-click Services.
   3. In the Services window, right-click TSM CAD and select Start from the pop-up menu.

   The Tivoli Storage Manager Remote Client Agent service must not be started manually. It is automatically started by the Tivoli Storage Manager Client Acceptor service when needed.

   The options that are only applicable to the dsmcad program are httpport, managedservices, and webports. You can also use options such as optfile or errorlogname. You can use the managedservices option to specify whether the Tivoli Storage Manager client acceptor daemon also manages the Tivoli Storage Manager scheduler.

   You can open the web client from the Tivoli Storage Manager Operations Center interface. To enable this feature, you must specify the web client address in the URL parameter of the REGISTER NODE or UPDATE NODE command. The web address must include the DNS name or IP address of the node, and the port number for the web client (for example, http://node.example.com:1581).

   All web client messages are written to the web client log file, dsmwebcl.log. Error messages are written to the error log file dsmerror.log, or the file you specify with the errorlogname option. The dsmwebcl.log and dsmerror.log files are in the directory that you specify with the DSM_LOG environment variable or in the current working directory. Set this environment variable to the directory where the log files should reside. The root directory is not a valid value for DSM_LOG. Specify a directory other than the root directory.

10. To access the web client, enter the following URL from any supported browser, where your_machine_name is the host name of the workstation that is running the web client:

    http://your_machine_name:1581

Port 1581 is the default port number. You can set a different port number by using the httpport option.

The Tivoli Storage Manager Remote Client Agent daemon must not be started manually. It is automatically started by the Tivoli Storage Manager Client Acceptor daemon when needed.

The options applicable only to the dsmcad program are httpport, managedservices, and webports. You can also use options such as optfile or errorlogname. You can use the managedservices option to specify whether the Tivoli Storage Manager client acceptor daemon also manages the Tivoli Storage Manager scheduler.

All web client messages are written to the web client log file, dsmwebcl.log. Error messages are written to the error log file dsmerror.log, or the file you specify with the errorlogname option. The dsmwebcl.log and dsmerror.log files reside in the directory you specify with the DSM_LOG environment variable or in the current working directory. Set this environment variable to the directory where the log files should reside. The root directory is not a valid value for DSM_LOG. Specify a directory other than the root directory.

After you install and configure the web client on your workstation you can use the web client to perform backup, archive, restore, and retrieve operations.