メインコンテンツまでスキップ

インストール直後の点検

インストール (ワンラインインストール, 量産ラインインストール, 閉域網インストール) が完了したら、 次の順序でゲートウェイを 運用準備状態 へ移行します。

1. 1分ヘルスチェック​

sudo bash /opt/kopens/install/bin/status.sh
curl -ks https://127.0.0.1/api/v1/system/version | python3 -m json.tool
curl -ks https://127.0.0.1/api/v1/system/health | python3 -m json.tool

期待される結果:

  • container running + healthy
  • 9つのポートがlistening (80, 443, 1883, 1884, 6379, 9042, 1880, 12000, 12443) — 7799(Tomcat JMX)は127.0.0.1でのみ受信します
  • /api/v1/system/version → build_date / image_tag / container_mode=true
  • /api/v1/system/health → 200, すべてのcomponentsがUP

pe-status すべての項目が ✓ であれば次の節へ。一部に ✗ がある場合は コンテナモード運用 の 「障害対応」セクションを参照してください。

運用投入前には プロダクション検収基準 の acceptance log も記録します。

2. 初期パスワードの変更 — 最優先​

インストール時に作成された認証情報をそのままにして運用しないでください。変更内容および手順は 初期パスワード変更 に記載されています — コミッショニング必須 項目であり、以下のバックアップ・ミラーリングよりも先に実施してください。

3. 自動バックアップの設定​

sudo tee /etc/cron.d/plantpulse-edge-backup > /dev/null << 'EOF'
# 매일 새벽 3시 백업 + 일요일 새벽 4시 30일 초과 백업 삭제
0 3 * * * root /opt/kopens/install/bin/backup.sh > /dev/null 2>&1
0 4 * * 0 root find /data1/pp-backups -name 'pe-backup-*.tar.zst' -mtime +30 -delete
EOF

sudo bash /opt/kopens/install/bin/backup.sh
ls -lh /data1/pp-backups/

詳細: バックアップおよび復旧

4. 外部NAS / S3 ミラーリング (災害復旧)​

バックアップがゲートウェイと同じディスクにのみ保存されている場合、災害復旧 の効果はありません。外部ミラーリングを強く推奨します。

# 컨테이너 백업 예시
LATEST=$(ls -t /data1/pp-backups/pe-backup-*.tar.zst | head -1)
rsync -av "$LATEST" "$LATEST.sha256" nas:/backup/edge/

5. ユーザー・権限設定 (任意)​

デフォルトのadmin以外に ユーザー別アカウント が必要な場合:

ゲートウェイには ユーザー・ロール・メニューアクセス権限 画面があります。

画面アドレス内容
ユーザー管理/system/userアカウントを作成し、ロールを割り当てます
ロール管理/system/roleロールを定義します
メニューアクセス権限/system/menu_accessロールごとに閲覧可能なメニューを指定します
シナリオ推奨事項
1名で運用デフォルトアカウントを使用し、パスワードのみ変更します
複数名で運用アカウントを分け、ロールを割り当てて 誰が何をしたか を記録します
外部協力会社以下の確認を先に行ってください
協力会社に開放する前に «実際に制限されるか» を確認してください

ロールとメニューアクセス権限を保存する画面とテーブルは存在しますが、それがリクエストごとに実際に適用されるかは、インストール済みの環境で直接確認するのが安全です。

確認方法 — 制限されたロールでアカウントを1つ作成し、そのアカウントでログインして、制限されるべきメニュー（例：接続削除）が本当に操作できないか試してください。「メニューが表示されないこと」と「アドレスを直接入力してもブロックされること」は異なります。

外部に見せる範囲が決まっている場合は、ゲートウェイ画面ではなく プラットフォーム権限グループ で必要な機能だけを開放する方が確実です。

6. 次に読むべきドキュメント​

  1. ホーム画面カード / アクションガイド — 30個のカードの意味
  2. 新規PLC接続の追加
  3. タグ登録 + PLCアドレス入力 (44種類ドライバ完全ガイド)
  4. Sparkplug B 発行 — 外部SCADA連携時
  5. フロー (Node-RED) — 自動化 / アラーム / 外部統合
  6. 運用概要 — 開始/停止/再起動/バックアップ/アップグレード/診断

7. 検収テストチェックリスト (納品・SIパートナー用)​

新規サイト検収時、以下の項目をすべてパスすること:

  • コンテナモードの場合は status.sh 全てOK、nativeの場合は bin/ps.sh 5つのJava/Nodeプロセスを確認
  • /api/v1/system/version HTTP 200 + 意図した edge_id/site_id/container_mode を返却
  • /api/v1/system/health HTTP 200 + components UP
  • プロダクション検収基準 の acceptance log 生成 + sha256 記録
  • /api/v1/monitoring HTTP 200 + cpu_used_percent < 30%, memory_used_percent < 60%
  • ホームカード30個すべてが表示 + 1秒更新動作
  • シミュレーターOPC 1つ登録 → 開始 → /ui/opcua ツリーでチャートが正常に表示
  • 実機PLC 1台登録 → 収集状態 🟢 正常 + 最新値が更新
  • コンテナ systemctl restart plantpulse-edge.service または native bin/restart.sh 後、PLC再接続が自動的に行われる (auto_collect=true)
  • バックアップ cron 登録 + 初回バックアップファイル/ディレクトリの生成を確認
  • 初回バックアップ .tar.zst および .sha256 を外部バックアップ位置にコピー
  • 外部SCADA / Sparkplug 受信側へのメッセージ到達を確認
  • パスワード変更 完了 (adminデフォルトパスワードの変更)
  • /etc/kopens/credentials.txt 権限 0600 root 確認 + パスワード伝達手続き完了
  • log-viewer で30秒間モニタリング — SEVERE / ERROR レベルのログがないこと
  • ディスク空き容量 30%+ (df -h /data1)
  • OS NTP同期 (timedatectl) 正常
  • 運用チームにゲートウェイIP / アクセス情報を伝達 + 引継書への署名

さらに詳しく​