mark_for_migrate

Evaluates any or all active policies to determine if there are any Teamcenter volume files pending for migration, and if found, mark it for migration. Because of performance considerations using the rich client application interface, Siemens Digital Industries Software recommends the system administrator execute this utility to create pending migration file sets. Sites can schedule this utility to execute overnight through a Linux cron job or Microsoft Windows at command. This utility can take considerable time to evaluate all migration policies. Syntax mark_for_migrate [-u=user-id {-p=password | -pf=password-file} -g=group] -migrationpolicy=[ALL | policy-name] [-listpolicies] [-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. -migrationpolicy Evaluates a given migration policy and marks pending files for migration. To evaluate all active migration policies and mark them for migration, specify -migrationpolicy=ALL. -listpolicies List all active policies in chronological order. -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 None. Return Values Return value upon success 0 Return value upon failure 1 Examples Execute the following command to evaluate all policies in the database: Copy mark_for_migrate -u=admin-user -p=admin-password -g=dba -migrationpolicy=ALL Execute the following command to evaluate a specific policy in the database: Copy mark_for_migrate -u=admin-user -p=admin-password -g=dba -migrationpolicy=policy_name Execute the following command to receive a list of all active policies names defined for a database: Copy mark_for_migrate -u=admin-user -p=admin-password -g=dba -listpolicies Related Topics Introduction to administering volumes