Tivoli Header

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

Installing and Using the Web Client

If you did not install the Web client during the installation process, you can use the command line or the setup wizard to install and configure it.

To install and configure the Web client from the native client GUI, perform the following steps:

  1. From the native client GUI's main window, open the Utilities menu and select Setup Wizard.
  2. Select the Help me configure the TSM Web Client check box.
  3. Click the Next button and then follow the instructions on the screen.

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

  1. Ensure that you specify passwordaccess generate in the client options file (dsm.opt). For more information on passwordaccess, see Passwordaccess.
  2. To generate the Tivoli Storage Manager password, start the backup-archive client by entering:

    dsmc query session
    

    when prompted, enter your user ID and password.

    On Windows the NT, 2000, and XP clients you can also use the client services utility (dsmcutil) to generate passwords and validate them with the server.

  3. Install the Client Acceptor Service by entering the following command:
    dsmcutil install cad /name:"TSM CAD" /node:nodename /password:password 
    
  4. Install the Remote Client Agent Service by entering the following command:
    dsmcutil install remoteagent /name:"TSM AGENT" /node:nodename 
         /password:password /partnername:"TSM CAD"
    
  5. Start the client acceptor service

    The TSM Remote Client Agent service does not need to be started manually. It is automatically started by the TSM Client Acceptor service when needed.

    The only options applicable to the dsmcad program are httpport, httpsport, and webports. You can specify the httpport, httpsport, and webports options in the dsm.opt file.

    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 installation directory. See Chapter 9, Setting Processing Options for more information.

    For more information about Tivoli Storage Manager client services and their options, see Appendix C, Using the Client Service Configuration Utility (Windows NT, 2000, XP, Windows.NET).

  6. To access the Web client, enter the following URL from any supported browser:
    http://your_machine_name:1581
    

    where your_machine_name is the host name of the machine running the Web client.

Port 1581 is the default port number. Your administrator can set a different port number using the httpport option. See Httpport for more information.

You can also access the Web client workstation through the Web administrative GUI. To use the Web client on Windows NT with secure socket layer (SSL) communications, or for more information about Tivoli Storage Manager client services, see Appendix E, Web Client Secure Socket Layer.

Use the httpsport option to specify a TCP/IP port address for the HTTPS secure socket layer (SSL) interface to the Web client. See Httpsport for more information.

Tivoli Storage Manager Firewall Support

In most cases, the Tivoli Storage Manager server and clients can work across a firewall. The ports that the client and server need to communicate must be opened in the firewall by the firewall administrator. Because every firewall is different, the firewall administrator may need to consult the instructions for the firewall software or hardware in use.

The ports that the firewall needs to define are those ports that are needed for the client to connect to the Tivoli Storage Manager server. If the server is listening on port 1500 then the firewall software needs to forward the port to the Tivoli Storage Manager server machine.

To allow clients to communicate with a server across a firewall, you must open the TCP/IP port for the server using the tcpport option in the server options file. The default TCP/IP port is 1500.

To allow the Web client to communicate with remote workstations across a firewall, you must open the HTTP port for the remote workstation using the httpport option in the remote workstation's client option file. The default HTTP port is 1581.

You must open the two TCP/IP ports for the remote workstation client using the webports option in the remote workstation's option file. Values for the webports are required. If you do not specify the values for the webports option, the default zero (0) causes TCP/IP to randomly assign two free port numbers. See Webports for more information about the webports option.

To use the administrative Web interface for a server across a firewall, you must open the port that is the HTTP port for the server using the httpport option in the server options file. The default HTTP port is 1580.

In an enterprise environment, we strongly recommend that you use the Tivoli Storage Manager Secure Web Administrator Proxy for Web administration of the Tivoli Storage Manager server. Install the proxy on a Web server that sits on the firewall so that the Web server can access resources on both sides of the firewall (this is sometimes called the demilitarized zone). When you set up the proxy, you can use it to administer any Tivoli Storage Manager server at Version 3.7 or higher. For more information on how to install and use the proxy, see the appendix about the Web proxy in the Tivoli Storage Manager Quick Start manual. You can also increase security in this environment by enabling HTTPS services (also called secure socket layer or SSL) on the Web server where you install the proxy. Check your Web server documentation for information on how to set this up.

When using Tivoli Storage Manager across a firewall, please consider the following:


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