The WebTrilinos, browser-based Trilinos repository can be accessed via a Docker Image. Instructions for obtaining the Image and installing Docker are below.

1.Follow these directions to install Docker on your local machine:

Note: For OS X and Windows, ensure that hardware virtualization is enabled in your BIOS settings. You may also have to disable Hyper-V in Windows Features.

Note: For OS X and Windows, Docker Toolbox will install Oracle VM VirtualBox if it is not already installed. If you already have VirtualBox installed on your machine, you do not have to uninstall it prior to installing Docker Toolbox. Native support for running Docker on Windows and OS X is in “beta” currently. The native support option does not require VirtualBox.

2. Open Docker:

  • Linux: Open a terminal, and then start the Docker service if it is not already started.

Note: For Linux, Docker requires sudo to run. You can avoid this by adding users to the docker group, but be warned that the docker group is equivalent to giving a user root access.

  • OS X and Windows: Open the Docker Quickstart Terminal application. A terminal window should appear and start the Docker Toolbox VM. You will see a single $ when it is done loading.

Note: If you have an issue connecting to the VM (an error message like No connection could be made because the target machine actively refused it when you run a command), open VirtualBox and delete the ‘default’ machine. Then re-run Docker Quickstart Terminal as an administrator. If you still have problems, ensure that hardware virtualization is enabled in your BIOS settings and you have disabled Hyper-V in Windows Features.

3. Pull the WebTrilinos image by entering the following command:

docker pull sjdeal/webtrilinos:12_2

You can confirm that the image was pulled by running docker images

4. Start a new container from the image by entering the following command (all one line):

docker run -d -p 9999:80 --name=WebTrilinos sjdeal/webtrilinos:12_2 usr/sbin/apache2ctl -D FOREGROUND

This will bind port 9999 of the container to port 80 of the host machine and start Apache in the container. The container port number can be changed from 9999 if you wish.

5. Open WebTrilinos in a browser:

  • Linux: Access localhost:9999/WebTrilinos from a web browser.
  • OS X/Windows: Run docker-machine ip default to find the IP address for the VM, then access :9999/WebTrilinos from a web browser.

WebTrilinos is already configured to work properly in the container. You can proceed to use WebTrilinos!

Since the Python and MatrixPortal modules are unsupported, it is recommended that users use the C++ interface page as their landing page for using WebTrilinos.

Docker Command Reference

  • docker exec <container-name> <command>: Executes a command in a running container
  • docker images: Lists all images available on the local machine
  • docker inspect <container-name>: Displays information about a container
  • docker inspect <image-ID>: Displays information about an image
  • docker ps -a: Shows all containers
  • docker pull <image-name>: Pulls an image from the Docker Hub Registry
  • docker rename <container-name> <new-name>: Renames a container
  • docker rm <container-name>: Removes a container
  • docker rmi <image-ID>: Removes an image
  • docker run <image-ID> <command>: Creates a new container and runs a given command
  • docker start <container-name>: Starts a stopped container
  • docker stop <container-name>: Stops a running container
  • docker run -it <image-ID> <command>: Starts a new container and executes a command

(for example docker run -it --name=WebTrilinos sjdeal/webtrilinos:12_2 /bin/bash, name is optional)