オフラインインストール※本書では「Operation Autonomy Support Engine」を「OASE」として記載します。

第1.2版
Exastro developer目次
1. はじめに
1.1 本資料について
2. システム構成
2.1 動作環境・条件(1/2)
2.2 動作環境・条件(2/2)
3. OASE環境構築手順
3.1 オフラインインストール
3.2 事前準備
3.3 OASE環境構築フロー
3.4 環境構築（1/16）
3.5 環境構築（2/16）
3.6 環境構築（3/16）
3.7 環境構築（4/16）
3.8 環境構築（5/16）
3.9 環境構築（6/16）
3.10 環境構築（7/16）
3.11 環境構築（8/16）
3.12 環境構築（9/16）
3.13 環境構築（10/16）
3.14 環境構築（11/16）
3.15 環境構築（12/16）
3.16 環境構築（13/16）
3.17 環境構築（14/16）
3.18 環境構築（15/16）
3.19 環境構築（16/16）

4. OASE動作確認
4.1 動作確認（1/4）
4.2 動作確認（2/4）
4.3 動作確認（3/4）
4.4 動作確認（4/4）
5. 参考
5.1 参考1. はじめに1.1

本資料について▌本資料について
 本資料では、OASEサーバをオフライン環境でご利用いただく場合の、構築手順について記載しています。

Exastro4

2. システム構成

2.1

動作環境・条件（1/3）▌OASEをご利用いただくための環境について。
 「Exastro-OASE_環境構築マニュアル –基本編-」を参照してください。

Exastro6

2.1

動作環境・条件（2/3）▌ライブラリ収集を実行する場合の前提条件
 ライブラリ収集を実行する場合には、ライブラリ収集用サーバ（オンライン環境）/ OASEサーバ（オフライン環境）、両サーバの構築状態（OSのバージョン、インストール済のパッケージ）を、合わせる必要があります。
 ライブラリ収集用サーバ（オンライン環境）は、以下のリポジトリが参照できる状態である必要があります。

（※次頁に記載）

Exastro7

2.1

動作環境・条件（3/3）▌ライブラリ収集を実行する場合の前提条件
 参照するリポジトリ一覧
リポジトリ

OS

https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
https://downloads.mariadb.com/MariaDB/mariadb_repo_setup

RHEL7

epel
rhel-7-server-optional-rpms
rhel-server-rhscl-7-rpms
https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm

RHEL8

https://downloads.mariadb.com/MariaDB/mariadb_repo_setup
rabbitmq_rabbitmq-server
https://downloads.mariadb.com/MariaDB/mariadb_repo_setup

CentOS7

epel
epel-release

Exastro8

3. OASE環境構築手順

3.1

オフラインインストール▌インストール手順について
OASEサーバがオフライン環境の場合、以下の手順で環境構築を行います。

 ライブラリ収集用のサーバ(オンライン)にてインターネット経由で必要なライブラリを収集し、OASEインストールパッケージとライブラリを一つに圧縮し、インストールパッケージ(オフライン用)を作成します。
 記憶媒体等でOASEサーバに、インストールパッケージ(オフライン用)を移動します。
 インストールパッケージ(オフライン用)からローカルリポジトリを作成し、必要なライブラリのインストールと、OASEインストーラーの実行を行います。
ライブラリ
収集用のサーバ

オンライン

インターネット
リポジトリ

インストールパッケージ(オフライン用)

ライブラリ

OASE サーバ

OASE
JAVA(openJDK)、JBoss、Python(uWSGI)、 Django
RabbitMQ Server、MariaDB
Server、Apache
RHDM、 Maven

ローカルリポジトリ

オフライン
Exastro

10

3.2

事前準備

▌OASE環境構築ツール一覧
 OASE環境構築ツール一覧は以下となります。
説明ファイル格納先

OASEインストーラー

oase_installer.sh/(インストール資材展開先)/oase/oase_install_package/install_scripts/

アンサーファイル

oase_answers.txt/(インストール資材展開先)/oase/oase_install_package/install_scripts/▌RHELサブスクリプションについて
 クラウド環境以外のRHEL7・RHEL8のOSの環境でライブラリ収集をする場合は、その環境へのサブスクリプション登録を事前に完了させてください。

Exastro11

3.3

OASE環境構築フロー▌環境構築フロー（オフライン）
 環境構築は以下のフローとなっています。
ライブラリ収集用サーバ(オンライン)①Githubからの資材ダウンロード②アンサーファイル編集③OASEインストーラー（ライブラリ収集）実行●処理内容
1. Yumリポジトリの設定
2. ライブラリ収集
3. オフラインインストール用
圧縮ファイル作成④インストールパッケージ（オフライン用）をOASEサーバへ記憶媒体等で移動

ExastroOASEサーバ作業(オフライン)⑤インストールパッケージ（オフライン用）展開⑥アンサーファイル編集③OASEインストーラー(オフラインインストール)実行●処理内容
1. OS環境設定
2. Yumリポジトリの設定
3. MariaDBインストール
4. Apacheインストール
5. python関連インストール
6. RHDMインストール
7. RabbitMQインストール
8. OASE本体インストール

12

3.4

環境構築（1/16）※オンライン環境で実施します※環境構築ユーザーはrootユーザーで実施すること。
▌Githubからの資材ダウンロード
 以下のコマンドで資材をDLします。
# wget https://github.com/exastro-suite/oase/releases/download/vx.x.x/exastro-oasex.x.x.tar.gz※wgetコマンドは事前にインストールしてください。
※バージョン(x.x.x)は適宜変更してください。

▌資材の展開 .tar.gz ファイルを解凍します。
# tar zxf exastro-oase-x.x.x.tar.gz▌ディレクトリ移動
 環境構築を設定を行うセッティングファイルとシェルのあるディレクトリに移動します。
# cd exastro-oase-x.x.x/oase_install_package/install_scripts
Exastro13

3.5

環境構築（2/16）▌アンサーファイル(oase_answers.txt)を編集
 ライブラリ収集を行う前にアンサーファイルを事前に作成してください。
 ライブラリ収集を行う場合は「install_mode」の設定値を「Gather_Library」にしてください。
種目

必須

初期値

説明

インストールモードの設定
・Install_Online：オンラインインストール
・Install_Offline：オフラインインストール
・Gather_Library：ライブラリ収集
・Versionup_All：OASE本体のバージョンアップ(ライブラリのインストールあり)・Versionup_OASE：OASE本体のバージョンアップ(ライブラリのインストールなし)
・Uninstall：OASE本体のアンインストール※詳細は参考参照

install_mode○

Install_Online

RabbitMQ_username○

administrator

RabbitMQのユーザー名

RabbitMQ_password○password

RabbitMQのパスワードRabbitMQ_queuename

○

oase

RabbitMQのキューの名前（生成されるので任意のもの）

RabbitMQ_ipaddr○-

RabbitMQのIPアドレス

db_root_password○password

MariaDBのrootパスワード

db_name○

OASE_DBOASE用MariaDBデータベースの名前

db_username○

OASE_USEROASE用MariaDBデータベースのユーザー名

Exastro14

3.6

環境構築（3/16）▌アンサーファイル(oase_answers.txt)を編集(2/3)
 OASE環境構築の設定を行うセッティングファイル(oase_answers.txt)の編集方法を以下に示します。
種目

必須

初期値

説明

db_password○

OASE_PASSWD

OASE用MariaDBデータベースのパスワード

db_erase○-

OASEのアンインストール時、DBを消すか、残すかの選択

jboss_root_directory○/exastro/WildFlyJbossのインストール先

rhdm_adminname○

admin0000

RHDMの管理者名

rhdm_password○

password@1

RHDMのパスワード

dm_ipaddrport○

localhost:8080

RHDMのIPアドレスとポート番号

rulefile_rootpath○/exastro/rule

RHDMのルール設定ファイルパス（生成されるので任意の場所）

apply_ipaddrport○

127.0.0.1:50001

Applyサービスが起動するIPとポート

mavenrep_path○/root/.m2/repository/com/oase/Maven

oasemail_smtp○"{'IPADDR':'127.0.0.1','PORT':25,'AUTH':False}"

OASEのメールサーバー設定

oase_directory○/exastro

OASEのインストール先パス

Exastrojarファイルの格納場所

15

3.7

環境構築（4/16）▌アンサーファイル(oase_answers.txt)を編集(3/3)

種目

必須

初期値

説明

oase_domain○

exastro-oase.local

OASEのドメイン名

certificate_path

任意－

ユーザ指定のSSLサーバ証明書に使用するファイルのファイルパス
(ユーザ指定のSSL証明書使用時のみ入力。絶対パスで指定してください)－

ユーザ指定のSSL秘密鍵に使用するファイルのファイルパス
(ユーザ指定のSSL秘密鍵使用時のみ入力。絶対パスで指定してください)

private_key_path

Exastro

任意16

3.8

環境構築（5/16）▌OASEインストーラー（ライブラリ収集）の実行
 以下のコマンドで、OASEインストーラー（ライブラリ収集）を実行します。
# sh oase_installer.sh▌処理の確認 ライブラリ収集スクリプトを実行すると、oase_install.log に処理内容が出力されます。
 ログ格納パス/(インストール資材展開先)/oase_install_package/install_scripts/log/▌ファイルの移動
 インストールパッケージ（オフライン用）をOASEサーバへ記憶媒体等で移動します。

※以降の手順は、OASEサーバ（オフライン環境）で実施します▌インストールパッケージ（オフライン用）展開 OASEサーバ上で、インストールパッケージ（オフライン用）を展開します。
# tar zxf oase_Verx.x.x_offline_yyyymmddhhmmss.tar.gz

Exastro17

3.9

環境構築（6/16）▌アンサーファイル(oase_answers.txt)を編集
 ライブラリ収集を行う前にアンサーファイルを事前に作成してください。
 ライブラリ収集を行う場合は「install_mode」の設定値を「Install_Offline」にしてください。
• アンサーファイル(oase_answers.txt)の項目一覧（1/3）
種目

必須

初期値

説明

インストールモードの設定
・Install_Online：オンラインインストール
・Install_Offline：オフラインインストール
・Gather_Library：ライブラリ収集
・Versionup_All：OASE本体のバージョンアップ(ライブラリのインストールあり)・Versionup_OASE：OASE本体のバージョンアップ(ライブラリのインストールなし)
・Uninstall：OASE本体のアンインストール※詳細は参考参照

install_mode○

Install_Online

RabbitMQ_username○

administrator

RabbitMQのユーザー名

RabbitMQ_password○

password

RabbitMQのパスワード

RabbitMQ_queuename○oase

RabbitMQのキューの名前（生成されるので任意のもの）

RabbitMQ_ipaddr○-

RabbitMQのIPアドレス

db_root_password○

password

MariaDBのrootパスワード

db_name○

OASE_DBOASE用MariaDBデータベースの名前

db_username○

OASE_USEROASE用MariaDBデータベースのユーザー名

Exastro18

3.10 環境構築（7/16）▌アンサーファイル(oase_answers.txt)を編集(2/3)

種目必須

初期値

説明

db_password○

OASE_PASSWD

OASE用MariaDBデータベースのパスワード

db_erase○-OASEのアンインストール時、DBを消すか、残すかの選択

jboss_root_directory○/exastro/WildFly

Jbossのインストール先

rhdm_adminname○

admin0000

RHDMの管理者名

rhdm_password○

password@1

RHDMのパスワード

dm_ipaddrport○

localhost:8080

RHDMのIPアドレスとポート番号

rulefile_rootpath○/exastro/rule

RHDMのルール設定ファイルパス（生成されるので任意の場所）

apply_ipaddrport○

127.0.0.1:50001

Applyサービスが起動するIPとポート

mavenrep_path○/root/.m2/repository/com/oase/Maven

oasemail_smtp○"{'IPADDR':'127.0.0.1','PORT':25,'AUTH':False}"

OASEのメールサーバー設定

oase_directory○/exastro

OASEのインストール先パスExastro

jarファイルの格納場所

19

3.11 環境構築（8/16）▌アンサーファイル(oase_answers.txt)を編集(3/3)

種目

必須

初期値

説明

oase_domain○

exastro-oase.local

OASEのドメイン名

certificate_path

任意－

ユーザ指定のSSLサーバ証明書に使用するファイルのファイルパス
(ユーザ指定のSSL証明書使用時のみ入力。絶対パスで指定してください)－

ユーザ指定のSSL秘密鍵に使用するファイルのファイルパス
(ユーザ指定のSSL秘密鍵使用時のみ入力。絶対パスで指定してください)

private_key_path

Exastro任意20

3.12 環境構築（9/16）▌ユーザ指定サーバ証明書・秘密鍵について
 サーバ証明書と秘密鍵にユーザが用意したファイルを使用することができます。使用する場
合は、サーバ証明書と秘密鍵の両方を用意し、アンサーファイル(oase_answers.txt)の「certificate_path」と「private_key_path」の両方にファイルパスを入力してください。
証明書と秘密鍵どちらか片方のみの使用はできません。
 サーバ証明書に中間証明書が付属している場合は、サーバ証明書に中間証明書を連結してファイルを作成し、「certificate_path」に作成したファイルのパスを指定してください。
作成コマンド例# cat [サーバ証明書ファイル] [中間証明書ファイル] > [連結済サーバ証明書ファイル] 「certificate_path」と「private_key_path」に入力がない場合は、OASEインストーラーがアンサーファイルの「oase_domain」の値を使用して自己証明書を作成・設置します。
（※「oase_domain」の値を自己証明書作成時のコモンネーム、ならびに自己証明書と秘密鍵のファイル名に使用します）

Exastro21

3.13 環境構築（10/16）
 インストール時にサーバ証明書と秘密鍵は「/etc/pki/tls/certs」のディレクトリに設置され、アンインストール時にはそのディレクトリから削除されますので、ユーザ指定のサーバ証明書と秘密鍵を使用する場合は、オリジナルのサーバ証明書・秘密鍵ファイルの管理に注意してください。
 アンインストールでは、アンサーファイル(oase_answers.txt)の「certificate_path」と「private_key_path」の両方にファイル指定がある場合は、それらの指定されたファイルの削除を行い、ファイル指定がない場合は、アンサーファイルの「oase_domain」に指定されている名前を使用したファイルを削除します

Exastro22

3.14 環境構築（11/16）▌アンサーファイル(oase_answers.txt)の記述サンプル 1/4
 アンサーファイル(oase_answers.txt)の記述サンプルを以下に示します

Exastro23

3.15 環境構築（12/16）▌アンサーファイル(oase_answers.txt)の記述サンプル 2/4

Exastro24

3.16 環境構築（13/16）▌アンサーファイル(oase_answers.txt)の記述サンプル 3/4

Exastro25

3.17 環境構築（14/16）▌アンサーファイル(oase_answers.txt)の記述サンプル 4/4

Exastro26

3.18 環境構築（15/16）▌ OASEインストーラー(オフラインインストール)実行 以下のコマンドで、OASEインストーラー(オフラインインストール)を実行します。
# sh oase_installer.sh▌ 処理の確認 環境構築ツールを実行すると、oase_installer.log に処理内容が出力されます。
 ログ格納パス/(インストール資材展開先)/oase_install_package/install_scripts/log/▌ 終了ステータスについて
 OASEインストーラーは、シェルの終了時に終了状態によって以下の終了ステータスを返します。
正常終了時：0
異常終了時：1

Exastro27

3.19 環境構築（16/16）▌環境構築時にインストールされるライブラリの一覧
 OASEインストーラー(オフラインインストール)を実行することでインストールされるライブ
ラリは、以下となります。
インストールドライバ

ライブラリ概要
httpd

httpd httpd-devel mod_ssl

MariaDBMariaDB MariaDB-server MariaDB-devel
MariaDB-shared expect

RabbitMQ

erlang rabbitmq-server

pythonpython36 python36-libs python36-devel
python36-pip

OASE

Exastroライブラリ名28

4. OASE動作確認4.1

動作確認（1/4）▌メインメニューの表示による確認
 インストール処理終了後、自端末のWindowsPCから下記の手順により、OASEシステムメインメニューにアクセスし、OASE本体、各ドライバーが正常に表示されたことを確認してください。

▌URL接続 以下のURLより、ログイン画面にアクセスしてください。
 URL：http://（サーバのIPアドレス）※インストール後は、HTTPとHTTPSの両方のアクセスが可能です。
HTTPはセキュリティ的に脆弱なので、HTTPSでのアクセスを推奨します。
HTTPSでのアクセス方法は、動作確認（4/4）を確認してください。

▌ログイン
 OASEのログイン画面が表示されたら、指定のログインID、初期パスワードを入力して、[ログイン]ボタンをクリックしてください。
・ログインID： administrator
・初期パスワード ： oaseoaseoase インストール後に初めてログインした場合は、「パスワード変更画面」に遷移します。
 パスワード変更画面から、初期パスワードを変更してください。

Exastro30

4.2

動作確認（2/4）▌OASEログイン画面
 正常にインストールされている場合、以下のようなログイン画面が表示されます。

ログインID： administrator

初期パスワード ：oaseoaseoase

Exastro31

4.3

動作確認（3/4）▌各メニューの表示による内容確認 ログイン後、以下のメニューが正常に表示されることを確認してください。

機能

メニュー
DashBoard
ルール

OASE画面システム

管理

Exastro32

4.4

動作確認（4/4）▌HTTPSでアクセスするための準備作業
 アンサーファイルの「oase_domain」に設定したホスト名をご使用の環境のDNSサーバまたは操作端末のhostsに登録してください。
 操作端末（Windows）への証明書インポートを行います。
ユーザ指定のサーバ証明書を使用していない場合、サーバ証明書はOASEインストール
パッケージの以下のパスに格納されています。
ディレクトリ/etc /pki/tls/certs

ファイル名[アンサーファイルのoase_domainに設定したホスト名].crt※ユーザ証明書を使用する場合はアンサーファイルの「certificate_path」に設定した証明書ファイルを使用してください。

 Webブラウザに証明書のインポートをしてください。

▌HTTPSでのURL接続
 以下のURLより、ログイン画面にアクセスしてください。
 URL：https://[アンサーファイルのoase_domainに入力したホスト名]※ドメイン名の代わりに、サーバのIPアドレスでアクセスすることも可能です。
接続後はHTTPの場合と同様となります。

Exastro33

5. 参考5.1

参考▌インストールモードについて
 アンサーファイル(oase_answers.txt)の「install_mode」の値によって、インストー
ラーの動作が以下のモードに分岐します。
• Install_Online：OASEに必要なライブラリのインストールをインターネット経由で行った後、OASE本体をインストールします。
• Install_Offline：Gather_Libraryで作成したパッケージを使い、オフラインでライブラリのインストールとOASE本体のインストールを行います。
• Gather_Library：OASEに必要なライブラリの収集をインターネット経由で行い、Install_Offlineの実行に必要なパッケージを作成します。（Install_Offlineを行う前に実行してください）• Versionup_All：バージョンアップで必要となるライブラリをインターネット経由で追加インストールした後、OASE本体をバージョンアップします。
• Versionup_OASE：ライブラリのインストールは行わず、OASE本体をバージョンアップします。
• Uninstall：OASE本体をアンインストールします。（ライブラリのアンインストールは行いません。）

Exastro35