Installing ITXA for Sterling B2B Integrator: Non-containerized deployment

The procedure for installing ITXA for Sterling B2B Integrator depends upon your current system and whether you want to include design components with the runtime installation.

Note: Further information about installing Sterling B2B Integrator using certified container can be found at https://www.ibm.com/docs/en/b2b-integrator/6.2.0?topic=integrator-installing-sterling-b2b-using-certified-container.

Prerequisite product versions

Integrating ITXA V10.0.1.8 and Sterling B2B Integrator requires the following product versions:

Sterling B2B Integrator V6.1.1 or later
ITXA V10.0.1.5 or higher
ITX V.10.1 or later. Optional if you are not invoking an ITX map. See installation phase 1 below for more information.

Additional requirements for ITXA and Sterling B2B Integrator

ITXA must be installed on the same machine as the Sterling B2B Integrator node that is running the SPE Transformation Service, if that service is to be used.
Sterling B2B Integrator Map Editor requires installation of an IBM® Java™ SDK. See the Sterling B2B Integrator System Requirements (V6.1.1 or later) at https://www.ibm.com/docs/en/b2b-integrator/6.1.1?topic=overview-system-requirements.
Installing the IBM Java SDK can precede or follow installation, but must be done before the map editor is used.
Draft comment:
NOT "1.6 or higher"-- Java 1.7 did not work per user group post 4/2015. B2Bi says that Java 7 SDK is required.
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.

Installation and integration

This outline for integrating ITXA with a new or upgraded Sterling B2B Integrator installation includes references to the detailed procedures. Not all steps are included in detail in the summary; consult the references.

Table 1. Overview of installation steps for an ITXA and Sterling B2B Integrator integration
This table outlines the general steps for integrating ITXA with a new or upgraded Sterling B2B Integrator installation.
Installation phase	Overview of installation phase	Notes® and references to detailed procedures
0.	Plan your installation.	Note: Planning for IBM Transformation Extender installations: ITX installation required if you will be invoking the SPETransformService, or invoking an ITX map through the ST envelope. Refer to the latest ITXA release notes for details, such as installation order (ITX > ITXA > SI). Otherwise, optional. Reference: ITXA installation summary covers ITX and ITXA installation.
1.	Install IBM Transformation Extender.
2.	Install and verify ITXA components and ITX packs.
3.	Choose your installation scenario, depending upon whether you are performing a new installation of both Sterling B2B Integrator and ITXA, or an ITXA upgrade.	References: Scenario 1: Installing ITXA and Sterling B2B Integrator as a new installation Scenario 2: Installing ITXA with a Sterling B2B Integrator upgrade Scenario 3: Upgrading ITX, ITXA, and Sterling B2B Integrator.
4.	Upgrade to Sterling B2B Integrator V6.1.1 or later. Verify your Sterling B2B Integrator installation. If ITXA is installed after Sterling B2B Integrator, you must edit environment variables.	When prompted during Sterling B2B Integrator V.5.2.6.1 installation, make these choices: ITXA components. Specify the location of your ITXA installation, ITX installation (if present), and the web port number for the ITXA Trading Partner UI. If a current Sterling B2B Integrator Map Editor is already installed on your system, do not select it from design components. References: Sterling B2B Integrator installation procedures If databases differ between the two products, see Using a different database for ITXA and Sterling B2B Integrator. If SPE is installed after Sterling B2B Integrator is upgraded, see Setting environment variables in Sterling B2B Integrator. Result: ITXA libraries and other assets are installed. Draft comment: Doc story 418858
5.	Configure properties. Modify the ITXA customer overrides properties file `spe_install_dir`/ customer_overrides.properties file to override default property settings as necessary.	For example, pack-related properties typically include the location of ITX compliance check maps. If the location of the compliance check maps is not specified, errors result when ITXA tries to use these maps to validate data. Reference: Overriding values in property files and Configuring Sterling B2B Integrator property files for an ITXA integration
6.	Create and configure the SPE (ITXA) Enveloping, De-enveloping, and Transformation services in Sterling B2B Integrator, as needed. If using Graphical Process Modeler, verify that icons for the installed services appear under All Services.	Tip: If the Graphical Process Modeler is open when services are created, refresh to view the icons. References: For SPE services, see SPE Enveloping Service, SPE Deenveloping Service, and SPE Transform Service. Using services and adapters for Sterling B2B Integrator
7.	Export maps and other needed resources from Sterling B2B Integrator and import them into ITXA.	To import resources, use the speimport.bat command or the Trading Partner UI. Restriction: You cannot use the command line to import envelopes into ITXA that have been exported from Sterling B2B Integrator. Use the Trading Partner UI to import those resources. References: Exporting resources for Sterling B2B Integrator To import resources into ITXA, see the topics speimport, Importing configurable rules from the command line, or Importing resources.