OACIS DOC
last updated on 17 August 2026

インストール方法

OACISを利用するには

の両方を行う必要があります。

OACISをインストールするには、

の２種類があります。

Windowsの方は(1.1)を選択してください。Unix系OS(Linux,Mac)の場合にはどちらの方法によっても環境構築ができます。 初めての方はセットアップが容易な仮想環境を推奨します。仮想環境の場合、次ページのチュートリアルがすぐに始められます。 より本格的に運用したい場合は(1.2)の方法に移行するのがよいでしょう。

ここではそれぞれのセットアップ方法を解説します。

(1.1) 仮想環境を使ったOACISのインストール

Dockerというツールを使ってOACISがインストールされた仮想環境を手軽に導入することができます。 Linuxだけでなく、Windows、MacOSにも導入することができます。 手順の概要は以下の通りです。

インストール手順はoacis_dockerのREADMEを参照してください。 oacis_dockerはOACISのDockerイメージを作成するプロジェクトです。 ここで作成されているイメージには、次ページのチュートリアルのStep1までが実行済みの状態で保存されています。

(1.2) 手動でのOACISのインストール

対象プラットフォーム

前提条件

Rubyのインストールにはrbenvまたはrvmを使って環境を整えるのがよいです。

Mac OS Xの場合、homebrew (http://brew.sh/) を使ってrbenvとMongoDBをインストールするのが手軽です。 Linuxの場合、yumやaptコマンドを使ってインストールできます。

bundlerはRubyに標準ライブラリとして添付されるので、個別にインストールする必要はありません。

MacOSXでの前提条件の整え方

ここではhomebrewを用いてセットアップしていきます。

Linuxでの前提条件の整え方

ここではUbuntu 24.04を例に取り、apt-getを用いてセットアップしていきます。

インストール・railsの起動チェック

まず手元にOACISのソースコード一式をgit cloneします。（gitがない場合はダウンロードします。）

git clone --recursive -b master https://github.com/crest-cassia/oacis.git

クローンしたディレクトリに移動し、以下のコマンドを実行するとRubyのバージョン、bundlerのインストール、MongoDBのバージョン、MongoDBのデーモンがシングルノードのreplica setとして起動していることを確認する事ができます。

./bin/check_oacis_env

次にRailsおよび関連gemのインストールを行います。ダウンロードしたディレクトリ内に移動し、

bundle install

を実行します。

成功すればこの時点でRailsを起動できます。試しに以下のコマンドで起動します。

bundle exec rails s

localhost:3000 にアクセスし、ページが適切に表示されればインストールは成功しています。 端末で Ctrl-C を押し、Railsを停止します。 もし失敗した場合は、MongoDBが正しく起動しているか、gemは正しくインストールされたか、などを確認してください。

起動

Railsおよびworkerの起動は以下のコマンドを実行します。

bundle exec rake daemon:start

localhost:3000 にアクセスできればRailsの起動が成功しています。 またWorkerプロセスが起動しているかどうかは localhost:3000/runs にアクセスすれば確認できます。 Workerが起動していない場合にはエラーメッセージが表示されます。

これらのプロセスの再起動、および停止は以下のコマンドで実行できます。

bundle exec rake daemon:restart
bundle exec rake daemon:stop
Tips
ジョブを投入後、全てのジョブが完了していなくてもOACISを停止することは可能です。 OACISが停止している間も実行中のジョブは計算ホストでそのまま動き続けます。次にOACISが起動したタイミングで完了したジョブがデータベースに取り込まれます。

(2) 計算ホストのセットアップ

チュートリアル実行用の仮想環境を利用する場合はこのステップは不要です。仮想環境をジョブ実行用のリモートホストとしても利用します。

ジョブ実行用のホストは以下の手順でセットアップします。以後、OACISを実行しているホストを「OACISホスト」、ジョブを実行するホストを「計算ホスト」と呼ぶことにします。 OACISホストと計算ホスト

  1. (OACISホストにて) OACISホストから鍵認証でSSH接続できるようにセットアップする。
    • ssh-keygen -t rsa を実行し、SSH認証用の鍵を作成する。
      • パスフレーズは自分で適当なものを設定します。
      • このコマンドにより秘密鍵、公開鍵がそれぞれ ~/.ssh/id_rsa, ~/.ssh/id_rsa.pub に作成されます。
    • 公開鍵をリモートホストに転送し、”authorized_keys”に追加する。
      • ssh-copy-idコマンドを使うと便利です。
    • ~/.ssh/configファイルを以下の形式で作成する。 
      Host my_host
  HostName 127.0.0.1
  Port 22
  User my_user
  IdentityFile ~/.ssh/id_rsa
      • Hostには好きな名前を指定可能
      • HostNameにリモートホストのアドレスを指定
      • Userにはログインユーザ名を指定
      • IdentityFileには生成した秘密鍵を指定
      • OACIS v3より、IP・port・ユーザ名の指定はwebインターフェースを用いず、~/.ssh/configを参照する仕組みになりました。
    • 接続確認を行う。
      • ssh my_host でパスワードを使わずにログインできたら成功です。
        • 鍵作成時にパスフレーズを入力した場合は、ログイン時にパスフレーズの入力が要求されます。OACISの実行時にはパスワードもパスフレーズも入力せずにログインできるようにセットアップする必要があります。パスフレーズの入力を省略するには
          • (macOS Sierra以降の場合) ssh-add ~/.ssh/id_rsaを実行します。この際パスフレーズの入力を要求されますが、以降はパスフレーズの入力を省略できます。
          • (Linuxの場合) SSH Agentを利用します。以下のコマンドを入力してください。（これらのコマンドはシステムにログインするたびに実行する必要があります。）
            • eval `ssh-agent` (SSH agentを起動する）
            • ssh-add ~/.ssh/id_rsa （秘密鍵のパスを指定する。このときにパスフレーズの入力を要求されますが、以降はパスフレーズの入力を省略できます。
            • さらに入力を簡便にするためにKeychainというツールもあります。
  2. (計算ホストにて) xsub または xsub_py を導入する。
    • xsubというのは、ジョブスケジューラの仕様の差異を吸収するスクリプトで、OACISはxsubコマンドを利用してジョブを投入します。
    • xsubの実行にはruby2.0以降が必要です。システムにインストールされていない場合はRubyもインストールしてください。
    • xsub_py はPythonで実装されたxsubコマンドで、Python 3.6以降が必要です。
    • 詳細はxsubのREADMEまたはxsub_pyのREADME を参照してください。
  3. (OACISホストにて) 導入の確認
    • ssh remotehost 'bash -l -c xstat' を実行します。エラーメッセージが出ずに、リモートホストのステータスが表示されれば完了です。
      • もしSSH接続に失敗している場合は1の設定を見直します。
      • xsubコマンドが見つからないというエラーの場合は3の設定を確認してください。
    • さらなる確認
      • 上記のコマンドラインからの ssh 接続がうまく行っても、OACIS からうまくホスト登録できない場合が有ります。その場合、ssh 接続について以下の確認を行ってみて下さい。長いメッセージが表示されますが、接続がうまく行っていれば、エラーなく ssh のセッションがひらきます。エラーが生じていれば、デバッグメッセージをたどって、接続の不具合をチェックしてみて下さい。 
        $ irb
> require 'net/ssh'
> ssh = Net::SSH.start("remotehost", "oacis", verbose:Logger::DEBUG)

注意点（(1.1)の場合も(1.2)の場合も共通）

OACISをインターネットに公開しないでください。 OACISは計算ホストとして登録したサーバー内で任意のコマンドを実行できるので、悪意のあるユーザーからアクセスされるとセキュリティホールになります。 各個人のマシン上で起動し、他の人からのアクセスを受け付けないようにして置く必要があります。

OACIS 2.11.0から、デフォルトで127.0.0.1のアドレスにバインドされる様になりました。他のマシンからはOACISにアクセスできません。 MongoDBもデフォルトでは127.0.0.1にバインドされるので、デフォルトで使っている限りさらに対策を行う必要はありません。 バージョン2.10以前のOACISを利用している場合は、ファイアウォールの設定を行い3000番ポートへのアクセスを制限してください。

Docker環境を使用している場合は、公開されたポートをローカルホストにバインドすることが望ましいです。こうすることにより他のホストからアクセスできなくなります。 docker runコマンドを実行する際に、-pオプションで127.0.0.1にバインドするようにしてください。

docker run -p 127.0.0.1:3000:3000 -dt oacis/oacis

外部からのアクセスを制限するとOACISの利便性が失われると心配かもしれませんが、このように設定しても外部からSSHのポートフォワーディングを利用することでOACISを使うことができます。 OACISを server.example.com で起動している場合、以下のコマンドを実行すると localhost:3000 でOACISにアクセスできるようになります。 （”server.example.com”をOACISが起動しているサーバーに置き換えて実行してください。）

ssh -N -f -L 3000:localhost:3000 server.example.com

更新

OACISの更新

“oacis”ディレクトリで以下のコマンドを実行してください。

bundle exec rake daemon:stop            # tentatively stop OACIS
git pull origin master                  # get the latest source code of OACIS
git pull origin master --tags
git submodule update --init --recursive
bundle install                          # install dependency
bundle exec rake daemon:start           # restart OACIS

OACIS v2からv3への更新

OACIS v3ではMongoDBをv3.6以降に、Rubyを2.5.1以降にアップデート、および新規にredisをインストールする必要があります。

MongoDBの更新

MongoDBをアップデートする際には2.6 -> 3.0 -> 3.2 -> 3.4といった段階的アップデートをしないとデータの互換性が維持されません。 ここでは一度に最新版に更新するため「OACISのデータのバックアップ」-> 「MongoDBを最新版に更新」-> 「OACISのデータのレストア」という手順で行うことを推奨します。 詳細は公式ドキュメントを参照してください。

SSH-configの編集

V3ではHostの設定項目から、”Hostname”, “User”, “Port”, “IdentityFile”がなくなりました。代わりに”~/.ssh/config”ファイルにこれらの情報を記述してください。

OACISの再起動

bundle install                          # install dependent libraries
bundle exec rake daemon:start           # restart OACIS

OACIS v3からv4への更新

OACIS v4では利用するソフトウェアスタックが更新されました。Ruby 3.2以降（Ruby 2.x系はサポート対象外。3.4を推奨）と、シングルノードのreplica setとして起動するMongoDB 6.0以降（OACIS v4はreplica setを必要とするMongoDBのトランザクションを利用するため）が必要です。内部的にはRails 7.2、Mongoid 9にアップグレードされています。

保存されるデータの形式は変わらないため、データの移行作業は不要です。ただし、MongoDBをシングルノードのreplica setとして再設定する作業は必須です。スタンドアロンのmongodではv4は動作しません。以下の手順で更新してください。

Rubyの更新

前提条件の項で説明した通り、rbenvまたはrvmでRuby 3.2以降（3.4を推奨）をインストールしてください。

rbenv install 3.4.2 && rbenv global 3.4.2
rbenv rehash
ruby --version   # 3.2以降であることを確認

MongoDBの更新

MongoDBが6.0より古い場合は6.0以降に更新してください。MongoDBはメジャーバージョン間を段階的にアップグレードする必要があるため、データをダンプし、新しいMongoDBをインストールしてからデータを書き戻すのが簡単です。

mongodump --db oacis_development   # データをバックアップ
# ... MongoDB 6.0以降をインストール ...
mongorestore --db oacis_development dump/oacis_development   # データを書き戻す

詳細は公式ドキュメントを参照してください。

MongoDBをシングルノードreplica setとして設定（必須）

OACIS v4では、単一マシンで運用する場合でもMongoDBをシングルノードのreplica setとして起動する必要があります。 MongoDBの設定ファイル（Homebrewの場合は /opt/homebrew/etc/mongod.conf、Linuxの場合は /etc/mongod.conf）に以下を追記してください。

replication:
  replSetName: rs0

MongoDBを再起動した後、以下を一度だけ実行してreplica setを初期化します。

mongosh --eval 'rs.initiate({_id: "rs0", members: [{_id: 0, host: "localhost:27017"}]})'

replica setが設定されていない場合、OACIS v4は起動しません。設定は ./bin/check_oacis_env で確認できます。

OACISの更新と再起動

bundle exec rake daemon:stop            # OACISを停止
git pull origin master                  # 最新のソースコードを取得
git pull origin master --tags
bundle install                          # 依存ライブラリをインストール
bundle exec rake daemon:start           # OACISを再起動

注意. OACIS v4ではPython API（oacis Pythonパッケージ）は同梱されなくなりました。再現可能なスクリプトによる操作はRuby APIで、AIエージェントによる対話的な操作は新しいMCPサーバで行えます。

OACISのユーザーメーリングリストに登録することをお勧めします。新規リリースについての情報がメールで通知されます。 oacis-users mailing list

Next »