バイナリインストール
現行出荷版は Docker Compose スタック 1 つです — 認証書ワンショット 1 個、データレイク 1 個、アプリ 6 個、プロキシ 1 個で構成されます(インストール後の構成)。
このページは バイナリインストールで構築された既存システムを継続運用される方向けに 残しているものです。新規構築には ワンラインインストール または Docker インストール をご使用ください。
また以下の本文はコンテナ移行前に作成されており、現行製品と異なる部分がある可能性があります。バイナリ環境での問題が生じた場合は、webmaster@kopens.com までお問い合わせください。
概要
このページでは OS 上に PlantPulse Platform を直接インストールするバイナリ（ネイティブ）インストール手順 をご説明します。tar.gz パッケージを解凍し、1 回のセットアップスクリプトで OS 依存関係、インフラストラクチャ、アプリケーションがすべて構成されます。
**データレイク / アプリケーション 2 ノード分離(
PP_TIER) でインストールする場合は、2 ノード分離インストール をご参照ください。このドキュメントは単一ボックス（FULL）バイナリインストール基準です。
インストール方式の比較
| 項目 | バイナリインストール | ワンライン / Docker インストール |
|---|---|---|
| インストール時間 | 20～40分 | 10～20分 |
| 環境依存性 | ホスト OS にパッケージインストール | コンテナにすべて含む |
| リソース分離 | ホストと共有 | コンテナで分離 |
| アップデート | tar.gz 再配布 + configure | update.sh 1 行 |
| ロールバック | バックアップから手動復元 | 前のイメージで自動ロールバック |
| 閉域網 | setup-offline.sh 対応 | airgap-load.sh 対応 |
| ホスト OS | 直接影響 | ほぼ影響なし |
サポート環境
| OS | バージョン | 検証 |
|---|---|---|
| Oracle Linux | 8.x, 9.x | ✓ |
| RHEL / Rocky Linux | 8.x, 9.x | ✓ |
| Amazon Linux | 2, 2023 | ✓ |
| Ubuntu | 22.04+ | ✓ |
ハードウェア推奨仕様
| 区分 | 最小 | 標準 | 大規模 |
|---|---|---|---|
| CPU | 16 vCPU | 32 vCPU | 48+ vCPU |
| メモリ | 64GB | 128GB | 200GB+ |
| データディスク | 200GB | 1TB | 4TB+ |
| ディスク IOPS | NVMe SSD 推奨 | NVMe SSD | NVMe SSD |
| ネットワーク | 1Gbps | 10Gbps | 10Gbps |
検証環境（参考）: 運用検証環境は 48 vCPU / 188GB RAM / 4.8TB NVMe SSD、RHEL 9 / Temurin OpenJDK 21 LTS で運用中です。
インストール手順概要
1. 事前準備
1.1 root 権限の確保
インストールは root 権限で実行します。非 root ユーザーで運用する場合は、インストール完了後に別途権限分離手順が必要です（運用チームへお問い合わせください）。
sudo -i
1.2 データディスクのマウント
大容量時系列データ用に、別途ディスクを /data1 にマウントしてください。
# 사용 가능한 디스크 확인
lsblk
# 예: /dev/sdb 를 ext4 로 포맷 후 /data1 에 마운트
mkfs.ext4 /dev/sdb
mkdir -p /data1
mount /dev/sdb /data1
# 부팅 시 자동 마운트
echo "/dev/sdb /data1 ext4 defaults 0 0" >> /etc/fstab
ディスク分離を推奨: OS ディスクとデータディスクを分離すると、バックアップ、拡張、障害分離が容易になります。小規模環境でも可能な限り別ディスク / 別論理ボリュームで構成してください。
1.3 時間同期
分散コンポーネント（Cassandra、Kafka など）はノード間の時間精度に敏感です。NTP 同期が必須です。
# RHEL 계열
dnf install -y chrony
systemctl enable --now chronyd
chronyc tracking
1.4 SELinux / ファイアウォール
setup.sh が自動的に SELinux を permissive に転換し、必要なファイアウォールポートを開きます。企業 / クラウド上位のファイアウォールについては、別途 ポート構成情報 ページをご参照のうえ、許可ルールを追加してください。
2. パッケージダウンロードと圧縮解凍
KOPENS 運用チームから受け取った plantpulse-platform-YYYY.MM.tgz パッケージを /opt/kopens/ に配置します。
mkdir -p /opt/kopens
cd /opt/kopens
# scp 또는 USB / 내부 미러로 패키지 이전
# 예시: scp 로 받은 파일을 풀기
tar -xzvf plantpulse-platform-2026.05.tgz
# 결과 디렉토리 확인
ls /opt/kopens/plantpulse-platform/
圧縮解凍後、次の構造が生成されます。
/opt/kopens/plantpulse-platform/
├── plantpulse-startup/ # 모든 운영 스크립트 + startup.jar
│ ├── env.sh # 전역 환경 변수 (★ 검토 필요)
│ ├── start.sh / stop.sh # 시작 / 정지
│ ├── start-daemon.sh # 데몬 모드 시작
│ ├── restart.sh # stop → clean → start-daemon
│ ├── status.sh # 포트 기반 상태 점검
│ ├── configure.sh # 템플릿 → 실제 설정 생성
│ ├── prepare-ssl.sh # TLS 인증서 생성
│ ├── restart-*.sh # 모듈별 재시작
│ ├── node-*.sh # Cassandra 운영
│ ├── log-viewer.sh # 통합 로그 뷰어
│ └── ...
├── plantpulse-server/ # 웹 콘솔 (Tomcat 기반)
├── plantpulse-batch/ # 배치 처리
├── plantpulse-cep/ # 복합 이벤트 처리
├── plantpulse-data-gateway/ # 데이터 게이트웨이
├── plantpulse-sql/ # SQL 쿼리 서비스
├── plantpulse-monitor/ # 모니터링
├── plantpulse-warehouse/ # 데이터 웨어하우스
├── plantpulse-plugin/ # OPC-UA / AAS 산업 플러그인
├── plantpulse-storage/ # Cassandra / PostgreSQL / Valkey / MinIO
├── plantpulse-messaging/ # Kafka / MQTT(HiveMQ) / STOMP(ActiveMQ)
├── plantpulse-analytics/ # Spark / Hive / Kyuubi / Gravitino / Hadoop
├── plantpulse-workflow/ # Temporal / Kestra
├── plantpulse-timeseries/ # 시계열 엔진 + UI
├── tools/ # OS 의존성 / JDK / DB 클라이언트 / 설정 템플릿
│ ├── setup.sh # 온라인 셋업
│ ├── setup-offline.sh # 폐쇄망 셋업
│ ├── java/ # OpenJDK
│ ├── postgresql/ # psql 클라이언트
│ ├── valkey/ # redis-cli
│ ├── cron/ firewall/ ssl/ swap/ ntp/ ...
│ └── ...
├── offline/ # 폐쇄망 설치 리소스 (RPM 리포 + wheels)
└── backup/ # 자체 백업 디렉토리
3. セットアップスクリプトの実行
tools/setup.sh が OS パッケージインストール、JDK インストール、データディレクトリ生成、ファイアウォール / SELinux / NTP / limits / sysctl をすべて一括処理します。
cd /opt/kopens/plantpulse-platform/tools
./setup.sh
セットアップ対話入力
setup.sh は以下の情報を確認します。
| 項目 | 説明 | 例 |
|---|---|---|
| ノードモード | MASTER（単一 / クラスタマスター）または WORKER | MASTER |
| HOST IP | サーバー内部 IP | 192.168.0.41 |
| SERVICE IP | 外部アクセス IP またはドメイン | 192.168.0.41 |
| MASTER IP（WORKER のみ） | マスターノード IP | 192.168.0.41 |
| データディスク名 | lsblk 出力基準 | sdb |
| データルートパス | データ保存ディレクトリ | /data1 |
セットアップが自動実行する処理
実行時間: 初回実行時は約 15～30 分かかります（OS アップデート + パッケージインストール + インフラコンポーネントインストール含む）。
4. 環境変数設定（env.local.sh でオーバーライド）
/opt/kopens/plantpulse-platform/plantpulse-startup/env.sh がプラットフォーム全体の単一設定ソース（デフォルト値マスター）です。すべてのモジュールのテンプレート設定ファイルがこの値を参照して生成されます。
全
PP_*変数リスト（デフォルト値・説明）は 環境変数リファレンス でカテゴリ別に整理されています。
⚠️
env.shを直接編集しないでください。 サーバーに合わせた値（IP・リソース・パスワードなど機械固有値）は同ディレクトリのenv.local.shに記述します。バイナリインストールはこの方式が標準です。
区分 Docker インストール バイナリインストール（このページ） 設定ファイル bin/env.shのDOCKER_PP_*環境変数を 直接編集plantpulse-startup/env.local.shに オーバーライド作成元ファイル保護 — env.sh元ファイルはそのままなので、アップデート時に安全
なぜ env.local.sh か？
env.sh は最上部で env.local.sh を最初に読み込みます。 env.sh のすべての変数は ${PP_XXX:-기본값} 形式なので、env.local.sh で export PP_XXX=... として宣言した値が 常にデフォルト値を上書きします。
env.local.shは git に含まれず、プラットフォームアップデート（tar.gz 再配布）時にも上書きされません。 → 一度作成すれば、アップデート後も設定がそのまま保持されます。- 反対に
env.shを直接編集すると、アップデート時に新しいenv.shに置き換わり、編集内容が消えます。
env.local.sh 作成
ファイルが存在しなければ新規作成してください。変更すべき変数だけを export で記述します。
cd /opt/kopens/plantpulse-platform/plantpulse-startup
vi env.local.sh
#!/bin/bash
# env.local.sh — 이 서버 전용 오버라이드 (env.sh 가 먼저 source 하여 우선 적용)
# 여기에 적은 값만 기본값을 덮어씁니다. 적지 않은 변수는 env.sh 기본값을 그대로 사용합니다.
export PP_HOST_IP="192.168.0.41" # 서버 내부 IP (hostname -I)
export PP_SERVICE_IP="192.168.0.41" # 브라우저 접속 IP/도메인 (단일 서버면 HOST_IP 와 동일)
export PP_MASTER_IP="192.168.0.41" # 마스터 IP (단일 서버면 HOST_IP 와 동일)
export PP_DATA_DISK_NAME="sdb" # 데이터 디스크 이름 (lsblk)
export PP_DATA_DIR="/data1/pp-data" # 데이터 저장 경로
export PP_CLUSTER_CORES="30" # 분산 분석에 할당할 코어 (아래 4.1 사이징표 참고)
export PP_CLUSTER_MEMORY_BY_CORE="2G" # 코어당 메모리
保存後、必ず
./configure.shを再実行 して、新しい値が各モジュール設定に反映されるようにしてください（ステップ 5）。変更時はenv.local.sh編集 →./configure.sh実行が 1 セットです。
4.1 必ず確認すべきコア変数
| カテゴリ | 変数 | 説明 | デフォルト |
|---|---|---|---|
| Platform | PP_HOME | インストールパス | /opt/kopens/plantpulse-platform |
PP_MODE | ノードモード | MASTER / WORKER | |
| Network | PP_HOST_IP | サーバー内部 IP | 192.168.0.41 |
PP_SERVICE_IP | 外部アクセス IP | 192.168.0.41 | |
PP_MASTER_IP | マスター IP | 192.168.0.41 | |
PP_PUBLIC_IP | 外部公開 IP（NAT） | ${PP_HOST_IP} | |
| Data | PP_DATA_DIR | データ保存パス | /data1/pp-data |
PP_TEMP_DIR | 一時ファイルパス | /data1/pp-temp | |
PP_BACKUP_DIR | バックアップパス | /data1/pp-backup | |
| Resources | PP_CLUSTER_CORES | 分散分析に割り当てるコア数 | 30 |
PP_CLUSTER_MEMORY_BY_CORE | コアあたりメモリ | 2G | |
| Locale | PP_LANG | ロケール（ko / en） | en |
PP_TZ | タイムゾーン | Asia/Seoul |
上表は 変数名とデフォルト値を参照するリファレンス です。実際に変更する値は、ステップ 4 導入部で説明した通り、
env.local.shにexportとして記述します（env.sh直接編集 ✗）。ステップ 3 のセットアップで入力した HOST IP / SERVICE IP / ディスク名はすでに反映されているので、このステップでは その値が正しいか確認し、不足項目だけenv.local.shに追加 する作業です。
値をどのように確認するのか？（混同しやすい項目）
# IP 확인 (PP_HOST_IP / PP_SERVICE_IP)
hostname -I | awk '{print $1}' # 서버 내부 IP
ip -4 addr | grep inet # 외부 접속용 IP를 따로 골라야 할 때
# 데이터 디스크 / 코어 / 메모리
lsblk # 데이터 디스크명 (sdb, nvme0n1 …)
nproc # 전체 CPU 코어 수
free -g | awk '/^Mem:/{print $2"G"}' # 전체 메모리
PP_HOST_IP= 同じネットワーク内でサーバーを指す内部 IP。単一サーバーならPP_SERVICE_IP・PP_MASTER_IPも同じ値を入力してください。PP_SERVICE_IP= ユーザーがブラウザでアクセスする IP / ドメイン。NAT・クラウド環境の場合、外部公開 IP をPP_PUBLIC_IPに追加で記述してください。
分散分析リソースサイジング（PP_CLUSTER_CORES / PP_CLUSTER_MEMORY_BY_CORE）
この 2 つの値は Spark などの分散分析に割り当てるリソースです。**ホスト全体をすべて与えず、**ストレージ・メッセージング・ウェブサーバーが使う分を残してください（全体の 60～70% を推奨）。
| サーバー仕様 | PP_CLUSTER_CORES | PP_CLUSTER_MEMORY_BY_CORE | 分析が使用するメモリ合計 |
|---|---|---|---|
| 16 コア / 64GB | 10 | 2G | 20GB |
| 32 コア / 128GB | 20 | 3G | 60GB |
| 48 コア / 188GB | 30 | 4G | 120GB |
코어 수 × 코어당 메모리が分析が占有するメモリ総量です。この合計がサーバー全体メモリを超えないようにしてください（余裕 30% 以上）。超過するとスタート中に OOM が発生します。
4.2 サービスアカウントのパスワード
運用環境では、必ず以下のデフォルトパスワードを変更してください。
# env.local.sh 안에 추가
export PP_REDIS_PASSWORD=$(openssl rand -base64 18)
export PP_CASSANDRA_PASSWORD=$(openssl rand -base64 18)
export PP_PG_PASSWORD=$(openssl rand -base64 18)
export PP_MQ_PASSWORD=$(openssl rand -base64 18)
export PP_HIVE_PASSWORD=$(openssl rand -base64 18)
export PP_MINIO_PASSWORD=$(openssl rand -base64 18)
export PP_TEMPORAL_PASSWORD=$(openssl rand -base64 18)
export PP_TLS_KEYSTORE_PASSWORD=$(openssl rand -base64 18)
推奨: 変更されたパスワードは運用 vault（HashiCorp Vault、AWS Secrets Manager など）に保管し、
env.local.shから環境ごとのオーバーライドとして注入するパターンを使用してください。
4.3 TLS / SSL 設定
# env.local.sh 안에 추가
export PP_TLS_ENABLED=true
export PP_TLS_DOMAIN=plantpulse.io
export PP_TLS_SAN_DNS="localhost,$(hostname -f),plantpulse.io,plantpulse.kopens.com"
export PP_TLS_SAN_IPS="${PP_HOST_IP},${PP_SERVICE_IP},${PP_PUBLIC_IP},127.0.0.1,192.168.0.10"
export PP_TLS_VALID_DAYS=730
外部公開 IP 追加: NAT / クラウド環境では、外部 IP / ドメインを
PP_TLS_SAN_DNS/PP_TLS_SAN_IPSに明示する必要があります。そうしないとクライアント証明書検証が失敗します。
4.4 検証とリセット
cd /opt/kopens/plantpulse-platform/plantpulse-startup
./env-validate.sh # env.sh + env.local.sh 최종 변수 정합성 검증
./env-reset.sh # env.local.sh 변경 후 템플릿 재생성이 필요할 때
env-validate.shはenv.local.shオーバーライドが適用された 最終値 を検証します。したがってenv.local.sh作成後、このスクリプトで IP・パス・パスワードが意図通り入力されたか確認できます。
5. テンプレート設定適用（configure.sh）
env.sh（+ env.local.sh オーバーライド）の最終値をすべてのモジュールの設定ファイルに一括適用します。
cd /opt/kopens/plantpulse-platform/plantpulse-startup
./configure.sh
configure.sh は内部的に startup.jar CONFIGURE を呼び出して以下を実行します。
template/ディレクトリのすべての設定テンプレート（*.template）をスキャンenv.sh変数でプレースホルダー（${PP_HOST_IP}、${PP_CASSANDRA_PASSWORD}など）を置換- 実際の設定ファイル位置に保存 — ウェブアプリサービス（server / batch / cep / sql / data-gateway）は各モジュールの
config/、インフラモジュールはconf/、etc/など
ウェブアプリサービスの設定がモジュール config/ に外部化されているので、ウェブアプリ（WAR）を再配布しても設定が失われません。
変更後の再実行が必須:
env.local.shを変更するたびに./configure.shを再実行して、新しい値がモジュールに反映されるようにしてください。
6. TLS 証明書準備（prepare-ssl.sh）
PP_TLS_ENABLED=true の場合、初回起動前に証明書を生成します。
cd /opt/kopens/plantpulse-platform/plantpulse-startup
./prepare-ssl.sh
- 自己署名証明書（ECDSA secp256r1）生成
- keystore / truststore 生成（
/var/security/plantpulse/） - OPC-UA / Kafka / MQTT / Cassandra / Web 証明書を個別生成
- 外部 CA 証明書を使用する場合は セキュリティ設定 ページをご参照ください
7. プラットフォーム起動
7.1 フォアグラウンド起動（初回検証）
初回インストール後は、起動ログを直接見ながら確認するとよいでしょう。
/opt/kopens/plantpulse-platform/plantpulse-startup/start.sh
7.2 バックグラウンド起動（運用モード）
運用環境ではデーモンモードで起動します。ターミナルを閉じてもプラットフォームは実行し続けます。
/opt/kopens/plantpulse-platform/plantpulse-startup/start-daemon.sh
7.3 起動順序
startup.jar が依存関係順に段階的にコンポーネントを起動します。
各ステップの完了まで自動的に待機するため、別途操作は不要です。全体起動には 3～5 分 かかります。
7.4 起動正常メッセージ
═══════════════════════════════════════════════════════════════════
____ _ _ ____ _
| _ \| | __ _ _ __ | |_| _ \ _ _| |___ ___
| |_) | |/ _` | '_ \| __| |_) | | | | / __|/ _ \
| __/| | (_| | | | | |_| __/| |_| | \__ \ __/
|_| |_|\__,_|_| |_|\__|_| \__,_|_|___/\___|
PLATFORM
═══════════════════════════════════════════════════════════════════
● Status STARTING [DAEMON]
● Host ...
● URLs https://... (web)
═══════════════════════════════════════════════════════════════════
...
플랜트펄스 플랫폼이 정상적으로 시작되었습니다.
8. インストール確認
8.1 サービス状態確認
/opt/kopens/plantpulse-platform/plantpulse-startup/status.sh
各モジュールが RUNNING 状態として表示され、システムリソース使用量（CPU / Memory PSS / Disk）の概要も表示されます。
=============================================================================================================
PLANTPULSE PLATFORM - ALL SERVICE STATUS
=============================================================================================================
<SYSTEM RESOURCE OVERVIEW>
--------------------------------------------------------------------------------------------------------------
CPU LOAD (AVG) : 12.3% (48 cores)
MEMORY USAGE : 65.2% (123.1G / 188.7G)
DATA DISK USAGE : 45.8% (2.2T / 4.8T)
--------------------------------------------------------------------------------------------------------------
<SERVICE STATUS BY PORT>
SERVICE | PORT | STATUS | PID | CPU | MEMORY (PSS) | PROCESS
PP_MESSAGING[KAFKA] | 9092 | RUNNING | 12345 | 2.3% | 8.5G ( 4.51%) | java
PP_STORAGE[CASSANDRA] | 9042 | RUNNING | 12567 | 5.1% | 16.2G ( 8.59%) | java
PP_SERVER | 80 | RUNNING | 12890 | 1.2% | 4.8G ( 2.55%) | java
...
8.2 ウェブコンソールアクセス
ブラウザで以下のアドレスにアクセスします。
| URL | 用途 |
|---|---|
http://[SERVICE_IP]/ | 運用コンソール（ポート 80） |
https://[SERVICE_IP]/ | 運用コンソール（ポート 443、TLS） |
https://[SERVICE_IP]:7443/ | 管理コンソール（別ポート） |
- デフォルト管理者アカウント：admin / admin123!
- ログイン後、直ちにパスワードを変更してください。
8.3 ヘルスチェックエンドポイント
外部監視システムと連携する場合に使用します。
# 컨테이너 / 프로세스 헬스
curl -kfsS https://127.0.0.1:4950/api/health | jq
# 모니터 모듈
curl -fsS http://127.0.0.1:4949/health
運用コマンド概要
cd /opt/kopens/plantpulse-platform/plantpulse-startup
./start.sh # 포그라운드 시작
./start-daemon.sh # 백그라운드 시작
./stop.sh # 정지
./restart.sh # stop → clean → start-daemon
./status.sh # 전체 모듈 상태
./log-viewer.sh # 통합 로그 뷰어
./log-delete.sh # 오래된 로그 정리
./clean.sh # 임시 파일 정리 (정지 후)
./kill.sh # 강제 종료 (응답 없을 때)
# 모듈별 재시작
./restart-server.sh # 웹 서버
./restart-storage.sh # 스토리지
./restart-analytics.sh # 분석
./restart-messaging.sh # 메시징
./restart-timeseries.sh # 시계열
./restart-workflow.sh # 워크플로우
./restart-cep.sh # CEP
./restart-data-gateway.sh # 데이터 게이트웨이
./restart-monitor.sh # 모니터
./restart-batch.sh # 배치
./restart-warehouse.sh # 웨어하우스
./restart-plugin.sh # 플러그인
./restart-opcua-server.sh # OPC-UA
./restart-aasx-server.sh # AAS
# Cassandra 운영
./node-status.sh # 클러스터 상태
./node-info.sh # 노드 상세
./node-cql.sh # CQL 셸
./node-compact.sh # 수동 컴팩션
./node-cleanup.sh # 노드 정리
./node-repair.sh # 데이터 복구
詳細な運用手順は スタートガイド および 運用管理 ページをご参照ください。
閉域網（エアギャップ）インストール
インターネット遮断環境でのインストール手順は以下の通りです。
ビルドノード（インターネット環境）でバンドル生成
cd /opt/kopens/plantpulse-platform/offline
./prepare-offline.sh
# 산출물: /offline-install/kopens-offline.tar.gz
バンドルには以下が含まれます。
- 全
/opt/kopens/plantpulse-platform/ディレクトリ - 必須 RPM（
offline/repos/rpm/+repodata/） - Python wheel（
offline/repos/python-wheels/） - JDK / インフラパッケージ（
tools/下位）
閉域網ノードへの転送
USB / 内部ファイルサーバー / scp などで kopens-offline.tar.gz を転送してください。
閉域網ノードでのインストール
mkdir -p /opt/kopens
tar -xzvf /path/to/kopens-offline.tar.gz -C /opt/kopens/
cd /opt/kopens/plantpulse-platform/tools
./setup-offline.sh
# 환경 변수 작성 및 시작 (env.sh 직접수정 ✗ → env.local.sh 에 오버라이드)
cd /opt/kopens/plantpulse-platform/plantpulse-startup
vi env.local.sh
./configure.sh
./start-daemon.sh
./status.sh
setup-offline.sh はローカル RPM リポのみを使用して OS 依存関係をインストールし、インフラコンポーネントを配備します。
アップデート
マイナーアップデート（設定 / パッチ）
cd /opt/kopens/plantpulse-platform/plantpulse-startup
./stop.sh
# 패치 파일 적용 (운영팀이 안내한 절차에 따라)
cp -r /tmp/patch/* /opt/kopens/plantpulse-platform/
./configure.sh
./start-daemon.sh
./status.sh
メジャーアップデート（全体再配布）
# 1. 현재 데이터 / 설정 백업
./stop.sh
cp -a /opt/kopens/plantpulse-platform /opt/kopens/plantpulse-platform.bak-$(date +%Y%m%d)
tar -czf /data1/pp-backup/pre-update-$(date +%Y%m%d).tar.gz /data1/pp-data /data1/pp-backup
# 2. 새 tar.gz 풀기 (env.local.sh / 데이터는 보존)
# 설정값은 env.local.sh 에 있으므로 그 파일만 보존하면 됩니다.
# env.sh 는 새 버전으로 갱신되어도 무방합니다(기본값 정본).
cd /opt/kopens
tar -xzvf plantpulse-platform-NEW.tgz --exclude='plantpulse-platform/plantpulse-startup/env.local.sh'
# 3. 재구성 및 시작
cd /opt/kopens/plantpulse-platform/plantpulse-startup
./configure.sh
./start-daemon.sh
# 4. 문제 시 롤백
./stop.sh
rm -rf /opt/kopens/plantpulse-platform
mv /opt/kopens/plantpulse-platform.bak-YYYYMMDD /opt/kopens/plantpulse-platform
cd /opt/kopens/plantpulse-platform/plantpulse-startup
./start-daemon.sh
データ保護: メジャーアップデート前に、必ず
/data1/pp-dataと/data1/pp-backupのフルバックアップを実行し、別ディスク / 外部ストレージに保管してください。
トラブルシューティング要点
| 症状 | 初期対応 |
|---|---|
| 起動後一部モジュール STOPPED | ./status.sh でどのモジュールか確認後 ./restart-<module>.sh |
| メモリ不足 / OOMKilled | env.local.sh の PP_CLUSTER_CORES / PP_CLUSTER_MEMORY_BY_CORE を調整後 ./configure.sh |
| ポート衝突 | ss -tlnp で占有プロセスを確認後終了、または env.local.sh でポート変更後 ./configure.sh |
| ディスク不足 | node-cleanup.sh / node-compact.sh または古いバックアップをクリーンアップ |
| 起動しない | ./log-viewer.sh または tail -F /var/log/plantpulse-startup.log |
| 強制終了が必要 | ./kill.sh（最終手段 — データ損傷リスク） |
詳細な診断手順は トラブルシューティング ページをご参照ください。
次のステップ
- スタートガイド — 日常的な起動 / 停止 / 再起動コマンド
- 運用管理 — バックアップ、アップデート、監視
- クラスタインストール — ワーカーノード追加
- ポート構成情報 — ファイアウォール / ネットワーク設定
技術サポート
インストール過程でサポートが必要な場合は、webmaster@kopens.com までお問い合わせください。./log-viewer.sh のスクリーンショット、または /opt/kopens/plantpulse-platform/plantpulse-startup/test/ の検証結果を一緒にお送りいただけると、迅速な分析が可能になります。