Skip to content
This repository has been archived by the owner on Sep 13, 2022. It is now read-only.

Latest commit

 

History

History
233 lines (194 loc) · 9.24 KB

README.md

File metadata and controls

233 lines (194 loc) · 9.24 KB

Liberty version is here: https://github.com/nishi2go/maximo-liberty-docker

Building and deploying an IBM Maximo Asset Management V7.6 with Feature Pack image to Docker

Maximo on Docker enables to run Maximo Asset Management on Docker. The images are deployed fine-grained services instead of single instance. The following instructions describe how to set up IBM Maximo Asset Management V7.6 Docker images. This images consist of several components e.g. WebSphere, Db2, and Maximo installation program.

Componets of Docker Images

Required packages

  • IBM Maximo Asset Management V7.6.1 binaries from Passport Advantage

    IBM Enterprise Deployment (formerly known as IBM Installation Manager) binaries:

    • IED_V1.8.8_Wins_Linux_86.zip

    IBM Maximo Asset Management V7.6.1 binaries:

    • MAM_7.6.1_LINUX64.tar.gz

    IBM WebSphere Application Server traditional V9 binaries:

    • WAS_ND_V9.0_MP_ML.zip

    IBM HTTP Server and WebSphere Plugin V9 binaries:

    • was.repo.9000.ihs.zip
    • was.repo.9000.plugins.zip

    IBM Java SDK V8 binaries:

    • sdk.repo.8030.java8.linux.zip

    IBM Db2 Advanced Workgroup Edition V11.1 binaries:

    • DB2_AWSE_REST_Svr_11.1_Lnx_86-64.tar.gz

  • Feature Pack/Fix Pack binaries from Fix Central

    IBM Maximo Asset Management V7.6.1 Feature pack 2 binaries:

    • MAMMTFP7612IMRepo.zip

    IBM WebSphere Application Server traditional Fixpack V9.0.0.10 binaries:

    • 9.0.0-WS-WAS-FP010.zip

    IBM HTTP Server Fixpack V9.0.0.10 binaries:

    • 9.0.0-WS-IHSPLG-FP010.zip

    IBM Java SDK Fixpack V8.0.5.25 Installation Manager Repository binaries:

    • ibm-java-sdk-8.0-5.25-linux-x64-installmgr.zip

    IBM Db2 Server V11.1 Fix Pack 4 Mod 1

    • v11.1.4fp4a_linuxx64_server_t.tar.gz

Building IBM Maximo Asset Management V7.6 images by using build tool

Prerequisites: all binaries must be accessible via a web server during building phase.

You can use a tool for building docker images by using the build tool.

Usage:

Usage: build.sh [DIR] [OPTION]...

-c | --check            Check required packages
-C | --deepcheck        Check and compare checksum of required packages
-r | --remove           Remove images when an image exists in repository
-d | --check-dir [DIR]  The directory for validating packages (Docker for Windows only)
-h | --help             Show this help text

Procedures:

  1. Place the downloaded Maximo, IBM Db2, IBM Installation Manager and IBM WebSphere Application Server traditional binaries on a directory.

  2. Clone this repository.

    git clone https://github.com/nishi2go/maximo-docker.git

  3. Move to the directory.

    cd maximo-docker

  4. Run build tool.

    bash build.sh [Image directory] [-c] [-C] [-r]

    Example:

    bash build.sh /images -c -r

    Example for Docker for Windows:

    bash build.sh "C:/images" -c -r -d /images

    Note 1: This script works on Windows Subsystem on Linux.
    Note 2: md5sum is required. For Mac, install it manually - https://raamdev.com/2008/howto-install-md5sum-sha1sum-on-mac-os-x/

  5. Run containers by using the Docker Compose file to create and deploy new instances.

    docker-compose up -d

    Note: It will take 3-4 hours (depend on your machine spec) to complete the installation. Note: To change the default passwords, edit [COMPONENT]_PASSWORD environment variables in docker-compose.yml file. Do not use a different value to the same environment variable across services.

  6. Make sure to be accessible to Maximo login page: http://hostname/maximo

Building IBM Maximo Asset Management V7.6 images by manually

Prerequisites: all binaries must be accessible via a web server during building phase.

Procedures:

  1. Place the downloaded Maximo, IBM Db2, IBM Installation Manager and IBM WebSphere Application Server traditional binaries on a directory
  2. Create docker network for build with: 
    docker network create build
  3. Run nginx docker image to be able to download binaries from HTTP. 
    docker run --name images -h images --network build \
-v [Image directory]:/usr/share/nginx/html:ro -d nginx
  4. Clone this repository. 
    git clone https://github.com/nishi2go/maximo-docker.git
  5. Move to the directory. 
    cd maximo-docker
  6. Build Docker images: Build Db2 image: 
    docker build -t maximo/db2:11.1.4a -t maximo/db2:latest --network build maxdb
    Build IBM Enterprise Deployment (IBM Installation Manager) image: 
    docker build -t maximo/ibmim:1.8.8 -t maximo/ibmim:latest --network build ibmim
    Build WebSphere Application Server base image: 
    docker build -t maximo/maxwas:9.0.0.10 -t maximo/maxwas:latest --network build maxwas
    Build WebSphere Application Server Deployment Manager image: 
    docker build -t maximo/maxdmgr:9.0.0.10 -t maximo/maxdmgr:latest maxdmgr
    Build WebSphere Application Server AppServer image: 
    docker build -t maximo/maxapps:9.0.0.10 -t maximo/maxapps:latest maxapps
    Build IBM HTTP Server image: 
    docker build -t maximo/maxweb:9.0.0.10 -t maximo/maxweb:latest --network build maxweb
    Build Maximo Asset Management Installation image: 
    docker build -t maximo/maximo:7.6.1.2 -t maximo/maximo:latest --network build maximo
    Note: If the build has failed during Maximo Feature Pack installation, run the docker build again.
  7. Run containers by using the Docker Compose file to create and deploy new instances. 
    docker-compose up -d
    Note: It will take 3-4 hours (depend on your machine spec) to complete the installation. Note: To change the default passwords, edit [COMPONENT]_PASSWORD environment variables in docker-compose.yml file. Do not use a different value to the same environment variable across services.
  8. Make sure to be accessible to Maximo login page: http://hostname/maximo

Building IBM Maximo Asset Management V7.6 images with an Oracle Database Container by using build tool

Prerequisites:

  • All binaries must be accessible via a web server during building phase.
  • An Oracle Database containar or any on-premise instance must be prepared before running docker-compose command.
    • Follow the guide from the repo to create an Oracle Database container.

Procedures:

  1. Place the downloaded Maximo, IBM Db2, IBM Installation Manager and IBM WebSphere Application Server traditional binaries on a directory.

  2. Clone this repository.

    git clone https://github.com/nishi2go/maximo-docker.git

  3. Move to the directory.

    cd maximo-docker

  4. Run build tool.

    bash build.sh [Image directory] [-c] [-C] [-r]

    Example:

    bash build.sh /images -c -r

    Example for Docker for Windows:

    bash build.sh "C:/images" -c -r -d /images

    Note 1: This script works on Windows Subsystem on Linux.
    Note 2: md5sum is required. For Mac, install it manually - https://raamdev.com/2008/howto-install-md5sum-sha1sum-on-mac-os-x/

  5. Run containers by using the Docker Compose file to create and deploy new instances.

    docker-compose -f docker-compose.ora.yml up -d

    Note: It will take 3-4 hours (depend on your machine spec) to complete the installation. Note: To change the default passwords, edit [COMPONENT]_PASSWORD environment variables in docker-compose.yml file. Do not use a different value to the same environment variable across services.

  6. Make sure to be accessible to Maximo login page: http://hostname/maximo

Skip the maxinst process in starting up the maxdb container by using Db2 restore command

Maxinst program supports to initialize and create a Maximo database that called during the "deployConfiguration" process in the Maximo installer. This process is painfully slow because it creates more than thousand tables from scratch. To skip the process, you can use a backup database to restore during first boot time in a maxdb service. So then, it can reduce the creation time for containers from second time.

Procedures:

  1. Build container images first (follow above instructions)
  2. Move to the cloned directory. 
    cd maximo-docker
  3. Make a backup directory. 
    mkdir ./backup
  4. Uncomment the following volume configuration in docker-compose.yml. 
      maxdb:
    volumes:
      - type: bind
        source: ./backup
        target: /backup
  5. Run containers by using the Docker Compose file. (follow above instructions)
  6. Take a backup from the maxdb service by using a backup tool. 
    docker-compose exec maxdb /work/backup.sh maxdb76 /backup
    Note: Backup image must be only one in the directory. Backup task must fail when more than two images in it.

So that, now you can create the containers from the backup image that is stored in the directory.