第3章 Red Hat build of Keycloak サーバーのアップグレード
アダプターをアップグレードする前にサーバーをアップグレードします。
3.1. アップグレードの準備
サーバーをアップグレードする前に、次の手順を実行します。
手順
- Red Hat build of Keycloak をシャットダウンします。
- 設定やテーマなどの古いインストールをバックアップします。
-
XA トランザクションが有効な場合は、開かれたトランザクションをすべて処理し、
data/transaction-logs/トランザクションディレクトリーを削除します。 お使いのリレーショナルデータベースのドキュメントの説明に従い、データベースをバックアップします。
サーバーをアップグレードすると、データベースは古いサーバーと互換性がなくなります。アップグレードを元に戻す必要がある場合は、まず古いインストールを復元してから、バックアップコピーからデータベースを復元します。
注記
現在のセットアップで機能 persistent-user-sessions が無効になり、サーバーがアップグレードされると、オフラインのユーザーセッションを除くすべてのユーザーセッションが失われます。これらのセッションを所有するユーザーは、再度ログインする必要があります。機能 persistent-user-sessions は、26.0.0 より前の Red Hat build of Keycloak サーバーリリースでデフォルトで無効になっていることに注意してください。
警告
brute force 検出の失敗したログインに関する情報と現在進行中の認証フローに関する情報は、Red Hat build of Keycloak のシャットダウン時にクリアされる内部キャッシュにのみ保存されます。現在認証し、パスワードの変更やパスワードのリセットは、Red Hat build of Keycloak を再起動して再度実行すると、認証フローを再起動する必要があります。
