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.

Advantages in using oacis_docker

Linux users can easily install docker package via apt command or yum command. Microsoft Windows users and Mac OS users can easily install docker via boot2docker. oacis_docker has start scripts in ./bin directory and the scripts include docker command lines to start OACIS. Thus, after installing dokcer, user can start using OACIS only by running the start scripts.

Several tasks to keep running your OACIS in virtual environment are not necessary. For example, the version update task is not necessary. When you want to update OACIS version, you logout from the virtual machine, and then you re-login by running start scripts. (The start scripts automatically check and get the latest OACIS image.) For another example, moving files between host machine and virtual machine is not necessary. Because, OACIS data (database data, simulation results) is automatically shared with the host file system.

• Easy installation

  1. In, Linux, Microsoft Windows and Mac, it is enable to install docker
  2. The start script creates shared directories between host file system and virtual machine file system
  3. Network configuration is automatically established
  4. The start script automatically get the OACIS image

• Easy management

  1. The start script automatically check and get the latest OACIS image
  2. The start script make a back of OACIS data in the shared directories

Usage

1. Install docker

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

2. Ruun 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.

```sh
git clone https://github.com/crest-cassia/oacis_docker ~/work/oacis_docker
cd /path/to/YOUR_PROJECT_ROOT_DIRECTORY
~/work/oacis_docker/bin/run_oacis_docker.sh PROJECT_NAME 3000
```
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:~$
  ```

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`. (Note: Windows users can know the ip address of the host in which OACIS is running, via `boot2docker ip` command.)

3. Access the page of OACIS from your local machine

- You can see OACIS web interface via a web browser `http://localhost:3000`.

Tips

• Tips