Step 5. Downloading Container Images and Starting the Docker Containers

Docker Compose will be starting up four containers, and for the three of them, the connection port is set to an automatically selected random high port number. However, the Panopticon container must use a known, static port since you will use it through a browser window. If your host system already has any process running which binds to port 8080 (the Panopticon container), then the container startup will fail.

Container Name Container Port Host Port

panoviz-1

8080

Static, set to 8080

monetdb-1

50000

Automatic, random

rserve-1

6311

Automatic, random

pyserve-1

9090

Automatic, random

 

If you depend on having some other application running on the same host, exposing port 8080, you have the option of changing the port mapping of the Panopticon container. You do this while the containers are stopped (command docker compose down, or press Stop in Docker Desktop).

Open the docker-compose.yaml file in the PanopticonDocker Compose package and change the value. For example, "8080:8080" to “8081:8080”, or some other suitable port number. Likewise, you can choose to set a static port number to anyone of the other three containers, instead of relying on an automatically selected, random port, for example by changing from “:9090” into “9090:9090” or something else.

 

For Linux

  1. On the command line, go to the folder where you have the files .env and altair-repo-login.sh.

    Add execute permissions to the folder pano-mount including all files and folders in it:

    chmod -R 777 pano-mount

  2. Run this command:

    ./altair-repo-login.sh

    NOTE:

    You may also find that you need to use sudo to run altair-repo-login.sh:

    sudo./altair-repo-login.sh

    This will establish an authenticated session with the Altair Docker image repository from where you will be downloading or pulling the images for the four containers included in the Docker Compose package.

  3. Run this command:

    docker compose up

    NOTE:

    You may also find that you need to use sudo to run docker compose up:

    sudo docker compose up

    This will start the download of the docker container images, and the containers will be mounted. The download is needed only at this first start.

    The containers will be up when you see a line like the following:

    panoviz-1 | dd-MMM-YYYY HH:mm:ss.SSS INFO [main] org.apache.catalina.startup.Catalina.start Server startup in [xyz] milliseconds

  4. Verify that you can reach Panopticon by opening a web browser and going to the URL:

    http://localhost:8080/

 

For MacOS

  1. Start Docker Desktop by clicking the app icon.

    NOTE: You must open Settings > Resources > File sharing in Docker Desktop and add the pano-mount folder before starting up the containers, otherwise the bind will fail when mounting the containers.

  2. On the command line, go to the folder where you have the files .env and altair-repo-login.sh.
  3. Run this command:

    ./altair-repo-login.sh

    This will establish an authenticated session with the Altair Docker image repository from where you will be downloading or pulling the images for the four containers included in the Docker Compose package.

  4. Run this command:

    docker compose up

    This will start the download of the docker container images, and the containers will be mounted. The download is needed only at this first start.

    The containers will be up when you see a line like the following:

    panoviz-1 | dd-MMM-YYYY HH:mm:ss.SSS INFO [main] org.apache.catalina.startup.Catalina.start Server startup in [xyz] milliseconds

  5. Verify that you can reach Panopticon by opening a web browser and go to the URL:

    http://localhost:8080/

    NOTE: Following this initial download and mount of the Docker Compose containers, you no longer need to use the command line to start and stop the containers. You can do that in the GUI of Docker Desktop for macOS.

 

For Windows

  1. Start Docker Desktop by clicking the app icon.

    NOTE: On Windows, you don’t have the option of starting the Docker daemon from command line, since that usage is supported only for Windows containers, not Linux containers.

  2. Open a command line window and go to the folder where you have the files .env and altair-repo-login.bat.
  3. Run this command:

    altair-repo-login.bat

    This will establish an authenticated session with the Altair Docker image repository from where you will be downloading or pulling the images for the four containers included in the Docker Compose package.

  4. Run this command:

    docker compose up

    This will start the download of the docker container images, and the containers will be mounted. The download is needed only at this first start.

    The containers will be up when you see a line like the following:

    panoviz-1 | dd-MMM-YYYY HH:mm:ss.SSS INFO [main] org.apache.catalina.startup.Catalina.start Server startup in [xyz] milliseconds

    You will also see the containers on the Containers tab in Docker Desktop, where you can also monitor Container CPU usage and memory usage.

  5. Verify that you can reach Panopticon by opening a web browser and go to the URL:

    http://localhost:8080/

    NOTE: Following this initial download and mount of the Docker Compose containers, you no longer need to use the command line to start and stop the containers. You can do that in the GUI of Docker Desktop for Windows.

 

 

 

(c) 2013-2024 Altair Engineering Inc. All Rights Reserved.

Intellectual Property Rights Notice | Technical Support