migrate_eda_data

Allows you to bulk migrate EDA data to the current data model. Run this utility to manually perform a bulk EDA migration. This utility runs automatically when you upgrade from a previous database to a more recent data model and select Teamcenter EDA Server Support as part of the upgrade. Note The migration process assumes the data does not contain variants. Syntax migrate_eda_data [-u=user-id {-p=password | -pf=password-file} -g=group] [-dryrun] [-ccaSelectFile=path-name] [-migrationList=path-name] [-logFile=path-name] [-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. -dryrun Performs a dry run of the migration, making no changes to the database. Use this argument to identify problematic data prior to migration. -ccaSelectFile Specifies the input file containing the list of items to select when a schematic is identified as being related to multiple CCA item objects. The utility uses this information to migrate EDA schematic data to one of x number of CCA item objects related to it. The file format is: Copy Schematic-Item-ID, CCA-Item-ID Schematic-Item-ID2, CCA-Item-ID2 ... Note Inconsistencies in the file are logged as errors. Erroneous entries are skipped during migration. -migrationList Specifies the input file containing the list of items to migrate. If this argument is not provided, all EDASchem item objects are migrated. The file format is: Copy Schematic-Item-ID Schematic-Item-ID2 Schematic-Item-ID3 ... Note Inconsistencies in the file are logged as errors. Possible errors include, but are not limited to: item IDs of non-EDASchem item objects, duplicate entries, and invalid item IDs. Erroneous entries are skipped during migration. -logFile Specifies the location of the migration log file. If this argument is not specified, the default location is TEMP\program-name_date-time.log. -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. The log file is generated in the user's TEMP directory. The file name format is migrate_eda_data-date-time.log. Restrictions None. Examples To manually perform a bulk migrate of EDA data from a previous database to a more recent data model: Copy migrate_eda_data -u=Tc-admin-user -p=password -g=group To perform a dry run of the EDA data bulk migration: Copy migrate_eda_data -u=Tc-admin-user -p=password -g=group -dryrun To perform a dry run of the EDA data bulk migration using the selectionFile.txt CCA selection file: Copy migrate_eda_data -dryrun -u=Tc-admin-user -p=password -g=group -ccaSelectFile=D:\migration\selectionFile.txt To perform a dry run of the EDA data bulk migration using the selectionFile.txt CCA selection file and the edaSchemList.txt migration list: Copy migrate_eda_data -u=Tc-admin-user -p=password -g=group -dryrun -ccaSelectFile=D:\migration\selectionFile.txt -migrationList=D:\migration\edaSchemList.txt To bulk migrate the EDA data specified in the selectionFile.txtmigration list: Copy migrate_eda_data -u=Tc-admin-user -p=password -g=group -ccaSelectFile=D:\migration\selectionFile.txt -migrationList=D:\migration\edaSchemList.txt To bulk migrate the EDA data specified in the selectionFile.txt CCA selection file: Copy migrate_eda_data -u=Tc-admin-user -p=password -g=group-ccaSelectFile=D:\migration\selectionFile.txt To bulk migrate the EDA data specified in the selectionFile.txt CCA selection file, with the migration information sent to the migration_output.log log file: Copy migrate_eda_data -u=Tc-admin-user -p=password -g=group -ccaSelectFile=D:\migration\selectionFile.txt -logFile=D:\migration\migration_output.log