Manual recovery of Transparent cloud tiering database

Transparent cloud tiering uses a database called "cloud directory" to store a list and versions of files that are migrated to the cloud. Any issues in this database might lead to undesired results. If the database is corrupted or has been accidentally deleted, you can reconstruct it from automatic backups of this database that are kept on the cloud.

You need to perform a recovery of the database when Transparent cloud tiering produces any of the following messages in the logs:
  • The cloud directory database for file system /dev/gpfs0 could not be found. Manual recovery is necessary.
  • The directory service for file system /dev/gpfs0 is not ready for use. Manual recovery is necessary.
  • The cloud directory database for file system /dev/gpfs0 is corrupted. Manual recovery is necessary.
To perform a manual recovery, issue a command according to this syntax:
mmcloudgateway files rebuildDB --container-pair-set-name ContainerPairSetName Device

where,

filesystem is the device name of the file system whose database is corrupted and which is in need of manual recovery.

--container-pair-set-name is the name of the container associated with the file system or fileset.

For example, if you want to recover the database associated with the file system, /dev/gpfs0 and the container, container-1, issue this command:
mmcloudgateway files rebuildDB --container-pair-set container-1 /dev/gpfs0
The system displays output similar to this:
mmcloudgateway: Command completed.
Note: It is important that background maintenance be disabled when running this command. For more information, see Planning for maintenance activities.