GLYPH<SM590000> The name of a file that contains a list of files to be migrated. 

Important:  IBM Spectrum Archive EE supports only the MIGRATE , PREMIGRATE , and RECALL  subcommands. 

GLYPH<SM590000> Any optional parameters that are specified with the OPTS  clause in the rule. These optional parameters are not interpreted by the IBM Spectrum Scale policy engine, but by the method that IBM Spectrum Archive EE uses to pass the tape cartridge pools to which the files are migrated. 

To set up automated IBM Spectrum Scale policy-driven migration to IBM Spectrum Archive EE, you must configure IBM Spectrum Scale to be managed by IBM Spectrum Archive EE. In addition, a migration callback must be configured. 

Callbacks are provided primarily as a method for system administrators to take notice when important IBM Spectrum Scale events occur. It registers a user-defined command that IBM Spectrum Scale runs when certain events occur. For example, an administrator can use the low disk event callback to inform system administrators when a file system is getting full. 

The migration callback is used to register the policy engine to be run if a high threshold in a file system pool is met. For example, after your pool usage reaches 80%, you can start the migration process. You must enable the migration callback by running the mmaddcallback command. 

In the mmaddcallback  command in Example 7-57, the  --command option points to a sample script file called /usr/lpp/mmfs/bin/mmapplypolicy . Before you run this command, you must ensure that the specified sample script file exists. The --event  option registers the events for which the callback is configured, such as the “low disk space” events that are in the command example. 

For more information about how to create and set a fail-safe policy, see 8.10, “Real world use cases for mmapplypolicy” on page 235. 

mmaddcallback MIGRATION --command /usr/lpp/mmfs/bin/mmapplypolicy --event lowDiskSpace --parms “%fsName -B 20000 -m <2x the number of drives> --single-instance” 

For more information, see the following publications: 

GLYPH<SM590000> IBM Spectrum Scale: Administration and Programming Reference Guide : 

https://www.ibm.com/support/knowledgecenter/STXKQY 

GLYPH<SM590000> Tivoli Field Guide - TSM for Space Management for UNIX-GPFS Integration  white paper: 

https://www.ibm.com/support/docview.wss?uid=swg27028178 

After the file system is configured to be managed by IBM Spectrum Archive EE and the migration callback is configured, a policy can be set up for the file system. The placement policy that defines the initial placement of newly created files and the rules for placement of restored data must be installed into IBM Spectrum Scale by using the mmchpolicy  command. If an IBM Spectrum Scale file system does not have a placement policy installed, all the data is stored in the system storage pool. 

