migrate_wf_attachments

Transforms workflow process attachments from VLA to GRM relationships. Active processes are normally migrated during the upgrade from versions prior to Teamcenter 11.2. If you want completed processes to be migrated, run this utility manually after upgrade. This utility slows down as it loads processes in memory, so you can control the number of migrations by limiting the size of the batch per process with the -batch_size argument. When the original process has reached the specified batch size, it starts another process and then terminates itself. The subprocess continues where its parent process left off and then when it reaches its own batch size, it creates another subprocess and so on. You can limit the number of processes running concurrently to improve performance with the -num_procs argument . Syntax migrate_wf_attachments [-u=user-id {-p=password | -pf=password-file} -g=group-name] [-process=active | completed | all] [-report] [-batch_size=number-to-upgrade] [-num_procs=number-to-run-concurrently] [-h] Arguments Entries in parentheses are accepted abbreviations for 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 user's password. If used without a value or if neither the -pf nor the -p argument is used, the system displays an error and asks for a username and password interactively. This argument is mutually exclusive with the -pf argument. -pf Specifies the password file. If used without a value or if neither the -pf nor the -p argument is used, the system displays an error and asks for a username and password interactively. 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. -process (Optional) Specifies if the attachments in active, completed, or all workflow processes are to be migrated. The allowed values are: active completed all If this argument is not specified, all processes are migrated. -report (Optional) Lists the workflow processes whose attachments it would have migrated, but makes no changes. -batch_size (Optional) Specifies the number of workflow processes to migrate per batch. If this argument is not specified, it migrates 250 per batch. -num_procs (Optional) Specifies the number of child processes to run concurrently if the number of processes is greater than the batch size. If this argument is not specified, it runs 4 child processes concurrently. -h Displays help for this utility. Environment As specified in Setting up a Teamcenter command-line environment. Files As specified in Log files produced by Teamcenter. Restrictions None. Examples The following example migrates the VLA-based attachments to GRM relations of all completed workflow processes. Copy migrate_wf_attachments -u=Tc-admin-user -p=password -g=group -process=completed Related Topics Workflow Designer on Rich Client