Export command for InfoSphere FastTrack assets
Use the istool export command with the -fasttrack parameter to export InfoSphere® FastTrack to an archive file.
Purpose
You export assets into a file that can be imported into 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 assets to a newer version of InfoSphere Information Server.
To export all assets of all types, see Moving all assets from one repository to another.
Prerequisites
You must have the FastTrack Administrator role.
You must run the command on a computer on the client tier where InfoSphere FastTrack is installed.
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 values in the syntax are enclosed in brackets, [ ].
export
authentication parameters
[generic parameters]
-archive "file_name_and_path"
[-maxArchiveSize number_of_megabytes]
[-updatearchive]
[-abortIfError number_of_errors]
[-preview] | [-responseFile "file_name_and_path"]
-fasttrack 'asset_IDs
[-includeGenerationHistory]
[-includeReports]
[-includeCommonMetadata]
[-includeDataStageAssets]
[-includeDependent]
[-includeProjectRoleAssignments]
'
[-cm 'common_metadata-options']
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 "file_name_and_path"
- Required. Specifies the .isx file that the assets are exported to.
- -maxArchiveSize | -mas number_of_megabytes
- For enhanced export and import performance, creates additional archive files when the size of the export file exceeds the specified number of megabytes. For example, if you specify 500 and the total size of the export is 1,300 MB, two additional archive files are created with numeric suffixes added to their names. For import, specifying the first archive file imports all. For more information, see common parameters.
- -updatearchive | -up
- Adds the exported assets to the archive file if the file exists. If you do not specify -updatearchive, the content of the existing archive file is overwritten.
- -abortIfError | -abort number_of_errors
- Stops the export after the specified number of errors.
- -preview | -pre
- Previews the export. The preview lists the assets that are exported when the export runs.
- -responseFile | -rf "file_name_and_path"
- Specifies the name and path of a response file that contains assets that failed to export during a run of a previous istool export -ft command. Not supported with the -preview parameter. For more information, see Using a response file for istool export and istool import commands.
- -fasttrack | -ft 'asset_IDs options'
- Required. Specifies that InfoSphere FastTrack assets are exported.
- You can specify one or more asset IDs.
- If you specify a project, all of the contained mapping specifications, mapping components, and mapping compositions are also selected and written to the archive. If the project is defined based on a project template, the template is automatically included.
- You can use the following options:
- -includeGenerationHistory | -incGen
- Includes generation history.
- -includeReports | -incRep
- Includes related reports in the exported archive.
- -includeCommonMetadata | -inccm
- Includes all related common metadata for the project names that are specified in the exported archive. If you use -includeCommonMetadata, you can add the -cm parameter with common metadata options between single quotes to export assets that are related to the exported common metadata. For more information on common metadata options, see Export common metadata.
- -includeDataStageAssets | -incDS
- Includes related InfoSphere DataStage® and QualityStage® shared containers in the exported archive. To transfer jobs, use the InfoSphere DataStage istool commands.
- -includeProjectRoleAssignments | -incRole
- Includes InfoSphere FastTrack role assignments in the exported archive.
- -includeDependent | -incDep
- Includes all types of referenced assets in the exported archive.
Examples
The following example exports all InfoSphere FastTrack projects, creating multiple archive files if the export size exceeds 500 megabytes.
export -u admin -p admin100 -dom KILIMANJARO
-ar ft_archive1.isx -maxArchiveSize 500 -fasttrack '*.ftp'
export -u admin -p admin100 -dom KILIMANJARO -ar ft_archive1.isx
-fasttrack '*.ftp -incDep'
The following example exports all projects, all dependent assets, all related common metadata, and any annotations for the related common metadata.
export -u admin -p admin100 -dom KILIMANJARO -ar ft_archive1.isx
-fasttrack '*.ftp -incDep -incCM' -cm '-includeAnnotation'
Exit status
- Exit status = 0
- The package was built successfully.
- Values greater than 0
- An error occurred.