FAQ
PlantPulse プラットフォームを運用されている方々から寄せられた頻出質問と回答をまとめました。より詳しい手順が必要な場合は、トラブルシューティングページをご参照ください。
インストール / ライセンス
Q. Docker インストールとバイナリ インストールのどちらを選択すべきですか？
A. 特別な理由がない限り、**ワンラインインストール（Docker ベース）**をお勧めします。ワンラインコマンドひとつで OS セットアップからファイアウォール、コンテナ起動まで自動処理され、更新とロールバックも簡単です。バイナリ インストールは Docker が使用できない環境でのみお勧めします。
Q. 閉域網でもインストールできますか？
A. 可能です。インターネット接続ノードから ./airgap-bundle.sh でバンドルを生成してから、USB または内部ファイルサーバで閉域網に移動させ、./airgap-load.sh を実行してください。詳しい手順はDocker インストール - 閉域網（Airgap）インストールセクションをご参照ください。
Q. ライセンスはどのように取得しますか？
A. イメージレジストリ認証情報とライセンスは KOPENS 運用チームから提供いただきます。webmaster@kopens.com までお問い合わせください。
Q. 最小 / 推奨仕様はどうなっていますか？
A. 単一ノード基準：
| 区分 | 最小 | 推奨 |
|---|---|---|
| CPU | 16 vCPU | 32 vCPU |
| メモリ | 64GB | 200GB |
| ディスク | 200GB | 1TB+（データ量により異なる） |
| OS | Oracle Linux 8 / RHEL 9 / Ubuntu 22.04 / Amazon Linux 2023 | 同一 |
詳細仕様はシステム要件ページをご参照ください。
Q. どの OS をサポートしていますか？
A. 次の OS でワンラインインストールをサポートしています。
- Oracle Linux 8.x
- RHEL / Rocky Linux 8.x, 9.x
- Ubuntu 22.04+
- Amazon Linux 2, 2023
検証されていない OS では SKIP_OS=1 オプションで OS セットアップをスキップして、手動でセットアップできます。
Q. Podman でも運用できますか？
A. 可能です。bin/env.sh の DOCKER_CMD="docker" を DOCKER_CMD="podman" に変更すれば、すべてのスクリプトが Podman で動作します。
インストール / 起動
Q. インストールにはどのくらい時間がかかりますか？
A. ワンラインインストール基準で、OS セットアップ + Docker インストール + イメージダウンロード + コンテナ起動まで約 10～20分（ネットワーク速度に応じて異なる）がかかります。その後、コンテナ内部のブートは追加で3～5分程度かかります（Cassandra スキーママイグレーション + JVM warm-up）。
Q. インストール後、どこにアクセスすればよいですか？
A. ブラウザで次のアドレスにアクセスしてください。
http://[서버IP]:7500
[서버IP]はenv.shのDOCKER_PP_EXTERNAL_IP値です。- デフォルト管理者アカウント：
admin/admin123! - ログイン後、必ずパスワードを変更してください。
Q. 起動しましたが health が unhealthy と表示されます。
A. ブートには 3～5分かかります。5分経過しても unhealthy 状態の場合は、トラブルシューティング - コンテナ起動の問題をご参照ください。
Q. env.sh を変更しましたが適用されません。
A. env.sh の変更はブート時点でのみ反映されます。必ず次のコマンドで再起動してください。
cd /opt/kopens/plantpulse-platform-docker/bin
./restart.sh
Q. サーバ再起動後に自動起動するようにするには？
A. コンテナは --restart unless-stopped ポリシーで実行されるため、Docker デーモンが起動すると自動的に一緒に起動します。Docker デーモン自体は systemctl enable docker でブート時に自動起動するよう設定されています。
運用 / 管理
Q. プラットフォームの起動 / 停止 / 再起動はどのようにしますか？
A. ホストの /opt/kopens/plantpulse-platform-docker/bin/ で：
./up.sh # 기동 — 준비될 때까지 대기 (종료 코드 0 = 쓸 수 있다)
./down.sh # 중지 (데이터 보존)
./restart.sh # 재시작 (graceful drain + 준비 대기)
./status.sh # 상태 요약 (0 = 정상 / 2 = 비정상)
詳しくはスタートアップガイドページをご参照ください。
Q. 全体を再起動せずに一部のコンポーネントのみを再起動できますか？
A. 可能です。ただしアプリか インフラか によって方法が異なります。
アプリ群は各々コンテナで実行されるため、そのコンテナを再起動するのが再起動そのものです。
cd /opt/kopens/plantpulse-platform-docker
docker compose -f compose/docker-compose.yml restart plantpulse-server-web
ストレージ・分析・メッセージング等のインフラコンポーネントはデータレイク コンテナ内で共に実行されるため、内部に入って個別スクリプトを実行します。
./shell.sh
/opt/kopens/plantpulse-platform/plantpulse-datalake-cli/bin/pd restart storage
exit
詳しいリストはスタートアップガイド — コンポーネント単位の再起動をご参照ください。
Q. ログはどこで見られますか？
A. ホストからコンテナの標準ログを確認でき、コンテナ内部からはモジュール別の詳細ログを確認できます。
# 전체 컨테이너 로그를 한 화면에 (서비스 이름 접두, 시간순)
./logs.sh
# 특정 컨테이너만
./logs.sh plantpulse-server-web -n 200
# 데이터레이크 안 컴포넌트 로그 파일
./logs.sh cassandra
# 볼 수 있는 대상 전체 목록
./logs.sh --list
# 모듈별 로그를 호스트로 한 번에 복사
./tools/copy-log-to-local.sh
コンテナが 8 つあるため、1 つのログだけ見ると原因を見落とすことがあります。引数なしの ./logs.sh は 8 つを時系列順に混合して表示します。
Q. バックアップはどのようにしますか？
A. Docker ボリューム単位で tar.gz バックアップが可能です。
cd /opt/kopens/plantpulse-platform-docker/bin
./backup.sh # 기본 세트 (pp-data · pp-security)
./tools/backup-volume.sh pp-data 7 /data1/pp-backup/docker-volume # 볼륨 하나만
推奨バックアップ周期は運用管理 - バックアップと復旧をご参照ください。
Q. 新しいバージョンが出たときはどのように更新しますか？
A. 無中断更新コマンドで処理されます。
cd /opt/kopens/plantpulse-platform-docker/bin
./update.sh
自動実行：docker pull → graceful 終了 → 新しいイメージで再生成 → health 検証 → 失敗時は自動ロールバック。データはボリュームに別途保存されているため安全です。
Q. 更新後に問題が発生したらどのようにロールバックしますか？
A. ./update.sh は health 検証失敗時に自動ロールバックされます。自動ロールバック後も問題がある場合、または手動ロールバックが必要な場合は env.sh の PP_IMAGE_TAG を以前の安定版に指定してから ./update.sh を再実行してください。
Q. ワーカーノードを追加してクラスタを構成できますか？
A. 可能です。ワーカーリストのマスターは compose/workers.roster であり、追加は専用スクリプトで行います。
cd /opt/kopens/plantpulse-platform-docker/bin
bin/worker-add.sh # 빈 id·주소 자동 선택 (링 합류까지 확인합니다)
詳しくはクラスタインストールページをご参照ください。
Q. コンテナメモリを増やすには？
A. env.sh の DOCKER_PP_MEMORY を修正してから、次のいずれかを実行してください。
./restart.sh
コンテナごとに上限値が異なります。データレイクは DOCKER_DATALAKE_MEMORY（デフォルト 80G）で、アプリは DOCKER_SERVER_MEMORY · DOCKER_BATCH_MEMORY のようにサービス別の変数があります → 環境変数リファレンス
どのコンテナが上限に達しているかは docker stats --no-stream で確認します。
データ / パフォーマンス
Q. データはどこに保存されますか？
A. ホストの Docker ボリュームに保存されます。
| ボリューム | 用途 |
|---|---|
pp-data | メインデータ（Cassandra、PostgreSQL、MinIO） |
pp-temp | 一時処理ファイル |
pp-backup | セルフバックアップ |
pp-security | 証明書 / キー |
pp-template | テンプレートデータ |
実際のホストパスは /data1/docker-data/volumes/ です（env.sh の DOCKER_DATA_DIR で変更可能）。
Q. コンテナを削除してもデータは残りますか？
A. はい、./remove.sh はコンテナのみ削除し、ボリュームはそのまま保存されます。再度インストールすれば、以前のデータをそのまま使用できます。ボリュームまで完全に削除するには ./tools/remove-all-volumes.sh を実行する必要があります。
Q. データの保存期間を調整できますか？
A. Cassandra TTL 設定で時系列データの保存期間を調整できます。コンソールのシステム設定または properties で変更可能です。詳しくはパフォーマンスチューニングおよびプロパティリファレンスをご参照ください。
Q. レスポンスが遅くなりました。どのように診断しますか？
A. 次の順序で点検してください。
# 1. 컨테이너 자원 사용량
docker stats --no-stream
# 2. 호스트 부하
top
df -h
# 3. critical 로그 확인
./ops-check.sh
# 4. Cassandra 컴팩션 / 디스크 I/O
./shell.sh
/opt/kopens/plantpulse-platform/plantpulse-datalake-cli/bin/pd node compactionstats
詳しいチューニングはパフォーマンスチューニングページをご参照ください。
Q. Cassandra ディスク使用量が非常に多いです。
A. 次のコマンドで整理できます。
./shell.sh
/opt/kopens/plantpulse-platform/plantpulse-datalake-cli/bin/pd node cleanup # 불필요 데이터 정리
/opt/kopens/plantpulse-platform/plantpulse-datalake-cli/bin/pd node compact # 수동 컴팩션
長期的には保存期間（TTL）の調整またはディスク拡張をご検討ください。
セキュリティ / ユーザ
Q. デフォルトパスワードは何で、どこで変更しますか？
A. デフォルト管理者アカウントは admin / admin123! です。ログイン後、右上のユーザアイコン > パスワード変更メニューで即座に変更してください。
データベース / メッセージング等のサービスアカウントパスワードは bin/env.sh の PP_*_PASSWORD 変数で管理され、初回インストール時に /etc/kopens/plantpulse-platform.env に保存されます（モード 0600）。
パス確認 — シークレットサイドカーのマスターは
/etc/kopens/plantpulse-platform.env単一です（権限0600）。古いインストールで/opt/kopens/配下に同名のファイルが残っていることがありますが、読み込まれず、インストールスクリプトがマスターに戻します → 環境変数リファレンス
Q. ユーザ / 権限の管理はどのようにしますか？
A. コンソールのセキュリティ管理メニューで、ユーザ、ロール、権限を管理できます。詳しくはユーザ管理およびセキュリティ設定ページをご参照ください。
Q. HTTPS 証明書を変更するには？
A. 証明書は pp-security ボリュームに保存されます。定期的な交換が推奨されます。詳しい手順はセキュリティ設定ページをご参照ください。
Q. 外部に公開する必要があるポートはどうなっていますか？
A. ユーザ / 外部システム接続用には80、443、7443、4950のみ公開することをお勧めします。設備が直接接続される場合は 1883/1884（MQTT）· 11004/11005（OPC-UA）を追加します。その他のポート（DB、Kafka、クラスタ、JMX）はプライベートネットワークからのアクセスのみに制限してください。詳しいリストはポート設定情報をご参照ください。
ヘルスと管理コンソールは**4950（HTTPS）と 4949（平文）**の両方で提供されます。4949 は平文なので、信頼できないネットワークからは 4950 をご使用ください。
Q. 複数ノード環境でノード間通信はどのように保護されますか？
A. JGroups、Cassandra、Kafka等のクラスタ内部通信は RFC 1918 プライベートネットワーク（10.0.0.0/8、172.16.0.0/12、192.168.0.0/16）および Tailscale CGN 範囲（100.64.0.0/10）からのアクセスのみ可能になるよう、ソース制限が自動適用されます。
多言語 / タイムゾーン
Q. 英語 UI で運用できますか？
A. 可能です。env.sh で：
export PP_LANG=en
export PP_TZ=America/New_York # 운영 지역 타임존
修正してから ./restart.sh。ただし、Cassandra 時系列データが KST epoch で搭載されるため、韓国運用時は必ず PP_TZ=Asia/Seoul を維持してください。
Q. PlantPulse はユーザごとに韓国語 / 英語 UI を切り替えられますか？
A. いいえ。プラットフォームはサーバインスタンス当たり単一ロケールモデルを使用しています。JVM ブートタイムに環境変数で固定され、ユーザ別の切り替えはサポートされていません。韓国ボックス = ko、グローバルボックス = en で運用してください。
外部システム連携
Q. OPC-UA サーバとどのように接続しますか？
A. コンソールの接続管理メニューで OPC-UA サーバ情報（URL、認証、セキュリティポリシー）を登録し、収集するタグをマッピングします。詳しい手順は接続管理ページをご参照ください。
Q. MQTT デバイスからデータを送信するには？
A. ホスト IP の 1883（PLAINTEXT）または 18884（TLS）ポートで MQTT ブローカ（HiveMQ）に接続してください。認証情報は env.sh の PP_MQ_USER / PP_MQ_PASSWORD です。
Q. API で外部システムと連携するには？
A. すべての機能は REST API でも提供されます。開発者ガイド - API 使用マニュアルをご参照ください。
監視 / アラーム
Q. プラットフォームの状態を外部監視システムに連携するには？
A. ヘルスエンドポイントと ops-check 結果を監視システムから polling できます。
# Healthcheck 엔드포인트 (모니터링용)
curl -kfsS https://[서버IP]:4950/api/health
# 운영 health + critical log (스크립트 호출)
ssh root@[서버IP] /opt/kopens/plantpulse-platform-docker/bin/ops-check.sh
詳しくはシステム監視ページをご参照ください。
Q. アラームをメールや SMS で受け取ることができますか？
A. メールは SMTP 設定を通じてサポートされています。コンソールのアラーム > 通知設定で構成できます。SMS / メッセンジャー（Slack 等）の連携は外部 webhook または Flow エンジンを通じて構成可能です。
サポート / お問い合わせ
Q. どこでサポートを受けられますか？
A. 次のリソースを優先して確認してください。
- トラブルシューティング — 症状別診断と解決手順
- 運用管理 — 日常運用コマンド
- システム監視 — 状態点検
- 診断 tarball：
./doctor.shを実行してから生成されるファイル
上記のリソースでも解決しない場合は、診断 tarball と共に webmaster@kopens.com までお問い合わせください。
Q. どのような情報を一緒に送信すべきですか？
A. トラブルシューティング - サポート依頼時に必要な情報セクションをご参照ください。./doctor.sh が生成する診断 tarball には、必要な情報のほとんどが含まれています（パスワード等の機密情報は自動的にマスキングされます）。
Q. 最新のドキュメントはどこで見られますか？
A. https://kopens.gitbook.io/plantpulse-platform/で、常に最新のドキュメントをご確認いただけます。