Super SIMPLE docker-compose with mirroring (version 2019.3 and later)

This is a very simple docker-compose with a simple class that creates 2 IRIS instances, in 2 different servers (serverA and serverB), configured in mirror. Also, it will define de mirror (MIRRORSET) and create 1 new DDBB in each server instance, called MIRRORDB, that will be mirrrored and configured under namespace MIRRORNS.

Requirements

• docker & docker-compose
• IRIS image (or docker repository with IRIS)
• iris.key

How to

Put the iris.key license in ./install directory.

Regarding the Iris docker image, you can either download from Intersystems or use a docker hub repository:

• Download an image from Intersystems and load the image

  Download the version you need from Intersystems and use docker load command to load the image. You will need to have access to wrc.intersystems.com, then go to distributions and find the version you need. I recommend to download 2019.3 and later. When I was writing this the version "iris-2019.3.0.302.0-docker.tar.gz" was under the preview tag (where you can also get a preview License key)

  docker load -i iris-2019.3.0.302.0-docker.tar.gz
  docker-compose up -d

• Or use a docker hub to download the image

  If you have a docker hub with images, just change the image inside the docker-compose.yml. For example:

  image: containers.intersystems.com/intersystems/iris:2019.3.0-latest

  you will need to be logged:

  $ docker login containers.intersystems.com

Useful commands

• Start a iris session in servarA (initially is Primary)

docker exec -it serverA iris session iris

• Start a iris shell in serverB (initially Backup)

docker exec -it serverB bash

• Connect to SMP serverA (Primary initially) http://127.0.0.1:9092/csp/sys/UtilHome.csp

• Connect to SMP serverB (Backup initially) http://127.0.0.1:9093/csp/sys/UtilHome.csp

**The first time you login you will need to use default credentials:

• Username: SuperUser
• Password: SYS

To clean and try a different version

Stop the containers:

docker-compose down
docker-compose up -d

Notes

Starting with 2019.3 IRIS containers use "irisowner" instead of "root", so the installation is a Nonroot installation. See https://irisdocs.intersystems.com/irislatest/csp/docbook/DocBook.UI.Page.cls?KEY=GCI_unix#GCI_unix_install_nonroot

This allow the scripts to be simpler and you don't need to pass credentials. The folder "irismirror older versions" contains the same simple mirror working for older versions. See readme inside.