upgrade_variants

Use the upgrade_variants utility to upgrade an existing Teamcenter system to the new variant model. It allows you to: Migrate the variants for one program (product item) at a time or migrate the entire database. Migrate only selected variant conditions and named variant expressions. Migrate the design structure or the architecture structure. Perform a dry run to validate data integrity before migrating production data. Generate a report on all named variant expressions that were migrated. Syntax upgrade_variants [-u=user-id -p=password | -pf=password-file -g=group] -product_code=product code -ves_list_file=variant expression uid list file -top_arch_id=top level architecture item -full_database=yes | no -lou_holder_id=item id of lou holder -file_path=path name -dry_run=yes | no [-long] -report_delete_failures=yes | no [-force] -delete_unreferenced_ves_only=yes | no -delete_tree=yes | no -bulk_delete=yes | no [-parallel] [-h] Arguments Note 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 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. This argument is mutually exclusive with the -pf argument. -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. -product_code Specifies the product code from the product definition form. -ves_list_file Specifies a text file containing the UIDs of the variant expressions to migrate. -top_arch_id Specifies the item ID of the top level assembly breakdown structure. The named variant expressions for the architecture breakdown are migrated. -full_database Specify yes to migrate all the variant conditions and NVEs in the entire database or no to migrate selected data. The default is no. -lou_holder_id Specifies the item ID of the LOU holder item. The variant conditions for the LOUs under this LOU holder are migrated. -file_path Specifies the path where the migration report should be stored. If no path is specified, the report is stored in the path identified in the TC_TEMP_DIR environment variable. -dry_run If specified as yes, the utility performs a dry run. A dry run does not migrate the variant expressions but generate a migration report. You must specifically set this argument to no if you do not want to perform a dry run. -long Optionally used when you perform a dry run. If specified, the utility outputs UIDs in addition to the variant expression text and named variant expression names. -report_delete_failures If specified as yes, reports failures encountered while deleting the variant expressions that are not successfully migrated. The default value is no. -force Optionally forces conversion of all variant expressions to the new variant model. -delete_unreferenced_ves_only Optionally deletes unreferenced variant expressions from the database. The default value is no. -delete_tree Optionally skips deletion of payload trees. The default value is no. -bulk_delete Optionally performs a bulk deletion of all unreferenced variant expressions. The default value is no. -parallel Optionally specifies a parallel variant model upgrade session when a session is already in progress. -h Displays help for this utility. Environment This utility should be run in a shell where the Teamcenter environment is set up. Files A report file is generated in the specified location. Restrictions None. Examples To migrate only the assembly structure: Copy upgrade_variants -u=Tc-admin-user -p=password -g=group -product_code=PLM00001 -file_path=c:\report.txt -dry_run=no To migrate the assembly structure and architecture breakdown (NVEs and LOUs): Copy upgrade_variants -u=Tc-admin-user -p=password -g=group -product_code=PLM00001 -top_arch_id=PLM0002 -lou_holder_id=PLM00003 -file_path=c:\report.txt -dry_run=no To migrate only LOUs in the assembly breakdown: Copy upgrade_variants -u=Tc-admin-user -p=password -g=group -lou_holder_id =GMO00003 -file_path=c:\report.txt -dry_run=no To create a variant expressions list file: Copy upgrade_variants -u=Tc-admin-user -p=password -g=group -ves_list_file=c:\vesList.txt -file_path=c:\report.txt -dry_run=no To perform a dry run of a full database migration: Copy upgrade_variants -u=Tc-admin-user -p=password -g=group -full_database=yes -file_path=c:\report.txt -dry_run=yes Related Topics Structure Management on Rich Client ─ Usage