StarDrop 8.x サーバー版インストール手順書

目次

• 1. 事前要件（ハードウェア／OS／システム設定）
• 2. インストール前の準備
• 3. インストーラーの基本フロー
• 4. 各サーバーのインストール手順
• 5. インストール後の作業
• 6. ポート・ファイアウォール
• 7. 動作確認

1. 事前要件

StarDrop サーバーのインストールには事前にライセンスキーを入手する必要があります。

ハードウェア

対応OS

• StarDropサーバー群・Derek Nexus・Metabolismサーバー: Ubuntu 24.04 LTS または RHEL 9 / 10（64bit）

システム設定

• DNS名前解決が正しく機能していること（nslookup <machine name>で確認）
• /etc/hostsにホスト名とIPが正しく登録されていること（ループバック127.0.0.1にマシン名を割り当てない）
• ファイアウォール・SELinuxは無効化、またはポート開放が必要

ソフトウェア要件

• Python 3.9以上
• Docker 20.10.24 以上
• Docker Compose 2.3.4 以上

sudo systemctl start docker
sudo systemctl enable docker
docker run hello-world

RHEL 10ではポート9090が別ソフトで使用されている場合があるため、License Serverのポートは9091への変更を推奨します。

2. インストール前の準備

2.1 バックアップ（既存インストールがある場合）

systemctl stop stardrop-automodeller
systemctl stop stardrop-model
systemctl stop stardrop-license
systemctl stop stardrop-dereknexus

cd /opt/stardrop
tar cvf stardrop.tar /opt/stardrop

Metabolismサーバーの場合:

/etc/init.d/StarDrop_metabolism stop
cd /opt/stardrop
tar cvf metabolism_backup.tar metabolism

2.2 必要なライセンス・キーの準備

2.3 SSL証明書（HTTPS通信）

各サーバーインストール時にHTTPS有効化を選択できます。オプションは以下の3つです：

• secure: 自前の.pem証明書を使用
• testing: Optibrium提供の自己署名証明書（テスト用のみ）
• http: HTTPSを使わずHTTP通信（リバースプロキシ利用時など）

Derek NexusはHTTPS非対応です。

3. インストーラーの基本フロー

1. rootまたはsudo権限でログイン
2. Optibriumサイトから servers-installer-8.x.tar をダウンロード
3. 展開して移動
   
   tar -xf servers-installer-8.x.tar cd servers_installer
   
4. 必要なサーバーのインストーラーを実行
   
   sudo python3 install_model_server.py
   sudo python3 install_auto-modeller_server.py
   sudo python3 install_license_server.py
   sudo python3 install_derek_nexus.py
   sudo python3 install_metabolism_server.py

以下の順に入力します：

1. ライセンス条項への同意
2. インストールモード選択（default: デフォルト設定 / custom: 詳細カスタマイズ）
3. インストールキーの入力（StarDrop.licがあれば自動検出）
4. HTTPS通信の設定（secure / testing / http）

defaultモードを選ぶと、論理CPU数−1のワーカーが自動構成され、デフォルトポートが使用されます。
既存インストールがある場合は、以前の選択値が引き継がれます。

4. 各サーバーのインストール手順（customモード）

4.1 Model Server（既定ポート 9000）

• インストール先: /opt/stardrop/model（既定）
• サーバーとワーカーは同一マシンに同時インストール（分離構成は廃止）
• Model workerとpKa workerの台数を指定（既定：論理CPU数−1）
• REST interfaceの導入有無を選択可能（別途ライセンスが必要）
• カスタムモデルの更新時刻（既定：3時）
• ログ／キャッシュ／custom_models／extensions ディレクトリを指定可能

4.2 Auto-Modeller Server（既定ポート 9050）

• インストール先: /opt/stardrop/automodeller
• インストールモード: both（サーバー+ワーカー同居）/ serverのみ / workersのみ、から選択可能
• ワーカー台数（既定：3、通常は論理CPU数−1）
• 外部ワーカーへの接続設定（複数マシン構成時）

4.3 License Server（既定ポート 9090）

• インストール先: /opt/stardrop/license
• sls.confライセンスファイルが必須
• ライセンス使用状況の追跡（既定: 有効）、タイムアウト時間（既定: 1.0時間）を設定

4.4 Derek Nexus Web Service（既定ポート 8080）

• インストール先: /opt/stardrop/dereknexus
• License.lxtライセンスファイルが必須（年次更新）
• HTTPS非対応

4.5 Metabolism Server（既定ポート 8150）

• インストール先: /opt/stardrop/metabolism
• ポートは1024より大きい必要がある
• DBハッシュ用のシークレットキー（32バイト・URL-safe base64）を生成 or 既存キー使用
• ワーカー台数（既定：論理CPU数−1）

各サーバーで共通して最後に以下を確認：

• ブート時の自動起動有効化（既定: yes）
• インストール完了後すぐにサーバーを起動するか（既定: yes）

5. インストール後の作業

サービス管理コマンド一覧

6. ポート・ファイアウォール

firewall-cmd --list-all
firewall-cmd --zone=public --permanent --add-port <port_number>/tcp
firewall-cmd --reload

7. 動作確認

コンテナ化サーバー（Model / Auto-Modeller / License / Derek Nexus）

/opt/stardrop/<service>/runner status
docker stats

問題発生時のサポート情報収集：

python3 <installer path>/generate_support_info.py

Metabolismサーバー

cd servers_installer
python server_tests.py

正常時の出力例：

Loopback address test [OK]
Metabolism server status test: [OK]
Metabolism server calculate test: [OK]