この手順は、ダウンタイムを最小限に抑え、データの整合性を維持しながら、スムーズな移行を確実に実現するのに役立ちます。可能な限り、まずは非本番環境でテストを実施してください。
バックアップ、アンインストール、再インストール、および復元手順
開始前に重要な注意事項：
データベースのバックアップと復元手順は最も重要です。先に進む前に、この手順が正常に完了していることを確認してください。
- すべてのコマンドプロンプトを管理者として実行してください。
- これらの手順は、標準的な JMP Live オンプレミス展開方法（JMP Pro、JMP Live データベースインストーラーによる PostgreSQL データベース、Keycloak、および JMP Live サービスを含む）に基づいています。
サービスがオフラインになるため、メンテナンス時間帯にスケジュールしてください。
ステップ1：準備とバックアップ
1. 設定ファイルを新しいフォルダ（例：C:\Backup）にバックアップします。
JMP PoolとJMP Liveのインストールディレクトリにある.envファイルを探してコピーしてください。これらの2つのファイルは再利用されます。
- Keycloakの.confファイルをバックアップしてください（参照用であり、直接再利用することはできません）。
重要：証明書（certs）は、デフォルトのProgram Filesフォルダに保存しないでください。アンインストール時に削除されます。必要に応じて、安全な場所に移動してください。
2. JMP Liveのすべてのサービスを停止します。
- サービス (services.msc) を開き、以下の項目を停止します。
- jmppoolsvc
- webjmpsvc
- JMP Live Keycloak
ステップ2：データベースのバックアップ
1. 管理者権限でコマンドプロンプトを開きます（管理者として実行）。
2. Backupsフォルダに移動します（cdコマンドを使用）。
3. 次のデータベースバックアップコマンドを実行します。
"C:\Program Files\PostgreSQL\13\bin\pg_dump" -Fc -b -h olddbhost -U dba_webjmp -f webjmp.dump webjmp
コマンド内のファイルパスを、ご自身のインストール環境に合わせて更新してください。
4. データベースのサイズによってはかなりの時間がかかる場合があるため、進捗状況を監視してください。
5. 続行する前に、バックアップファイルが存在し、空または破損していないことを確認してください。
- この手順は非常に重要です。バックアップに失敗すると、データ損失につながる可能性があります。
JMP Liveデータベース全体をバックアップおよび復元する必要があります。そうしないと、新しいデプロイメントが正しく動作することが保証されません。
ステップ3：既存のコンポーネントをアンインストールする
以下のプログラムを任意の順序でアンインストールしてください（コントロール パネル > プログラムと機能、またはプログラムの追加と削除から）。
- JMPライブ
- JMP Pro
- JMP Live Database（PostgreSQLインスタンス）
- キークローク
ステップ4：データベースのインストールと復元
1. JMP Liveの自己解凍実行ファイルに含まれているJMP Liveデータベースコンポーネントをインストールします。
2. 同じ管理者権限のコマンドプロンプトとバックアップフォルダを使用して、次の復元コマンドを実行します。
"C:\Program Files\PostgreSQL\13\bin\pg_restore" -Fc -h newdbhost -U dba_webjmp -d webjmp webjmp.dump
コマンド内のファイルパスを、ご自身のインストール環境に合わせて更新してください。
3. リストアが正常に完了したことを確認します（ログを確認するか、データベースにクエリを実行します）。
ステップ5：その他のJMP Liveコンポーネントをインストールする
以下の手順で正確にインストールしてください。
1. JMP Pro
2. キークローク
インストール中に、必要な管理者設定とデータベース設定を入力してください。
- バックアップした Keycloak の .conf ファイルをメモ帳で開き、設定値 (ポート、管理者認証情報、データベース接続など) の参照として使用します。
3. JMP Live
インストール中に、インストール後に.envファイルを上書きする予定がある場合は、プロンプトが完全に正確である必要はありません。
- プロンプトが表示されたら、JMP Pro のインストール パスが正しく指定されていることを確認してください (または、後で JMP Pool の .env ファイルで更新します。つまり、18 → 19 の参照を変更します)。
ステップ6：インストール後の設定
1. サービスを再度停止します（自動的に開始された場合）：
- サービス (services.msc) を開き、以下の項目を停止します。
- jmppoolsvc
- webjmpsvc
- JMP Live Keycloak
2. 設定ファイルを上書きする
- JMP Pool および JMP Live ディレクトリにある新しい .env ファイルを、バックアップしたコピーに置き換えてください。
バージョン固有のパス（例：JMP Pro パス 18 → 19）を確認し、必要に応じて更新してください。これらのパスはメモ帳で編集できます。
変更を保存します。
3. JMP Liveを起動する
- `C:\Program Files\JMP\JMP Live\`（またはインストールパス）に移動します。
- `launch.cmd` を管理者として実行してください。
- 両方のコマンドプロンプトウィンドウの初期化が完了するまで待ち、その後閉じます。
4. サービスを開始する
- サービス (services.msc) を開き、以下の手順で開始します。
- JMP Live Keycloak
- webjmpsvc
- jmppoolsvc
ステップ7：最終確認と再承認
1. JMP Live AdministratorのWebインターフェースにアクセスします。
- https://URL/admin/login
2. 管理者としてログインしてください。
3. [管理者]タブに移動します。
4. JMP Liveを再認証します（画面の指示に従ってライセンス認証と接続検証を完了してください）。
5. 主要機能のテスト: デスクトップ版 JMP Pro からサンプル レポートを公開し、ユーザー アクセスを確認し、データの更新をチェックするなど。
問題が発生した場合：
サービスの状態とログを確認してください。
- データベース接続とKeycloakレルムの設定を確認します。
- JMP Liveの公式インストール手順書を参照するか、JMPテクニカルサポートにお問い合わせください。
