Access Gatewayノードを管理コンソールから最新バージョンにアップグレードします。
始める前に
- アップグレード処理中に、ターミナルウィンドウのサイズを変更しないでください。ウィンドウのサイズを80x24未満に変更すると、アップグレード処理が中断される可能性があります。
- Access Gateway管理者ノードが、
<your-org>-admin.okta.comのorg URLにアクセスできる必要があります。SSL復号化から除外されていることを確認します 。「Access Gatewayデプロイメントの前提条件」を参照してください。
- いずれかのバージョンからアップグレードする際は、すべてのワーカーノードをアップグレードした後に、管理者ノードをアップグレードしてください。
- バージョン2024.6.1以前からアップグレードするときは、 「バージョン2024.6.1以前からAccess Gatewayをアップグレードする方法」を参照してください。
- バージョン2024.7.0以前からアップグレードする際は、同じメンテナンスウィンドウ内ですべてのノードをアップグレードしてください。これにより、PHPのアップグレード後にすべてのアプリ構成が確実に更新されます。すべてのノードを同時にアップグレードできないときは、こちらの「Oktaサポート記事」を参照してください。
- スケジュール設定したAutoUpdateが構成されている場合は、スケジュール設定された時間までにすべてのノードでインストール手順のステップ5を完了してください。
手順
-
アップグレードプロセスを開始する前にアプライアンスのスナップショットを作成するか、バックアップしてください。
スナップショットの作成手順については、仮想プラットフォームのドキュメントを参照してください。「バックアップと復元」を参照してください。
-
Access Gateway 管理コンソールにサインインします。
-
必要な
okta-mgmt-userパッケージをインストールします。
この手順は、次のいずれかの場合に必要になります。
- 連邦情報処理標準(FIPS)モードを有効にし、Access Gatewayのバージョン2026.3.0以前を実行している。この場合、パッケージ
okta-mgmt-user-2026.3.0-23e5552d4を使用します。
- FIPSが有効になっておらず、Access Gatewayのバージョン2023.7.2以前を実行している。この場合、パッケージ
okta-mgmt-user-2023.9.1-64a0a16e6を使用します。
他のすべてのバージョンと構成では、ステップ4に進みます。
-
を選択します。
-
プロンプトが表示されたら、正しいパッケージ名(前述のとおり)を入力し、Enterを押します。
-
アップグレードが完了したら、管理コンソールを閉じます。
-
管理コンソールを開いてサインインし直します。
-
okta-release-2025.3.1-a01a66b3dパッケージをインストールします。
この手順はAccess Gatewayのバージョン2025.1.1以前を使用している場合にのみ必要です。Access Gatewayのバージョンが2025.3.1以降の場合は、手順5に進んでください。
-
を選択します。
-
インストーラーからパッケージ名を求められたら、
okta-release-2025.3.1-a01a66b3dを入力してEnterを押します。
-
okta-release-2026.5.1-73c148ab1パッケージをインストールします。
この手順は、Access Gatewayのバージョン2026.4.0以前を使用している場合にのみ必要です。Access Gatewayのバージョンが2026.5.1以降の場合は、手順6に進んでください。
-
を選択します。
-
インストーラーからパッケージ名を求められたら、
okta-release-2026.5.1-73c148ab1を入力してEnterを押します。
-
を選択し、プロンプトに従って残りのAccess Gatewayパッケージを更新します。
注:
アップグレードが完了した後、アップグレード中(Upgrade in-progress)ぺージが空白になる場合があります。この場合は、以下に従ってアップグレードを検証してください。
- キーボードでCTRL+Cを押して、前のページに戻ります。アップグレードの失敗メッセージが表示される場合があります。
- シェルにサインインして次のコマンドを実行します。
sudo tail -1 /opt/oag/upgrades/current/yumUpdateOutput.log
アップグレードが正常に完了したときは、シェルが完了(Complete!)と表示します。
- インストール手順の残りの指示に従ってください。
-
アップグレードが完了したら、ノードをリブートします。
-
クライアントのコンピューターからブラウザーのクッキーを消去します。
リブート後のAccess Gateway管理者UIコンソールにアクセスする前にこれを実行します。
-
まだ有効になっていない場合は、管理者ノードで信頼済みドメインを有効にします。