Quick Start


Getting Started

This section describes the following tasks:



Figure AB0CT107 not displayed.

You can perform most of the tasks mentioned in this section from either an administrative command line or web interface. See Appendix B, Using Tivoli Storage Manager 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 MODIFY command as in the example shown here:


Figure AB0CT217 not displayed.

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

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.


Figure AB0CT217 not displayed.

f server,register admin admin admin



Figure AB0CT217 not displayed.

 f server,grant authority admin classes=system

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

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:


Figure AB0CT124 not displayed.

 update admin admin tucson



Figure AB0CT338 not displayed.

  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

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 Tivoli Storage Manager Installing the Clients.

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 Tivoli Storage Manager Installing the Clients.

When you start the administrative client, you must enter an administrator name and password. The following administrator was defined earlier and should be used:

Name
admin

Password
admin

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 6 is an example of a modified TSO administrative client logon procedure:

Figure 6. 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 7 shows the ANSCLIST CLIST procedure.

Figure 7. 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 communciation 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 for MVS

+--------------------------------------------------------------------------------+
|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 1 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 1.1 support.

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:


Figure AB0CT124 not displayed.

 quit



Figure AB0CT338 not displayed.

From Options, select Log Off.

Stopping the Server

You can halt 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.


Figure AB0CT107 not displayed.

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:


Figure AB0CT124 not displayed.

 halt



Figure AB0CT338 not displayed.

  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

When you install Tivoli Storage Manager, each server license you order must be specified with a LICENSE option in the server options file. The base license includes an unlimited number of administrative clients and one backup-archive client. Additional licensed options are:

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

You can register licenses by specifying them directly in the server options file. The REGISTER LICENSE command adds a license statement to the end of the server options file if the options file is specified in the OPT DD statement of the server startup JCL with a DISP=MOD parameter. For example, use the following command to register space management for use on the MVS server:


Figure AB0CT124 not displayed.

register license spacemgt

To license features on the server using the web interface:


Figure AB0CT338 not displayed.

  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:


Figure AB0CT124 not displayed.

 register node mercedes montana



Figure AB0CT338 not displayed.

  1. Select Clients.

  2. Select Client Nodes.

  3. From Operations, select Register a New Node.

  4. Enter the node information and Finish.



Figure AB0CT108 not displayed.

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 IconFind 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 IconFind 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 ]