IBM Tivoli Storage Manager for Space Management, Version 7.1

Control files in the .SpaceMan directory

When you add space management to your file systems, the Tivoli® Storage Manager for Space Management client creates control files in a hidden directory named .SpaceMan.

Table 1 provides a brief description of the control files and directories in the .SpaceMan directory in each space-managed file system. These files are also in the /etc/adsm/SpaceMan directory that is created when you install the Tivoli Storage Manager for Space Management client.

The HSM client automatically excludes these files from space management. No action on your part isequired to ensure that the files remain on the local file systems. The Tivoli Storage Manager for Space Management client requires these objects for processing. Do not delete or modify the .SpaceMan directory, its contents, or any of the file ownerships and permissions.

Table 1. Control files stored in the .SpaceMan directory
Files Description
ActiveRecallTab This file contains the active recall table.
config/dmiFSGlobalState This file contains global and file system information about the Data Management Application Programming Interface (DMAPI) interface.
config/dmiFSGlobalState.pid This file is a lock file for the dmiFSGlobalState file.
config/DSM.pid This file is a lock file for the DSMNodeSet and DSMSDRVersion files.
config/DSMNodeSet This file stores the HSM configuration.
config/DSMSDRVersion This file stores the number of changes in the HSM configuration.
dmiFSState This file stores information about the file system.
dsmmigfstab If this file exists, it is from an older version of the HSM client. It is needed for transition to current version.
hsmfsconfig.pid This file is a lock file for the local hsmfsconfig.xml file.
hsmfsconfig.xml This file contains the space management settings for the file system.
logdir/ This directory records information during file migration or recall processing. The information is used to complete any interrupted transactions, such as during a system failure.
metadata/ This directory contains the complete file index (CFI) that was created by the scout daemon. The CFI contains file system information.
orphan.stubs This file records the orphan files that were identified during reconciliation.
reserved/ This directory contains reserved files for demand migration.
multiserver/BasicRuleSet This file is a rule set for a file system that is managed by multiple Tivoli Storage Manager servers.
multiserver/serverlist This file contains the list of Tivoli Storage Manager servers that manage the file system.
ruleset This file contains the automatically generated rule set for GPFS™.
SDR/ If this directory exists, it is from an older version of the Tivoli Storage Manager for Space Management client.
status This file records space management statistics for the file system.
tapeOptimizedRecall/ This directory contains the recall list files that optimize tape access.
   

For HSM storage pool support, all files located in the .SpaceMan directory are placed in the same storage pool. EXCLUDE rules prevent other migration rules from moving those files to a different pool.

To ensure that other migration rules do not move files into the .SpaceMan directory, you can specify the following rules:

 RULE 'TSM_EXCL_DOTSPACEMAN' EXCLUDE WHERE PATH_NAME LIKE '%/.SpaceMan/%'

If files were moved to an unwanted location, the following rule moves all files into one storage pool:

 RULE 'TSM_MIGR_DOTSPACEMAN' MIGRATE TO POOL 'target_pool' 
         WHERE PATH_NAME LIKE '%/.SpaceMan/%'

where target_pool might be "system" or the custom default pool if the system pool is dedicated only to metadata.



Feedback