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

installer케이스별시나리오

0. 共通確認項目 (すべてのケース共通)​

確認項目期待動作確認必要
./start.sh実行バックグラウンドで起動される✅
./start.sh foreground実行フォアグラウンドで起動される✅
./stop.sh実行起動中のエージェントが終了される✅

1. Unpack — 新規 (2番選択)​

  • 事前条件: exem/ディレクトリがない状態
  • 実行: .bin実行 → 2番(unpack)選択
  • 期待ログ:
Unpack completed
UNPACK_DIR={실행경로}/exem/kafka
xmSuccess(0): unpack completed
確認項目期待動作確認必要
exem/kafka/ディレクトリ生成生成される✅
start.sh, stop.sh存在✅
install_start.sh, install_stop.shなし✅

2. Unpack — 既存あり (2番選択)​

  • 事前条件: exem/kafka/に既存インストールあり(cfg/kafka.confが修正された状態)
  • 実行: 同じパスで.bin実行 → 2番(unpack)
備考

⚠️ unpackはパッケージをそのまま解凍するモードであるため、既存に修正したcfg/kafka.confなどの設定ファイルがパッケージのデフォルト値で上書きされます。既存設定を維持したままアップデートするには、unpackの代わりにinstall(patch)モードを使用してください。

確認項目期待動作確認必要
cfg/kafka.confパッケージのデフォルト値で上書きされる✅
lib/exem-kafka-agent.jar上書きされる✅
pkg_version.sh/bat上書きされる✅
jre/上書きされる✅
.installconfig維持(パッケージに未含)✅
log/内の既存ログファイル維持(パッケージに未含)✅

3. Fresh Install — デフォルトパス (1番選択)​

  • 事前条件: exem/ディレクトリがない状態
  • 実行: .bin実行 → 1番 → EXEM_HOME Enter(デフォルト値)
  • 期待ログ:
Installation completed
xmSuccess(0): installation completed
確認項目期待動作確認必要
"Existing installation found"メッセージ表示されない✅
インストール位置{실행경로}/exem/kafka✅
start.sh, stop.sh存在(install用)✅
install_start.sh, install_stop.shなし✅
.installconfig生成される✅
exem-installer-tmp/残らない✅

4. Fresh Install — ユーザー指定パス (1番選択)​

  • 事前条件: /opt/exemがない状態
  • 実行: 1番 → EXEM_HOMEに/opt/exemを入力
確認項目期待動作確認必要
インストール位置/opt/exem/kafka✅
残り3番と同一✅

5. Patch — デフォルトパス (1番選択、既存インストールあり)​

  • 事前条件: exem/kafka/に既存インストールあり
  • 実行: 同じパスで.bin実行 → 1番 → EXEM_HOME Enter
  • 期待ログ:
Existing installation found. Running patch...
Existing version: "3.0.x.x"
New version: "3.0.x.x"
...
Patch completed (agent not started)
xmSuccess(0): patch completed
確認項目期待動作確認必要
置換されるファイル
lib/exem-kafka-agent.jar新バージョンで置換される✅
pkg_version.sh新バージョンで置換される✅
pkg_version.bat新バージョンで置換される✅
.installconfigユーザー入力値で更新される✅
維持されるファイル
cfg/kafka.conf既存設定維持✅
start.sh, stop.sh既存ファイル維持✅
jre/既存維持(既にあればコピーしない)✅
log/既存維持✅
整理
exem-installer-tmp/残らない✅

6. Patch — ユーザー指定パス (1番選択、既存インストールあり)​

  • 事前条件: /opt/exem/kafka/に既存インストールあり
  • 実行: 1番 → EXEM_HOMEに/opt/exemを入力
確認項目期待動作確認必要
動作5番と同一✅

7. Config モード (silent install)​

  • 実行: ./setup.bin config.txt
  • config.txt例:
INSTALL_DIR=/opt/exem
RECEIVER_IP=10.20.30.40
RECEIVER_PORT=9009
確認項目期待動作確認必要
INSTALL_DIRキーインストールパスとして認識される✅
INSTALL_PATHキーインストールパスとして認識される✅
RECEIVER_PORT未指定時デフォルト値9009適用✅
EXEM_AGENT_NAME未指定時デフォルト値kafka-agent適用✅
対話形式入力なしでインストール完了✅

8. 異常終了後の再インストール​

  • 事前条件: 以前のインストール中断によりexem-installer-tmp/が残っている状態
  • 実行: .bin実行 → 1番 → 正常インストール進行
確認項目期待動作確認必要
既存exem-installer-tmp整理後に正常インストールされる✅
インストール結果Fresh InstallまたはPatchと同一✅