UNIX Backup-Archive Clients
Starting a TSM GUI Session
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)
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 Search icon from the tool bar.
3. Select the type of backup from the pull-down menu:
o To perform an incremental backup: click on Incremental (complete)Incremental (complete)
o To perform an incremental by date: click on Incremental (date only)
o To perform a selective backup: click on Always backup
o To perform an image backup: click on Image Backup
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:
a. Expand the Backup Sets directory tree object.
b. To restore backup sets locally, expand the Local object and specify the local device or
filename containing the backup set.
c. 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:
o Enter a description, or
o Accept the default description, or
o Select an existing description from the drop-down list.
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:
• Place cursor on option or field of interest and press F1
• Select Help menu
• Click on Help button in many windows
Ending a GUI Session
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
Starting the TSM Scheduler
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:
To stop the scheduler:
• Use Ctrl+C (foreground)
• Enter the kill command (background)
• Enter q.
________________________________________
Starting a TSM Command Line Session
To start a command line session, do the following:
• On the command line, change directory to the TSM directory:
o Batch mode--for a single client command, enter:
> dsmc command
o Interactive mode--for more than one client command, enter:
> dsmc or dsmc loop
tsm> command
:
tsm> quit
Performing a Command Line Backup
• 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
Restoring Backup Versions
To run a command line restore:
• To restore the /home/jones/proja file to its original directory, enter:
• dsmc restore /home/jones/proja
• To restore a backup set from the /dev/rmt0 tape device, enter:
• dsmc restore backupset /dev/rmt0 -location=tape
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:
• 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
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:
3. dsmc query session
and, when prompted, enter your user ID and password.
4. Quit from the native TSM backup-archive client.
5. 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.
6. 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.
7. You can access the TSM Web client using any browser that is Java1.1.6-capable by entering the following URL:
8. 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.
________________________________________
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"
dsmc set access [archive|backup] filespec|"filespec" node [user] [options]
dsmc set password [oldpw newpw] [options]