ドキュメント

セットアップガイド・使い方・API仕様

1. クイックスタート

Rocky Linux NOVE OS v13.2を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 NOVE OS v13.2",
  "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: myseiyakagetu@proton.me

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

📞 サポート

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

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

詳細ドキュメント

完全なAPI仕様、開発者ガイド、トラブルシューティングなどの
詳細ドキュメントは契約後に提供いたします。

お問い合わせ

💾 完全自動メモリ管理システム v1.1.0

🎯 概要

Webダッシュボード不要の完全自動メモリ管理システム。5分ごとに自動チェック、閾値超過時に自動最適化。 ZRAM圧縮(4.5倍)、キャッシュ管理、スワップ管理を統合した革新的システム。

🚀 主要機能

  • 完全自動実行: 5分ごとにsystemdタイマーで自動実行、ユーザー操作不要
  • キャッシュ管理 v1.1.0: メモリ使用率75%以上でキャッシュクリア(500MB以上)
  • ZRAM圧縮: zstd圧縮アルゴリズムで4.5倍圧縮(10.8GB → 2.5GB)
  • スワップ管理: 7.6GB確保、物理メモリ超過時も安定動作
  • 統合最適化: 緊急最適化、危機対応、リアルタイム監視を自動実行
  • ログ記録: /var/log/nove-memory.log に改善効果、キャッシュクリア量を記録

📊 動作ルール

メモリ使用率 動作 キャッシュクリア
< 75% 正常(最適化なし) なし
75-89% 緊急最適化実行 500MB以上でクリア
≥ 90% 危機対応実行 100MB以上で無条件クリア

🛠️ 管理コマンド

# 状態確認
systemctl status nove-auto-memory.timer

# 次回実行時刻確認
systemctl list-timers nove-auto-memory.timer

# ログ確認(リアルタイム)
tail -f /var/log/nove-memory.log

# ログ確認(最新30行)
tail -30 /var/log/nove-memory.log

# 手動で即座に実行
sudo systemctl start nove-auto-memory.service

# タイマー停止(一時的)
sudo systemctl stop nove-auto-memory.timer

# タイマー再開
sudo systemctl start nove-auto-memory.timer

📈 実績データ

  • 復旧時間削減: 99.7%削減(10分 → 2秒)
  • システム安定性: 100%(フリーズ防止)
  • ZRAM圧縮率: 4.5倍(2.4GB → 530MB)
  • ユーザー操作: 0(完全自動)

🔧 技術仕様

  • 実行間隔: 5分ごと(systemd timer)
  • 起動方式: systemd oneshot service
  • ログファイル: /var/log/nove-memory.log
  • スクリプト場所: /usr/local/bin/nove-auto-memory-manager.sh
  • サービス名: nove-auto-memory.service
  • タイマー名: nove-auto-memory.timer

📋 ログ出力例

[2026-02-12 03:13:18] [INFO] 🚀 NOVE OS Auto Memory Management - Starting...
[2026-02-12 03:13:18] [INFO] Memory: 9.8Gi/15Gi, Swap: 2.7Gi/7.6Gi, Cache: 2.1Gi
[2026-02-12 03:13:18] [INFO] Memory Usage: 64%, Swap Usage: 36%
[2026-02-12 03:13:18] [INFO] Cache size: 2078MB
[2026-02-12 03:13:18] [SUCCESS] ✅ OK: Memory/Swap usage normal (Mem: 64%, Swap: 36%)
[2026-02-12 03:13:18] [INFO] No optimization needed.
[2026-02-12 03:13:18] [INFO] 🏁 NOVE OS Auto Memory Management - Completed

💡 ポイント

完全自動メモリ管理システムは、Rocky Linux NOVE OS v13.2の全プランに標準搭載されています。 追加料金なしで、メモリ問題を完全解決します。