Importing assets by using the command line

When you run a import on the InfoSphere® Metadata Asset Manager command line, you create a parameters file to contain the import parameters for the bridge or connector that you use.

Before you begin

Before you can save a parameters file for use on the command line, you must create or have access to an import area in InfoSphere Metadata Asset Manager. To save the parameters file, you must have the role of Common Metadata Administrator or you must be the Common Metadata Importer who created the import area.

About this task

When you run an import in InfoSphere Metadata Asset Manager the parameter values that you specify in the import wizard are saved internally.

To run an import on the command line, you create a parameters file that contains the saved parameter values of the staged import. You specify the parameters file on the command line and import the metadata into a new import area by using the command line. The parameter information is specific to the bridge or connector that you used for the original import.

You can edit the parameters file to change or add values.

For security reasons, password values that you entered in the import wizard are not saved. You must enter them manually in the import parameters file.You can encrypt any value by using the Encrypt command.

Procedure

  1. Open an import area and select the Staged Imports tab.
  2. Select the staged import whose parameters you want to save and click More Actions > Save Parameters File.
  3. Download the parameters file and open it in a text editor.
  4. Password values are not automatically saved to the parameters file. Add any necessary password values between the <value> and </value> tags for password parameters.
  5. For connector imports, you can specify data connection credentials either in the parameters file or on the command line, but not in both places. If you specify data connection credentials on the command line, delete the automatically generated value of the data connection user name from the parameters file.
  6. Optional: As necessary, change any other parameter values that are within the value tags.
    Note: The parameter names in the file not always the same as the parameter menu choices that are displayed in the user interface. If you are not sure of the value to specify in the file, run the import again as a managed import. Choose the correct value in the interface, and save the parameters file.
  7. If you want to import a file on your local computer, take one of the following actions:
    Option Description
    If the original import specified a local file Specify the local file path as a command-line option. Do not specify the path in the parameters file.
    If the original import specified a file on the metadata interchange server
    1. Delete the value for the File parameter in the parameters file, by deleting the content between the <value> and </value> tags.
    2. Specify the local file path as a command-line option. Do not specify the path in the parameters file.
  8. When you are ready to run a command-line import, specify the parameters file on the command line and use the import option with the action parameter of the imam command. For information about command-line syntax for the import option, see import option for the imam command.

Results

When the import runs, a new import area is created. The imported metadata is displayed in the import area.

Command-line imports are run as express imports. Depending on your Administration tab settings, the import might be directly shared to the metadata repository or you might be required to preview the import.