IBM Tivoli Storage Manager for Space Management, Version 7.1

dsmmigfs add and update

Use the dsmmigfs command with the add parameter to add space management to the file system. Use the dsmmigfs command with the update parameter to update space management settings for your file system.

You must have root user authority to use this command.

For information about configuring GPFS™ integration with the Tivoli® Storage Manager for Space Management client, see the Tivoli field guide TSM for Space Management for UNIX-GPFS Integration Part I: Policy-driven Threshold Migration at https://www.ibm.com/support/docview.wss?uid=swg27018848.

Before you run dsmmigfs add filesystem on AIX® GPFS and Linux x86_64 GPFS file systems, ensure that the file system is mounted and enabled for Data Management Application Programming Interface (DMAPI) management. Issue the following commands:

For AIX GPFS and Linux x86_64 GPFS:
  /usr/lpp/mmfs/bin/mmlsfs DevicePath -z
If it is required, change the value as follows:
  /usr/lpp/mmfs/bin/mmchfs DevicePath -z yes 
Run only one dsmmigfs command within the local GPFS node group at the same time.

You cannot add space management to your root ( / ), /tmp, /usr, or /var file systems.

JFS2 Encrypted File System is not supported. Adding space management to a JFS2 EFS with the dsmmigfs add command yields an error message.

Note: You can query only information about mounted file systems. If a file system is space-managed, but not mounted, it does not show up within the query command

Syntax

Read syntax diagramSkip visual syntax diagram
                                      .--------------------.   
                                      V                    |   
>>-DSMMIGFS--+-Add----+--+---------+------filesystemSpec---+---><
             '-Update-'  '-options-'                           

Parameters

Add
Adds space management to your file systems.
Update
Updates one or more space management settings for a file system to which you added space management.

If you change the high and low thresholds or the premigration percentage, the new values take effect immediately. If you change the stub file size, the new size is used for files that are migrated after the change. The size of existing stub files does not change.

If you change the minmigfilesize option value, the new value is used the next time a migration candidates list is built. Also, the new value is used only for files that are migrated after the value is changed.

If you change the readstartsrecall option value, the new value is used only for files that are migrated after the value is changed.

You can set the quota below the amount of currently migrated and premigrated data. No more files are migrated until automatic and selective recalls reduce the amount of currently migrated and premigrated data to less than the new quota.

filesystemSpec
Specifies a file system name. You can specify more than one file system name, and you can use wildcard characters within a file system name. If you specify more than one file system name, separate each name with one or more blank spaces.
options
Use the option settings that are provided for this command to add or update space management settings.
On GPFS file systems, you can use the GPFS policy engine to monitor space thresholds and search for migration candidates. If you configure the GPFS policy engine to drive automatic migration, the following options for the dsmmigfs command have no consequence:
  • hthreshold
  • lthreshold
  • maxcandidates
  • maxfiles
  • minpartialrecallsize
  • minmigfilesize
HThreshold=n
Specifies the high threshold percentage that you set for space usage on your file systems. Specify a value of 0 -100 percent. The default is 90 percent.
Lthreshold=n
Specifies the low threshold percentage that you set for space usage on your file systems. Specify a value of 0 through 100 percent. The default is 80 percent.
ERRORLOGName=file_path
Specifies the path and file name of the error log file to be used by this command. Output from only this command is logged to the specified file. Other commands and daemons write output to the error log file specified by the errorlogname option in options file dsm.sys or dsm.opt, or as specified by the DSM_LOG environment variable. If any part of the path you specify does not exist, the Tivoli Storage Manager for Space Management client creates it.
LOGname=file_path
Specifies the path and file name of the log file to be used by this command. The kinds of events that are logged to the file are specified with the hsmlogeventflags option. Error events are not logged to the file.
Maxcandidates=n
Specifies the maximum number of migration candidates the dsmscoutd daemon delivers to the automatic migration process during automigration. A value 50 - 1000 is sufficient for good performance. The acceptable range is 9 - 9999999. The default is 10000.
MAXFiles=n
Specifies the maximum number of files for which the CFI database is sized. The acceptable range is 0 - 4294967295. The default is 0.

This parameter allocates space based on the maximum number of blocks in the file system. If the specified value is less than the number of currently used blocks, an error occurs. The value must be greater than the current number of files in the file system. The value must be less than the total likely number of inodes.

You can configure the size of the complete file index (CFI). This value can be queried or set with the maxfiles parameter. If this parameter is set to 0, the CFI allocates the maximum required space. The maximum required space is the maximum number of blocks that are possible in the file system. Less file system space is needed to create the CFI. If the specified value is out of bounds, the nearest boundary is used to allocate the configurable CFI size.

MINMigfilesize=n
Specifies the minimum size (in bytes) for a file to qualify for migration. The acceptable range is 0 - 2147483647. The default is 0. If you specify 0, the Tivoli Storage Manager for Space Management client uses the current file system stub size plus 1 byte, as the minimum size for files that can be migrated. If you specify a non-zero value, the value must be greater than the current file system stub size. A valid value takes precedence over the global minmigfilesize option setting that is specified in the dsm.sys file.
MINPartialrecallsize=n (AIX GPFS and Linux x86_64 GPFS only)
Specifies the minimum size (in megabytes) for a file to qualify for partial file recall. The acceptable range is 0 - 999999999. The default value of 0 disables partial file recall for all files.
MINStreamfilesize=n
Specifies a number to enable or disable an asynchronous recall of migrated files. This parameter is the number of megabytes that must be recalled before the Tivoli Storage Manager for Space Management client starts streaming data to the requesting application. Smaller files are recalled in normal recall mode. The recalled portion of the file can be accessed while the file is recalled. The acceptable range is 0 - 999999999. The default is 0.
Pmpercentage=n
Specifies the percentage of file system space that is available to contain premigrated files. The minimum value is 0. The maximum value is the low threshold. A warning is issued if the premigration percentage is greater than the difference between the low threshold and the recommended minimum size of the file system. A premigration percentage greater than this difference can result in insufficient space for the file system, and can result in endless attempts to find premigration candidates.
Quota=n
Specifies the maximum number of megabytes of data that you can migrate and premigrate from your file system to Tivoli Storage Manager storage. Specify a value from 0 to 999999999999999. The default is the number of megabytes that are allocated for your file system. If you set the quota to 0 for your file system, files do not migrate to storage. If you set the quota to 999999999999999, the amount of data you can migrate and premigrate is unlimited.
READEVEnttimeout=n
Specifies the maximum time of inactivity (in seconds) before a streaming recall process times out. The acceptable range is 0 - 999999999. A value of 999999999 means that a streaming recall process does not time out. The default value is 600. This option applies to streaming recall mode only.
READStartsrecall=value
Specifies whether a recall operation starts when an application reads the stub file. Valid values are No and Yes. The default value is No. This option applies only to streaming recall mode.
Regardless of the value of the readstartsrecall option, the file is recalled when either of the following conditions are true:
  • The recall daemon determines that the stub file does not contain all of the data that is required by a read operation.
  • An operation modifies the file.
SErver=server_name
Overrides the default migration server for this file system. Specify the server to contact for space management services. Define the server in a stanza in your dsm.sys file. If you do not specify a server name, the default migration server that you defined is used. Use a dash (–) to set the server to the default migration server.
STREAMSeq=n
Specifies the number of megabytes that are buffered before the recall daemon flushes the data to disk. The acceptable range is 0 - 1024. The default value of 0 means that buffering is disabled. This option applies only to streaming recall mode.
STUbsize=n
Specifies the size of stub files that remain on your local file systems when files are migrated to storage.

For Tivoli Storage Manager for Space Management clients on AIX GPFS and Linux x86_64 GPFS file systems, you can specify 0 or a multiple of the file system block size. The default value is 0.

For Tivoli Storage Manager for Space Management clients on AIX Enhanced Journaled Files Systems (JFS2), you can specify a multiple of the file system fragment size. The default value is the file system fragment size.

For all file system types, the maximum value for a stub file size is 1 GB.

If HSM is globally deactivated on a node (dsmmigfs globaldeactivate), it is reset to active state, if one of the following commands are performed:

Examples

Commands are provided for the example tasks.

Task Command
Add space management to the /hsmmanagedfs1 file system. Set the space to the maximum number of blocks in the file system. dsmmigfs Add -MAXFiles=0 /hsmmanagedfs1
Update the space management settings for the /hsmmanagedfs2 file system. Set the space (number of blocks) to the specified number. dsmmigfs update -MAXFiles=10000000 /hsmmanagedfs2
Add space management to the /home file system. Set the high threshold to 80 percent. Set the low threshold to 70 percent. Set the size of stub files to 256 k (KB). dsmmigfs Add -HT=80 -L=70 -STU=256k /home
Add space management to more than one file system and accept the default values for all space management settings. dsmmigfs Add /home /test1 /proj*
Update the space management settings for the /home file system as follows:
  • Change the high threshold to 80 percent.
  • Change the low threshold to 70 percent.
  • Set the size of stub files to 1 megabyte.
dsmmigfs Update -HT=80 -L=70 -STU=1m /home
Specify the minimum size of files in the /home/user1 file system that are recalled with partial file recall. dsmmigfs Update -minp=100 /home/user1
Specify that the minimum size for a file that can be migrated from the /home/user2 file system must be at least 1 megabyte. dsmmigfs Update -minm=1048576 /home/user2
Add space management to the /myfs file system. Set the high threshold to 80 percent. Set the low threshold to 50 percent. Set the space (number of blocks) to the specified number. dsmmigfs add -maxfiles=1000000 -lt=50 -ht=80 -pm=10 /myfs


Feedback