import

You can import extended data source and extension mapping documents from a file that is in an ISX format by using the istool import command.

Purpose

With this command, you can import all properties of extended data sources and extension mapping documents except images and collections. Links to relationships with other assets remain even if those assets do not yet exist in the catalog. When the assets are imported into the catalog, the links from the extension mapping document to those assets are established again.

Use this command to import these asset types from IBM® InfoSphere® Metadata Workbench, Versions 8.7.x or 9.1.x, to IBM InfoSphere Information Governance Catalog, Version 11.3.1 and later. You can also use this command to import these asset types from other instances of InfoSphere Information Governance Catalog, or when you want to schedule an import.

When extension mapping documents are migrated by ISX, the identity of the mapping sources and targets is taken from their internal ID on the source system. The internal ID from the source system is preserved in assets when the assets are migrated by using ISX. This internal ID is not preserved in other import or export methods, or if the assets are created independently.

Important: When using ISX migration for extension mapping documents, ALL source and target assets in the mapping rows MUST be migrated by using the ISX method. For details, see this technote.

Prerequisites

You must have the Information Governance Catalog Information Asset Administrator role.

IBM InfoSphere Information Governance Catalog must be installed on the same server as IBM WebSphere® Application Server.

The version of istool command framework must be the same version as InfoSphere Information Governance Catalog.

Run the command from the client tier, or from the engine tier if InfoSphere Information Governance Catalog was installed there.

The preferred way to run this command is in the istool command-line window. If you run this command in your operating system command-line window or in scripts, you must add istool before the command name.

Command syntax

Optional parameters and optional values in the syntax are enclosed in brackets [ ].

import 
authentication_parameters
[generic_parameters] 
-archive path_name_for_import_file
-informationgovernancecatalog | igc
[-replace]

Parameters

authentication parameters: Required. All asset interchange commands use authentication parameters to connect to a specific installation of InfoSphere Information Server.
generic parameters: The generic parameters are available to all asset interchange commands. Use the generic parameters to request help on command syntax, to specify silent or verbose operation, and to use a script to run commands.
-archive | -ar path_name_for_import_file: Specifies the file path and file name of the file to import. You must have read and write access to path_name_for_import_file.isx.
-informationgovernancecatalog | -igc '': Indicates that istool import command is for assets in the catalog of InfoSphere Information Governance Catalog.
-replace | -r: Replaces existing assets in the catalog with the assets that are imported from the ISX file that is used in the -archive command parameter.; If an asset exists in the catalog and the -replace parameter is not used, the import continues and no change is made to the asset in the catalog. A message is displayed for each asset in the catalog that is not replaced.

Examples

The following command imports and updates all assets from an archive file named myARCHIVE.isx:

import –dom localhost –u USER –p PASSWORD –igc '' 
–ar c:\archive\myARCHIVE.isx -r