Deploying Maximo Data Loader in Docker

As an administrator, you can deploy Maximo Data Loader to create a persistent volume, download the Maximo Data Loader container image, and run the image in a container.

Before you begin

Ensure that Docker is installed on the computer where you want to run Maximo Data Loader.

When you run the Maximo Data Loader container, connect the container to a persistent volume on the local host. You can use the persistent volume to store data, such as the certificate keystore, log files, configuration files, and Microsoft Excel workbooks. If the container does not use a persistent volume, the data in the container is lost when the container is restarted.

If you want to use a persistent volume for a Maximo Data Loader container that is running on a Linux® or Mac host, you must first create a directory for the volume on the host. For a Linux host, you must also create a local user and give the user ownership of the directory that you created. These steps are described in the following table:
Table 1. Preparing to use a persistent volume for the container on a Linux or Mac computer
Operating system Commands
Linux Open a terminal window and run the following commands:

useradd -u 8443 maxloader

mkdir -p /home/maxloader/data

chown maxloader:maxloader /home/maxloader/data

By assigning a uid of 8443 to the local user, you give the preconfigured maxloader user that is in the Docker container full permissions to the directory on the host.
Mac Open a terminal window. In your home directory, for example, /Users/username, run the following command: mkdir -p maxloader/data

Procedure

  1. To log in to the IBM® Entitled Registry, run the following command:
    docker login cp.icr.io --username cp --password entitlement_key
    where entitlement_key is the IBM Cloud® entitlement key that you obtained for the IBM Entitled Registry.
  2. To download the Maximo Data Loader Docker container image, run the following command:
    docker pull cp.icr.io/cp/manage/maxloader:latest
  3. To run the Maximo Data Loader image in a Docker container, run the following command:
    docker run -e MAXLOADER_KEY_PASS=<maxloader keystore password> -e MAXLOADER_USERNAME=username -e MAXLOADER_PASSWORD=password -d -h internal_hostname --name=maxloader -p external_port:8443 -v local_directory:/maxloader/data -u maxloader -w /maxloader -it cp.icr.io/cp/manage/maxloader:latest
    where:

    internal_hostname is the internal name that you want to assign to the Docker host.

    external_port is the port on which you want to make Maximo Data Loader available.

    local_directory is the path to the volume on the host that provides persistent storage for the Maximo Data Loader files.

    The following table shows example commands for each operating system:

    Table 2. Example run commands for Docker
    Operating system Command
    Linux docker run -e MAXLOADER_KEY_PASS=maxloader_mci_ssl -e MAXLOADER_USERNAME=maxloader -e MAXLOADER_PASSWORD=password -d -h maxloader --name=maxloader -p 8443:8443 -v /home/maxloader/data:/maxloader/data -u maxloader -w /maxloader -it cp.icr.io/cp/manage/maxloader:latest
    Windows docker run -e MAXLOADER_KEY_PASS=maxloader_mci_ssl -e MAXLOADER_USERNAME=maxloader -e MAXLOADER_PASSWORD=password -d -h maxloader --name=maxloader -p 8443:8443 -v c:\maxloader:/maxloader/data -u maxloader -w /maxloader -it cp.icr.io/cp/manage/maxloader:latest
    Mac docker run -e MAXLOADER_KEY_PASS=maxloader_mci_ssl -e MAXLOADER_USERNAME=maxloader -e MAXLOADER_PASSWORD=password -d -h maxloader --name=maxloader -p 8443:8443 -v /Users/Mac_username/maxloader/data:/maxloader/data -u maxloader -w /maxloader -it cp.icr.io/cp/manage/maxloader:latest

What to do next

When the deployment is complete, use the following URL to access the user interface: 
https://hostname:port/maxloader
where hostname is the internal hostname that you assigned to the Docker host and port is the value of the external port that you specified when you ran Maximo Data Loader in a Docker container.

The first time that you access the user interface, a message is displayed that indicates that your browser doesn't trust the Maximo Data Loader self-signed security certificate. Accept the certificate and proceed to the Maximo Data Loader user interface.