Installing the AS4 Microservice integration module

You can install the AS4 Microservice integration module in your environment, whether clustered or non-clustered. During installation you can also create an adapter container for integration module adapters.

Before you begin

You can install the integration module during the Sterling B2B Integrator installation, or with the integration module JAR file that is included in the Sterling B2B Integrator installation media. After installing the integration module, you create an adapter container for the module adapters that you configure in Sterling B2B Integrator.

About this task

You can install the AS4 Microservice integration module in one of two ways:

During the Sterling B2B Integrator installation.

In the Features window, select AS4 Microservices Integration Module.

Execute the integration module JAR file that is included in the Sterling B2B Integrator installation media.

If your installation is a multiple-node (clustered) environment, you must install the JAR file on each node and create an adapter container on at least one of the nodes. If you already have an adapter container on one of the cluster nodes, you do not need to create a new one.

The following instructions assume that you installed Sterling B2B Integrator. See Sterling B2B Integrator Documentation for information about the following items for the version of Sterling B2B Integrator that you are using with AS4 Microservice.

  • Installation
  • Specific maintenance level (version) of Sterling B2B Integrator
  • Adapter containers and the InstallService command

If you are installing the AS4 Microservice integration module with the JAR file, the installation procedure depends on the following items:

  • Operating system (UNIX/Linux or Windows
  • Configuration (single node or multiple-node cluster)
Important: During the installation, various messages are displayed, including some warning messages. The warning messages require no action on your part and are included so that helpful data is recorded in the InstallService.log file in the install_dir\install\logs directory.

Procedure

  1. To install the AS4 Microservice integration module with the included JAR file in a single-node (non-clustered) environment, perform one of the following procedures. If you are installing in a multiple-node (clustered) environment, go to step 2.
    Operating System Procedure
    UNIX or Linux® environment
    1. Stop Sterling B2B Integrator.
    2. Change to the install_dir/install/bin directory in the Sterling B2B Integrator installation.
    3. Enter the following command to install the JAR file: 
      ./InstallService.sh install_dir/install/packages/<JAR file name>
      For example, if the JAR file number is b2bi4meg_1000000.jar, enter the following command: 
      ./InstallService.sh install_dir/install/packages/b2bi4meg_1000000.jar
    4. If there is no adapter container on the node, create an adapter container. This example shows the commands to create adapter container 1: 
      
./startCluster.sh 1 
./setupContainer.sh 1
    5. Enter the following command to restart Sterling B2B Integrator: 
      ./runAll.sh
    Windows
    1. Stop Sterling B2B Integrator.
    2. Change to the install_dir\install\bin directory in the Sterling B2B Integrator installation.
    3. Enter the following command to install the JAR file: 
      InstallService.cmd install_dir\install\packages\
      <appropriate JAR file number of Sterling B2B Integrator bridge>
      For example, if the JAR file number is b2bi4meg_1000000.jar, enter the following command: 
      InstallService.cmd install_dir\install\packages\b2bi4meg_1000000.jar
    4. If there is no adapter container on the node, create an adapter container. This example shows the command to create adapter container 1: 
      
startCluster.cmd 1 false
setupContainer.cmd 1
    5. Enter the following command to restart Sterling B2B Integrator: 
      startWindowsServices.cmd
  2. To install the AS4 Microservice integration module with the included JAR file in a multiple-node (clustered) environment, perform one of the following procedures for each node in the cluster:
    Operating System Procedure
    UNIX or Linux
    1. Stop Sterling B2B Integrator.
    2. Change to the install_dir/install/bin directory in the Sterling B2B Integrator installation.
    3. Enter the following command to install the JAR file:
      ./InstallService.sh install_dir/install/packages/
      <appropriate JAR file number of Sterling B2B Integrator bridge>
      For example, if the JAR file number is b2bi4meg_1000000.jar, enter the following command: 
      ./InstallService.sh install_dir/install/packages/b2bi4meg_1000000.jar
    4. If there are no adapter containers in the cluster, create an adapter container on one of the nodes. This example shows the commands to create adapter container 1: 
      ./startCluster.sh 1
            
            ./setupContainer.sh 1
    5. Enter the following command to restart Sterling B2B Integrator: 
      runAll.sh
    Windows
    1. Stop Sterling B2B Integrator.
    2. Change to the install_dir\install\bin directory in the Sterling B2B Integrator installation.
    3. Enter the following command to install the JAR file:
      InstallService.cmd install_dir\install\packages\
      <appropriate JAR file number of Sterling B2B Integrator bridge>
      For example, if the JAR file number is b2bi4meg_1000000.jar, enter the following command: 
      InstallService.cmd install_dir\install\packages\b2bi4meg_1000000.jar
    4. If there are no adapter containers in the cluster, create an adapter container on one of the nodes. This example shows the commands to create adapter container 1: 
      startcluster.cmd 1 false
            setupContainer.cmd 1
    5. Enter the following command to restart Sterling B2B Integrator: 
      startWindowsServices.cmd