unmigrate_from_hsm

Reverses migration of the existing Teamcenter volume files objects from the purview of hierarchical storage management (HSM) by removing the hsm_info object associated with file objects from the database. Use this utility for the following situations: Encountering errors while migrating files to HSM. Maintenance requirement to remove a specific volume from purview of HSM. Remove all volumes from the purview of HSM. After the execution of this utility completes, all physical volume files must be brought back to a primary tier in the event it has already migrated by third-party HSM software to secondary or tertiary tier. Siemens Digital Industries Software recommends sites execute this utility on a specific volume when no other users are accessing Teamcenter, especially during maintenance or upgrades. This utility can take considerable time to reverse migrate all files from the purview of HSM. Syntax unmigrate_from_hsm [-u=user-id {-p=password | -pf=password-file} -g=group] [-listvolumes] [-volume= ALL | volume-name] [-v] [-h] Arguments -u Specifies the user ID. This is a user with Teamcenter administration privileges. Note If Security Services single sign-on (SSO) is enabled for your server, the -u and -p arguments are authenticated externally through SSO rather than being authenticated against the Teamcenter database. If you do not supply these arguments, the utility attempts to join an existing SSO session. If no session is found, you are prompted to enter a user ID and password. -p Specifies the password. -pf Specifies the password file. For more information about managing password files, see Manage password files. This argument is mutually exclusive with the -p argument. -g Specifies the group associated with the user. If used without a value, the user's default group is assumed. -listvolumes List all volumes defined for the database. -volume Specifies particular volume to unmigrate. The system administrator can specify volume=ALL to unmigrate all volumes from the purview of HSM. -v Verbose mode. Provides information about results and progress. -h Displays help for this utility. Environment The generic command window set with all Teamcenter-related environments. As specified in Setting up a Teamcenter command-line environment. Files As specified in Log files produced by Teamcenter. Restrictions This utility is intended only for system-level users. Return Values Return value upon success 0 Return value upon failure 1 Examples To unmigrate all volumes defined for the database: Copy unmigrate_from_hsm -u=admin-user -p=admin-password -g=dba -volume=ALL -v To unmigrate a specific volume: Copy unmigrate_from_hsm -u=admin-user -p=admin-password -g=dba -volume=volume_name To list volumes names defined for a database: Copy unmigrate_from_hsm -u=admin-user -p=admin-password -g=dba -listvolumes Related Topics Introduction to administering volumes