![]() |
![]() |
If you did not install the Web client during the installation process, you can use the command line to install and configure it.
To install and configure the Web client from the command line, perform the following steps:
dsmc query session
when prompted, enter your user ID and password.
dsmcutil install cad /name:"TSM CAD" /node:nodename /password:password
dsmcutil install remoteagent /name:"TSM AGENT" /node:nodename /password:password /partnername:"TSM CAD"
dsmcad
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 optfile, httpport, httpsport, and webports. You can specify the httpport, httpsport, and webports options in the dsm.sys file. You can specify the optfile option on the command line only.
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. See Chapter 9, Setting Processing Options for more information.
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 AIX or AIX 5L with secure socket layer (SSL) communications, or for more information about Tivoli Storage Manager client services, see Appendix D, 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.
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:
Note: Tivoli Storage Manager does not support the scheduler running in prompted mode outside a firewall. In prompted mode the Tivoli Storage Manager server needs to contact the client. In order to do this, some software must be installed on the Tivoli Storage Manager server to route the request through the firewall. This software routes the server request through a sock port on the firewall. This is typically called socksifing a system. Proxies are not supported, since they only route a few types of communication protocols (HTTP, FTP, GOPHER) and Tivoli Storage Manager is not one of these communication protocols that are routed. It is important to note that the client creates a new connection to the Tivoli Storage Manager server when prompted. This means that the firewall configuration discussed above must be in place.