![]() |
![]() |
To edit your options files from the Backup-Archive Client for UNIX graphical user interface, perform these steps:
The sections that follow provide descriptions of each space management option that you can use. For more information about these options, see "Using Options".
In addition to backup and archive options, the dsm.sys file:
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.
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 |
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:
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 |