Tivoli Header

Tivoli Space Manager for UNIX Using the Hierarchical Storage Management Clients

Edit Your Options Files

To edit your options files from the Backup-Archive Client for UNIX graphical user interface, perform these steps:

  1. Select the Utilities menu> Setup Wizard.
  2. Check Help me configure the TSM Backup Archive Client.
  3. Check Update my options file.
  4. Follow the instructions on your screen.

The sections that follow provide descriptions of each space management option that you can use. For more information about these options, see "Using Options".

Set Options in Your dsm.sys File

In addition to backup and archive options, the dsm.sys file:

Table 5 provides a brief description of each space management option that you can set in your dsm.sys file. The values that you set for the HSM client affect automatic migration, reconciliation, and recall. For more information about these options, see "Using Options".

For information about setting up space managment for AIX in an HACMP environment, see "Set Up Space Management for AIX in an HACMP Environment".

For AIX GPFS file systems only: To access your data on the server in the event of failover, ensure that all HSM nodes participating in the failover environment share the same node name in your dsm.sys file.

With the exception of errorprog, place all space management options at the beginning of your dsm.sys file before any server stanzas that you define.

  1. Obtain the server information from your TSM administrator.
  2. Edit your dsm.sys file to include the server to which you want to connect for space management services.
  3. Assign a name to the server to which you want to contact for space management services. For each Servername entry, include a COMMmethod entry to specify the communication method to use for client and server communications.
  4. Enter a value for each option and remove the leading asterisk (*). You can specify options for more than one server.

You can specify both a default server and a migration server in your dsm.sys file. If you do not specify a server name on either the defaultserver option or the migrateserver option, then, the server that you do specify in the first stanza of your dsm.sys file becomes your default server.

If you specify a migration server with the migrateserver option, it overrides the server that you specified with the defaultserver option.

Figure 1 displays an example of a server stanza containing options for a server that you want to contact.

Figure 1. Example of a dsm.sys File with HSM Options

DEFAULTServer                 server1
MIGRATEServer                 server2
CHECKThresholds               2
CANDIDATESInterval            12
MAXCANDprocs                  5
RECOncileinterval             12
MAXRECOncileproc              5
MAXThresholdproc              5
MINMIGFILESize                8192
MIGFILEEXPiration             10
MINRECAlldaemons              5
MAXRecalldaemons              15
CHECKFororphans               no
MAXMIGRators                  1
KERNelmessages                no
 
Servername     server1
  COMMmethod                  TCPip
  TCPPort                     1500
  TCPServeraddress            almvmd.almaden.ibm.com
  Passwordaccess              generate
  Mailprog                    /usr/bin/xsend root
  Groups                      system tsm
  Users                       steiner chron wang nguyen
  Inclexcl                    /adm/tsm/backup.excl
  ERRORProg                   /bin/cat
 
Servername     server2
  COMMmethod                  SNAlu6.2
  PARtnerluname               raptor
  TPname                      appcdel
  CPICMOdename                appc
  Passwordaccess              generate
  Mailprog                    /usr/bin/xsend root
  Groups                      system tsm
  Users                       sullivan tang stewart
  Inclexcl                    /adm/tsm/migrate.excl
  ERRORProg                   /bin/cat

Table 5. Setting Space Management Options in Your dsm.sys File

Option Description Default
candidatesinterval Specifies how often the dsmscoutd daemon searches for migration candidates in file systems to which you added space management. The range of values is zero through 9999. 1
checkfororphans Specifies whether or not the dsmreconcile command checks for orphans. No
checkthresholds Determines how frequently the space monitor daemon checks space usage on the file systems to which you add space management. Every 5 minutes
compression Compresses files before you send them to the TSM server. No
defaultserver Specifies the name of the default TSM server to contact for space management services if you do not specify a server name on the migrateserver option.

You cannot override the default server for space management services in your dsm.opt file.

Server name in the first stanza
errorprog Specifies a program to which you want to send a message if a severe error occurs during space management processing. None
kernelmessages Valid for AIX JFS file systems only

Displays HSM-related messages during processing. If you change the value, it will not take effect until you restart your system.

Yes
maxcandprocs Specifies the number of slave scout daemons that can scan for migration candidates in parallel on a system. The range of values is two through 20. 5
maxmigrators Specifies the number of parallel migration sessions that you can perform. The range of values is one through 20. 1
maxrecalldaemons Specifies the maximum number of recall daemons that you can run at one time. The range of values is two through 99. 20
maxreconcileproc Specifies the maximum number of automatic reconciliation processes that you can start at one time. The range of values is one through 99. 3
maxthresholdproc Specifies the maximum number of automatic threshold migration processes that you can start at one time. The range of values is one through 99. 3
migfileexpiration Specifies the number of days that copies of migrated or premigrated files remain on the TSM server after they are modified on, or erased from, your local file system. The range of values is zero through 9999. 7 days
migrateserver Specifies the TSM server to which you want to migrate files from your client node. Specify only one migration server for each client node.

You cannot override the migration server in your dsm.opt file.

Specify a server name in the first stanza
minmigfilesize Specifies the minimum file size for migration candidates that is smaller or larger than the stub file size. The range of values is zero through 2147483647. Zero
minrecalldaemons Specifies the minimum number of recall daemons that you want to run at the same time to perform recalls for your client node. The range of values is one through 99. 3
reconcileinterval Specifies how often automatic reconciliation of file systems occurs to which you add space management. The range of values is zero through 9999. Every 24 hours

Set Options in Your dsm.opt File

The dsm.opt file contains options that affect the backup-archive client. However, some options, such as optionformat and restoremigstate, affect both the backup-archive client and the HSM client. Table 6 provides a brief description of the space management options that you can set in your dsm.opt file.

To edit your dsm.opt file:

  1. Group the options into stanzas for each server that your client node contacts for backup, archive, and space management services.
  2. Enter a value for each option and remove the leading asterisk (*).
  3. Set the DSM_CONFIG environment variable to point to your dsm.opt file. For instructions to set this variable, see Set Environment Variables.

Table 6. Setting Space Management Options in Your dsm.opt File

Option Description Default
optionformat Specifies the format to use (either standard or short) when you specify HSM client commands. If you change the value, the new value is effective immediately. Standard
restoremigstate Restores a file if it is backed up after migration. You cannot restore a stub file if you back up a file before migration because a server stub file copy does not exist. Yes


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