tc_customization_compare_report

Analyzes Teamcenter sites and reports BMIDE customizations. This analysis is particularly useful when moving from an earlier on-premises Teamcenter release to a later cloud-based release. Run this utility using the -f=create_package argument on two sites to generate packages of data model and template files. Then, use this utility using the -f=generate_report argument to compare those packages and generate reports of differences as described in Identify and resolve BMIDE customization differences. Syntax tc_customization_compare_report [-u=user-id {-p=password | -pf=password-file} -g=group] -f={create_package -out=output_folder | generate_report -type={bmide | adminData | all} -source=model_path -target=model_dir -sourceVersion=source_ver -targetVersion=target_ver [-skip_added] [-skip_admin]} [-h] Arguments -u Specifies the user ID. Required to use -f with a value of generate_report. 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. This argument is mutually exclusive with the -pf argument. -pf Specifies the password file. For more information about managing password files, see 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. When using -f with a value of generate_report, this is a user who is a member of a group with DBA privileges. If used without a value, the user's default group is assumed. -f Specifies the function to be performed; you must specify one of the following arguments: create_package Generates a package (folder) containing data model and template files used at the current site. Run the utility at both the source and target sites to generate packages for comparison. Specify a value for -out when using create_package. generate_report Compares two packages of data model and template files and generates reports of their differences. -out Specifies the folder in which the generated package (folder) of model and template files is stored. Use with -f=create_package. -type Specifies the report type to generate. A value of bmide generates a report comparing the data models and templates. A value of adminData generates a report comparing the sites' administration data. A value of all (or bmide,adminData generates reports for both types of data. -source Specifies the directory containing the folder containing the package (folder) of files generated from the source site. (This is the earlier version or on-premises site). Use with -f=generate_report. -target Specifies the directory containing the folder containing the package (folder) of files generated from the target site. (This is the later version or cloud-based site). Use with -f=generate_report. -sourceVersion Specifies the version of Teamcenter on the source site. Use with -f=generate_report. Use the form TCrelease. For example, TC2312 and TC2406. When running Teamcenter, select Help > About to verify the version of Teamcenter. -targetVersion Specifies the version of Teamcenter on the target site. Use the same form as described for -sourceVersion. -report_folder Specifies the folder in which the generated report files are saved. Use with -f=generate_report. -skip_added Excludes added entries when generating reports. Use with -f=generate_report. -skip_admin Excludes administration data when generating reports. Use with -f=generate_report. -h Displays help for this utility. Environment This utility works on any Linux or Windows platforms with Perl installed and in the path. Restrictions Use this utility in preparation for using the Multi-Site data_share utility to migrate data between different Teamcenter releases. Examples Run at the current site to generate a package to compare data model and template files. Copy tc_customization_compare_report -f=create_package -type=bmide -out=c:\temp\TC2312 Generate data model and template file comparison reports. Copy tc_customization_compare_report -u=admin-username -p=password -f=generate_report -type=bmide -target=c:\temp\TC2406 -source=c:\temp\TC2312 -report_folder=c:\temp\TcCompare -sourceVersion=TC2312 -targetVersion=TC2406 The comparison report is saved to the c:\temp\TcCompare directory. Related Topics TC XML and PLM XML Configuration for Data Import and Export Multi-Site Collaboration