Access Gatewayの最新バージョンをインストールする

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を完了してください。

手順

  1. アップグレードプロセスを開始する前にアプライアンスのスナップショットを作成するか、バックアップしてください。

    スナップショットの作成手順については、仮想プラットフォームのドキュメントを参照してください。「バックアップと復元」を参照してください。

  2. Access Gateway 管理コンソールにサインインします。
  3. 必要な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に進みます。

    1. システム(5 - System) > パッケージをインストール(2 - Install Package)を選択します。
    2. プロンプトが表示されたら、正しいパッケージ名(前述のとおり)を入力し、Enterを押します。
    3. アップグレードが完了したら、管理コンソールを閉じます。
    4. 管理コンソールを開いてサインインし直します。
  4. okta-release-2025.3.1-a01a66b3dパッケージをインストールします。

    この手順はAccess Gatewayのバージョン2025.1.1以前を使用している場合にのみ必要です。Access Gatewayのバージョンが2025.3.1以降の場合は、手順5に進んでください。

    1. システム(5 - System) > パッケージをインストール(2 - Install Package)を選択します。
    2. インストーラーからパッケージ名を求められたら、okta-release-2025.3.1-a01a66b3dを入力してEnterを押します。
  5. okta-release-2026.5.1-73c148ab1パッケージをインストールします。

    この手順は、Access Gatewayのバージョン2026.4.0以前を使用している場合にのみ必要です。Access Gatewayのバージョンが2026.5.1以降の場合は、手順6に進んでください。

    1. システム(5 - System) > パッケージをインストール(2 - Install Package)を選択します。
    2. インストーラーからパッケージ名を求められたら、okta-release-2026.5.1-73c148ab1を入力してEnterを押します。
  6. システム(5 - System) > 更新(4 - Update)を選択し、プロンプトに従って残りのAccess Gatewayパッケージを更新します。
  7. アップグレードが完了したら、ノードをリブートします。

    手順については、システムメニューのリブート(Reboot)を参照してください。リブート後に、アプリの更新プロセスが開始します。 「アップグレード後にアプリケーションの更新が進行中かどうかを確認する方法」を参照してください。

  8. クライアントのコンピューターからブラウザーのクッキーを消去します。

    リブート後のAccess Gateway管理者UIコンソールにアクセスする前にこれを実行します。

  9. まだ有効になっていない場合は、管理者ノードで信頼済みドメインを有効にします。

    このオプションを有効にしないと、シングルログアウトが失敗します。 Access Gatewayネットワークセットアップメニューの 信頼済みドメインを管理する(Manage Trusted Domains)セクションを参照してください。