Retrieving the contents of an administrative image

After you configure Maximo® Manage to send build images to an external registry, you can retrieve the administrative image and instantiate it in a Docker container. You can then review the contents of the container or use it as a development environment for customizations.

Before you begin

Before you can instantiate a Maximo Manage administrative image in a Docker container, you must complete the following tasks:
  1. Install Docker Desktop on your local computer. For more information, see the Docker Desktop documentation.
  2. Configure Maximo Manage to send image builds to an external registry. For more information, see Storing images in an external registry.

Procedure

  1. Log in to the Docker image repository, as shown in the following example:
    docker login -u <username> -p <password> <your_docker_registry_server>
  2. Pull the administrative image from the repository as shown in the following example:
    docker pull <your_docker_registry_server>/<image_folder>/<adminimagename:tag>
  3. Run the docker image command and get a container shell.
    1. Run the docker image command to get the image ID for the image that you pulled.
    2. Run the following command:
      docker run -d <image id>
    3. Use the docker ps command to get the container ID that is running the pulled image.
    4. Run the following command:
      docker exec -it <container id> /bin/bash
  4. Update the properties in the /opt/IBM/SMP/maximo/applications/maximo/properties maximo.properties file with the URL, user name, and password for your Maximo Manage database.