Installing the Sterling B2B Integrator Docker container

You can use the docker run command to install the Sterling B2B Integrator Docker container.

Before you begin

You must complete all the prerequisite tasks specified. For more information, see Prerequisites for installing Sterling B2B Integrator Docker container.

If you are creating adapter containers, you must install IBM MQ before you create the adapter containers. You must also configure the properties for IBM MQ in the setup.cfg file. For more information, see Configuring the B2Bi container.

Ensure that the following items are saved on each node.

Note: All items must be saved in the same folder <local dir>.

  • The downloaded Sterling B2B Integrator Docker image.
  • The database driver jar file.
  • The setup.cfg file.
  • JCE Policy(Optional)
  • IBM MQ keys(Optional)
  • Liberty keys(Optional)

For information about Docker deployment parameters, see Docker deployment parameters.

Procedure to install with a non-root user

You can add a non-root user to the Sterling B2B Integrator Docker image.

The Sterling B2B Integrator Docker image comes with a default non-root user with name/uid as b2biuser/1010 respectively.

By default, the Docker container starts the Sterling B2B Integrator application services with the b2biuser. This user also owns the mapped trace folder.

Note: For the default user in the Docker container to be able to access the configurations and resources from the host folder path mapped to /ibm/resources, all the folders in that path should have an execute ‘x’ permission and all the files should have a read ‘r’ permission for others.

Follow these steps to install the Sterling B2B Integrator Docker container with the currently logged in user or any other user on the host:

1. Copy the contents shown below to a file named as Dockerfile and place it on a host that has Docker installed.

 

				
					FROM b2bi:latest

ARG USER_ID
ARG GROUP_ID
USER root
RUN if [ ${USER_ID:-0} -ne 0 ] && [ ${GROUP_ID:-0} -ne 0 ]; then \
    userdel -f b2biuser && \
    if getent group b2bigroup ; then groupdel b2bigroup ; fi && \
    groupadd -g ${GROUP_ID} b2bigroup && \
    useradd -r -u ${USER_ID} -m -s /sbin/nologin -c "B2BI user" -g b2bigroup b2biuser && \
    install -d -m 0755 -o b2biuser -g b2bigroup /home/b2biuser && \
    chown --silent --no-dereference --recursive \
          --from=1010:1010 ${USER_ID}:${GROUP_ID} \
        /home/b2biuser \
        /ibm/ && \
    chown -R ${USER_ID}:${GROUP_ID} /ibm/trace \
;fi
        
USER b2biuser

2. Edit the Dockerfile to change the repository and tag name from b2bi:latest to the appropriate repository and tag name for the Sterling B2B Integrator image you downloaded.

3. Run the following command to extend the Sterling B2B Integrator Docker image to include the host user:

 

				
					docker build -t ${desired tag}:${product version} --build-arg USER_ID=${host user id} --build-arg GROUP_ID=${host user group id} ${path/to/dockerfile}

Note: The build arguments host_user_id and host_user_group_id should be the uids for the selected host user and group.

4. Use the new Docker image id/tag as the <image-id> in all the subsequent Docker installation commands.

Procedure if you are using Host Network

1. If you are installing the first node of a cluster or if you are installing in a non-clustered environment, run the following command to set up Sterling B2B Integrator1. :

				
					For Host network:
docker run -e LICENSE="accept" -e KEY=<key> -e TZ=<Time Zone> -d --name=<container name> --net=host 
-v <local dir>:/ibm/resources <image-id> b2bi_run all 1

For more information about parameters, see Docker deployment parameters.

2. If you are installing the additional nodes of a cluster, run the following command to set up Sterling B2B Integrator:

				
					For Host network:
docker run -e LICENSE="accept" -e KEY=<key> -e TZ=<Time Zone> -d --name=<container name> --net=host 
-v <local dir>:/ibm/resources <image-id> b2bi_run all <nodenumber>

Procedure if you are using Overlay Network

1. If you are installing the first node of a cluster, run the following command to set up Sterling B2B Integrator:

				
					For Overlay network:
docker run -e LICENSE="accept" -e KEY=<key> -e TZ=<Time Zone> -d --name=<container name>
--net=<name of the overlay network> --ip=<IP address> --hostname="<hostname>" 
-p <port range> -v <path to setup.cfg>:/ibm/resources <image-id> b2bi_run all 1
  • The port range starts with the initial port number that is specified in setup.cfg for this node. The suggested port range is for a range of 200 port numbers but can change based on application requirements. For example, if the INITIAL_PORT is set to 40000, the port range will be 40000-40200:40000-40200.
  • It is recommended that you provide the IP address during the overlay network container creation. This assigns the IP address from the overlay network range to the container that is created and maintains the same IP each time you stop and start the container. If the IP address is not provided when the container is created, a new IP is assigned to the container each time you stop and start the container.
  • It is recommended that you provide the hostname when you create the container. If the hostname is not provided, the containerID is added as the hostname.

For more information about other parameters, see Docker deployment parameters.

2. If you are installing the additional nodes of a cluster, run the following command to set up Sterling B2B Integrator:

				
					For Overlay network:
docker run -e LICENSE="accept" -e KEY=<key> -e TZ=<Time Zone> -d --name=<container name>
--net=<name of the overlay network> --ip=<IP address> --hostname="<hostname>" 
-p <port range> -v <path to setup.cfg>:/ibm/resources <image-id> b2bi_run all <nodenumber>

Procedure if you are using Vertical Clusters with bridge network

If you are using vertical clusters, ensure that all nodes have separate ports and they are added to the setup.cfg file for each node.

1. If you are installing the first node of a cluster, run the following command to set up Sterling B2B Integrator:

				
					For vertical clusters with port mapping:
docker run -e LICENSE="accept" -e KEY=<key> -e TZ=<Time Zone> -d --name=<container name> 
--net=<network name> -p <port range 1> -v <path to setup.cfg for node 1>:/ibm/resources
<image-id> b2bi_run all 1
  • The port range starts with the initial port number that is specified in setup.cfg for this node. The suggested port range is for a range of 200 port numbers but can change based on application requirements. For example, if the INITIAL_PORT is set to 40000, the port range will be 40000-40200:40000-40200.
  • It is recommended that you provide the IP address during the overlay network container creation. This assigns the IP address from the overlay network range to the container that is created and maintains the same IP each time you stop and start the container. If the IP address is not provided when the container is created, a new IP is assigned to the container each time you stop and start the container.
  • It is recommended that you provide the hostname when you create the container. If the hostname is not provided, the containerID is added as the hostname.

For more information about other parameters, see Docker deployment parameters.

2. If you are installing the additional nodes of a cluster, run the following command to set up Sterling B2B Integrator:

				
					For vertical clusters with port mapping:
docker run -e LICENSE="accept" -e KEY=<key> -e TZ=<Time Zone> -d --name=<container name> 
--net=<network name> -p <port range n> -v <path to setup.cfg for node n>:/ibm/resources
<image-id> b2bi_run all <nodenumber>

Procedure if you are using Vertical Clusters with Host Network

If you are using vertical clusters, ensure that all nodes have separate ports and they are added to the setup.cfg file for each node.

1. If you are installing the first node of a cluster, run the following command to set up Sterling B2B Integrator:

				
					For vertical clusters with Host Network:
docker run -e LICENSE="accept" -e KEY=<key> -e TZ=<Time Zone> -d --name=<container name> 
--net=host -v <path to setup.cfg for node 1>:/ibm/resources
<image-id> b2bi_run all 1

For more information about other parameters, see Docker deployment parameters.

2. If you are installing the additional nodes of a cluster, run the following command to set up Sterling B2B Integrator:

				
					For vertical clusters with Host Network:
docker run -e LICENSE="accept" -e KEY=<key> -e TZ=<Time Zone> -d --name=<container name> 
--net=host -v <path to setup.cfg for node 2>:/ibm/resources
<image-id> b2bi_run all <nodenumber>

Viewing logs

1. To view the logs, use the following commands:

				
					docker logs <container ID>

To view incremental logs, use:

				
					docker logs -f <container ID>

Browse categories

Share Blog Post
Pragma Edge (4.5/5)
4.5/5

Recent Blog Posts - Read More

At Pragma Edge, we are a forward-thinking technology services provider dedicated to driving innovation and transformation across industries.

  • 12926 Gran Bay Pkwy W., Suite 220,
    Jacksonville, FL 32258
  • info@pragmaedge.com
  • +1 (848) - 999 - 9090
Linkedin Facebook-f X-twitter Youtube Instagram

What We Do

Industries

Products

Who We Are

Sterling Data Exchange

Thank you for submitting your details.

For more information, Download the PDF.

Get Solution Brief

PragmaEdge Universe | 2024

Thank you for the Registration Request, Our team will confirm your request shortly.

Invite and share the event with your colleagues 

Return to home page

IBM Partner Engagement Manager Standard

IBM Partner Engagement Manager Standard is the right solution
addressing the following business challenges

IBM Partner Engagement Manager Standard

IBM Partner Engagement Manager Standard is the right solution
addressing the following business challenges

IBM Partner Engagement Manager Standard

IBM Partner Engagement Manager Standard is the right solution
addressing the following business challenges

Pragma Edge - API Connect