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