Command line interface

The command line interface has the benefit of being a character mode interface, and therefore is well suited for those users who want to type the commands. You may also consider using it when you cannot access the web administrative interface.

To start the command line interface, you must execute the administrative client program by typing DSMADMC at the operating system prompt. You are then prompted for an administrative user ID and password. Without authentication, you cannot logon to the Tivoli Storage Manager server. The following shows the start of an administrative client session on UNIX:

Option Notes

TCPSERVERNAME kindu The DNS name or IP address

TCPPORT 1500 Default

DATEFORMAT 3 YYYY-MM-DD

TIMEFORMAT 1 hh:mm:ss

LANGUAGE AMENG American English

NUMBERFORMAT 1 1,000.00

You then get the prompt tsm: SERVERNAME>to type the administrative Tivoli Storage Manager commands. Once an administrative command is executed, you always return back to thetsm: SERVERNAME> prompt. This interactive method is also called loopmode. If you use the interactive mode, you do not have to re-enter your password with each command.

Another method to start an administrative session is the so-called batchmode.

You simply type DSMADMC together with the administrative ID, the password, and the actual command that you want to execute. In this mode, the

administrative client processes the command and returns to the operating system prompt.

Help is available from thetsm: SERVERNAME>command prompt by typinghelp xxx where^xxxis blank, a command, or a Tivoli Storage Manager message number.

9.3.2 Web administrative interface

In Tivoli Storage Manager, the web administrative interface is the primary interface for administration. It incorporates Java applets and provides the following functions:

• Tivoli Storage Manager enterprise console

The enterprise console displays Tivoli Storage Manager as a single entity in the enterprise. It is an interface that integrates Tivoli Storage Manager server and client functions for the administrator as a single application to manage Tivoli Storage Manager in a distributed environment

• Server function

The web administrative interface is a Tivoli Storage Manager server function and consists of an integrated web server and a new HTTP server

communications protocol.

• Browser requirements

The web administrative interface can be used from any workstation running an HTML 3.0 compliant Web browser with support for Java 1.1.6 or higher.

Netscape 4.06 has the required Java support. Microsoft’s Internet Explorer 4.01 has the required Java support.

root@ / > dsmadmc Tivoli Storage Manager

Command Line Administrative Interface - Version 3, Release 7, Level 1.0 (C) Copyright IBM Corporation, 1990, 1999, All Rights Reserved.

Enter your user id: sysadmin Enter your password: ******

Session established with server TSM010: AIX-RS/6000 Server Version 3, Release 7, Level 1.0

Server date/time: 02/10/00 14:31:42 Last access: 02/10/00 14:30:57 tsm: TSM010>

• Security

Security for the web administrative interface is based on enhanced logging of Web-based sessions, password restrictions, and administrator lockout capabilities. In addition, Tivoli Storage Manager now has a Tivoli Storage Manager Secure Web Administration Proxy package, which enhances the web operations as well as potentially improving administrative client performance.

• Administrative functions

The web administrative interface can be used to perform all administrative functions graphically, and it provides a command line and server event viewer.

The web administrative interface connects to a Tivoli Storage Manager server through the Web to present an interface to a true Tivoli Storage Manager

administrator session. Using a Web browser means that you do not have to have any Tivoli Storage Manager code on the Web browser workstation.

To access the web administrator interface, start your web browser. In the Location or Address field, enter the URL:

http://<servername>:1580

Where, <servername> is the TCP/IP DNS name or dotted IP address of your Tivoli Storage Manager server machine, and 1580 is the TCP/IP port number set by the HTTPPORT option.

Figure 20 shows the web administrative interface logon screen.

Figure 20. Web administrative interface logon screen

When an administrator logs in to the server through the web administrative interface, the Tivoli Storage Manager enterprise console is displayed. The enterprise console consists of three frames. Additional command line and event viewers can be displayed.

• Banner Frame: The banner frame indicates which server you are connected to (server name, platform, and version, release, level) and the fact that you are using the Tivoli Storage Manager enterprise console. It also indicates the name you are logged on to as administrator.

The only operable control on the banner frame is a selection button that you can use to choose whether you want to display the command line and the event viewer. You can turn those windows off or on, depending on what you want to see in your browser display. Another option offers you the ability to log off (forcing re-authentication).

• Tree Frame: A collapsible tree is used for navigation. The content and layout are determined by the “view” that you have chosen. The initial branches of the tree are the views from which you can choose. Views are simply paradigms that are used to navigate to the objects in the enterprise that you want to use.

Available views are operation, network, configuration, and object.

• Detail Frame: The detail frame displays detailed information about the item that you have selected from the tree frame. All operations that are available to manipulate the selected item are provided in the form of a pull-down menu in the top-right corner of the detail frame. For example, when a server group is selected, its attributes are displayed in the detail frame. Operations are provided for adding servers to the group, removing servers from the group, and defining new server groups.

• Command Line: An administrative command line can be displayed by selecting it from the selections pull-down menu in the banner frame.

• Event Viewer: A server event viewer can be displayed by selecting it from the selections pull-down menu in the banner frame.

Figure 21 shows the Tivoli Storage Manager enterprise console with the Server Status screen and an open drop-down box with the Set password expiration option selected. Also shown are the administrative command line window and the server event viewer at the bottom of the screen.

Figure 21. Tivoli Storage Manager Enterprise Console browser interface

The web administrative interface has a drop-down box in the upper right corner of the screen that allows you to perform three functions: show a command line, show an event console line, and log off the Tivoli Storage Manager administrator.

In the command line area, you can issue any Tivoli Storage Manager command that could be issued from the command line interface. The event console line displays the command issued as a result of performing a function using the web administrative interface. It maintains a history of the commands that have been issued in this session. The command line and the event console line can be displayed simultaneously.

The web administrator session must re-authenticate after the time set in the Tivoli Storage Manager server setting WEBAUTHTIMEOUT expires. At the next interaction with the Tivoli Storage Manager server, you are prompted to enter your administrator ID and password. This time frame is based on wall clock time, not on the time since the last transaction. For example, if WEBAUTHTIMEOUT 10 is set, then every 10 minutes you will be prompted to re-authenticate, whether you have been active in those 10 minutes or not. Setting WEBAUTHTIMEOUT to zero indicates no timeout will occur.

We recommend that you use the web administrative interface, because it is platform-independent, it is location-independent (you only need a Web browser) and it allows you to perform all Tivoli Storage Manager administrator functions.