Coexistence: Preserve or migrate a Version 5.1 gateway

Web services gateways running on WebSphere Application Server Version 5.1 can, subject to certain restrictions, coexist with gateway instances running on Version 7.0 or later application servers. Alternatively, we can migrate the Version 5.1 gateways and application servers to WAS v7 or later. To help you choose whether to preserve or migrate the Version 5.1 gateways, this topic explains the restrictions to gateway coexistence and the approach taken to gateway migration.

WebSphere Application Server Version 5.0 is no longer supported, so you should migrate any existing gateways that are running in Version 5.0 application servers to run on application servers at the current level of the product.


Coexistence with Version 5.1 gateways

Version 5.1 web services gateways can coexist with Version 7.0 or later gateways, subject to the following restrictions:

If the deployment is not affected by these restrictions, and the Version 5.1 gateways are running on stand-alone Version 5.1 application servers, then we need take no further action.

If the deployment is not affected by these restrictions, and the Version 5.1 gateways are running on Version 5.1 application servers that are part of WAS Network Deployment cells, we can continue to use the Version 5.1 gateways and application servers even if you migrate the cells from Version 5.1 or Version 6 to Version 7.0 or later. However, when you migrate a cell any previously-configured Version 5.1 gateway on an application server in the cell is replaced with an empty gateway. To preserve and restore the Version 5.1 gateway configurations, first follow the steps given in Preserve a Version 5.1 gateway when migrating a cell.


Migration of Version 5.1 gateways

We can migrate a Version 5.1 gateway running in a Version 5.1 application server to a Version 7.0 or later gateway running in a Version 7.0 or later application server. To do this you export the Version 5.1 gateway configuration, then run a script to migrate the exported configuration into a new gateway instance in an existing Version 7.0 or later application server. The detailed steps for this task are given in Migrate a Version 5.1 web services gateway configuration. The key rules underlying the migration process are as follows: