ドキュメント

1. クイックスタート

Rocky Linux v4.0を5分で始める方法

前提条件

• Rocky Linux 10.1 (Peridot) または互換OS
• Python 3.12以上
• インターネット接続（ライセンス認証に必須）
• root権限またはsudo権限

最速セットアップ

# 1. 環境変数にライセンスキーを設定
export NOVE_LICENSE_KEY="XXXX-XXXX-XXXX-XXXX"

# 2. システム実行
./scripts/launchers/run_adaptive_system_v4.sh

# 3. 結果確認（5秒で完了）
cat data/adaptive_system_v4/adaptive_report_v4_*.txt

2. インストール

必要パッケージのインストール

# Rocky Linux 10.1の場合
sudo dnf install python3 python3-pip sysbench tuned perf -y

# Python依存関係
pip3 install --user multiprocessing

ライセンス認証サーバー接続確認

# サーバー状態確認
curl https://license.yourdomain.com/api/v1/status

# 期待される出力:
# {"status":"online","timestamp":"2026-01-31T09:00:00","version":"1.0.0"}

3. 基本的な使い方

基本実行（完全分析）

./scripts/launchers/run_adaptive_system_v4.sh

高速モード（分析のみ）

./scripts/launchers/run_adaptive_system_v4.sh --fast-mode

レポート確認

# 最新レポート表示
cat $(ls -t data/adaptive_system_v4/adaptive_report_v4_*.txt | head -1)

# JSONレポート表示
cat $(ls -t data/adaptive_system_v4/adaptive_report_v4_*.json | head -1) | jq .

4. ライセンス認証

ライセンスキーの設定

# 環境変数で設定（推奨）
export NOVE_LICENSE_KEY="XXXX-XXXX-XXXX-XXXX"

# 永続化（.bashrcに追加）
echo 'export NOVE_LICENSE_KEY="XXXX-XXXX-XXXX-XXXX"' >> ~/.bashrc
source ~/.bashrc

認証状態の確認

# システム実行時に自動で認証されます
./scripts/launchers/run_adaptive_system_v4.sh

# 成功時の出力:
# ✅ ライセンス認証成功
#    プラン: スタンダード
#    有効期限: 2027-01-31
#    最大サーバー数: 500

認証エラーの対処

• ライセンスキーが無効 → キーを確認、サポートへ連絡
• 別のデバイスで使用中 → 1ライセンス=1デバイスの制限
• 期限切れ → 契約更新が必要
• 停止中 → サポートへ連絡

5. 最適化の適用

推奨される最適化の確認

システム実行後、最適化スクリプトが自動生成されます：

# 最適化スクリプトの場所
data/adaptive_system_v4/optimization_script_v4_*.sh

最適化の適用

# 最新の最適化スクリプトを実行
sudo bash $(ls -t data/adaptive_system_v4/optimization_script_v4_*.sh | head -1)

最適化前後の比較

# 最適化前
./scripts/launchers/run_adaptive_system_v4.sh
# スコア記録

# 最適化適用
sudo bash data/adaptive_system_v4/optimization_script_v4_*.sh

# 最適化後
./scripts/launchers/run_adaptive_system_v4.sh
# スコア改善を確認

6. API仕様

ライセンス認証API

POST https://license.yourdomain.com/api/v1/validate
Content-Type: application/json

{
  "license_key": "XXXX-XXXX-XXXX-XXXX",
  "device_id": "abc123...",
  "timestamp": "2026-01-31T09:00:00",
  "product": "Rocky Linux v4.0",
  "version": "4.0.0"
}

Response:
{
  "valid": true,
  "message": "認証成功",
  "tier": "standard",
  "max_servers": 500,
  "expires_at": "2027-01-31T09:00:00"
}

使用統計送信API

POST https://license.yourdomain.com/api/v1/usage
Content-Type: application/json

{
  "license_key": "XXXX-XXXX-XXXX-XXXX",
  "total_score": 689,
  "execution_time": 5.3
}

Response:
{
  "status": "success"
}

7. トラブルシューティング

Q1: ライセンス認証に失敗する

原因: インターネット接続、無効なキー、期限切れ

対処:

# 1. ネットワーク確認
curl https://license.yourdomain.com/api/v1/status

# 2. ライセンスキー確認
echo $NOVE_LICENSE_KEY

# 3. サポートへ連絡
# Email: seiya@example.com

Q2: スコアが低い

原因: システム設定が最適化されていない

対処:

# 自動生成された最適化スクリプトを適用
sudo bash data/adaptive_system_v4/optimization_script_v4_*.sh

# 再度測定
./scripts/launchers/run_adaptive_system_v4.sh

Q3: GPU検出されない

原因: GPU未搭載、またはドライバ未インストール

対処: GPU未搭載でも50/100確保されるため問題なし。搭載している場合はドライバをインストール。

Q4: 実行時間が長い

原因: 完全分析モード

対処:

# 高速モードを使用
./scripts/launchers/run_adaptive_system_v4.sh --fast-mode

📞 サポート

ご不明な点がございましたら、お気軽にお問い合わせください。

• メール: seiya@example.com
• 営業時間: 平日 9:00-18:00
• 緊急サポート: スタンダード以上のプランで24時間対応