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 NetWare server 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 NetWare server as a client node with the server.
The first time you start a session using the load dsmc or load dsmc loop command, TSM prompts you for information necessary to register your NetWare server with the server identified in your options file. You need to supply your node name, a password, and contact information.
To register your NetWare server with additional servers, edit the dsm.opt file and change the communication options. Then, when you start a session, your NetWare server is registered.
When you use open registration:
If necessary, your administrator can change these defaults later.
During installation of the NetWare backup-archive client, you updated your autoexec.ncf file to include the TSM directory in your path. To start TSM from this directory, begin a TSM command with load dsmc. If you did not update autoexec.ncf or you want to start TSM from a different directory, you must include the directory in the command line. For example:
load sys:adsm/dsmc
Your administrator can require you to use a password to connect to the server. TSM prompts you for the password if one is required. If you do not know your password, contact your administrator.
You can start a client command session from a NetWare server in either batch or interactive mode.
Use batch mode when you want to enter a single client command. You must precede each command with load dsmc.
If a TSM password is required at your NetWare server, TSM prompts you for your password each time you enter a command. For example, to issue the incremental command, enter the following at the NetWare colon prompt:
load dsmc incremental
If your client node name is nwserver, TSM responds:
Please enter password for node "nwserver":
When you type in your password and press Enter, the password does not appear on your screen.
You can also enter your password with the command. For example, to issue the incremental command with your password in batch mode, enter the following:
load dsmc incremental -password=secret
where secret is your password.
If TSM is unable to authenticate your ID and password, you are returned to the NetWare colon prompt without being able to use TSM services. If TSM authenticates your ID and password, it then asks you for your NetWare user ID:
Please enter NetWare user for "nwserver":
Next, TSM requests your NetWare password.
Please enter the password on "nwserver" for NetWare user "username":
After your NetWare ID and password are accepted, TSM processes your command, displays any messages it generates, and returns to the NetWare colon prompt.
Use interactive mode when you want to issue a series of commands. Because TSM needs to establish the connection to the server only once for interactive mode, TSM can process a series of commands more quickly in interactive mode than it can in batch mode.
To start a client command session in interactive mode, enter the load dsmc or load dsmc loop command:
When you press Enter, this prompt appears on your screen:
dsmc>
When you are in interactive mode, do not precede commands with load dsmc. For example, instead of typing load dsmc archive to archive a file, type only archive.
The first time you enter a command in an interactive session, TSM prompts you for your password, if a password is required. For example, if you enter the following as the first command in your session:
incremental
TSM responds:
Please enter password for node "nwserver"
When you type your password and press Enter, the password does not appear on your screen.
You can also enter your password with the loop command:
load dsmc loop -password=secret
If TSM is unable to authenticate your ID and password, you cannot use TSM services. If TSM authenticates your ID and password, it then asks you for your NetWare user ID:
Please enter NetWare user for "nwserver":
Next, you are prompted for your NetWare password.
Please enter the password on "nwserver" for NetWare user "username":After your NetWare ID and password are accepted, TSM processes your command, displays any messages it generates, and returns to the dsmc> prompt.
If you have specified nwpwfile yes in your client options file, TSM saves your NetWare ID and password in a file in your installation directory with a .pwd extension. When you enter additional commands within the same interactive session, TSM gets your NetWare ID and password from this file instead of prompting you for them. For more information on the nwpwfile option, see Loop.
After you start an interactive session, most options you enter with additional commands remain in effect throughout the session unless you reenter them with a different setting. The following options, however, are exceptions. You must enter them with each command for which you want the options to take effect:
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.
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.
You can use the Web client to perform backup, archive, restore, and retrieve operations from machines or platforms that support 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.
To install and configure the Web client, perform the following steps:
load dsmc query session
and, when prompted, enter your password to access the server. For important information about how passwords operate on the native client and the Web client, see 7.
load dsmc query tsa
and, when prompted, enter your NetWare user id and password.
load dsmc query tsa nds
and, when prompted, enter your NetWare user id and password.
The only options you can use with the dsmcad command are optfile and httpport.
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 about the httpport option.
The Web client workstation can also be accessed through the Web administrative GUI..
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.
TSM requires two connections to the NetWare server for normal operations. These two connections do not count against the licensed user connections. For example, if you have a five-user NetWare server, TSM uses connection numbers 6 and 7.
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 "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.
You can display online help by entering the Help command. A menu of topics is displayed for which help is available. See Help for more information about the Help command.
To receive technical support for TSM:
http://www.tivoli.com/tsm
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, and four other anonymous servers that are unofficially maintained by non-IBM volunteers. These servers are:
ftp.software.ibm.com (primary - California, 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. Select Fix/Readmes.
In batch mode, each load dsmc command you enter is a complete session. TSM ends the session when it finishes processing the command.
To end an interactive session, enter quit at the dsmc> prompt.