Tivoli Storage Manager Quick Reference for the Backup-Archive Clients


UNIX Backup-Archive Clients


Starting a TSM GUI Session

You can start a TSM GUI session, do the following:

Performing a GUI Backup

To run a GUI backup, perform the following steps:

  1. Click on Backup files and directories from the TSM window.
  2. Expand the directory tree. Select the object that you want to back up. To search or filter files, click the Search icon from the tool bar.
  3. Select the type of backup from the pull-down menu:
  4. To modify specific backup options click the Backup Options button located to the right of the Estimate button. The options you select are effective during the current TSM session only.
  5. Click on Backup. The Task List window displays backup processing status.

Restoring Backup Versions

To run a GUI restore, perform the following steps:

  1. Click on Restore files and directories to your system from the TSM window.
  2. Expand the directory tree. Select the object that you want to restore. To search or filter files, click the Search icon from the tool bar.

    To restore a backup set:

    1. Expand the Backup Sets directory tree object.
    2. To restore a backup set from a local device, expand the Local object and specify the local device.
    3. To restore a backup set from the server, expand the Server object and select the backup set name.
  3. To modify specific restore options click the Restore Options button located to the right of the Estimate button. The options you select are effective during the current TSM session only.
  4. Click on Restore. Enter the information in the Restore Destination window.
  5. Click on Restore. The Task List window displays restore processing status.

Performing a GUI Archive

To archive directory or drive files you can use search and filter criteria to locate the files that match that criteria. To search or filter files during an archive operation, perform the following steps:

  1. Click on Archive files and directories into long term storage from the TSM window. The Archive window displays.
  2. Expand the directory tree. Select the object that you want to archive. To search or filter files, click the Search icon from the tool bar.
  3. In the Description field:
  4. To modify specific archive options click the Archive Options button located to the right of the Estimate button. The options you select are effective during the current TSM session only.
  5. Click on Archive. The Task List window displays the archive processing status.

Retrieving Archives

Retrieve a file when you want to return an archive copy from the TSM server to your workstation. To retrieve an archived file:

  1. Click on Retrieve from the TSM window. The Retrieve window displays.
  2. Expand the directory tree. Select the directory or files you want to retrieve. To search or filter files, click the Search icon from the tool bar.
  3. To modify specific retrieve options, click the Retrieve Options button located to the right of the Estimate button. The options you select are effective during the current TSM session only.
  4. Click the Retrieve button. The Retrieve Destination window displays. Enter the appropriate information.
  5. Click on Retrieve. The Task List window displays the retrieve processing status.

Displaying GUI Online Help

To display GUI online help, do one of the following:

Ending a GUI Session

To end a GUI session, do one of the following:

Starting the TSM Scheduler

To start the TSM Scheduler, do one of the following:

To display information about scheduled work for your client node, enter:

   dsmc query schedule

To display information about completed work for your client node: Check the dsmsched.log file in the current directory.

To stop the scheduler:

To stop the scheduler:


Starting a TSM Command Line Session

To start a command line session, do the following:

Performing a Command Line Backup

Restoring Backup Versions

To run a command line restore:

Note:You can use wildcard characters to restore groups of files, or entire directories.

Performing a Command Line Archive

Use the archive command to archive a single file, a group of files, or all files in a directory and its subdirectories. If you want to archive all the files in a directory and its subdirectories, use the subdir=yes option. Use the deletefiles option if you want TSM to delete the files from your local workstation after they are archived and committed to storage.

For example, to archive the files in the /home/jones/proj directory and its subdirectories, enter:

   dsmc archive /home/jones/proj/ -subdir=yes -deletefiles

You can use more than one file specification with the archive command. For example, to archive the /home/jones/h1.doc and /home/jones/test.doc files, enter:

   dsmc archive /home/jones/h1.doc /home/jones/test.doc

Use the description option to assign a description to the archive, as follows:

   dsmc archive /home/jones/h1.doc -description="Chapter 1, first
   version"

Retrieving Archives

You can use the retrieve command to retrieve files or directories. Enter the file name you want to retrieve and its destination. If you do not indicate a destination, the files are retrieved to their original location. For example, to retrieve the /home/jones/h1.doc file to its original directory; enter:

   dsmc retrieve /home/jones/h1.doc

To retrieve this file under a new name, enter:

   dsmc retrieve /home/jones/h1.doc /home/jones/h2.doc

Displaying Command Line Help

To display command line help, enter the following command:

   dsmc help

Using the Web Client

You can use the Web client to perform backup, archive, restore, and retrieve operations from any machine, or platform that supports a Java 1.1.6-capable browser, such as Netscape Navigator 4.06 or higher, and Microsoft Internet Explorer 4.01 or higher. Using the Web client, you can back up and restore your own data, or a TSM administrator can centralize the backup or restore operations of many TSM clients. To use it, simply point your Web browser at any TSM client machine that is running the Web client. The Web client is only supported on a server that is Version 3 or higher.

All backup and restore procedures in this chapter are also supported on the Web client. The following functions are not supported by the Web client:

To use the Web client, perform the following steps

  1. If you do not already have password files generated for TSM clients, specify passwordaccess generate in the dsm.sys options file.
  2. To create the TSM password file, start the native backup-archive client by entering:

    dsmc query session
    

    and, when prompted, enter your user ID and password.

  3. Quit from the native TSM backup-archive client.
  4. Start the TSM Client Acceptor daemon by entering the dsmcad command. The TSM Web client agent service automatically starts when needed.

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

    All the Web client messages are written to the Web client log file, dsmwebcl.log. Error messages are also written to the TSM error log file. The dsmwebcl.log file and the TSM error log file are located in the same directory specified by the errorlogname option.

  5. 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. To determine whether your server supports enterprise management, contact your server administrator.
    Note:Use the revokeremoteaccess option to restrict an administrator with client access privilege from accessing your workstation through the Web client. Administrators with clientowner privilege, system privilege, or policy privilege can access the Web client.
  6. You can access the TSM Web client using any browser that is Java1.1.6-capable by entering the following URL:
    http://your_machine_name:1581
    

    where your_machine_name is the hostname of the machine running the TSM Web client.

    Port 1581 is the default port number. The administrator can set a different port number using the httpport option.

    The Web client workstation can also be accessed through the TSM system administrative GUI.

If you want to use the Web client with secure socket layer (SSL) communications, which is only supported on the AIX clients, see the Appendix in Tivoli Storage Manager Installing the Clients, order number SH26-4102, for more information.


Summary of Commands


DSMC Archive [options] filespec|"filespec"
DSMC Backup Image [options] filespec|"filespec"
DSMC CANcel Restore [options]
DSMC Delete ACcess [options]
DSMC Delete ARchive [options] filespec|"filespec"
DSMC Delete Filespace [options]
DSMC Help
DSMC Incremental [options] [filespec|"filespec"]
DSMC LOOP [options]
DSMC MAcro macroname
DSMC Query ACcess [options]
DSMC Query ARchive [options] filespec|"filespec"
DSMC Query Backup [options] filespec|"filespec"
DSMC Query BACKUPSET [options] [backupsetname|filename]
DSMC Query Filespace [options]
DSMC Query Image [options] logicalvolumename|filespacename
DSMC Query Mgmtclass [options]
DSMC Query REStore [options]
DSMC Query SChedule [options]
DSMC Query SEssion [options]
DSMC RESTArt Restore [options]
DSMC REStore [FILE] [options] sourcefilespec|"sourcefilespec" [destinationfilespec]
DSMC REStore BACKUPSET [options] [backupsetname|filename sourcefilespec|"sourcefilespec" [destinationfilespec]
DSMC REStore Image [options]sourcefilespec|"sourcefilespec" [destinationfilespec]
DSMC RETrieve [options] sourcefilespec|"sourcefilespec" [destinationfilespec]
DSMC SCHedule [options]
DSMC Selective [options] filespec | "filespec"|image-fs
DSMC SET Access [Archive|Backup] filespec|"filespec" node [user] [options]
DSMC SET Password [oldpw newpw] [options]


For Further Information


For more information, see the following references:
TSM Installing the Clients SH26-4102
TSM for UNIX Using the Backup-Archive Clients SH26-4105
Using the UNIX HSM Clients SH26-4083
DSM.OPT.SMP, DSM.OPT (online files)
DSM.SYS.SMP, DSM.SYS (online files)
Include-Exclude Options File (online file)
README, README.API (online files)


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