This chapter includes instructions for the following
tasks:
The following information assumes that you have installed TSM. If you have not installed TSM, see Installing the Clients, SH26-4102, 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.
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:
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.
Start a GUI session using one of the following methods:
set path=c:\tivoli\tsm\client\ba;%PATH% set beginlibpath=c:tivoli\tsm\clientba set dsm_config=c:\tivoli\tsm\client\ba\dsm.opt set dsm_dir=c:\tivoli\tsm\client\ba dsm.exe
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.
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.
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:
set path=c:\tivoli\tsm\client\ba;%path% set beginlibpath=c:\tivoli\tsm\client\ba set dsm_config=c:\tivoli\tsm\client\ba\dsm.opt set dsm_dir=c:\tivoli\tsm\client\ba dsmc.exe
You can include options with the start dsm command, or modify the settings for the TSM icon. For example, modify the format used to display dates, times, and numbers. Or, include your password so TSM does not prompt for it. However, if you include the password option, your password will only display in your icon settings.
For example, you might have two machines that back up to TSM under separate node names. If you wanted to recover a file from one machine (brant1) while at the other machine (derek2), you could start TSM using the nodename option specifying brant1:
start dsm -nodename=brant1
Be careful if you use TSM in this way. Do not attempt to do an incremental backup from the derek2 machine while connected to TSM as brant1. If the drive labels are the same on the brant1 and derek2 machines, the incremental backup will expire any files that are not on the derek2 machine, even if they still exist on brant1. You could lose some valuable backup generations.
Expiring a file means that old backup versions of the file are removed from storage. TSM does not remove files from your workstation.
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.
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:
To install and configure the Web client from the command line, perform the following steps:
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.
dsmcad
The Web client agent service starts automatically when needed.
The only options you can use with the dsmcad command are optfile, httpport, and httpsport.
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. |
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 TSM Installing the Clients, SH26-4102.
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.
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.
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:
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.
The following are additional password information sources:
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 "Running Point-in-Time Restores").
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.
You can display online help in any one of the following ways:
To receive technical support for TSM:
http://www.tivoli.com/storage
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.
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.support.tivoli.com.
You can end a TSM session in any one of the following ways: