Scenario 3: Upgrading ITX, ITXA, and Sterling B2B Integrator

In this scenario, WebSphere® Transformation Extender is upgraded to ITX, SPE is upgraded to ITXA, and Sterling B2B Integrator is upgraded.

CAUTION:

If you update your ITXA and ITX product versions and are invoking ITXA through Sterling B2B Integrator, your compiled maps and your ITX and ITXA runtime components must be at the same version. ITX runtime components are backward compatible only. They do not work with newer version maps.

It is possible to have two versions of WebSphere Transformation Extender/ITX and SPE/ITXA installed on a single server. It is recommended to keep the installed components in separate directories.

Requirement: ITXA V10.0.1.8 requires ITX V10.1 or higher and Sterling B2B Integrator V6.1.1 or higher

Upgrade WebSphere Transformation Extender to ITX V10.1 or higher.

If the ITX installation directory changed, comment out the existing WebSphere Transformation Extender VENDOR_JAR entries in b2bi_install_dir/properties/dynamicclasspath.cfg
Upgrade SPE to ITXA V10.0.1.5 or higher.
Upgrade your Sterling B2B Integrator installation as required.
If the ITXA installation directory has changed, comment out the existing SPE VENDOR_JAR entries in b2bi_install_dir/properties/dynamicclasspath.cfg
Compile compliance and transformation maps with the new version of ITX.
Load the new compiled maps into the Sterling B2B Integrator map repository.

Edit the following properties in b2bi_install_dir/properties/sandbox.cfg:

# set this value to where SPE is installed.
SPE_INSTALL_DIR=/full_pathname_to_spe2
# present only if WTX is installed. 						
WTX_INSTALL_DIR=/full_pathname_to_WTX-DTX
# port that the SPE user interface uses.					
SPE_UI_PORT=port_number 													
# set by installService, this port must be referenced in the SPE customer_overrides.properties file
REST_HTTP_SERVER_PORT=13060

Note: The httpPort value in /tpuiserver/usr/servers/defaultServer/server.xml defaults to 9080.

In b2bi_install_dir/properties/sandbox.cfg, note these values for later use:
- The IP address of the machine where Sterling B2B Integrator, ITX, and ITXA are installed:
```
EXT_HOST_ADDR=ipaddress
```
- The port on which the RESTAPI web application in Sterling B2B Integrator listens:
```
REST_HTTP_SERVER_PORT=portnumber
```

If you are upgrading ITX or ITXA and you are changing either the spe_install_dir and wtx_install_dir files to point to different locations, you must edit the b2bi_install_dir/properties/dynamicclasspath.cfg file to comment out these existing entries for the ITX and ITXA jars:

#VENDOR_JAR=/path/to/spe/jars/log4j-1.2-api-2.17.1.jar
#VENDOR_JAR=/path/to/spe/jars/10x-core-2.3.0.15.jar
#VENDOR_JAR=/path/to/spe/jars/commons-codec-1.13.jar
#VENDOR_JAR=/path/to/spe/jars/event-publisher-sdk-2.0.3.jar
#VENDOR_JAR=/path/to/spe/jars/gson-2.2.4.jar
#VENDOR_JAR=/path/to/spe/jars/icu4j-55.1.jar
#VENDOR_JAR=/path/to/spe/jars/jt400.jar
#VENDOR_JAR=/path/to/spe/jars/openjpa-all-2.4.0.jar
#VENDOR_JAR=/path/to/spe/jars/spe-10.0-core.jar
#VENDOR_JAR=/path/to/spe/jars/spe-10.0-standardsbase.jar
#VENDOR_JAR=/path/to/spe/jars/translator.jar
#VENDOR_JAR=/path/to/spe/jars/derbyclient.jar
#VENDOR_JAR=/path/to/spe/jars/jval2021.jar
#VENDOR_JAR=/path/to/spe/jars/spe-10.0-edifact.jar
#VENDOR_JAR=/path/to/spe/jars/spe-10.0-rnd.jar
#VENDOR_JAR=/path/to/spe/jars/spe-10.0-swift.jar
#VENDOR_JAR=/path/to/spe/jars/spe-10.0-tradacoms.jar
#VENDOR_JAR=/path/to/spe/jars/spe-10.0-x12.jar
#VENDOR_JAR=/path/to/wtx/WTX-DTX/libs/dtxpi.jar
#VENDOR_JAR=/path/to/wtx/WTX-DTX/libs/m4spe.jar
#VENDOR_JAR=/path/to/wtx/WTX-DTX/libs/xds4j.jar

In the ITXA customer_overrides.properties file, uncomment (but do not edit) the following lines if necessary.

HostApplication.name=SBI
HostApplication.migrationStylesheet=ie_si_to_spe_hosted
HostApplication.driverName=InvokeSIBP
HostApplication.driverClass=com.ibm.spe.core.drivers.DriverInvokeSIBusinessProcess
# the port should be set to the value of the REST_HTTP_SERVER_PORT in sandbox.cfg above.
# the ip address is that of the SBI install which should be installed on same machine as SPE.
HostApplication.restURL=https://server:13060port/restwar/restapi/v1.0

Update your Trading Partner UI configuration in tpuiserver/usr/servers/defaultServer/server.xml.
Use the Sterling B2B Integrator InstallService to install the b2bi4spe.jar file.
Verify your installation as described in Scenario 1: Installing ITXA and Sterling B2B Integrator as a new installation.