Downloading MDM Docker assets and images

To acquire the InfoSphere® MDM Docker assets, you must download them from IBM® Passport Advantage®®. You will then be able to use a script to acquire the MDM Docker images from the IBM Docker registry.

Before you begin

Before you start, verify that you have an IBM ID, and that the Passport Advantage primary contact at your company has granted your IBM ID permission to access and download IBM InfoSphere Master Data Management. If you do not have an IBM ID, you can create one at the Passport Advantage site.

Procedure

  1. On the host machine, create a Docker working directory where you will base all of your Docker activity: downloads, installation, running, and monitoring. Give the directory a meaningful name, such as /mdm.
    Important: If you plan to deploy the containers on Red Hat® OpenShift®, download the images on a separate machine from the OpenShift server, such as an Ubuntu or Red Hat Enterprise Linux machine.
  2. In a web browser, navigate to the IBM Passport Advantage site.
    Tip: If you are not familiar with Passport Advantage, view a short tutorial on Downloading Products from Passport Advantage on YouTube.
  3. Locate and download the MDM Docker artifacts (MDM_<VERSION>_Docker_Key.zip). Refer to the Download IBM InfoSphere Master Data Management page to determine the part numbers that you should download.
    Important: If you are planning to deploy the images on Red Hat OpenShift or a Kubernetes cluster, you must use installable images. Deployed images do not support OpenShift or Kubernetes deployment.
  4. Unpack each of the parts into the Docker working directory that you created on your host machine (/mdm).
  5. Download the MDM Docker images from the IBM Docker registry.
    All MDM Docker images are hosted on the IBM Docker registry. Use the script Configure_MDM_Docker, located within the package file MDM_<version>_DKR_COMPOSE.zip, to access the MDM docker images.
    Important: If you plan to deploy the containers on Red Hat OpenShift, complete the following steps on a separate machine from the OpenShift server, such as an Ubuntu machine.
    1. Open MDM_<version>_DKR_COMPOSE.zip and extract Configure_MDM_Docker.
    2. Run Configure_MDM_Docker.
      $ ./Configure_MDM_Docker
    3. Follow the onscreen prompts to review and accept the license, including selecting your preferred language. You must accept the terms of the license agreement before you can continue.

      After you accept the license agreement terms, the script logs into the IBM Docker registry and displays a list of InfoSphere MDM related Docker Compose (YAML) files that you can either run directly or run using a custom script.

          [1] - Installable MDM for remote DB
          [2] - Installable MDM for remote DB with UI container
          [3] - Installable MDM with IBM Stewardship Center for remote DB
          [4] - Installable MDM with IBM Stewardship Center for remote BPM DB
          [5] - Installable MDM for remote WebSphere Application Server profile
          [6] - MDM Workbench
          [7] - Machine Learning Assisted Data Stewardship
          [8] - Deployed MDM with DB2 container [for Development/Demon purpose only]
          [9] - Deployed MDM with IBM Stewardship Center [for Development/Demo purpose only]
          [10] - Deployed MDM with Machine Learning Assisted Data Stewardship [for Development/Demo purpose only]
          [11] - Installable MDM with DB2 container [for Development/Demo purpose only]
          [12] - Installable MDM with IBM Stewardship Center and DB2 container [for Development/Demo purpose only]
          [13] - MDM with custom docker-compose [place docker-compose.yml in /root/MDM<version>DKR/MDM_<version>_DKR_COMPOSE]
          [14] - Machine Learning Assisted Data Stewardship image for Red Hat OpenShift
    4. Select the Docker Compose (YAML) file that you wish to run, or select option 13 to run using a custom Docker Compose file.
    Note: After exiting the Configure_MDM_Docker script, you will remain logged in to the IBM Docker registry. When the Docker Compose YAML files are running but the MDM Docker image is not available locally, Docker will automatically download any required image from the IBM Docker registry.

What to do next

Deploy the MDM Docker images
To deploy the MDM Docker images, follow the instructions that correspond to the platform on which you wish to deploy: