Options files reference
The space management client provides system and space management options that you 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 affect automatic migration, reconciliation, and recall.
- afmskipuncachedfiles
The afmskipuncachedfiles option specifies whether uncached and dirty files in IBM Spectrum Scale™ Active File Management file sets are processed for backup, archive, and migration operations. - candidatesinterval
The candidatesinterval option specifies how often the dsmscoutd daemon searches the file systems for migration candidates. - checkfororphans
The checkfororphans option specifies whether or not the dsmreconcile command checks for migrated files that are no longer present on the server but whose stub files still remain on the client (orphans). The option parameter that you set determines whether or not the dsmreconcile command queries the scout daemon for all migrated and premigrated files. - 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. - compression
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 IBM Spectrum Protect™ throughput. - 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 can also specify the server to which files are migrated from your local file systems. - errorlogname
The errorlogname option specifies the path of the file that logs error messages for the space management client and the backup-archive client. - errorprog
The errorprog option specifies a program to which you want to send a message if a severe error occurs during space management processing. - hsmdisableautomigdaemons
Use the hsmdisableautomigdaemons option to control the start of the dsmscoutd and dsmmonitord daemons. - hsmdistributedrecall
The hsmdistributedrecall option specifies whether a node that is running as owner node can delegate recall requests to other nodes in an IBM Spectrum Scale cluster. - hsmenableimmediatemigrate
The hsmenableimmediatemigrate option determines if files that are less than 2 minutes old can be migrated during selective migration. - hsmeventdestroy
The hsmeventdestroy option specifies whether immediate reconciliation occurs. - hsmextobjidattr
The hsmextobjidattr option specifies whether the dsmreconcile, dsmmigrate, dsmrecall, or dsmrecalld command assigns an object ID to the file as a Data Management Application Programming Interface (DMAPI) extended attribute (extObjId). - hsmgroupedmigrate
The hsmgroupedmigrate option specifies whether the dsmmigrate command migrates more than one file with each transaction. - hsmlogeventflags
The hsmlogeventflags option specifies which kinds of events are added to the HSM log file. - hsmlogmax
The hsmlogmax option specifies the maximum size of the HSM log, in megabytes. - hsmlogname
The hsmlogname option specifies the HSM log file name. - hsmlogretention
The hsmlogretention option specifies how many days to maintain HSM log entries before pruning, and whether to save the pruned entries. - hsmlogsampleinterval
The hsmlogsampleinterval option specifies how often to gather file system data for the HSM log file. - hsmmaxrecalltapedrives
The hsmmaxrecalltapedrives option controls how many tape drives participate in tape-optimized recall processing. - hsmmigzeroblockfiles
The hsmmigzeroblockfiles option specifies whether the space management client migrates files that allocate zero data blocks in the file system. - hsmmultiserver
The hsmmultiserver option enables and disables migration and backup in an environment of multiple IBM Spectrum Protect servers. - hsmrecallbufferalignment
The hsmrecallbufferalignment option specifies whether and how the internal buffer address for recall operations is aligned in the recall process memory. The alignment can significantly impact the recall performance. - hsmrecallbuffersize
The hsmrecallbuffersize option specifies the size (in kilobytes) of the buffer that is used to collect data before the data is written to a file system as part of a recall operation. - hsmrpcport
The hsmrpcport option specifies a Remote Procedure Call (RPC) TCP/IP port address for the HSM recall services. - inclexcl
Use the inclexcl option to define the filename and path of your include-exclude options file. - maxcandprocs
The maxcandprocs option specifies the number of parallel threads in the scout daemons that can scan for file systems. - maxmigrators
The maxmigrators option specifies the maximum number of parallel migration sessions that can run in parallel for each file system. Ensure that you have sufficient resources on the server for parallel migration to occur. - maxrecalldaemons
The maxrecalldaemons option specifies the maximum number of recall daemons that you can run at one time to recall files for the client node. If the number of recall daemons that are running at one time is close to the maximum number, increase the value. - maxthresholdproc
The maxthresholdproc option specifies the maximum number of threshold migration processes that the space management 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. - 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 are deleted from your local file system. - 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. - minmigfilesize
The minmigfilesize option specifies the minimum file size for a file to be eligible for migration. - minrecalldaemons
The minrecalldaemons option specifies the minimum number of recall daemons that can run in parallel to recall files for the client node. - reconcileinterval
The reconcileinterval option specifies how often the space monitor daemon reconciles your file systems. Depending on the checkfororphans option, the reconciliation either expires or deletes obsolete objects on the server and updates the status file, or checks for orphan stub files and makes metadata updates. - restoremigstate
The restoremigstate option specifies whether you want to restore or retrieve stub files or backup-archive versions of migrated files during a restore-retrieve operation. Use this option with the backup-archive client restore and retrieve commands. - skipmigrated
The skipmigrated option specifies whether the IBM Spectrum Protect backup-archive client process migrated files during a backup or archive operation. Use this option with the backup-archive client archive, backup image, incremental, and selective commands.