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

ワンラインインストール (推奨)

概要​

PlantPulse プラットフォームをわずか一行のコマンドでインストールできる最短の方法です。ダウンロードサーバーからインストールスクリプトを取得し、OSセットアップ、Dockerインストール、ファイアウォール構成、Docker Composeスタックの起動までを自動的に実行します。

いつ使用しますか？ 標準環境（Oracle Linux 8 / RHEL 9 / Ubuntu 20.04+ / Amazon Linux 2023）で、デフォルト設定を用いて迅速にインストールしたい場合に適しています。詳細設定を段階的に検討する必要がある運用環境では、Dockerインストール ページの手動インストール手順を推奨します。

インストールモードの選択​

インストールの前に、どのような構成でインストールするかを決定してください。

構成サーバー台数推奨される状況ガイド
シングルボックス (FULL) — デフォルト1台 (推奨 256GB, 最小 128GB)標準構成。このページの手順に従うこのページ
閉域網 (Airgap)—インターネット未接続環境閉域網インストール

以下の手順は シングルボックス(FULL) を基準としています。環境変数なしで実行するとFULLでインストールされます。

対応環境​

OSバージョン
Oracle Linux8.x
RHEL / Rocky Linux8.x, 9.x
Ubuntu20.04+ (20 / 22 / 24)
Amazon Linux2, 2023

事前準備​

  • インターネット接続が可能なサーバー (ダウンロードサーバー product.kopens.io へのアクセスが必要)
  • root 権限
  • 最小 16 vCPU / 128GB RAM / 1TB SSD (運用推奨 32 vCPU / 256GB RAM) — データレイクマスターに 96GB以上 を割り当てられる必要があり、64GBはサポート仕様ではありません (システム要件)

閉域網(Airgap)環境ではワンラインインストールを使用できません。閉域網インストール ページの手順を参照してください。

インストールの実行​

サーバーにSSHで接続後、以下のコマンドを実行します。

sudo -i
curl -fsSL https://product.kopens.io/plantpulse-platform/install.sh | bash
⌨️ プラットフォームワンラインインストール — ステージングサーバーでの実演録画

スクリプトが自動的に実行する作業：

  1. OS自動検知 (RHEL/Rocky/Oracle 8·9, Ubuntu 20+, Amazon Linux)
  2. Docker Engine + Compose v2 インストールおよびデーモン設定 (data-root)
  3. カーネル / リソースチューニング (limits.conf, sysctl.conf, chrony.conf, tmpfiles.d)
  4. SELinux permissiveへの切り替えおよびswapの無効化
  5. ファイアウォールポートの自動開放 — 公開ポート(80/443/4949/4950)および私設網制限ポート
  6. サービス資格情報サイドカー(/etc/kopens/plantpulse-platform.env)の作成
  7. コンテナレジストリ(docker.kopens.io)へのログイン
  8. Dockerネットワーク / ボリューム作成後の composeスタック起動
起動するコンポーネント

インストールが完了すると、コンテナ 9つすべてが常時動作 します — 証明書(plantpulse-certs), インフラ(plantpulse-datalake), アプリ6つ(plantpulse-server-web · plantpulse-batch-web · plantpulse-warehouse-web · plantpulse-plugin-opcua-server · plantpulse-plugin-aasx-server · plantpulse-ha), エッジ(plantpulse-proxy).

詳細な構成は Dockerインストール — インストール後の構成 を参照してください。

インストールスクリプトはスタック起動後、準備が整うまでポーリング します。プロセス起動自体は3〜5分（JVMウォーミングアップ）ですが、クリーンインストールの場合はAster TSDBスキーママイグレーションと安定化のため、全コンポーネントが安定するまで15〜18分 かかります。再起動の場合はスキーマが既に存在するため、大幅に早くなります。

インストールオプション​

# Docker가 이미 설치된 경우 OS 셋업 단계 생략
curl -fsSL https://product.kopens.io/plantpulse-platform/install.sh | bash -s -- --skip-os
オプション効果
--skip-osOSセットアップおよびDockerインストールを省略 (既にDockerがインストールされている場合)

参考: ワンラインインストールはレジストリ認証が自動構成されるため、別途 docker login は不要です。ファイアウォール省略(SKIP_FW=1), レジストリログイン省略(SKIP_LOGIN=1), Docker data-rootパス変更(DOCKER_DATA_DIR, デフォルト /data1/docker-data)は、ノードにダウンロードした bin/install.sh を直接実行する際に環境変数として指定します → Dockerインストール

インストールの確認​

インストールが完了したら、以下のコマンドで状態を確認します。

cd /opt/kopens/plantpulse-platform-docker/bin
./status.sh        # 0 = 정상 / 2 = 비정상
./ops-check.sh

curl -kfsS https://<server-ip>:4950/api/health | jq   # "status":"OK" 또는 "WARN" 이면 정상
docker ps          # 아홉 개가 모두 (healthy)
docker ps に plantpulse-platform がないことで失敗したわけではありません

その名前の単一コンテナ構成は廃止されました。デフォルトインストールで起動するのは 以下の9つ です。

plantpulse-certs · plantpulse-datalake · plantpulse-server-web · plantpulse-batch-web · plantpulse-warehouse-web · plantpulse-plugin-opcua · plantpulse-plugin-aasx · plantpulse-ha · plantpulse-proxy

10番目の plantpulse-mirror-maker は デフォルトでは起動しません — composeの mirror プロファイルで有効にした場合のみ表示されます。表示されないのが正常です → ユーティリティモジュール

旧ランブックの docker logs plantpulse-platform は動作しません。ログは ./logs.sh で確認してください。

すべての項目が正常であれば、ブラウザからウェブコンソールに接続します。

https://[서버IP]          # 웹 콘솔 (80/443, plantpulse-proxy 가 받습니다)
https://[서버IP]         # 관리 UI (웹 콘솔과 같은 주소)
https://[서버IP]:4950     # 모니터 UI
  • デフォルト管理者アカウント: admin / admin123!
  • ログイン後、必ずパスワードを変更してください。 → 初期パスワード

インストール後の環境変数調整​

ワンラインインストールはホストを検知してリソース値を自動的に計算するため、ほとんどのサーバーでは 変更する必要はありません。 ロケールのよう自動的に決定できない値のみ調整してください。

変更箇所は サイドカーファイル です。

vi /etc/kopens/plantpulse-platform.env
cd /opt/kopens/plantpulse-platform-docker/bin && ./restart.sh

一行に 이름=값 と記述します。

PP_LANG=ko
DOCKER_PP_EXTERNAL_IP=203.0.113.10
bin/env.sh を変更しないでください — 再インストール時に消失します

インストールスクリプトは インストールツリー全体を削除して再取得します。 /opt/kopens/plantpulse-platform-docker 以下に手動で記述した値は、再インストールやアップグレード時にすべて消失します。

サイドカー /etc/kopens/plantpulse-platform.env はインストールツリーの外にあるため 保持されます。 インストール時に作成され、権限は 0600 です。

値が決定される優先順位は以下の通りです。

優先順位場所備考
1サイドカー /etc/kopens/plantpulse-platform.envここに設定があれば、以下のデフォルト値より優先されます。 ここを変更してください
2bin/env.sh のデフォルト値製品で定義された値
3bin/env.sh 下部の明示的な export 行最後に読み込まれるため優先されますが、 再インストールで消失します

よく調整される項目：

変数説明デフォルト値
PP_LANGプラットフォームロケール (ko / en)en — 韓国語運用の場合は ko
PP_TZプラットフォームタイムゾーンAsia/Seoul
DOCKER_PP_CPUSコンテナに割り当てるvCPU数nproc の結果 (自動)
DOCKER_PP_MEMORYメモリ上限ホストRAMの90% (自動)
DOCKER_DATALAKE_MEMORYデータレイクメモリ上限96G(最小値), ホストRAMの90%を超えない範囲 — ホスト107G未満は仕様未達
DOCKER_PP_DATA_DISK_NAMEデータディスク名自動逆追跡 (失敗時は sda)
DOCKER_PP_EXTERNAL_IPNAT環境の外部advertise IP空値 — NAT配下でない場合は空にします
DOCKER_PP_EXTERNAL_IP は不用意に設定しないでください

この値はTLS証明書のSANリストに含まれます。無効なIPを入力すると証明書が 一枚も生成されず スタックが起動しません。

デフォルトロケールは en です。韓国語で運用する場合はサイドカーに PP_LANG=ko を入れ、 ./restart.sh で適用します。時系列データがKST基準で積載されるため、韓国運用では PP_TZ を Asia/Seoul で維持してください。

全環境変数リストは 環境変数リファレンス を参照してください。

よく使う運用コマンド​

cd /opt/kopens/plantpulse-platform-docker/bin

./preflight.sh           # 설치 전 비파괴 사전 점검
./up.sh                  # 기동 — 준비될 때까지 대기 (0 = 준비 완료)
./down.sh                # 정지 (상태 보존)
./restart.sh             # graceful 재시작 (drain + 준비 대기)
./status.sh              # 서비스 / health / 볼륨 요약 (0=정상 / 2=비정상)
./logs.sh [서비스]       # 로그 보기 (1회 출력, -f 로 따라가기). 인자가 없으면 전체, 목록은 --list
./shell.sh [서비스]      # 컨테이너 bash 진입 (인자 없으면 데이터레이크)
./ops-check.sh           # 운영 health + 최근 critical log 점검
./remove.sh              # 컨테이너 제거 (볼륨은 보존)
./doctor.sh              # 장애 진단 tarball 생성

新しいバージョンに更新する場合は、このワンライナーを再実行します — アップグレード. すべての動詞が --help をサポートしています。旧名称(stack-run.sh · stack-stop.sh · stack-bash.sh · stack-update.sh · stack-remove.sh)も引き続き動作します。

問題解決​

ダウンロードスクリプトの実行失敗​

# 다운로드 서버 접근 가능 여부 확인
curl -fsSL https://product.kopens.io/plantpulse-platform/install.sh -o /tmp/install.sh
ls -al /tmp/install.sh

# 회사 방화벽 / 프록시로 차단된 경우 네트워크 관리자에게 도메인 허용 요청:
#   product.kopens.io, docker.kopens.io

コンテナがhealthy状態に遷移しない​

どのコンテナに問題があるかから絞り込みます。

cd /opt/kopens/plantpulse-platform-docker/bin
./status.sh                              # 어떤 서비스가 비정상인가
./logs.sh --list                         # 볼 수 있는 서비스 목록
./logs.sh plantpulse-server-web -n 200   # 그 컨테이너의 로그

./doctor.sh    # 진단 tarball 생성 후 기술 지원팀에 전달 (모든 컨테이너를 담습니다)

Aster TSDBスキーママイグレーションの失敗、または /data1/pp-data 権限問題である可能性が高くなります。詳細な手順は Dockerインストール — スタックが起動しない場合 にあります。

追加のお問い合わせ​

その他の問題については、まず Dockerインストール ページの問題解決セクションを確認し、解決しない場合は webmaster@kopens.com までご連絡ください。