Tivoli Header

Quick Start


Getting Started

This section describes the following tasks:



Attention

You can perform most of the tasks mentioned in this section from either an administrative command line or web interface. See Appendix A, Using Administrative Interfaces for details about each.

All of the administrative commands in this book are shown as issued from an administrative command line. The commands can also be issued with the MVS(TM) MODIFY command as in the example shown here:


MVS modify command

+--------------------------------------------------------------------------------+
|f server,command                                                                |
+--------------------------------------------------------------------------------+

server
The name of the JOB under which the TSM server is running. For example, TIVSM is the name of the job started in Figure 7.

command
A TSM command.

Registering an Administrator

You must register an administrator before you can perform the tasks that follow in this section. Using the MVS MODIFY command, register the administrator ADMIN with the password ADMIN. Then give ADMIN the highest authority level, SYSTEM. For details about the other authority levels, see the TSM Administrator's Reference.


MVS modify command

+--------------------------------------------------------------------------------+
|f server,register admin admin admin                                             |
|f server,grant authority admin classes=system                                   |
+--------------------------------------------------------------------------------+

server
The name of the JOB under which the TSM server is running. For example, TIVSM is the name of the job started in Figure 7.

Changing the Administrative Client Password

If you wish, you can change the password of administrator ADMIN at this point. To change the password to TUCSON, for example, do the following:


Admin Command Line

+--------------------------------------------------------------------------------+
|update admin admin tucson                                                       |
+--------------------------------------------------------------------------------+
OR
Web Icon
  1. Select Administrators.
  2. Select the desired administrator name.
  3. From Operations, select Update an Administrator.
  4. Enter the administrator information and Finish.

Refer to TSM Administrator's Reference for the command syntax and the minimum number of characters that can be specified.

Starting an Administrative Client

The TSM server must be running before any client can connect.

Notes:

  1. The TSM server must be running before any client can connect.

  2. The communications method that an administrative client uses to connect to the TSM server must be defined in the server options file. See Specifying Server Communication Options.

  3. The client options file must be prepared with the appropriate communications method and related options. Refer to Backup-Archive Installation and User's Guide.

This section describes how to start the TSO administrative client and the web interface. Follow the instructions under Starting the TSO Administrative Client to start the TSO client and follow the instructions under Starting the Administrative Web Interface to start the web interface.

For information on starting all other clients, refer to Backup-Archive Installation and User's Guide.

When you start the administrative client, you must enter an administrator name and password. The administrator ADMIN with a password of ADMIN was defined earlier and should be used.

Start an administrative client session in command line mode by entering this command on your workstation:

+--------------------------------------------------------------------------------+
| dsmadmc -id=admin -password=admin                                              |
+--------------------------------------------------------------------------------+

Starting the TSO Administrative Client

The ANSPROC member of the ASAMPLIB dataset contains a sample TSO logon procedure for the TSO administrative client. Create or modify this logon procedure and make it available to the TSO user ID that will be used to administer Tivoli Storage Manager. Figure 8 is an example of a modified logon procedure.

Figure 8. Example of Modified TSO Administrative Client Logon Procedure


//DSMADMC    EXEC PGM=IKJEFT01,TIME=1440,REGION=32M,DUNAMNBR=200
//           PARM='SPFPROF'
//DSCOPT     DD DSN=TIVSM.TSOADMIN.OPTIONS,DISP=SHR
//DSCLANG    DD DSN=TIVSM.SANSMSG(ANSMENU),DISP=SHR
//SYSUADS    DD DSN=SYS1.UADS,DISP=SHR
//SYSHELP    DD DSN=SYS1.HELP,DISP=SHR
//           DD  DSN=SYS1.ISRCLIB,DISP=SHR
//           DD  DSN=SYS1.HELP1,DISP=SHR
//SYSPROC    DD  DSN=SYS1.HRFCLST,DISP=SHR
//           DD  DSN=SYS1.SBLSCLI0,DISP=SHR
//           DD  DSN=SYS1.ISRCLLIB,DISP=SHR
   ...
//SYSPRINT   DD TERM=TS
//SYSIN      DD TERM=TS 

As an alternative to using the ANSPROC member to start the TSO administrative client, you can use the ANSCLIST CLIST procedure from the ASAMPLIB dataset by modifying it and adding it to your CLIST library. Figure 9 shows the ANSCLIST CLIST procedure.

Figure 9. Example of ANSCLIST Procedure from ASAMPLIB


PROC 0
PROFILE PROMPT
CONTROL NOLIST NOCONLIST MSG FLUSH PROMPT
/* it is important to include the parameter "PROMPT"      */
/* in the PROFILE and CONTROL statements to allow                  */
/* DSMADMC (TSO Admin Client module) to prompt for                 */
/* input (e.g. PASSWORD).                                          */
ALLOC F(DSCOPT) DA('TIVSM.TSOADMIN.OPTIONS') SHR REUSE
ALLOC F(DSCLANG) DA('TIVSM.SANSMSG(ANSMENU)') SHR REUSE
CALL 'SYS1.LINKLIB(DSMADMC)'
FREE F(DSCOPT DSCLANG )

TSO Client Option File Setup

The ANSSMPOP member of the ASAMPLIB dataset contains a sample client options file. Allocate a sequential data set and copy ANSSMPOP from the ASAMPLIB dataset to the allocated data set. The name of the data set must be specified in the DSCOPT DD statement. The options shown here are the only options that you are required to update. For a complete list of client options, refer to Installing the Clients.

The TSO administrative client can communicate with a TSM server in one of four communication methods:

The desired communication method must be specified in the client options file prior to starting the TSO administrative client. Refer to Administrator's Reference for a complete description of the options and the parameters that you can specify.

IBM TCP/IP

+--------------------------------------------------------------------------------+
|COMMMETHOD              TCPIP                                                   |
|   TCPSERVERADDRESS     tcp_address                                             |
|   TCPPORT              port#                                                   |
+--------------------------------------------------------------------------------+

TCPaccess TCP/IP

+--------------------------------------------------------------------------------+
|COMMMETHOD              TCPIP                                                   |
|   ICSSNAME             ACSS                                                    |
|   TCPSERVERADDRESS     tcp_address                                             |
|   TCPPORT              port#                                                   |
+--------------------------------------------------------------------------------+

IBM APPC/MVS (SNA LU6.2)

+--------------------------------------------------------------------------------+
|COMMMETHOD              SNALU6.2                                                |
|   SYMBOLICDESTINATION  applid                                                  |
+--------------------------------------------------------------------------------+

IBM IUCV

+--------------------------------------------------------------------------------+
|COMMMETHOD              IUCV                                                    |
|   SERVERNAME           job_name                                                |
+--------------------------------------------------------------------------------+

If you used the ANSPROC member of the ASAMPLIB dataset for the TSO administrative client, enter the following command at the TSO prompt:

+--------------------------------------------------------------------------------+
| dsmadmc                                                                        |
+--------------------------------------------------------------------------------+

If you used the CLIST procedure and you named it tsmadm, enter the following at the TSO prompt:

+--------------------------------------------------------------------------------+
|tsmadm                                                                          |
+--------------------------------------------------------------------------------+

Starting the Administrative Web Interface

Before starting the administrative web interface, ensure that you have submitted the ANRIDL job from the ASAMPLIB dataset on the server machine. See Figure 3 for an example of the ANRIDL job. This job loads the web interface definition file.

Note:
If you will be using the administrative web interface, your browser must have Java(TM) 1.1.6 support. See System Requirements.

To start the web interface, enter the URL on a web browser on your client workstation:

+--------------------------------------------------------------------------------+
|http://server_name:1580                                                         |
+--------------------------------------------------------------------------------+

server_name
Is the IP address (name, dotted name, or dotted number - for example, server1 or 9.115.2.15) of the Tivoli Storage Manager server you want to contact.

1580
Is the value specified in either the server option HTTPTCPPort or HTTPICSPort. The default is 1580.

To end an administrative client session do one of the following:


Admin Command Line

+--------------------------------------------------------------------------------+
|quit                                                                            |
+--------------------------------------------------------------------------------+
OR
Web Interface

From Options, select Log Off

Stopping the Server

You can stop the server without warning if an unexpected problem occurs. To avoid severely affecting administrative and client node activity, stop the server only after current administrative and client node sessions have completed or been canceled.


Attention

For most tasks in this book, your server must be running. This procedure is explained here only if an unusual situation requires that you stop the server.

To stop the server, do one of the following:


Admin Command Line

+--------------------------------------------------------------------------------+
halt


|                                                                                |
+--------------------------------------------------------------------------------+
OR
Web Interface
  1. Select Server.
  2. Select Server Status.
  3. Select Halt Server and then Yes.

This shuts down the server immediately and cancels all client sessions, even if activity has not completed.

Registering Tivoli Storage Manager Licenses

The base Tivoli Storage Manager license includes an unlimited number of administrative clients and one backup-archive client. When you install Tivoli Storage Manager, each server license you order must be specified with a LICENSE option in the server options file. For example, to license Tivoli Disaster Recovery Manager and 25 backup-archive clients, adding the following options to the server options file:

license drm
license managedsyslan number=25
Note:
TSM requires one Managed System for LAN license for each Tivoli Data Protection client.

The licensed option keywords are:

SPACEMGMT
Tivoli Space Manager (HSM clients)

DRM
Tivoli Disaster Recovery Manager

MANAGEDSYSLAN
To license Managed System for LAN. TSM requires this license for each managed system (client) that moves data to and from storage over a LAN.

ORACLEAPPL
To license each managed system that uses Tivoli Data Protection for Oracle.

MSSQLAPPL
To license each managed system that uses Tivoli Data Protection for MS SQL Server.

MSEXCHANGEAPPL
To license each managed system that uses Tivoli Data Protection for MS Exchange.

LOTUSNOTESAPPL
To license each managed system that uses Tivoli Data Protection for Lotus(R) Notes(TM).

DOMINOAPPL
To license each managed system that uses Tivoli Data Protection for Lotus Domino(TM).

INFORMIXAPPL
To license each managed system that uses Tivoli Data Protection for Informix.

R3APPL
To license each managed system that uses Tivoli Data Protection for R/3.

ESSAPPL
To license each managed system that uses Tivoli Data Protection for ESS.

ESSR3APPL
To license each managed system that uses Tivoli Data Protection for ESS R/3.

EMCSYMMETRIXR3APPL
To license each managed system that uses Tivoli Data Protection for EMC Symmetrix R/3.

AFSDFS
To license each managed system that uses AFS/DFS Support. TSM also requires a Managed System for LAN license.

See TSM Administrator's Guide and TSM Administrator's Reference for additional license information.

Also, the REGISTER LICENSE command can be used to register licenses dynamically. Besides activating a license, a LICENSE statement will be added to the server options file. To allow the server to update the server options file dynamically:

For example, to register the license for space management enter the following command:


Admin Command Line

+--------------------------------------------------------------------------------+
|register license spacemgt                                                       |
+--------------------------------------------------------------------------------+
OR
Web Interface
  1. Select Server.
  2. Select License Information.
  3. From Operations, select Register License.
  4. Enter the required information and Finish.

Registering Backup-Archive Client Nodes

You are now ready to register backup-archive clients. For example, to register a node named MERCEDES with the password MONTANA, do the following:


Admin Command Line

+--------------------------------------------------------------------------------+
|register node mercedes montana                                                  |
+--------------------------------------------------------------------------------+
OR
Web Interface
  1. Select Clients.
  2. Select Client Nodes.
  3. From Operations, select Register a New Node.
  4. Enter the node information and Finish.


A Closer Look Symbol

Two commands, DEFINE CLOPTSET and DEFINE CLIENTOPT, let you define client options affecting backup, archive, restore, and retrieval operations. See TSM Administrator's Guide and Installing the Clients for details.

Verifying Your Server Installation

This section describes how to verify the initial configuration by backing up and restoring client data. The section also describes how to archive and retrieve client data.

Note:
The example shown in this section is for a Windows 32-bit backup-archive client.

You can use the ANRSIVP member in the ASAMPLIB dataset as a checklist to verify that you have completed all the steps necessary to successfully install the server. Perform this step from an MVS operator or system console. The following are queries contained in the ANRSIVP member and the expected results if you have successfully completed all the required installation steps.

Q OPTION
Displays information about your server options.

Q STATUS
Displays information about your server parameters.

Q STGPOOL
Displays information about your backup and archive storage pools.

Q VOLUME
Displays information about your storage pool volumes.

Q DB
Displays allocation information about the TSM database.

Q DBV
Displays information about database volumes.

Q LICENSE
Displays licensing information.

Q LOG
Displays allocation information about the recovery log.

Q LOGVOLUME
Displays information about the recovery log volumes.

Q DOMAIN
Displays information about policy domains.

Q MGMTCLASS
Displays information about management classes.

Q COPYGROUP
Displays information about backup and archive copy groups.

Before You Perform a Backup

Before you perform a backup, you will need to do the following:

  1. Ensure that you have registered your clients and have set up the configuration file.
  2. Install the Tivoli Storage Manager client software on each remote workstation.
  3. Configure the communications options in the client options file to connect with the server.

Backing Up a Client

Using an Include-Exclude Options File to Control Processing

You may not want to back up certain files. These files may be core files, local caches of network file systems, operating system or application files that could be easily recovered by installing the program again. This can also apply to any other files that you could easily rebuild.

You can use the options in the include-exclude options file to exclude certain files from backup processing. The options apply for both incremental and selective backups. Tivoli Storage Manager backs up any file that is not explicitly excluded from backup. You can also include specific files that are in a directory you have excluded. For more information on creating an include-exclude options file, see the appropriate Using the Backup-Archive Clients User's Guide.

Do the following to backup a client:

  1. To start the backup-archive client GUI, click on the client icon:



    Backup-archive GUI

    Enter the registered node name and password.

    Use the following steps to backup several files:

  2. Click Backup from the TSM window. The Backup window appears.
  3. Expand the directory tree. Select the folder icons to display the files in the directory. Choose the selection boxes next to the files or directories you want to back up.
  4. Choose the backup type:
  5. Click Backup. The Backup Status window displays the backup processing status.

Restoring Tivoli Storage Manager Client Files

This section explains the procedure used to perform a simple restore of client files. For details and advanced procedures, see the appropriate Using the Backup-Archive Clients User's Guide.

Restoring Files or Directories

An administrator can determine how many backup versions are kept for each file. Keeping multiple versions of files allows a user to restore an older version if their most recent backup is damaged.

Tivoli Storage Manager refers to the most recent backup version as the active version. The most recent backup version is considered an inactive version if the file was deleted or excluded at the client and an incremental backup was run. Any other backup version is considered an inactive version. If you try to restore both an active and inactive version of a file at the same time, only the active version is restored.

Every time Tivoli Storage Manager backs up your files, it marks the new backup version as the active backup. It also changes the previous active backup to an inactive backup. When the maximum number of inactive versions is reached, the oldest inactive version is deleted.

Restoring files or subdirectories

To restore backup versions of individual files or subdirectories:

  1. Click Restore from the TSM window. The Restore window opens.
  2. Expand the directory tree. Select the selection boxes next to the files or directories you want to restore.
  3. Click Restore. The Restore Destination window opens.
  4. Select the destination in the Restore Destination window.
  5. Click Restore. The Restore Status window displays the restore processing status.

Archiving and Retrieving Files

This section contains procedures to help you perform a simple archive and retrieval of client files. For details and advanced procedures, see the appropriate Using the Backup-Archive Clients manual.

Note:
We recommend that you archive a small file or directory.

To archive files, select the files by name or description, or select them from a directory tree in the TSM main window.

Note:
A user can assign an archive description for all archived files. The description can be up to 255 characters. If you do not enter a description, TSM assigns a default archive description. When you select the archive function from the backup-archive GUI, TSM displays a list of all previously used archive descriptions. You can use these displayed archive descriptions on future archives.

To Archive Files by Name
Note:
You can archive a file or a group of files with similar names. Specify the file name or path in the Find Files window. Assign a unique description for each archive package.

To archive a file:

  1. Click the Archive button in the TSM main window. The Archive by Tree window opens.
  2. Expand the directory tree.
  3. Click the plus sign (+) next to a directory or drive.
  4. Highlight the drive or directory that you want.
  5. Click the
    Task Complete Icon
    Find button on the toolbar.
  6. Enter the search criteria in the Find Files window.
  7. Click Search. The Matching Files window opens.
  8. Click the selection boxes next to the files you want to archive.
  9. Click Archive to archive the files. The Archive Status window displays the status progress of the archive.

To Archive Files Using a Directory Tree
Note:
You can archive specific files or entire directories from a directory tree. You can also assign a unique archive description for each group of files you archive.

To archive your files:

  1. Click the Archive button in the TSM main window. The Archive by Tree window opens.
  2. Expand the directory tree.
  3. Click the plus sign (+) next to a directory or drive.
  4. Click the selection boxes next to the files or directories that you want to archive.
  5. Click Archive. The Archive Status window opens. The Archive Status window displays the status progress of the archive.

Retrieving Archive Copies

You retrieve a file when you want to return an archive copy of a file or a directory from the TSM server to your workstation. To retrieve archive copies:

  1. Click the Retrieve button on the TSM main window. The Retrieve by Tree window opens.
  2. Expand the directory tree.
  3. Click the plus (+) sign next to an object that you want to expand. The objects on the tree are grouped by archive package description.
  4. Highlight the object in the tree that you want.
  5. Click the
    Task Complete Icon
    Find button on the tool bar. The Find Files window opens.
  6. Enter your search information in the Find Files window.
  7. Click Search. The Matching Files window opens.
  8. Click on the selection boxes next to the files you want to retrieve.
  9. Click Retrieve. The Retrieve Destination window opens.
  10. Enter the information in the Retrieve Destination window.
  11. Click Retrieve. The Retrieve Status window displays the processing results.


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