Migration

Edit online

  • The migration guidelines given below are applicable for the following releases:
    • IBM Sterling Transformation Extender Runtime Server 10.0.3
    • IBM Sterling Transformation Extender for Red Hat OpenShift 10.1.1
    • IBM Sterling Transformation Extender for Red Hat OpenShift 10.1.2

  • Both container and non-container variants of the Runtime REST API endpoints have been synchronized. The /itx-rs/v1 substring in the endpoints has to be replaced with /tx-rest/v1/itx when invoking V1 REST API endpoints of the Runtime Server. API synchronization allows consistent invocation of REST API endpoints across environments, thereby easing the design, development, testing, deployment, and maintenance of user applications.

  • Swagger 2.0 documentation is no longer provided for REST API endpoints. Only OpenAPI 3.0 documentation is provided for REST API endpoints. By default, deployed map and flow endpoints of V2 REST API are shown to users in the Swagger web UI page if rest.defaultSwagger property is not set to v1.

  • Environment variables that were supported to configure the container deployment are no longer supported. All configuration settings have to be specified through an overridden config.yaml file if the default value is not suitable for your deployed environment. It is mandatory to accept the license for running the product successfully. The environment variable, ITX_RS_LICENSE_ACCEPT, is indirectly set during a Helm install based on the license parameter, which should only be set to true after reading through the license terms and conditions.

  • The default map extension expected by the Runtime Server has been changed from lnx to mmc. Compiled maps with .lnx extension should be renamed to .mmc extension before deploying them to the Runtime Server. If the .lnx extension is still desired, override the rest.mapFileExtension setting from mmc to lnx.

Tip:

Design Server generates multi-platform composite maps. Users may opt to generate multi-platform composite maps in Design Studio, by selecting Windows and Linux platforms under Window > Preferences > Transformation Extender > Map > Build Options panel. Multi-platform composite maps get .mmc extension. You may also change the default extension of the compiled map for a specific platform under Window > Preferences > Transformation Extender > Map > Compiled Map Extensions panel.