IBM Tivoli Software IBM Tivoli Software

[ | | | ]


IBM Tivoli Storage Manager for Space Management for UNIX: User's Guide


Using Options

Attention: You must have root user authority to set the options in your dsm.sys file.

The HSM client provides system and space management options that you can set either in your dsm.sys file or in your dsm.opt file. The values that you set for space management options determine which server your client node contacts for space management services, and they affect automatic migration, reconciliation, and recall. In your dsm.sys file, group your options into stanzas for each server that your client node contacts for backup, archive, and space management services.

Options are processed following this order:

  1. Options that are defined on the server with server-enforced client options. The client cannot override the value.
  2. Options that are entered locally on the command line.
  3. Options that are defined on the server for a schedule using the options parameters.
  4. Options that you enter locally in your options file.
  5. Options that are received from the server with client options that the server does not enforce. The client can override the value.
  6. Default option values.

With the exception of the errorprog option, place all space management options before the stanzas for each server that you define in your dsm.sys file. For example, if you want to specify a default server for backup and archive services, a migration server, and new values for other space management options, place the options in your dsm.sys file. The following is an example of a server stanza containing options for a server that you want to contact.

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
OVERLAPRECALL                   no
Servername     server1
  COMMmethod                  TCPip
  TCPPort                     1500
  TCPServeraddress            almvmd.almaden.ibm.com
  Passwordaccess              generate
  Mailprog                    /usr/bin/xsend root
  Groups                      system adsm
  Users                       steiner chron wang nguyen
  Inclexcl                    /adm/adsm/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 adsm
  Users                       sullivan tang stewart
  Inclexcl                    /adm/adsm/migrate.excl
  ERRORProg                   /bin/cat

Table 17. Space Management Options in Your Options Files

Option Description Page
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 one through 9999. The default is one. Candidatesinterval
checkfororphans Specifies whether or not the dsmreconcile command checks for orphans. Specify yes or no. The default is no. Checkfororphans
checkthresholds Determines how frequently the space monitor daemon checks space usage on the file systems to which you add space management. The range of values is one through 9999. The default is five. Checkthresholds
compression Compresses files before you send them to the Tivoli Storage Manager server. Specify yes or no. The default is no. Compression
defaultserver Specifies the name of the default Tivoli Storage Manager 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.

Defaultserver
errorprog Specifies a program to which you want to send a message if a severe error occurs during space management processing. Place this option after all space management options for each server that you define in your dsm.sys file. Errorprog
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. Specify yes or no. The default is yes.

Kernelmessages
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. The default is five. Maxcandprocs
maxmigrators Specifies the number of parallel migration sessions that you can perform. The range of values is one through 20. The default is one. Maxmigrators
maxrecalldaemons Specifies the maximum number of recall daemons that you can run at one time. The range of values is two through 99. The default is 20. Maxrecalldaemons
maxreconcileproc Specifies the maximum number of automatic reconciliation processes that you can start at one time. The range of values is one through 99. The default is three. Maxreconcileproc
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. The default is three. Maxthresholdproc
migfileexpiration Specifies the number of days that copies of migrated or premigrated files remain on the Tivoli Storage Manager server after they are modified on, or erased from, your local file system. The range of values is zero through 9999. The default is seven days. Migfileexpiration
migrateserver Specifies the Tivoli Storage Manager 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.

Migrateserver
minmigfilesize Specifies the minimum file size for a file to be eligible for automatic migration. The range of values is the fragment size of the file system through 2147483647. The default is zero. Minmigfilesize
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. The default is three. Minrecalldaemons
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. Select standard or short format. The default is standard. Optionformat
overlaprecall Valid for AIX JFS file systems only

Specifies whether migrated files must be recalled immediately even if a process is accessing only the resident part of the file. This option is valid for read-only operations on a file. Specify Yes or No. The default is No.

Overlaprecall
reconcileinterval Specifies how often automatic reconciliation of file systems occurs to which you add space management. The range of values is zero through 9999. The default is 24. Reconcileinterval
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. Specify yes or no. The default is yes. Restoremigstate

Candidatesinterval

The candidatesinterval option specifies how often the dsmscoutd daemon searches for migration candidates in file systems to which you added space management.

Place this option at the beginning of your dsm.sys file before any server stanzas.

Syntax

>>-Candidatesinterval number_in_hours--------------------------><
 
 

Parameters

number_in_hours
Specifies the maximum number of hours that will elapse between each successive time the dsmscoutd daemon automatically searches for candidates in a file system. The range of values is one through 9999; the default is one. If it is required, the dsmscoutd daemon will scan a file system more often than you specify.

If you modify the setting to the maximum value of 9999, the dsmscoutd daemon does not search in regular cycles for migration candidates. It searches for migration candidates only on requests from the automigration process.

Checkfororphans

The checkfororphans option specifies whether or not the dsmreconcile command checks for migrated files that are no longer present on the server (orphans) but whose stub files still remain on the client. The option parameter that you set determines whether or not the dsmreconcile command requires a full file system tree traversal.

Place this option at the beginning of your dsm.sys file before any server stanzas.

Syntax

                   .-No--.
>>-CHECKFororphans-+-----+-------------------------------------><
                   '-Yes-'
 
 

Parameters

No
The dsmreconcile command checks for orphans only when you remove the HSM client from your file system, or when you specify the -o parameter with the dsmreconcile command. Full file system tree traversals are not required when you select this setting. You can run the dsmautomig command concurrently with dsmreconcile. This is the default.
Yes
The dsmreconcile command checks for orphans. When orphans are located, their names are recorded in .SpaceMan/orphan.stubs. Full file system tree traversals are required when you select this setting. If you specify yes, the dsmautomig command cannot run concurrently with dsmreconcile.

Checkthresholds

The checkthresholds option specifies how often the space monitor daemon checks space usage on your file systems. The space monitor daemon checks each file system to which you added space management.

Place this option at the beginning of your dsm.sys file before any server stanzas.

Syntax

>>-CHECKThresholds interval------------------------------------><
 
 

Parameters

interval
Specifies the number of minutes that must elapse before the space monitor daemon checks space usage on your file systems. The range of values is one through 9999; the default is five.

Compression

Place this option in the client system options file (dsm.sys) within a server stanza.

The compression option compresses files before you send them to the server. Compressing your files reduces data storage for backup versions and archive copies of your files. It can, however, affect Tivoli Storage Manager throughput. A fast processor on a slow network connection benefits from compression, but a slow processor on a fast network connection does not. Use this option with the backup-archive client option, compressalways.

If you specify compressalways yes, compression continues even if the file size increases. To stop compression if the file size grows, and resend the uncompressed file, specify compressalways no.

If you specify compression yes, you can control compression processing in the following ways:

This option controls compression only if your administrator specifies that your client node determines the selection.

Note:
The server also can define this option.

Syntax

               .-No--.
>>-COMPRESSIon-+-----+-----------------------------------------><
               '-Yes-'
 
 

Parameters

No
Files are not compressed before they are sent to the server. This is the default.
Yes
Files are compressed before they are sent to the server.

Defaultserver

The defaultserver option specifies the default server to which you back up and archive your files from your local file systems. If you do not specify a migration server with the migrateserver option, this option also can specify the server to which files are migrated from your local file systems.

Place this option at the beginning of your dsm.sys file before any server stanzas.

Syntax

>>-DEFAULTServer servername------------------------------------><
 
 

Parameters

servername
Specifies the name of the default server to which you back up and archive your files. Specify the server to which your files migrate from your local file systems. Use this option if you do not specify a migration server with the migrateserver option.

Errorprog

The errorprog option specifies a program to which you want to send a message if a severe error occurs during space management processing.

Do not place this option at the beginning of your dsm.sys file before any server stanzas.

Syntax

>>-ERRORProg program-name--------------------------------------><
 
 

Parameters

program-name
Specifies the path and file name of the program to which you want to send a message if a severe error occurs during space management processing. For example:
   errorprog /usr/bin/echo

Kernelmessages

Valid for AIX JFS file systems only

The kernelmessages option specifies whether or not to display HSM-related messages during processing.

Note:
During transparent recall, if more than one process accesses the same migrated file at one time, the kernel displays a message only for the first process that accesses the file.

Place this option at the beginning of your dsm.sys file before any server stanzas.

Syntax

                  .-Yes-.
>>-KERNelmessages-+-----+--------------------------------------><
                  '-No--'
 
 

Parameters

Yes
Displays HSM-related messages that the kernel sends. This is the default.
No
Does not display HSM-related messages that the kernel sends.

Maxcandprocs

The maxcandprocs option specifies the number of slave scout daemons that can scan for migration candidates in parallel on a system.

Place this option at the beginning of your dsm.sys file before any server stanzas.

Syntax

>>-MAXCANDProcs max_number_of_scout_daemons--------------------><
 
 

Parameters

max_number_of_scout_daemons
Specifies the maximum number of slave scout daemons that you can set. The range of values is two through 20; the default is five.

Maxmigrators

The maxmigrators option specifies the maximum number of parallel migration sessions per file system to the Tivoli Storage Manager server that the dsmautomig command can perform. Ensure that you have sufficient resources on the server for parallel migration to occur. Do not set the maxmigrators option higher than the number of parallel sessions that the server can use to store data.

Place this option at the beginning of your dsm.sys file before any server stanzas.

Syntax

>>-MAXMIGRrators number----------------------------------------><
 
 

Parameters

number
Specifies the maximum number of parallel migration sessions that you can set. The range is one through 20; the default is one.

Maxrecalldaemons

The maxrecalldaemons option specifies the maximum number of recall daemons that you can run at one time to perform recalls for your client node. During normal operations, if the number of recall daemons that are running at one time is similar to the maximum number that is permitted, increase the value. For example, if you use an application that opens several files at one time, and these files are migrated, the application can use all available recall daemons. If you cannot start a recall daemon for another process that is attempting to access a migrated file, the process stops until a recall daemon is available.

Place this option at the beginning of your dsm.sys file before any server stanzas.

Syntax

>>-MAXRECAlldaemons number-------------------------------------><
 
 

Parameters

number
Specifies the maximum number of recall daemons that you can run at one time to perform recalls. The range is two through 99; the default is 20.

Maxreconcileproc

The maxreconcileproc option specifies the maximum number of reconciliation processes that the HSM client can start at one time.

Place this option at the beginning of your dsm.sys file before any server stanzas.

Syntax

>>-MAXRECOncileproc maxreconcileproc---------------------------><
 
 

Parameters

maxreconcileproc
Specifies the maximum number of reconciliation processes that the HSM client can start at one time. The range of values is one through 99; the default is three.

Maxthresholdproc

The maxthresholdproc option specifies the maximum number of threshold migration processes that the HSM client can start at one time. When a file system runs out of space, the HSM client does not verify the maximum number of threshold migration processes that currently are running. It starts threshold migration as part of the demand migration process regardless of the number of threshold migration processes in progress.

Place this option at the beginning of your dsm.sys file before any server stanzas.

Syntax

>>-MAXThresholdproc maxthresholdproc---------------------------><
 
 

Parameters

maxthresholdproc
Specifies the maximum number of automatic threshold migration processes that the HSM client can start at one time. The range of values is one through 99; the default is three.

Migfileexpiration

The migfileexpiration option specifies the number of days that copies of migrated or premigrated files remain on the server after they are modified on your local file system, or deleted from your local file system.

Place this option at the beginning of your dsm.sys file before any server stanzas.

Syntax

>>-MIGFileexpiration days--------------------------------------><
 
 

Parameters

days
Specifies the number of days a copy of a migrated or premigrated file remains in storage after it is modified on your local file system, or deleted from your local file system. The range of values is zero through 9999; the default is seven days.

Migrateserver

The migrateserver option specifies the name of the server to which you want to migrate files from your client node. Specify one migration server for each client node. You cannot override the server that you specify for migration in your dsm.opt file, or when you enter a command.

If you do not specify a server with the migrateserver option, your files migrate to the server that you specify with the defaultserver option. If you do not specify a server with either of these options, your files migrate to the server that you identify in the first stanza of your dsm.sys file.

After your files migrate to the server that you specified, do not specify a different migration server unless your administrator tranfers your migrated files from the specified server to another. Otherwise, the server cannot locate your migrated files until you specify the server to which your files were originally migrated.

Place this option at the beginning of your dsm.sys file before any server stanzas.

Syntax

>>-MIGRateserver servername------------------------------------><
 
 

Parameters

servername
Specifies the name of the server to which you want to migrate files from your client node. Your dsm.sys file must contain a stanza beginning with the servername option and it must contain the required communication options for the server that you specify with the migrateserver option.

Minmigfilesize

The minmigfilesize option specifies the minimum file size for a file to be eligible for migration.

Place this option at the beginning of your dsm.sys file before any server stanzas.

Syntax

>>-MINMIGfilesize fileSize-------------------------------------><
 
 

Parameters

fileSize
Specifies the minimum file size, in bytes, for a file to be eligible for migration. This byte size is ignored if it is smaller than the file system block size. The range of values is zero through 2147483647; the default is zero.

If you specify the default, the HSM client uses the file system block/fragment size or stubsize as the minimum size for files that can be migrated; whichever is larger.

Minrecalldaemons

The minrecalldaemons option specifies the minimum number of recall daemons that you can run at the same time to perform recalls for your client node.

Place this option at the beginning of your dsm.sys file before any server stanzas.

Syntax

>>-MINRecalldaemons number-------------------------------------><
 
 

Parameters

number
Specifies the minimum number of recall daemons that you can run at one time to perform recalls. The range of values is one through 99; the default is three.

Optionformat

The optionformat option specifies the format to use when you specify HSM client commands.

Place this option in your dsm.opt file.

Syntax

                .- STandard-.
>>-OPTIONFormat-+- SHort----+----------------------------------><
 
 

Parameters

STandard
Enter HSM client commands in a format similar to backup-archive client commands. This is the default. For example:
   dsmmigrate -Recursive -Detail /home/user1/file1   
SHort
Enter HSM client commands in a format similar to your operating system commands. For example:
   dsmmigrate -Rv /home/user1/file1
   dsmmigrate -v -R /home/user1/file1

Overlaprecall

Valid for AIX JFS file systems only

The overlaprecall option specifies whether migrated files must be recalled immediately even if a process is accessing only the resident part of the file. This option is valid for read-only operations on a file.

Place this option at the beginning of your dsm.sys file before any server stanzas.

Syntax

                 .-No--.
>>-OVERLAPREcall-+-----+---------------------------------------><
                 '-Yes-'
 
 

Parameters

No
Migrated files will not be recalled immediately. This is the default.
Yes
Migrated files will be recalled immediately.

Reconcileinterval

The reconcileinterval option specifies how often the space monitor daemon reconciles your file systems. This includes marking deleted local files for expiration on the server, removing stale entries from the premigration database, and bringing the status file up to date.

Place this option at the beginning of your dsm.sys file before any server stanzas.

Syntax

>>-RECOncileinterval interval----------------------------------><
 
 

Parameters

interval
Specifies the number of hours that must elapse between each successive time your file systems are automatically reconciled on your workstation. If you specify a value of zero, your file systems are not reconciled automatically. The range of values is zero through 9999; the default is 24.

Restoremigstate

The restoremigstate option specifies whether you want to restore or retrieve stub files or backup-archive versions of migrated and premigrated files during a restore-retrieve operation. Use this option with the backup-archive client restore and retrieve commands.

Place this option in your dsm.opt file.

You can restore or retrieve a stub file for a migrated or premigrated file only when:

When the number of days elapse that you specified with the migfileexpiration option, the migrated file is removed from storage.

If you specify restoremigstate yes, and if the migrated or premigrated file has not expired, the file is restored or retrieved to a stub file, regardless of whether it is marked for expiration.

The restoremigstate option restores a file if it is backed up after migration. If the file is backed up before migration, you cannot restore a stub file because a server stub file copy does not exist.

Files with ACLs are restored in a resident state regardless of the setting for restoremigstate.

Attention: The restoremigstate option does not support hardlinked files. If you want to restore or retrieve a stub file for a hardlinked file, delete all files from your local file system that are hardlinked together. When one file in a set of hardlinked files is migrated, all of the hardlinked files in the set become stub files. When you enter the restore command with the restoremigstate option, and restore a stub file for a hardlinked file, the stub file has the same name as the file that was originally migrated. Stub files are not restored for any other files that previously were in the hardlinked set of files.

Syntax

                    .-Yes-.
>>-RESToremigstate--+-----+------------------------------------><
                    '-No--'
 
 

Parameters

Yes
Restores or retrieves migrated and premigrated files to stub files on your local file system during a restore or retrieve operation. The files remain migrated. This is the default.

Attention: A stub file created during a restore or retrieve operation contains the information that is necessary to recall the migrated file from storage. It does not contain any leading bytes of data from the file. Any recall mode that was set previously for the migrated file (for example, migrate-on-close or read-without-recall) is not stored in the stub file. The recall mode is set to normal for all files that are restored or retrieved to stub files.

No
Restores or retrieves backup-archive versions of migrated files to your local file system during a restore or retrieve operation. The files become resident.


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