istool import -all

You can import most types of assets with a single command by using the istool import command with the -all parameter.

Purpose

You can use the -all parameter to import assets into the metadata repository from a different instance of InfoSphere® Information Server. For example, you can export from a development environment and import the file into a production or test environment. You can also migrate the assets to a newer version of InfoSphere Information Server.

By using the -all parameter, you can import all metadata assets except for the following types:

InfoSphere DataStage® and QualityStage® assets, such as projects, jobs, and stages.
InfoSphere Information Governance Catalog categories, terms, information governance rules, and information governance policies.

The following import parameters are automatically included and run when you specify istool import -all:

-replace: If an asset with the same identity exists in the target metadata repository, the existing asset is replaced by or merged with the imported asset, depending on the type of asset. If you do not want to replace existing assets, do not use import -all. Instead, use separate asset import commands for each type of metadata in the archive file.
-allowDuplicates: For common metadata. If duplicate assets exist in the import file, allows them to be imported as separate assets. If the duplicate assets have the same identity as an existing asset in the metadata repository, the existing asset is unchanged by the import, even if you also use the -replace parameter. If you do not want to allow duplicates to be created, do not use import -all. Instead, use separate asset import commands for each type of metadata in the archive file.; For guidance on whether to allow duplicates, see Import settings for InfoSphere Metadata Asset Manager.

Do not separately specify -replace or -allowDuplicates when you use import -all.

Note: Data connections that are imported when you use the -all parameter do not work in the target environment unless the name of the target host system is the same as the name of the source host system. When that is not the case, export only data connections by using the -cm parameter. Import the data connections by using a mapping file to specify the source host name as the current value and the target host name as the new value.

Prerequisites

You must have the required roles to import all the types of assets in the archive file. The Suite Administrator role provides the required roles for importing all supported asset types, with the following exceptions:

Importing InfoSphere Streams assets requires the Common Metadata Importer role.
Importing common metadata assets requires the Common Metadata Administrator role.

You must run istool commands from a computer where the istool framework or required products are installed. If you are transferring assets from InfoSphere FastTrack or InfoSphere Streams, run the command from a client tier computer. See Location of the istool command line.

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 for istool import -all

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

import 
authentication parameters
[generic parameters] 
[-abortAfter number_of_errors]
-archive "file_name_and_path"
–all 
[-preview] | [-responseFile "file_name_and_path]"

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 temporarily increase max heap size, to request help on command syntax, to specify silent or verbose operation, and to use a script to run commands.
-abortAfter | -abort number_of_errors: Stops the import after the specified number of errors.
-archive | -ar file_name_and_path: Required. Specifies the name and path of the .isx file to import assets from.
-all: Required. Specifies that all supported asset types are imported.
-preview | -pre: Previews the import. The preview lists the assets that will be imported when the import runs. The assets are not imported when you run a command with the -preview parameter.
-responseFile | -rf "file_name_and_path": Specifies the name and path of a response file that contains assets that failed to import during a run of a previous istool import -all command. Not supported with the -preview parameter. For more information, see Using a response file with istool export and istool import commands.

Exit status

A return value of 0 indicates successful completion. Any other value indicates failure.

Examples

The following command imports all assets from the file dev_QA.isx.

import –dom ABC:9443 –u user1 –p pass1 -archive "c:\dev_QA.isx" -all

The following command uses the generic parameter -Xmx to set the max heap size to 1024 MB for the duration of the import.

import –dom ABC:9443 –u user1 –p pass1 
-archive "c:\dev_QA.isx" -Xmx1024M -all

The following command imports all assets from three files that were created by using the -maxArchiveSize parameter with the -all parameter in a single export command. The file that was specified for the export was warehouse.isx. Two more files, named warehouse_1.isx and warehouse_2.isx were created by the export when the maximum archive file size was exceeded. When you specify the same file in the import command that was specified in the export command, any additional files that were created during the export are also imported.

import –dom ABC:9443 –u user1 –p pass1 -archive "c:\warehouse.isx" -all