Tivoli Storage Manager for Windows Using the Backup-Archive Client


Chapter 2. 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"
"Changing Your Password" "Changing Your Password"
"Displaying Online Help" "Displaying Online Help"
"Ending a Session" "Ending a Session"

Starting TSM the First Time

Note:Unless otherwise specified, references in this manual to Windows 95 also include Windows 98. References to Windows NT also include Windows 2000.

The following information assumes that you have installed TSM. If you have not installed TSM, see Installing the Clients, SH26-4119, for installation information.

If you plan to use a Web client with an enterprise management server, ensure that you were assigned an administrative user id with system privilege, policy privilege, client access, or clientowner authority.

Before you can use TSM, you must register your client with the server. The process of setting up a node name and password is called registration, and is performed by your administrator.

TSM provides two types of registration: open and closed. Your administrator chooses the type of registration for your site.

Using Closed Registration

With closed registration, an administrator must register your workstation as a client node with the server. If your enterprise uses closed registration, you need to provide the following information to your administrator:

In addition to possibly defining certain options in your options file, your administrator defines the following for you:

Using Open Registration

With open registration, you can register your workstation as a client node with the server.

The first time you start a session, TSM prompts you for information necessary to register your workstation with the server identified in your options file. You need to supply your node name, a password, and contact information.

When you use open registration:

If necessary, your administrator can change these defaults later.

For more information about TSM client services, see Installing The Clients, SH26-4102.


Permissions Required for Using Client Services

Note:This section refers to Windows NT and Windows 2000, only.
To install and configure TSM services on the entire system, including the system registry, you must belong to a local administrator account or a domain administrator account. To back up files, you must have access rights on the local drive or directory containing those files.

By default, the TSM client services run under the local system account. Because the services use logon properties such as persistent drive mappings, and local search path and environment variables of the account into which they are logged, consider having the services account run under a domain account instead of the local system account.

Domain resources, such as network drives, can only be accessed by services configured to run under a domain authorized account using dsmcutil or the Service Control Panel Application. Any non-system account (local or domain) must have the following rights:

Without these rights, users can only back up files they own, not files owned by another or owned by the system registry.


Permissions Required to Restore Files that Use Adaptive Subfile Backup

Note:This section refers to Windows NT and Windows 2000, only.

To restore files that were processed using adaptive subfile backup, you must be either the owner of the file or have read access. These permissions are in addition to those required to perform a normal restore.


Starting a GUI Session

Start a GUI session using one of the following methods:

Your administrator can require you to use a password to connect to the server. TSM prompts you for the password, if one is required. Contact your administrator if you do not know your password. See Changing Your Password for information about changing your password.

Note:For Windows NT, in order to back up the entire system, including the system registry, your user ID must belong to the administrator group or domain administrator group which has the following rights:
  • Backup files and directories
  • Restore files and directories
  • Manage auditing and security logs
Users without these rights can back up only files they own.

Configuration Wizard

When the GUI client starts initially and does not find an options file, a setup wizard displays to guide you through the configuration process. You can also display the setup wizard by selecting Utilities>Setup Wizard from the TSM main window. To perform configuration tasks, follow instructions on the screen. The Setup Wizard is not available through the Web client.


Starting a Command Line Session

An alternate way to start the client is from the command line. However, if TSM does not find an options file, it displays an error message and stops processing. In that case, see your administrator to determine the name of the options file TSM should use.

Start a command line session using one of the following methods:

Note:For Windows NT, in order to back up the entire system, including the system registry, your user ID must belong to the administrator group or domain administrator group which has the following rights:
  • Backup files and directories
  • Restore files and directories
  • Manage auditing and security logs
Users without these rights can only back up files they own.

These are local user rights and must be set using the local User Manager application, and domain accounts may not automatically be enabled for them. Domain accounts may be granted local rights by the local User Manager.

The account must also have the following permissions to the HKEY_LOCAL_MACHINE, HKEY_KEY_USERS, and HKEY_CURRENT_USER registry hives:

The local system account and local Administrator group have these permissions by default. Other accounts/groups (including domain Administrators) must be granted these permissions either explicitly through the registry editor security dialog (regedt32), or implicitly by adding the account/group to the local Administrators group through the local User Manager (recommended).

For more information about using the command line client, see "Starting and Ending a Client Command Session".

For more information about client services, see Tivoli Storage Manager Installing the Clients, SH26-4119.

Using Options on the DSMC Command

You can include options on the dsmc command. For example, your organization might have two machines that back up to TSM under separate node names. To recover a file from one machine (galaxy1) while at the other machine (galaxy2), you will need access to galaxy1. A recommended way to gain access is to issue the set access command.

For example, assume the file to be recovered on galaxy1 is c:\universe\saturn. The owner of galaxy1 enters the following command:

   dsmc set ac archive c:\universe\saturn galaxy2

Once access is granted, you would gain access by entering:

   dsmc retrieve fromnode=galaxy1 c:\universe\saturn

Access to another user's files may also be granted and gained using the GUI.

For more information about set access, see Set Access. For more information about fromnode, see Fromnode.


Starting A Web Client Session

You can use the Web client to perform backup, archive, restore, and retrieve operations from machines or platforms that support at least a Java 1.1.6-capable browser, such as Netscape Navigator 4.06 or higher, or Microsoft Internet Explorer 4.01 or higher. Using the Web client, you can back up and restore your own data, or an administrator can centralize the backup or restore operations of many clients. To use the Web client, specify the URL of the client machine running the Web client in your Web browser. The Web client is only supported on a server that is Version 3 or higher.

Installing and Using the Web Client

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

To use the setup wizard, perform the following steps:

  1. From the GUI, select Utilities>Setup Wizard.
  2. Select the checkbox titled "Help me configure the TSM Web Client."
  3. Follow the instructions on the screen.

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

  1. If you do not have a client password file, specify passwordaccess generate in the dsm.opt options file. For more information on passwordaccess, see Passwordaccess.
  2. To generate the TSM password, start the native backup-archive client by entering:

    dsmc query session
    

    and, when prompted, enter your user id and password. For important information about how passwords operate on the native client and the Web client, see 5.

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

  3. Quit from the native TSM backup-archive client.
  4. Start the client acceptor service
    For Windows 95 and 98: Enter the dsmcad command.
    For Windows NT:
    1. On the task bar, click Start> Settings> Control Panel> Services.
    2. In the Services window select TSM Client Acceptor and click the Start button.
    For Windows 2000:
    1. On the task bar, click Start> Administrative Tools> Computer Management.
    2. Expand the System Tools subtree.
    3. Select Services.
    4. Select TSM Client Acceptor.
    5. Click the right mouse button.
    6. Select Properties.
    7. Click the Start button.

    The Web client agent service starts automatically when needed.

    The only options you can use with the dsmcad command are optfile, httpport, and httpsport.

    All Web client messages are written to the Web client log file, dsmwebcl.log. Error messages are written to the error log file. The dsmwebcl.log file and the error log file are located in the directory specified by the errorlogname option. See Chapter 8, "Setting Common Options" for more information.

    For more information about TSM client services, see Tivoli Storage Manager Installing the Clients, SH26-4119.

  5. To use a Web client with an enterprise management server, ensure that you were assigned an administrative user id with system privilege, policy privilege, client access, or clientowner authority. If your server does not support enterprise management, then use your node name and password when prompted by the Web client.
    Note:Use the revokeremoteaccess option to restrict an administrator with client access privilege from accessing your workstation through the Web client. Administrators with client owner privilege, system privilege, or policy privilege can access the Web client. For more information see Revokeremoteaccess.
  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 hostname 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.

    The Web client workstation can also be accessed through the Web administrative GUI. To use the Web client with secure socket layer (SSL) communications, see Tivoli Storage Manager Installing the Clients, SH26-4119.

For more information about TSM client services, see Tivoli Storage Manager Installing the Clients, SH26-4119.

Considerations for NT and 2000 TSM Client Services

To back up the entire system registry, you must belong to a Windows NT group which has the following rights:

Users without these rights can only back up files they own and cannot back up the system registry or files owned by other users. These are local user rights and must be set using the local User Manager application, and domain accounts may not automatically be enabled for them. Domain accounts may be granted local rights by the local User Manager.

The account must also have the following permissions to the HKEY_LOCAL_MACHINE, HKEY_KEY_USERS, and HKEY_CURRENT_USER registry hives:

The local system account and local administrator group have these permissions by default. Other accounts/groups (including domain Administrators) must be granted these permissions either explicitly through the registry editor security dialog (regedt32), or implicitly by adding the account/group to the local Administrators group through the local User Manager (recommended).


Starting the Client Scheduler Automatically

Note:Install the command-line client if you want to use the client scheduler. This client permits you to request TSM services with commands rather than with the GUI.

You can start the client scheduler automatically when you start your machine. If the administrator has defined schedules for your node, starting the client scheduler permits TSM to automatically back up your machine (or perform other scheduled actions). See Chapter 5, "Automating TSM Tasks" for more information about the client scheduler.


Changing Your Password

Your administrator can require you to use a password to connect to the server. TSM prompts you for the password if one is required. Contact your administrator if you do not know your password.

If you are using passwords, you should change them regularly to restrict access to your data.

To change your password from the GUI:

  1. Select Utilities>Change password.
  2. Enter your current and new passwords, and enter your new password in the Verify password field.
  3. Click Change.

A TSM password can be up to 64 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.


Sorting File Lists

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 "Using Point-in-Time Restore").

To sort a file list, select one of the Sort by items from the View menu bar. Or, click the appropriate column heading in the File List box.

The Show active/inactive files menu option controls whether TSM lists both active and inactive backup versions of files. TSM only lists the active backup versions of files during a session, unless the Show active/inactive files menu option is selected. 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 called inactive. If you delete the file from your workstation, the active version becomes inactive the next time you run an incremental backup.


Displaying Online Help

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


Online Forum

To participate in online user discussions of TSM, subscribe to an Internet Listserv forum. This is not officially supported by TSM, but support people do participate in the discussions, along with other users.

You can subscribe by sending a note to Listserv@vm.marist.edu that contains:

 subscribe adsm-l yourfirstname yourlastname

Posts can then be sent to adsm-l@vm.marist.edu.


Other Sources of Online Help

An anonymous FTP server is available where you can find PTF maintenance and other TSM- related materials. In addition, four other anonymous servers are unofficially maintained by non-IBM volunteers. These servers are:

 ftp.software.ibm.com        (primary - Colorado, IBM)
 ftp.wu-wien.ac.at            (mirror  - Austria)
 ftp.cac.psu.edu              (mirror  - Pennsylvania) 
 sunsite.unc.edu/pub/packages (mirror  - North Carolina)

If you have the required username and password, you can get maintenance information from the TSM support page at http://www.tivoli.com/support/storage_mgr/tivolimain.html.


Contacting Customer Support

For support for this or any Tivoli product, you can contact Tivoli Customer Support in one of the following ways:

Customers in the United States can also call 1-800-TIVOLI8 (1-800-848-6548). For product numbers 5697-TS9, 5697-DRS or 5697-DPM call 1-800-237-5511.

International customers should consult the Web site for customer support telephone numbers.

You can also review the Customer Support Handbook, which is available on our Web site at http://www.tivoli.com/support/handbook/.

When you contact Tivoli Customer Support, be prepared to provide identification information for your company so that support personnel can readily assist you. Company identification information may also be needed to access various online services available on the Web site.

The support Web site offers extensive information, including a guide to support services (the Customer Support Handbook); frequently asked questions (FAQs); and documentation for all Tivoli products, including Release Notes, Redbooks, and Whitepapers. The documentation for some product releases is available in both PDF and HTML formats. Translated documents are also available for some product releases.

You can order documentation by e-mail at swdist@tivoli.com. Please provide the publication number, part number, or order number of the desired document. Alternatively, you can provide the document title, version number, and date of publication.

We are very interested in hearing about your experience with Tivoli products and documentation. We also welcome your suggestions for improvements. If you have comments or suggestions about our documentation, please contact us in one of the following ways:


Ending a Session

You can end a TSM session in any one of the following ways:


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