Tivoli Storage Manager Quick Reference for the Backup-Archive Clients
You can start a TSM GUI session, do the following:
- Start the X Window System
- Enter dsm (runs TSM in foreground) or dsm &
(runs TSM in background)
To run a GUI backup, perform the following steps:
- Click on Backup files and directories from the TSM
window.
- 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.
- Select the type of backup from the pull-down menu:
- To perform an incremental backup: click on Incremental
(complete)Incremental (complete)
- To perform an incremental by date: click on Incremental (date
only)
- To perform a selective backup: click on Always backup
- To perform an image backup: click on Image Backup
- 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.
- Click on Backup. The Task List window displays backup
processing status.
To run a GUI restore, perform the following steps:
- Click on Restore files and directories to your system from the
TSM window.
- 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:
- Expand the Backup Sets directory tree object.
- To restore backup sets locally, expand the Local object and
specify the local device or filename containing the backup set.
- To restore a backup set from the server, expand the Server
object and select the backup set name.
- 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.
- Click on Restore. Enter the information in the Restore
Destination window.
- Click on Restore. The Task List window displays restore
processing status.
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:
- Click on Archive files and directories into long term storage
from the TSM window. The Archive window displays.
- 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.
- In the Description field:
- Enter a description, or
- Accept the default description, or
- Select an existing description from the drop-down list.
- 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.
- Click on Archive. The Task List window
displays the archive processing status.
Retrieve a file when you want to return an archive copy from the TSM server
to your workstation. To retrieve an archived file:
- Click on Retrieve from the TSM window. The Retrieve
window displays.
- 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.
- 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.
- Click the Retrieve button. The Retrieve Destination
window displays. Enter the appropriate information.
- Click on Retrieve. The Task List window
displays the retrieve processing status.
To display GUI online help, do one of the following:
- Place cursor on option or field of interest and press F1
- Select Help menu
- Click on Help button in many windows
To end a GUI session, do one of the following:
- Select File menu; Exit item
- Double-click on the system menu icon
- Select the system menu; close item
To start the TSM Scheduler, do one of the following:
- Enter the dsmc schedule command, or
- Include the dsmc schedule command in your
/etc/inittab file
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:
- Use Ctrl+C (foreground)
- Enter the kill command (background)
- Enter q.
To start a command line session, do the following:
- On the command line, change directory to the TSM directory:
- Batch mode--for a single client command, enter:
> dsmc command
- Interactive mode--for more than one client command, enter:
> dsmc or dsmc loop
tsm> command
:
tsm> quit
>
- To run an incremental backup of the /home file system:
dsmc incremental /home
- To run an incremental backup by date of the /home/jones
directory, enter:
dsmc incremental -incrbydate /home/jones
- To run a selective backup of the proja file in the
/home/jones directory, enter:
dsmc selective /home/jones/proja
- To run an image backup of the /home/jones directory,
enter:
dsmc backup image /home/jones
To run a command line restore:
Note: | You can use wildcard characters to restore groups of files, or entire
directories.
|
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"
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
To display command line help, enter the following command:
dsmc help
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:
- Estimate
- View Policy Information
- Access Another User
- Searching and Filtering
- User Access List
- Setup Wizard
- Querying and Restoring Backup Sets
To use the Web client, perform the following steps
- If you do not already have password files generated for TSM clients,
specify passwordaccess generate in the
dsm.sys options file.
- 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.
- Quit from the native TSM backup-archive client.
- 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.
- 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.
|
- 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-4119, for
more information.
- 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"
- DSMC SET Access [Archive|Backup]
filespec|"filespec" node
[user] [options]
- DSMC SET Password [oldpw newpw]
[options]
|
For more information, see the following references:
|
|
TSM Installing the Clients
| SH26-4119
|
TSM for UNIX Using the Backup-Archive Clients
| SH26-4122
|
Using the HSM Clients
| SH26-4115
|
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 ]