Migrating Mediator to API Gateway
API Gateway supports the migration of Mediator 9.7 and later; the earlier versions of Mediator should be migrated first.
Migrating Mediator Deployments to API Gateway
Existing Mediator deployments can be migrated to API Gateway by publishing the virtual service, applications, and runtime aliases to API Gateway. This lets you build an API Gateway runtime enforcement landscape in parallel to the existing Mediator landscape.
To migrate the existing Mediator deployments, perform the following procedure:
![*](chapterTOC_bullet.png)
For all installed Mediators:
1. Stop Mediator.
2. Install corresponding API Gateway.
3. Migrate Mediator configuration to API Gateway.
![*](chapterTOC_bullet.png)
For all
Mediator targets configured in
CentraSite:
1. Configure a corresponding API Gateway in CentraSite.
2. Deploy all virtual services from the Mediator target to the corresponding API Gateway.
3. (Optional) Undeploy all virtual services from the Mediator target.
Note:
The procedure assumes that the Mediators and the corresponding API Gateway provide the same endpoints. Therefore either the Mediator or its corresponding API Gateway can be up and running. If the endpoint compatibility is not required it is not necessary to stop the Mediators. Also the undeploying the Mediator deployments is optional. This means Mediator and API Gateway can be driven by CentraSite in parallel.
Migrating Mediator Configurations to API Gateway
To migrate existing Mediator configurations to API Gateway, perform the following procedure:
1. Run IS migration using the IS migration tool.
For details of the IS migration tool, see Upgrading Software AG Products.
2. Run Mediator migration using the API Gateway migration tool.
The API Gateway migration tool is available within the IS instance running the API Gateway. If API Gateway is running in the default IS instance the tool is available in the folder: Install-Dir\IntegrationServer\instances\default\packages\WmAPIGateway\bin\migrate.
The script migrateFromMediator[.sh|.bat] has two parameters:
![*](chapterTOC_bullet.png)
Full path to Integration service installation running the
Mediator to be migrated. (for example, E:\SoftwareAG\IntegrationServer)
![*](chapterTOC_bullet.png)
Name of the instance that is running the
Mediator. (for example, default)
On Unix the script can be invoked as follows:
./migrateFromMediator.sh /opt/softwareag/IntegrationServer default
On Windows the script can be invoked as follows:
migrateFromMediator.bat C:\SoftwareAG\IntegrationServer default
3. Start API Gateway.
The Mediator configuration migration covers the following configuration items:
![*](chapterTOC_bullet.png)
Elastic Search
![*](chapterTOC_bullet.png)
SNMP
![*](chapterTOC_bullet.png)
Email
![*](chapterTOC_bullet.png)
HTTP Configuration
![*](chapterTOC_bullet.png)
Keystore Configuration
![*](chapterTOC_bullet.png)
Ports Configuration
![*](chapterTOC_bullet.png)
Service Fault
![*](chapterTOC_bullet.png)
Extended Settings
The following configuration items are not automatically migrated. The configuration of these items have to be done manually in API Gateway.
![*](chapterTOC_bullet.png)
Security Token Service (STS) Configuration
apig_rest_service_redirect parameter: When you set this to
true, the apig_rest_service_redirect in the extended Administration setting in
API Gateway REST requests against the /mediator directive will be redirected to the /gateway directive. This means that REST requests can be sent to /mediator and to /gateway.
Note:
The Mediator configuration migration can only be applied to a fresh API Gateway installation once.