Home

Welcome to oacis_docker wiki!

Go to Japanese wiki

Index

• Introduction
• SSH key
• Job submission
• Install additional packages

Introduction

OACIS is an useful software to manage a lot of simulation jobs. However, the installability of OACIS may not be good for the researchers who use Microsoft Windows OS or who are unfamiliar with Linux OS. oacis_docker is developed to help such researchers easily start using OACIS.

SSH Key

• OACIS requires ssh connections.
• Two ways to put the ssh key on a container are shown in the following.

  1. Put existing private ssh key on the container

     • Copy the ssh key via docker cp command, and then change the file permission after login the container via docker exec command.

       docker cp ~/.ssh/id_rsa oacis:/home/oacis/.ssh/id_rsa_remote
       docker exec oacis bash -c "chmod 600 /home/oacis/.ssh/id_rsa_remote"
       docker exec oacis bash -c "chown oacis:oacis /home/oacis/.ssh/id_rsa_remote"

  2. Get public ssh key from the container

     • Get the ssh key via docker cp command.

       docker cp oaics:/home/oacis/.ssh/id_rsa.pub .
       #You can find id_rsa.pub

     • Register the id_rsa.pub to a remote host.

Job submission

• Host Registration

  1. Remote Host

     • No particular comment

  2. Local Host

     • localhost as a Host is registered when you start a new container.

     • localhost is not localhost as the address of host_machine but an address of virtual_machine

     • localhost has following fields.

       Name=localhost
       Hostname=localhost
       Status=enabled
       User=oacis
       Port=22
       SSH\ key=~/.ssh/id_rsa
       Work base directory=~/oacis/public/Result_development/work/__work__
       Mounted work base directory=~/oacis/public/Result_development/work/__work__
       Maximum number of jobs=1
       Polling interval=5
       MPI procs=1
       OMP threads=1

• Simulator and Analyzer Registration, Creating ParameterSet, Run and Analysis

  1. Operation via web browser interface

     • No particular comment

  2. Operation via oacis_cli

     • Run oacis_cli command after logging in the container via docker exec command.

       docker exec -it -u oacis oacis bash -l
       cd ~/oacis
       ./bin/oacis_cli usage

Install additional packages

• Install Additional Packages

  • Example of gnuplot installation

    docker exec -it oacis bash
    apt-get update && apt-get install -y gnuplot && apt-get clean