admin_data_import

Imports administration data from the specified input package into the current Teamcenter environment. (To create a site package file, export administration data.) A conflict occurs when the data exists at both the exporting and importing sites but does not contain the same values at both. For each administration data type, you can specify how conflicting data is handled during import. The utility allows you to generate an import report without executing the actual import, referred to as a dry run. You can use the import report (dry run) to analyze how the input package potentially impacts the current environment. For an actual import, the utility adds a report to an import history report that contains a record of all the previous imports performed at the current environment. You can use this report to analyze how administrative data has changed over time at the importing site due to prior imports. Import reports (dry run and actual) are located in the TC_ROOT\logs\import_history directory. Caution If you have an input file with Access Manager data from older Teamcenter releases (earlier than Teamcenter 13.1), ensure that the input file is regenerated with a minimum Teamcenter 13.1 version before importing. Syntax admin_data_import -u=user-ID {-p=password | -pf=password-file} -g=group -inputPackage=input-file-name-and-path -adminDataTypes=admin-data-type1,admin-data-type2, ... | all -mergeOption=admin-data-type1,merge-option1:admin-data-type2,merge-option2, ... [-dryrun] [-skipPackageValidation] [-listTypes] [-listMergeOptions] [-h] Arguments -u Specifies the user ID. The user must have administrative privileges. 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 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. -inputPackage Specifies the fully qualified path to the location for the file to import. -adminDataTypes Specifies a comma separated list of administration data types you want to import. You can also specify the all value to import all data types in the input package. Tip Use the -listTypes argument to display a list of allowable administration data types. -mergeOption Indicates how the utility handles data conflicts (merge options) between the target (importing) site administration data and the source (exporting) site data in the input package. Tip Use the -listMergeOptions argument to display a list of allowable merge options for each administration data type the import file contains. -dryrun Generates an import history report that shows the impact on the importing site's administration data without actually importing the data. -skipPackageValidation Specifies the import file is not validated for proper content prior to importing the package. If you do not specify this argument, the utility ensures the data in the import file is valid and fails the import if it is not. -listTypes Displays the supported administration data types that can be imported from the input package. -listMergeOptions Lists the supported merge options configured for the available administration data types in the import file. You must specify the -inputPackage argument to point to the import file. The merge options are: override_with_source Replaces the target site administration data with the source site administration data. keep_target Keeps the existing administration data at the importing site when there are merge conflicts. choose_latest Replaces the conflicting administration data with the latest administration data based on time stamp. choose_target_for_unresolvable_conflicts Keeps the existing administration data at the importing site for nontrivial or unresolvable merge conflicts. For all other merge conflicts, uses the latest administration data based on time stamp. session_options Indicates session options that you want the utility to use for the current command. Accepts valid session options in a comma delimited format. If you supply the opt_traverse_ref_org in this argument value, the utility traverses the organization data. Otherwise its value is passed as true (default behavior). Caution You must export/import organization objects (such as users and groups) before importing other objects. Otherwise the import of other objects fails. -h Displays the help for this utility. Environment As specified in Manually configure the Teamcenter environment. Files As specified in Log files produced by Teamcenter. Examples Imports administration data from the specified input package into the current Teamcenter environment: Copy admin_data_import -u=admin-username -p=admin-password -g=dba -adminDataTypes=all -inputPackage=C:\temp\admin_data\siteB\siteB.zip Performs a dry run import from the specified input package with merge options: Copy admin_data_import -u=admin-username -p=admin-password -g=dba -dryrun -adminDataTypes=all -inputPackage=C:\temp\admin_data\siteB\siteB.zip
-mergeOption=AccessManager:override_with_source,Organization: override_with_source,Preferences:choose_latest, RevisionRules:choose_target_for_unresolvable_conflicts,SavedQueries:keep_target, Stylesheets:keep_target, Subscriptions:keep_target,WorkflowTemplates:override_with_source Related Topics TC XML and PLM XML Configuration for Data Import and Export Multi-Site Collaboration