IBM App Connect Enterprise, Version 11.0.0.2 Operating Systems: Windows, Linux


mqsiextractcomponents command

Migrate your IBM® Integration Bus Version 10.0 or Version 9.0 integration servers to IBM App Connect Enterprise Version 11.0 by using the mqsiextractcomponents command to extract configuration and resources to Version 11.0 on the same computer or a different computer.

Supported platforms

  • Windows
  • Linux

Purpose

Extract integration server configuration and resources to IBM App Connect Enterprise Version 11.0 from IBM Integration Bus Version 10.0 or Version 9.0.

You must run this command from the later version of the product.

You must have an installation of the product at both target and source versions, with the required component code installed, to issue this command successfully.

You can use this command to extract configuration and resources from your IBM Integration Bus Version 10.0 or Version 9.0 system that is running on any previously supported platform to your IBM App Connect Enterprise Version 11.0 system that is running on Windows or Linux.

Before you start to extract configuration and resources, stop the integration server and all active debug sessions in the IBM App Connect Enterprise Toolkit. You cannot extract message flows that are being debugged.

Usage notes

Ensure that you run the mqsibackupbroker command on the source system and then transfer the backup file that is created to the computer to which you are extracting the configuration and resources.

Syntax

Extract integration server configuration and resources

Read syntax diagramSkip visual syntax diagram
>>-mqsiextractcomponents---------------------------------------->

>-- --source-integration-node --integration_node_name----------->

>-- --backup-file --backup_file_name---------------------------->

>-- --source-integration-server --integration_server_name------->

>-- --target-work-directory --work_directory_path--------------->

>--+----------------------------------------------+------------->
   '- --policy-project-name --policy_project_name-'   

>--+--------------------------+--------------------------------->
   '- --clear-work-directory -'   

>--+------------------------------------------------+----------><
   '- --default-application-name --application_name-'   

Parameters

--source-integration-node integration_node_name

(Required) The name in the backup file of the integration node with which the integration server that you are migrating is associated.

--source-integration-server integration_server_name

(Required) The name in the backup file of the integration server from which you are extracting configuration and resources.

--backup-file backup_file_name

(Required) The file path of the backup file that is created by running the mqsibackupbroker command on the source system prior to running the mqsiextractcomponents on the target system.

--work-directory work_directory_path

(Required) The workpath of the work directory to which the configuration and resources that are extracted from the integration server are written. If the work directory already exists, the mqsiextractcomponents command fails unless you specify --clear-work-directory in which case the configuration and resources are written to the work directory, overwriting any data that might be present in the directory.

--policy-project-name policy_project_name

(Optional) The name of the policy project for all extracted configurable service and resource manager data. Configurable services from the source system are converted to policies on the target system. The policy project resides in the run subfolder in the work directory on the target system.

If you do not specify a value for this parameter, policies are created in a plicy project called DefaultPolicies.

--clear-work-directory

(Optional) Deletes all content from the work directory if it already exists and is not empty on your IBM App Connect Enterprise Version 11.0 system before the mqsiextractcomponents command puts the configuration and resources from the source system there.

default-application application_name

(Optional) This parameter is required if any independent resources are associated with the integration server. This parameter creates a new default application, and all independent resources that are associated with the integration server are moved into it. This new file structure is then saved, so the parameter is required only the first time that the mqsiextractcomponents command is run for each integration server that contains independent resources.

Examples

Enter the command on a single line.

The following example shows extraction of configuration and resources from an IBM Integration Bus Version 10.0 integration server called myIntegrationServer1, which is associated with an integration node called IBNODEV10. The backup file that was created by running the mqsibackupbroker command at IBM Integration Bus Version 10.0 is called V10Backup01072018.zip

mqsiextractcomponents --source-integration-node IBNODEV10 --source-integration-server myIntegrationServer1 --backup-file C:\V10Backup\V10Backup01072018.zip --target-work-directory C:\ACEv11\ACEServ1 --policy-project-name C:\V10Backup\V11PolicyProject

an26200_.htm | Last updated 2018-11-02 14:45:59