![]() |
![]() |
[ | | | ]
This chapter includes instructions for the following tasks:
When using the backup-archive GUI, command line client, or the Web client, you can logon using a node name and password or administrative user ID and password. Tivoli Storage Manager prompts for your user ID and compares it to the configured node name. If they match, Tivoli Storage Manager attempts to authenticate the user ID as a node name. If the authentication fails or if the user ID does not match the configured node name, the client attempts to authenticate the user ID as an administrative user ID.
To use an administrative user ID with any of the backup-archive clients, the user ID must have one of the following authorities:
Client access authority only allows Tivoli Storage Manager administrators to back up and restore files on remote machines. They do not have physical access to the data. That is, they cannot restore the data belonging to the remote machine to their own machines. To restore data belonging to a remote machine to your own machine, you must possess at least client owner authority.
To determine what authority you have, you can use either of the following methods:
The Tivoli Storage Manager GUI must be run from the X Window System. If you see the Tivoli Storage Manager icon on your desktop, Tivoli Storage Manager is already running. Double-click the icon to open the Tivoli Storage Manager window. If the Tivoli Storage Manager icon does not display on your desktop, you should start Tivoli Storage Manager using the dsm (starts the Motif GUI) or the dsmj (starts the Java GUI) command. Tivoli Storage Manager can run as either a foreground or background process.
To run the Java or Motif GUI in the foreground, enter:
dsmj or dsm
To run the Java or Motif GUI in the background, enter:
dsmj & or dsm &
Tivoli Storage Manager locates the client user options file (dsm.opt) and starts with the options specified in that file. See Chapter 2, Configuring Tivoli Storage Manager for more information about the client user options file.
Your Tivoli Storage Manager administrator can require you to use a password to connect to the server. Tivoli Storage Manager prompts you for the password if one is required. Contact your Tivoli Storage Manager administrator if you do not know your password. For information about changing your password, see Changing your password.
When the GUI client starts, it checks to see whether a client user options file exists. If the client user options file does not exist (which usually happens after you have installed the client for the first time on your machine), the setup wizard will automatically start and guide you through the configuration process. You can launch the setup wizard at any time to modify your client configuration files. To do this from the main Motif GUI window, select Utilities -> Setup Wizard.
Attention: If you are using the setup wizard in the Java GUI, a new dsm.opt and dsm.sys is created, overwriting the existing dsm.opt or dsm.sys file. For the Tivoli Storage Manager 5.2.0 release, it is recommended that you use the Motif GUI for configuration purposes. The Java GUI should only be used for initial setup if a previous dsm.opt or dsm.sys file does not exist, otherwise, existing dsm.opt or dsm.sys files will be overwritten.
You can launch the Preferences editor at any time to modify your client configuration files. To do this, select Edit -> Preferences from the Java GUI main window.
The setup wizard is not available through the Web client.
You can start a command line session using one of the following methods:
Your Tivoli Storage Manager administrator can require you to use a password to connect to the server. Tivoli Storage Manager prompts you for the password if one is required. If you do not know your password, contact your Tivoli Storage Manager administrator.
You can start a client command session in either batch or interactive mode.
Use batch mode to enter a single client command. When you use batch mode, you must precede the command with dsmc.
For example, to archive the file archive /home/proj1/file1.txt, enter the command:
dsmc archive /home/proj1/file1.txt
To issue the incremental command, enter the following at the command prompt:
dsmc incremental
Depending upon the current setting of your passwordaccess option, Tivoli Storage Manager may prompt you for your password before you enter a command in a batch mode session. See Passwordaccess for more information.
When you type your password and press Enter, the password does not display on your screen. If Tivoli Storage Manager is unable to authenticate your ID and password, you cannot use Tivoli Storage Manager services.
Use interactive mode when you want to issue a series of commands. Because Tivoli Storage Manager establishes the connection to the server only once for interactive mode, you can process a series of commands more quickly in interactive mode than in batch mode.
To start a client command session in interactive mode, enter either of the following commands:
When you press Enter, this prompt is displayed on your screen:
tsm>
When you are in interactive mode, do not precede commands with dsmc. For example, instead of typing dsmc archive to archive a file, type only archive.
For example, to archive a file named archive /home/proj1/file1.txt, enter the command:
archive /home/proj1/file1.txt
Note: In interactive mode, you cannot enter a file specification that contains national language characters. If a command contains national characters, process the command in batch mode by preceding the command with the executable program name, dsmc.
Depending upon the current setting of your passwordaccess option, Tivoli Storage Manager may prompt you for your password before you enter a command in an interactive session.
When you type your password and press Enter, the password does not display on your screen. If Tivoli Storage Manager is unable to authenticate your ID and password, you cannot use Tivoli Storage Manager services.
See Options handling in interactive mode for a discussion of how options are handled in interactive mode.
See Chapter 10, Using commands for more information on how to start and use the command line client.
You can include options as arguments to dsm, dsmj, and dsmc commands. For example, you can use options to modify the format that displays dates, times, and numbers, or to include your password so that Tivoli Storage Manager does not prompt for it.
In addition, if you have more than one server defined in the client system options file (dsm.sys) and you want to contact a different server for backup-archive services (other than the one specified in your client user options file dsm.opt), specify the server with the servername option. For example:
dsmj -servername=server_b
After installing the Web client on your workstation (see Configuring the Web client) you can use the Web client to perform backup, archive, restore, and retrieve operations from any browser that is at least Java Runtime Environment (JRE) 1.3.1 Swing-enabled. The Web client facilitates the use of assistive devices for users with disabilities and contains improved keyboard navigation. The native look and feel of the platform running the browser is preserved. The Web client will use most desktop font and color settings when run in browsers on Windows platforms.
The Web client runs on the following browsers:
To run the Web Client from Netscape browsers, Enable JavaScript must be checked. This setting is enabled by default, but to verify it:
For Microsoft Internet Explorer browsers, you must enable the Scripting of Java applets. This setting is also enabled by default. You can verify this by following these steps:
If your browser does not have the correct JRE level, the Web client will notify you and if possible, will try to automatically install the correct JRE for you.
If you have JRE 1.3.0 or lower installed, consider the following:
You can download and install JRE 1.3.1 or higher versions (unless otherwise noted) manually from the appropriate URL:
http://java.sun.com/j2se/1.3/jre/
http://www-106.ibm.com/developerworks/java/jdk/aix/index.html
http://www.hp.com/products1/unix/java/java2/sdkrte1_3/downloads/index.html
Comes with the required JRE support in the operating system. The Internet Explorer 5.1 browser for Macintosh OS X, Version 10.1 fully supports the required JRE.
For Windows:
For UNIX:
Additional information about running Swing applets can be found in Sun's Java Tutorial:
http://java.sun.com/docs/books/tutorial/uiswing/start/swingApplet.html
You can back up and restore your own data, or an Tivoli Storage Manager administrator can centralize the backup or restore operations of many clients.
To use the Web client, specify the URL of the client workstation running the Web client in your Web browser. You also need to specify the HTTPport number defined on the client workstation; the default is 1581. For example:
http://myhost.mycompany.com:1581
Note: Entering a different URL or pressing the browser Back button during an operation disconnects the Web client and causes the current operation to end. However, Tivoli Storage Manager backup and restore activities running in conjunction with a NAS box will continue after disconnect.
If you plan to use the Web client, ensure that you were assigned an administrative user ID with system privilege, policy privilege, client access authority, or client owner authority. When a new node is registered with the server, by default it is given an admin ID of the same node name with client owner authority. See Tivoli Storage Manager client authentication for more information about these authorities.
Note: You can use the revokeremoteaccess option to prevent a Tivoli Storage Manager administrator with client access privilege from performing client operations on your workstation through the Web client. However, Tivoli Storage Manager administrators with client owner privilege, system privilege, or policy privilege can still perform client operations on your workstation through the Web client. See Revokeremoteaccess for more information about the revokeremoteaccess option. See Tivoli Storage Manager client authentication for more information about access authorities.
Root User
You can add a command to the inittab file to start the client scheduler when the system boots up without any users logged in. If the Tivoli Storage Manager administrator has defined schedules for your node, starting the client scheduler permits you to automatically back up your workstation (or perform other scheduled actions). See Chapter 7, "Automating tasks" for more information about the client scheduler.
You can also use the Tivoli Storage Manager Client Acceptor daemon to manage the scheduler. See Configuring the client scheduler for more information.
Your Tivoli Storage Manager administrator can require you to use a password to connect to the server. Tivoli Storage Manager prompts you for the password if one is required. Contact your Tivoli Storage Manager administrator if you do not know your password.
To change your password from the GUI:
To change your password from the command line client, enter:
dsmc set password
Then, enter your old and new passwords when prompted.
A Tivoli Storage Manager password can be up to 63 characters. Valid
characters are:
Character | Description |
A-Z | Any letter; A through Z, upper or lower case |
0-9 | Any number; 0 through 9 |
+ | Plus |
. | Period |
_ | Underscore |
- | Hyphen |
& | Ampersand |
A password is not case sensitive. See Password for additional password information.
The following are additional password information sources:
Table 23. Working with your files using the Tivoli Storage Manager GUI
Task | Procedure |
---|---|
Displaying files | To display files in a directory, click the folder icon next to the directory name. The files appear in the File List box on the right. |
Sorting the file list |
|
Display active and inactive backup versions |
|
Display only active backup versions |
|
Selecting files to restore or retrieve. |
|
Deselecting files |
|
Displaying file information |
|
Notes:
On the command line client, you can use the inactive and pick options with query and restore commands to display both active and inactive objects. See Inactive and Pick for more information.
You can display online help in any of the following ways:
You can end a Tivoli Storage Manager client session in any one of the following ways:
To participate in user discussions of Tivoli Storage Manager you can subscribe to the ADSM-L list server. This is a user forum maintained by Marist College. While not officially supported by IBM, Tivoli Storage Manager developers and other IBM support staff also participate on an informal, best-effort basis. Because this is not an official IBM support channel, you should contact IBM Technical Support if you require a response specifically from IBM. Otherwise there is no guarantee that IBM will respond to your question on the list server.
You can subscribe by sending a note to the following e-mail address:
listserv@vm.marist.edu
The body of the message must contain the following:
SUBSCRIBE ADSM-L yourfirstname yourlastname
The list server will send you a response asking you to confirm the subscription request. Once you confirm your subscription request, the list server will send you further instructions. You will then be able to post messages to the list server by sending e-mail to:
ADSM-L@vm.marist.edu
If at a later time you want to unsubscribe from ADSM-L, you can send a note to the following e-mail address:
listserv@vm.marist.edu
The body of the message must contain the following:
SIGNOFF ADSM-L
You can also read and search the ADSM-L archives, join discussion forums, and access other resources at the following URL:
http://www.adsm.org
An anonymous FTP server is available where you can find PTF maintenance and other Tivoli Storage Manager-related materials. Four other anonymous servers are unofficially maintained by non-IBM volunteers. These servers are:
ftp.software.ibm.com/storage (primary - IBM) ftp.rz.uni-karlsruhe.de (mirror - Germany) ftp.wu-wien.ac.at (mirror - Austria) ftp.cac.psu.edu (mirror - Pennsylvania)
You can get maintenance information from the Tivoli Storage Manager support page at:
http://www.ibm.com/software/sysmgmt/products/support/IBMTivoliStorageManager.html
Also see Contacting customer support for product support information.