Home

Welcome to the oacis_docker wiki!

Go to Japanese wiki

Introduction

OACIS is a useful job management software for large scale simulations. However, the installability of OACIS is not good for the researchers who use Microsoft Windows OS or who are unfamiliar with Linux OS. oacis_docker is developed to improve the installability of OACIS.

What for docker?

Several tasks to keep running your OACIS in virtual environment are required. Moreover it is not easy to update OACIS version and it is also not easy to make a backup of your simulation data in your virtual machines.

• Difficulties to set up virtual environment

  1. Installing virtual machine pakyer
  2. Setting up file sharing between host and guest
  3. Setting up networking between host and guest
  4. Getting large size virtual machine image file

• Difficulties to manage OACIS in virtual environment

  1. Updating OACIS is required even if OACIS is running in virtual environment
  2. It is difficult to make a backup of OACIS which is running in virtual machine

Advantages in using oacis_docker

• Easy start

  1. Installing docker is easy in Linux, Microsoft Windows and Mac
  2. To start OACIS, you just run the start script on host machine

• Easy management

  1. No requirement of OACIS updating: The start script automatically check and get the latest OACIS image
  2. Automatic making backup: The start script make a back of simulation data

Usage

1. Install docker

[Docker installation page](https://docs.docker.com/installation/) for Linux, Mac OS X, Windows, etc. helps you install docker.

2. Run start script

Get the start script form [crest-cassia/oacis_docker](https://github.com/crest-cassia/oacis_docker), and run the start script. If you use boot2docker, you have to login virtual machine before you get and run the start script.

- for Linux users
```sh
/path/to/oacis_docker/bin/native-linux/run_oacis_docker.sh YOUR_PROJECT_NAME PORT
```

- for Mac and Windows users
```sh
/path/to/oacis_docker/bin/boot2docker/run_oacis_docker.sh YOUR_PROJECT_NAME PORT
```

You can see that OACIS processes are running in the container, and then you can access OACIS via a web browser.

  ```sh
  updating schema...
  Progress ============================================================ 100% (0/0)
  Progress ============================================================ 100% (0/0)
  Progress ============================================================ 100% (0/0)
  bundle exec rails s -d
  => Booting Thin
  => Rails 3.2.17 application starting in development on http://0.0.0.0:3000
  JobWorker started.
  AnalyzerWorker started.
  ServiceWorker started.
  oacis@86d74429c4fc:~$
  ```

Note: Linux user and Mac user can see OACIS top page in `localhost:3000`. Windows users can see OACIS top page in `192.168.59.103:3000`. (Windows users can know the ip address of the host in which OACIS is running, via `boot2docker ip` command.)

Tips

• Tips includes usage of oacis_docker in more detail.