Tivoli Header

Tivoli Space Manager for UNIX Using the Hierarchical Storage Management Clients

dsmmigfs

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

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 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.

filesystemSpec
The file system name to perform the specified action. 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. See the table that follows for options and information.

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.
  • For AIX GPFS file systems: Specify a value of zero or a multiple of the physical block size. The default is zero.
  • For AIX JFS file systems: Specify a value of size fragment size or a multiple of the physical block size. The default is the fragment size.
  • For Solaris file systems: Specify a value of one or a multiple of the physical block size. The default is the block size.
-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:
  • Change the high threshold to 80 percent.
  • Change the low threshold to 70 percent.
  • Set the size factor to zero to ensure that the number of days since a file was last accessed is the only factor that determines when eligible files are prioritized for migration.
dsmmigfs Update -t80 -l70 -i0 /home


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