Table of Contents

Search

  1. Preface
  2. Overview of the Server Manager Command Line Interface
  3. Usage Scenario: Using Server Manager CLI Commands to Run Replications
  4. Command Reference

Command Line Interface for the Server Manager

Command Line Interface for the Server Manager

import config

import config

Imports information from an XML configuration file or configuration SQLite database file to the Server Manager Main server to which you are connected. The file can be from the local replication environment or from another replication environment. Use this command to create another configuration instance locally or to migrate a configuration to another Main server environment.
For example, you can import a configuration that you created in a test environment for use in the production environment.

Syntax

You can enter the command with or without parameters. If you run the command without any parameters, the Server Manager CLI prompts you to enter them in interactive mode. If you specify one or more optional parameters in the command, the Server Manager CLI uses these parameter values to update the configuration in non-interactive mode and preserves the values that were last set for the other optional parameters.
To enter the command with its parameters, use the following syntax:
import config
path_to_configuration_file
name=
configuration_name
owner=
user_name
src=
source_server_name
dest=
target_server_name
srcenv=
source_environment_variables_list
destenv=
target_environment_variables_list
[srcconnection=
source_connection
] [destconnection=
target_connection
] [needclean=
need_clean_option
]
The following short form is acceptable:
ic
path_to_configuration_file
name=
configuration_name
owner=
user_name
src=
server_name
dest=
server_name
srcenv=
source_environment_variables_list
destenv=
target_environment_variables_list
[srcconnection=
source_connection
] [destconnection=
target_connection
] [needclean=
need_clean_option
]

Parameters

The following table describes the command parameters:
Parameter
Description
path_to_configuration_file
The full path to the XML configuration file or configuration SQLite database file to import.
If the path includes spaces or special characters, enclose the path value with single quotation marks.
name
The name of the configuration to import.
Configuration names are not case-sensitive. They can contain the digits 0-9, Latin letters A-Z and a-z, and the underscore (_) character. The Server Manager CLI truncates configuration names that are longer than 100 characters.
owner
The name of the Server Manager user to assign as the owner for the configuration.
To set the current connected user as the configuration owner, enter this parameter without a value, as follows:
owner=
src
The name of the source Server Manager instance.
To set the Main Server Manager as the source Server Manager, enter this parameter without a value, as follows:
src=
dest
The name of the target Server Manager instance.
To set the Main Server Manager as the target Server Manager, enter this parameter without a value, as follows:
dest=
srcenv
The name of the environment variables list for the source Server Manager.
To use the system environment variables, enter this parameter without a value, as follows:
srcenv=
destenv
The name of the environment variables list for the target Server Manager.
To use the system environment variables, enter this parameter without a value, as follows:
destenv=
srcconnection
Optional. The name of the source database connection that you want to import into the SQLite database for the configuration. The specified connection must be defined on the source Server Manager instance. This parameter value overrides the default source connection from the imported XML configuration file or configuration SQLite database file.
If you omit this parameter and the configuration file does not contain source connection information, the Server Manager CLI returns an error.
destconnection
Optional. The name of the target database connection that you want to import into the SQLite database for the configuration. The specified connection must be defined on the target Server Manager instance. This parameter value overrides the default target connection from the imported XML configuration file or configuration SQLite database file.
If you omit this parameter and the configuration file does not contain target connection information, the Server Manager CLI returns an error.
needclean
Optional. Indicates whether the Server Manager cleans the configuration file before importing it into the SQLite database. Valid values are:
  • true
  • false

Examples

The following command imports the Ora2Ora_local.xml configuration file from the C:\configs directory on the Main server system as the Ora2Ora configuration. The Ora2Ora configuration is owned by idradmin and uses the Main server as both the source and target Server Manager instance. The Main server uses system environment variables.
import config C:\configs\Ora2Ora_local.xml name=Ora2Ora owner=idradmin src=Main dest=Main srcenv= destenv=
The following command displays a series of prompts to enter the parameters:
ic

0 COMMENTS

We’d like to hear from you!