![]() |
![]() |
This section describes the following tasks:
![]() |
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:
+--------------------------------------------------------------------------------+ |f server,command | +--------------------------------------------------------------------------------+
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.
+--------------------------------------------------------------------------------+ |f server,register admin admin admin | |f server,grant authority admin classes=system | +--------------------------------------------------------------------------------+
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:
+--------------------------------------------------------------------------------+ |update admin admin tucson | +--------------------------------------------------------------------------------+OR
Refer to TSM Administrator's Reference for the command syntax and the minimum number of characters that can be specified.
The TSM server must be running before any client can connect.
Notes:
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 | +--------------------------------------------------------------------------------+
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 | +--------------------------------------------------------------------------------+
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.
To start the web interface, enter the URL on a web browser on your client workstation:
+--------------------------------------------------------------------------------+ |http://server_name:1580 | +--------------------------------------------------------------------------------+
To end an administrative client session do one of the following:
+--------------------------------------------------------------------------------+ |quit | +--------------------------------------------------------------------------------+OR
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.
![]() | 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:
+--------------------------------------------------------------------------------+ halt | | +--------------------------------------------------------------------------------+OR
This shuts down the server immediately and cancels all client sessions, even if activity has not completed.
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
The licensed option keywords are:
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:
+--------------------------------------------------------------------------------+ |register license spacemgt | +--------------------------------------------------------------------------------+OR
You are now ready to register backup-archive clients. For example, to register a node named MERCEDES with the password MONTANA, do the following:
+--------------------------------------------------------------------------------+ |register node mercedes montana | +--------------------------------------------------------------------------------+OR
![]() | 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. |
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.
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.
Before you perform a backup, you will need to do the following:
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:
Enter the registered node name and password.
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.
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.
Click Display active/inactive files from the View menu on the TSM window.
Click Display active files only from the View menu on the TSM window.
To restore backup versions of individual files or subdirectories:
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.
To archive files, select the files by name or description, or select them from a directory tree in the TSM main window.
To archive a file:
To archive your files:
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: