How to Migrate One Service/Policy using GMU

Products

• CA API Gateway

Issue/Introduction

This KB article outlines how to migrate one service from a source gateway to a target gateway using GMU.

Two scenarios are outlined:

1. The service does not exist on the target gateway
2. The service does exist on the target gateway

In this example, a service called Echo Test will be migrated from a source gateway to a target gateway .

Environment

API Gateway 10.X

Resolution

SCENARIO 1: The policy DOES NOT exist on the target gateway

 

MIGRATE OUT (update the blue text)

./GatewayMigrationUtility.sh migrateOut --argFile SourceCommon.properties --dest SERVICE_NAME.xml --serviceName SERVICE_NAME –trustHostname

Example: ./GatewayMigrationUtility.sh migrateOut --argFile SourceCommon.properties --dest echo_test.xml --serviceName 'Echo Test' --trustHostname

 

MIGRATE IN – TEST (update the blue text)

./GatewayMigrationUtility.sh migrateIn --argFile TargetCommon.properties --bundle SERVICE_NAME.xml --results results.xml --test –trustHostname

Example: ./GatewayMigrationUtility.sh migrateIn --argFile TargetCommon.properties --bundle echo_test.xml --results results.xml --test --trustHostname

 

MIGRATE IN (update the blue text)

./GatewayMigrationUtility.sh migrateIn --argFile TargetCommon.properties --bundle SERVICE_NAME.xml --results results.xml –trustHostname

Example: ./GatewayMigrationUtility.sh migrateIn --argFile TargetCommon.properties --bundle echo_test.xml --results results.xml --trustHostname

 

SCENARIO 2: The policy DOES exist on the target gateway

 

MIGRATE OUT (update the blue text)

./GatewayMigrationUtility.sh migrateOut --argFile SourceCommon.properties --dest SERVICE_NAME.xml --serviceName SERVICE_NAME –trustHostname

Example: ./GatewayMigrationUtility.sh migrateOut --argFile SourceCommon.properties --dest echo_test.xml --serviceName 'Echo Test' --trustHostname

 

MANAGE MAPPINGS (update the blue text)

./GatewayMigrationUtility.sh manageMappings --bundle SERVICE_NAME.xml --type SERVICE --srcName SERVICE_NAME --targetName 'SERVICE_NAME' --action NewOrUpdate

Example: ./GatewayMigrationUtility.sh manageMappings --bundle echo_test.xml --type SERVICE --srcName 'Echo Test' --targetName 'Echo Test' --action NewOrUpdate

 

MIGRATE IN – TEST (update the blue text)

./GatewayMigrationUtility.sh migrateIn --argFile TargetCommon.properties --bundle SERVICE_NAME.xml --results results.xml --test –trustHostname

Example: ./GatewayMigrationUtility.sh migrateIn --argFile TargetCommon.properties --bundle echo_test.xml --results results.xml --test --trustHostname

 

MIGRATE IN (update the blue text)

./GatewayMigrationUtility.sh migrateIn --argFile TargetCommon.properties --bundle SERVICE_NAME.xml --results results.xml –trustHostname

Example: ./GatewayMigrationUtility.sh migrateIn --argFile TargetCommon.properties --bundle echo_test.xml --results results.xml --trustHostname

 

Additional Information

The same process can be used for migrating one policy.