To build the Order Balancer cloud native Docker image, the asap-img-builder.zip file is required. This zip file is packaged as part of the ASAP cloud native tar file. For more information about downloading the Order Balancer cloud native Image Builder, see "Downloading the ASAP Cloud Native Artifacts".

See ASAP Software Compatibility Matrix for details about the latest recommended installer versions of Order Balancer.

See ASAP Software Compatibility Matrix for details about the required and supported versions of the prerequisite software.

The Order Balancer cloud native image builder tool builds the Order Balancer cloud native Docker image, which is then pushed to the Docker repository and deployed in the Kubernetes cluster. If the Docker repository is not available, you copy the image to all the worker nodes of the cluster.

The ASAP installer is packaged with the Order Balancer cloud native image builder and the cloud native toolkit.

To create the Order Balancer cloud native image:

1. Copy the asap-img-builder.zip file to the machine where the Docker daemon is running.

2. Extract the contents of the zip file by running the following command:

   unzip asap-img-builder.zip

3. Copy the following installers to the $asap-img-builder/installers directory.

   • Order Balancer Installer
   • Installers for WebLogic Server and JDK

4. Update the following parameters in the $asap-img-builder/ob.properties file:

   ob.tar.file=ASAP.R7_4_0.B196.ob.tar
   ob.weblogic.username=weblogic
   ob.weblogic.password=
   ob.weblogic.port=7501
   ob.weblogic.domainName=ob
   ob.weblogic.channel.listenport=7502
   ob.weblogic.channel.publicport=30301
   ob.ssl.incoming=0
   ob.cacheexpiry=60
   #Time in seconds
   ob.all.servers.down.wait.interval=3600
   ob.all.servers.down.retry.interval=120
   ob.server.down.retry.interval=2
   ob.server.poll.interval=60
   ob.webservice.res.timeout=0
   ob.asap.conn.timeout=10
   ## Values allowed: SEVERE, WARNING, INFO , FINE , FINEST ,ALL
   ob.logger.info=INFO
   ob.db.host=
   ob.db.port=1521
   ob.db.service.name=
   ob.db.user=
   ob.db.password=
   ob.jms.user=
   ob.jms.password=

   where

   • ob.weblogic.username is the user name to log in to WebLogic Server.
   • ob.weblogic.password is the password to log in to WebLogic Server.
   • ob.weblogic.port is the port of the WebLogic Server.
   • ob.weblogic.domainName is the WebLogic Server domain.
   • ob.weblogic.channel.listenport is the channel listen port of the WebLogic Server.
   • ob.weblogic.channel.publicport is the public port of the WebLogic Server.
   • ob.ssl.incoming is set to enable SSL on Order Balancer WebLogic Server. The default value is 0 which specifies non-SSL.
   • ob.cacheexpiry specifies the duration in seconds that Order Balancer JPA shared query refreshes the cache. Cache is refreshed upon next request after the duration expires. The default value is 60.
   • ob.all.servers.down.wait.interval specifies the duration in seconds that Order Balancer waits before routing the request back to queue when all the ASAP instances are down. The default value is 3600.
   • ob.all.servers.down.retry.interval specifies the duration in seconds that Order Balancer waits before retrying to connect to fetch for an active ASAP member instance while waiting when all servers are down. The default value is 120.
   • ob.server.down.retry.interval specifies the duration in seconds that Order Balancer waits before reattempting to route the order to the same instance. If the re-attempt fails, the instance is marked as down. The default value is 2.
   • ob.server.poll.interval specifies the duration in seconds that Order Balancer waits before it retries to check the ASAP instance status. The default value is 60.
   • ob.webservice.res.timeout specifies the duration in seconds that Order Balancer waits for response before the read times-out. Order Balancer Web Service waits for a response from ASAP member instance after invoking the operation. A value of zero means Order Balancer will wait indefinitely until it receives a response from ASAP. The default value is 0 seconds (no read time-out).
   • ob.asap.conn.timeout specifies the duration in seconds that Order Balancer reattempts the connection to the ASAP instance. The default value is 10.
   • ob.logger.info specifies the log level for initializing the Order Balancer application root logger. The valid values are SEVERE, WARNING, INFO, FINE, FINEST, and ALL.
   • ob.db.host is the database host name or IP address.
   • ob.db.port is the database port.
   • ob.db.service.name is the database service name.
   • ob.db.user is the database user name.
   • ob.db.password is the database password.
   • ob.jms.user is the JMS user.
   • ob.jms.password is the JMS password.

   Note:

   Do not add an ASAP instance when you are building the Order Balancer Docker image. The wallet store is mounted dynamically in the Kubernetes cluster. The wallet files created in the Docker image are not accessible in the Kubernetes Pod.

   In the cloud native deployment, the WebLogic domain is non-SSL and the ingress controller is configured as SSL.

5. Update the HTTPS_PROXY and HTTP_PROXY variables in the build_ob_env.sh script:

   base_image=oraclelinux:8
   HTTPS_PROXY=
   HTTP_PROXY=
   
   # Docker details
   OB_IMAGE_TAG="obcn:7.4.0.0.0"
   OB_VOLUME=obhost_volume
   OB_CONTAINER="ob-c"
   DOCKER_HOSTNAME="obhost"
   
   # Installer filenames
   WEBLOGIC_DOMAIN=/u01/oracle/user_projects/domains/
   JDK_FILE=jdk-8u321-linux-x64.tar.gz
   FMW_FILE=fmw_14.1.1.0.0_wls_lite_Disk1_1of1.zip
   
   # Installation locations
   JAVA_HOME=/usr/lib/jvm/java/jdk1.8.0_321
   PATH=$JAVA_HOME/bin:$PATH
   WEBLOGIC_HOME=/home/oracle/weblogic141100
   

   Note:

   The file names of JDK_FILE and FMW_FILE variables must match with the file names in the /asap-img-builder/installers/ folder.

6. Run the build-asap-images.sh script to build the Order Balancer docker images:

   ./build-asap-images.sh -i ob

   The script creates the Order Builder Docker images by running the docker container and commits the Order Builder image.