FAQ

PlantPulse Platformを運用される方向けに、よくある質問と回答をまとめました。より詳細な手順が必要な場合は、問題解決ページをご参照ください。

インストール / ライセンス

Q. どのインストール方法を選択すべきですか？

A. ワンラインインストールが標準です。コマンド一行でOSセットアップからファイアウォール、コンテナ起動まで処理され、アップデートとロールバックも同じツールで行います。閉域網の場合は Dockerインストールの閉域網手順、Kubernetes上に構築される場合は Kubernetesインストールをご覧ください。

Q. 閉域網でもインストールできますか？

A. 可能です。インターネットに接続されたノードで ./airgap-bundle.sh を使用してバンドルを作成し、USBまたは内部ファイルサーバで閉域網に転送した後、 ./airgap-load.sh を実行してください。詳細な手順は Dockerインストール - 閉域網(Airgap)インストールセクションをご参照ください。

Q. ライセンスはどのように発行してもらえますか？

A. イメージregistryの認証情報とライセンスはKOPENS運営チームから発行いたします。 webmaster@kopens.com までお問い合わせください。

Q. 最小 / 推奨仕様はどうなっていますか？

A. 単一ノード基準：

区分	最小	推奨
CPU	16 vCPU	32 vCPU
メモリ	128GB (データレイクマスター 96GB以上、64GBはサポート対象外)	256GB
ディスク	200GB	1TB+ (データ量に応じて)
OS	RHEL · Rocky · Oracle Linux 8/9/10 · Ubuntu 22.04+ · Amazon Linux 2023	同様

詳細仕様はシステム要件ページをご参照ください。

Q. どのOSをサポートしていますか？

A. 以下のOSでワンラインインストールをサポートしています。

RHEL · Rocky Linux · Oracle Linux 8.x · 9.x · 10.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分 ほどかかります（Aster TSDBスキーママイグレーション + JVM warm-up）。

Q. インストール後、どこにアクセスすればよいですか？

A. ブラウザから以下のアドレスにアクセスしてください。

http://[서버IP]/

プロキシコンテナが 80ポート一つ を開きます。別途の管理コンソールポートはありません。
[서버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. インストールワンライナーを同じサーバで再実行します（削除や整理はせずに行います）。新版の運用スクリプト・compose・イメージが共に導入され、データはボリュームにそのまま残ります。

sudo -i
curl -fsSL https://product.kopens.io/plantpulse-platform/install.sh | bash

./update.sh は公式手順ではありません。イメージだけを変更し、新版で追加されたサービスを認識できないためです。バックアップ・確認方法はアップグレードをご覧ください。

Q. アップデート後に問題が発生した場合、どのようにロールバックしますか？

A. ワンライナーはアップグレード直前にスタックをバックアップし、アップグレードに失敗すると 旧版へ自動的に戻します（データもバックアップ時点まで戻るため、新版が起動していた間に流入したデータは残りません）。原因を修正後、同じワンライナーを再実行します。アップグレードは成功したが後から戻したい場合は bin/upgrade-rollback.sh <백업 위치> で戻します — [アップグレード](/platform/admin-guide/upgrade#실패하면-자동으로-되돌립니다]。

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 (デフォルト 96G)、アプリは DOCKER_SERVER_MEMORY · DOCKER_BATCH_MEMORY のようにサービス別の変数があります → 環境変数リファレンス

どのコンテナが限界に達しているかは docker stats --no-stream で確認します。

データ / パフォーマンス

Q. データはどこに保存されますか？

A. ホストのDockerボリュームに保存されます。

ボリューム	用途
`pp-data`	メインデータ (Aster TSDB, PostgreSQL, RustFS)
`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. Aster TSDB 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. Aster TSDBのディスク使用量が大きすぎます。

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 に保存されます (mode 0600)。

パス確認 — シークレットサイドカーの正本は /etc/kopens/plantpulse-platform.env のみです(権限 0600)。古いインストールで /opt/kopens/ の下に同名ファイルが残っている場合がありますが、読み込まれず、インストールスクリプトが正本に戻します → 環境変数リファレンス

Q. ユーザー / 権限管理はどのように行いますか？

A. コンソールの セキュリティ管理 メニューでユーザー、ロール(role)、権限を管理できます。詳細はユーザー管理およびセキュリティ設定ページをご参照ください。

Q. HTTPS証明書を変更するには？

A. 証明書は pp-security ボリュームに保存されます。定期的な交換が推奨されます。詳細な手順はセキュリティ設定ページをご参照ください。

Q. 外部に公開すべきポートはどうなっていますか？

A. ユーザー / 外部システムアクセス用としては 80, 443, 4950 のみ公開することを推奨します。設備が直接接続する場合は 1883/1884(MQTT) · 11004/11005(OPC-UA) を追加します。残りのポート(DB, Kafka, クラスタ, JMX) は私設網からのみアクセス可能に制限してください。詳細なリストはポート構成情報をご参照ください。

ヘルスと管理コンソールは 4950(HTTPS)と4949(平文) の両方で出力されます。4949は平文のため、信頼できないネットワークでは4950を使用してください。

Q. 多ノード環境でノード間通信はどのように保護されますか？

A. JGroups, Aster TSDB, 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。ただし、 Aster TSDB時系列データが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送信 をオンにします(SMSはゲートウェイが設定されている場合に送信されます)。実際に誰に送られたかはアラーム詳細のアラーム受信者パネルに残ります。メッセンジャー(Slackなど)連携は外部webhookまたはFlowエンジンを通じて構成可能です。

サポート / お問い合わせ

Q. どこで助けを得られますか？

A. まず以下の資料をご確認ください。

問題解決 — 症状別診断と解決手順
運用管理 — 日常運用コマンド
システムモニタリング — 状態点検
診断tarball: ./doctor.sh 実行後に生成されるファイル

上記資料でも解決しない場合は webmaster@kopens.com まで診断tarballと共ににお問い合わせください。

Q. どのような情報を併せて送るべきですか？

A. 問題解決 - サポート依頼時に必要な情報セクションをご参照ください。 ./doctor.sh が生成する診断tarballには、必要な情報の大部分が含まれています (パスワードなどの機密情報は自動マスキング)。

Q. どこで最新ドキュメントを見ることができますか？

A. https://kopens.gitbook.io/plantpulse-platform/ で常に最新ドキュメントをご確認いただけます。

インストール / ライセンス​

Q. どのインストール方法を選択すべきですか？​

Q. 閉域網でもインストールできますか？​

Q. ライセンスはどのように発行してもらえますか？​

Q. 最小 / 推奨仕様はどうなっていますか？​

Q. どのOSをサポートしていますか？​

Q. Podmanでも運用できますか？​

インストール / 起動​

Q. インストールにはどのくらい時間がかかりますか？​

Q. インストール後、どこにアクセスすればよいですか？​

Q. 起動しましたが、healthがunhealthyと表示されます。​

Q. env.sh を変更しましたが適用されません。​

Q. サーバ再起動後に自動的に開始されるようにするには？​

運用 / 管理​

Q. プラットフォームをどのように開始 / 中止 / 再起動しますか？​

Q. 全体を再起動せずに、一部のコンポーネントだけを再起動できますか？​

Q. ログはどこで確認できますか？​

Q. バックアップはどのように行いますか？​

Q. 新しいバージョンが出た場合、どのようにアップデートしますか？​

Q. アップデート後に問題が発生した場合、どのようにロールバックしますか？​

Q. ワーカーノードを追加してクラスタを構成できますか？​

Q. コンテナメモリを増やすには？​

データ / パフォーマンス​

Q. データはどこに保存されますか？​

Q. コンテナを削除してもデータは残りますか？​

Q. データの保存期間を調整できますか？​

Q. 応答が遅くなりました。どのように診断しますか？​

Q. Aster TSDBのディスク使用量が大きすぎます。​

セキュリティ / ユーザー​

Q. デフォルトパスワードは何で、どこで変更しますか？​

Q. ユーザー / 権限管理はどのように行いますか？​

Q. HTTPS証明書を変更するには？​

Q. 外部に公開すべきポートはどうなっていますか？​

Q. 多ノード環境でノード間通信はどのように保護されますか？​

多言語 / タイムゾーン​

Q. 英語UIで運用できますか？​

Q. PlantPulseはユーザーごとに韓国語 / 英語UIを切り替えられますか？​

外部システム連携​

Q. OPC-UAサーバとどのように接続しますか？​

Q. MQTTデバイスからデータを送信するには？​

Q. APIで外部システムと連携するには？​

モニタリング / アラーム​

Q. プラットフォームの状態を外部モニタリングシステムに連携するには？​

Q. アラームをメールやSMSで受け取れますか？​

サポート / お問い合わせ​

Q. どこで助けを得られますか？​

Q. どのような情報を併せて送るべきですか？​

Q. どこで最新ドキュメントを見ることができますか？​