Export command for InfoSphere Streams assets

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.

Any custom attributes that you have created for InfoSphere Streams endpoints are exported with the endpoints.

To export all assets of all types, see Moving all assets from one metadata repository to another.

Prerequisites

You must have the Common Metadata User role.

You must run the command on a client tier computer.

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 to 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"] 
-streamsEndpoint  '-endPoints endpoints'

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 -streams command. Not supported with the -preview parameter. For more information, see Using a response file for istool export and istool import commands.

-streamsEndpoint | -streams

Required. Specifies that InfoSphere Streams endpoints are exported. The following option is required:

'-endPoints | -ep endpoints'

Specify the value of endpoints in one of the following ways:

• Specify a single asterisk (*) to export all endpoints.
• Specify both the specific scope and name of the endpoints in the form scope/name. You can use wildcards for both scope and name. Only endpoints that have an application scope are exported.
• Specify the name of an endpoint to export. You can use wildcards anywhere in the name string. Only endpoints that do not have an application scope are returned.

Exit status

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

Example

istool> export -domain ISDOMAIN:9443 -archive c:\temp\ep.isx 
-username dsadm -password **** -streams '-ep *'

istool> export -domain ISDOMAIN:9443 -archive c:\temp\ep.isx 
-username dsadm -password **** -streams '-ep */Send*'

istool> export -domain ISDOMAIN:9443 -archive c:\temp\ep.isx 
-username dsadm -password **** -streams '-ep Send*'