Tivoli Storage Manager for NetWare Using the Backup-Archive Client


Chapter 2. Getting Started

This chapter includes instructions for the following tasks:

Task Page
"Starting a Session" "Starting a Session"
"Using Batch Mode" "Using Batch Mode"
"Using Interactive Mode" "Using Interactive Mode"
"Starting A Web Client Session" "Starting A Web Client Session"
"Displaying Online Help" "Displaying Online Help"
"Ending a Session" "Ending a Session"

Starting TSM the First Time

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 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:

Using Open Registration

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.


Starting a Session

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.

Using Batch 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 display 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.

Using Interactive Mode

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:

load dsmc
load dsmc loop

When you press Enter, this prompt displays 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 display 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. However, you must enter certain options with the command for which you want the options to take effect. To identify which options must be entered in this way, see Chapter 9, "Using Options With Commands".

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.


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 to install and configure it.

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 and nwpwfile yes in the dsm.opt options file. For more information on passwordaccess, see Passwordaccess.
  2. Start the native backup-archive client (dsmc.nlm) by entering:

    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.

  3. Enter
    load dsmc query tsa
    

    and, when prompted, enter your NetWare user id and password.

  4. If you have NDS installed, enter
    load dsmc query tsa nds
    

    and, when prompted, enter your NetWare user id and password.

  5. Quit from the native TSM NetWare backup-archive client.
  6. Start the client acceptor background process by entering: load dsmcad from the NetWare console. The Web client agent service starts automatically when needed.

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

    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.

  7. 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.
  8. 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..


Accessing the NetWare Server

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.


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 "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 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.


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

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.


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