Installing Docker

Applies to: On premises

You must install Docker. If you are installing Docker on a Linux® operating system, you must also install Docker Compose.

Before you begin

Ensure that you have a minimum of 20 GB of RAM.

Ensure that you have 100 GB of free disk space on the computer on which you install Docker. On Linux operating systems, the 100 GB of free disk space must be on the disk or partition that contains the Docker data directory, by default /var/lib/docker. Or, configure Docker to use a different directory on a disk or partition that has 100 GB of free space.

On Linux operating systems, the Linux kernel 3.10 or later is required.

On Linux operating systems, you must also enable the extras repositories. For example,

  • On Red Hat Enterprise Linux operating systems, use the following command to enable the extra RHEL repositories:

    sudo yum-config-manager --enable rhel-7-server-extras-rpms

  • On CentOS, use the following command:

    sudo yum-config-manager --enable extras

If you are going to run IBM OpenPages® in a distributed environment, you must install Docker on two computers.

About this task

OpenPages supports the following Docker software versions:
  • Docker Engine for Linux: 18.09.2
  • Docker Desktop for Windows: 2.0.0.3
  • Docker Desktop for Mac: 2.0.0.3

Procedure

  1. Install Docker.

    For more information about installing Docker, see the product documentation:

  2. If you are installing on Linux operating systems, do the following steps:
    1. Create a Docker group and add your user name to the group to allow for easier installation. For more information, see Manage Docker as a non-root user (https://docs.docker.com/engine/installation/linux/linux-postinstall/).
    2. Configure Docker to start when the computer starts up. For more information, see Configure Docker to start on boot (https://docs.docker.com/engine/installation/linux/linux-postinstall/).
    3. Configure the image size limit for Docker.

      If your Docker installation uses the devicemapper storage driver, configure Docker to increase the base device size (the default is 10 GB, and one of the OpenPages Docker images is larger than that). Do this step before you download any images to your host.

      Check if Docker is using devicemapper:
      docker info | grep "Storage Driver"
      If the result is Storage Driver: devicemapper, do the following steps:
      1. Create a file /etc/docker/daemon.json with the following content: 
        $ sudo tee /etc/docker/daemon.json <<-EOF
          {
              "storage-driver": "devicemapper",
              "storage-opts": ["dm.basesize=50G"]
          }
          EOF

        If the daemon.json file already exists, edit it to include the lines in curly braces.

      2. Stop the Docker Engine, flush the changes, clean up local containers and images, and then restart Docker.
        sudo systemctl stop docker
sudo systemctl daemon-reload
sudo rm -rf /var/lib/docker
sudo systemctl start docker
    4. Install Docker Compose. For more information, see Install Docker Compose (https://docs.docker.com/compose/install/).
  3. On Microsoft Windows or macOS operating systems, you must configure resource allocations.
    Microsoft Windows
    1. Right-click the Docker icon on the Windows Taskbar, and click Settings.
    2. On the Advanced tab, allocate at least 4 CPUs, 16 GB for memory, and 100 GB for the disk image.
    3. Click Apply.
    macOS
    1. Click the Docker icon on the Menu bar, and click Preferences.
    2. On the Advanced tab, allocate at least 4 CPUs, 16 GB for memory, and 100 GB for the disk image.
  4. On Microsoft Windows operating systems, set Docker to use Linux containers.
    For more information, see Switch between Windows and Linux containers.