![]() |
![]() |
You must have root user authority to use this command.
The dsmmigfs command adds space management to your file system, or updates space management settings for your file system.
For AIX GPFS file systems only: Before you run dsmmigfs add filesystemName, enable the file system for DMApi management. Run the following:
/usr/lpp/mmfs/bin/mmlsfs DevicePath
Search for the status of the -z flag. If DMApi is not enabled on your file system, run the following:
/usr/lpp/mmfs/bin/mmchfs DevicePath -z yes
Run only one dsmmigfs command within the local GPFS node set at the same time.
In an HACMP environment: In the event of a system failure, specify the import parameter to access your data. The result permits an individual file system to specify a certain server stanza to manage your file system. Your file system can contain migrated files but it is not required to have them. The connection is made by adding an entry for the file system to /etc/tsm/SpaceMan/config/dsmmigfstab. A link is also created for the status file in /etc/tsm/SpaceMan/status. The export parameter removes the connection.
You cannot add space management to your root (/), /tmp, /usr, or /var file systems.
Syntax
>>-dsmmigfs--+- Add----+--+--------------+----------------------> '- Update-' | .----------. | | V | | '--- options-+-' .---------------------. V | >------ filesystemSpec---+-------------------------------------><
Parameters
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 only for files that are migrated after you make the change. If you change the age or size factor, the new value is used the next time a migration candidates list is built.
If you reduce the quota, and the amount of migrated and premigrated data exceeds the new quota, the HSM client does not migrate any additional files until enough files are recalled during automatic recall or selective recall to drop the total number of megabytes for migrated and premigrated files below the new quota.
Table 19. Space Management Option Settings
Option | Short Name | Description |
---|---|---|
-HThreshold=n | -tn | The high threshold percentage that you set for space usage on your file systems. Specify a value of zero through 100 percent. The default is 90 percent. |
-Lthreshold=n | -ln | The low threshold percentage that you set for space usage on your file systems. Specify a value of zero through 100 percent. The default is 80 percent. |
-Maxcandidates=n | -mn | The maximum number of migration candidates the dsmscoutd daemon searches for during one scan period. When this number is reached, dsmscoutd stops scanning. The range of values that you can enter are nine through 9999999. The default is 10000. |
-Pmpercentage=n | -pn | The percentage of file system space that is available to contain premigrated files. The default is the difference between the percentage that you set for the high threshold and the percentage that you set for the low threshold. Specify a value from zero through 100 percent. |
-Agefactor=n | -an | Assign an age factor to your files in each file system to which you added space management. The age and size factors determine the order in which eligible files migrate to TSM storage. Specify a value of zero through 999999999. The default is one. |
-SIzefactor=n | -in | Assign a size factor to your files in each file system to which you added space management. The age and size factors determine the order in which eligible files migrate to TSM storage. Specify a value of zero through 999999999. The default is one. |
-Quota=n | -qn | The maximum number of megabytes of data that you can migrate and premigrate from your file system to TSM storage. Specify a value from zero to 999999999. The default is the number of megabytes that are allocated for your file system. |
-STubsize=n | -stn | The size of stub files remaining on your local file systems when files
migrate to TSM storage.
|
-SErver=<servername> | -Sserver name | Overrides the default migration server for this file system. Specify the server to contact for space managment services. Define the server in a stanza in your dsm.sys file. If you do not specify a server name, the default migration server is used. Use a dash (-) to set the server to the default migration server. After you use the import parameter, perform a reconcile to update the status file. |
Examples
Task | Command |
---|---|
Add space management to the /home file system and set the high threshold to 80 percent and the low threshold to 70 percent. | dsmmigfs Add /home -t80 -l70 |
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:
| dsmmigfs Update -t80 -l70 -i0 /home |