IBM Tivoli Software IBM Tivoli Software

[ | | | ]


IBM Tivoli Storage Manager for UNIX: Backup-Archive Clients Installation and User's Guide


Chapter 3. Getting started

This chapter includes instructions for the following tasks:

Task Page
Starting a GUI session "Starting a GUI session"
Starting a command line session "Starting a command line session"
Starting a Web client session "Starting a Web client session"
Starting the client scheduler automatically "Starting the client scheduler automatically"
Changing your password "Changing your password"
Sorting file lists using the Tivoli Storage Manager GUI "Sorting file lists using the Tivoli Storage Manager GUI"
Displaying online help "Displaying online help"
Ending a session "Ending a session"

Tivoli Storage Manager client authentication

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:

System privilege
Authority over the entire system. An administrator with system privilege can perform any administrative task.

Policy privilege
Authority over the node policy domain. Allows an administrator to manage policy objects, register client nodes, and schedule client operations for client nodes.

Client owner
Authority over the registered Tivoli Storage Manager client node. You can access the client through the Web client or native backup-archive client. You own the data and have a right to physically gain access to the data remotely. You can back up and restore files on the same or different machine, and you can delete file spaces or archive data.

Client access
To use the Web Client to back up and restore files on a remote client machine, you must have an administrative user ID with client access authority over the node name for the remote client machine. If you do not want Tivoli Storage Manager administrators with client access authority over your node name to be able to back up and restore files on your machine, specify the revokeremoteaccess option in your client user options file (dsm.opt). See Revokeremoteaccess for more information

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:


Starting a GUI session

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.

Using your Tivoli Storage Manager password

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.

Setup Wizard

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.


Starting a command line session

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.

Using batch 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.

Using interactive mode

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.


Starting: Additional considerations

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

Starting a Web client session

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:

  1. Open Netscape Navigator's Edit menu and select Preferences.
  2. In the Preferences dialog under Category, select Advanced.
  3. Ensure there is a check mark next to Enable JavaScript.

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:

  1. Open the Tools menu and select Internet Options
  2. From the Internet Options dialog, select the Security tab.
  3. Click the Web content zone in which you will be using the Storage Manager Web client and then click the Custom Level button.
  4. In the Security Settings dialog, ensure that Enable is selected under the Scripting of Java applets setting.

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:

Note:
Note for proxy server users: The JRE 1.3.1 may return a security exception or a class not found exception if the Storage Manager Web Client attempts to open a TCP/IP socket to a socks server to communicate with the Storage Manager Remote Client Agent. To avoid this, you can use one of the following methods to bypass a proxy server, allowing the Web client to establish a direct connection to the Agent machine:

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.

Setting user privileges

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.


Starting the client scheduler automatically

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.


Changing your password

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:

  1. From the main window, open the Utilities menu and select Change password.
  2. Enter your current and new passwords, and enter your new password again in the Verify password field.
  3. Click Change.

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:


Sorting file lists using the Tivoli Storage Manager GUI


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
  • Select one of the Sort by items from the View menu bar.
  • Click the appropriate column heading in the File List box.

Display active and inactive backup versions
  • Click the Display Active/Inactive Files option from the View menu.
  • Click the Display both active and inactive files tool on the tool bar.

Display only active backup versions
  • Click the Display active files only option from the View menu.
  • Click the Display both active and inactive files tool on the tool bar.

Selecting files to restore or retrieve.
  • Click the selection box next to the directory or file name that you want to restore or retrieve.
  • Highlight the files that you want to restore or retrieve and click the Select Items tool on the tool bar.
  • Highlight the files that you want to restore or retrieve and click the Select Items option from the Edit menu.

Deselecting files
  • Click the checked selection box next to the directory or file name.
  • Highlight the files that you want to deselect and click the Deselect Items tool on the tool bar.
  • Highlight the files that you want to deselect and click the Deselect Items option from the Edit menu.

Displaying file information
  • Highlight the file name, and click the View File Details button on the tool bar.
  • Highlight the file name, and select File Details from the View menu.
  • Highlight the files that you want to deselect and click the Deselect Items option from the Edit menu.

Notes:

  1. Using the Tivoli Storage Manager GUI, you can sort a list of files by various attributes, such as name, directory, size, or modification date. Sorting files by the last backup date can be useful in determining what date and time to use for the point-in-time function (see "Performing point-in-time restores").

  2. An active file is the most recent backup version of a file that existed on your workstation when you ran your last backup. All other backup versions of that file are inactive. Only active backup versions of files are displayed, unless you select the Display active/inactive files menu option. If you delete the file from your workstation, the active version becomes inactive the next time you run an incremental backup.

    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.


Displaying online help

You can display online help in any of the following ways:


Ending a session

You can end a Tivoli Storage Manager client session in any one of the following ways:


Online forum

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

Other sources of online help

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.


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