Installer la version la plus récente d'Access Gateway

Mettre à niveau un nœud Access Gateway vers la dernière version depuis l'Console de gestion

Avant de commencer

  • Ne modifiez pas la taille de la fenêtre de votre terminal pendant le processus de mise à niveau. Si vous redimensionnez la fenêtre à une taille inférieure à 80x24, cela risque d'interrompre le processus de mise à niveau.
  • Le nœud d'administration d'Access Gateway doit pouvoir accéder à l'URL de votre org à l'adresse <your-org>-admin.okta.com. Vérifiez qu'il est exclu du déchiffrement SSL. Consultez Conditions nécessaires au déploiement d'Access Gateway.
  • Si vous effectuez une mise à niveau depuis n'importe quelle version, mettez à niveau le nœud administrateur après avoir mis à niveau tous les nœuds de travail.
  • Si vous effectuez une mise à niveau à partir de la version 2024.6.1 ou antérieure, consultez Comment mettre à niveau Access Gateway à partir des versions 2024.6.1 et antérieures.
  • Si vous effectuez une mise à niveau depuis la version 2024.7.0 ou antérieure, mettez à niveau tous vos nœuds dans la même fenêtre de maintenance. Cela garantit que toutes les configurations d'application sont mises à jour après la mise à niveau de PHP. Si vous ne pouvez pas mettre à niveau tous vos nœuds en même temps, consultez cet article du Support Okta.
  • Si vous avez configuré une mise à jour automatique planifiée, effectuez l'étape 5 de la procédure d'installation sur tous les nœuds avant la date planifiée.

Procédure

  1. Prenez un instantané de l'appliance ou effectuez une sauvegarde avant de commencer le processus de mise à niveau.

    Consultez la documentation de votre plateforme de virtualisation pour savoir comment effectuer des instantanés. Consultez Sauvegarde et restauration.

  2. Connectez-vous au Access Gateway Console de gestion.
  3. Installez le package okta-mgmt-user requis.

    Cette étape est requise dans les cas suivants :

    • Vous avez activé le mode FIPS (Federal Information Processing Standards) et vous utilisez la version 2026.3.0 d'Access Gateway ou une version antérieure. Dans ce cas, utilisez package okta-mgmt-user-2026.3.0-23e5552d4.
    • Le mode FIPS n'est pas activé et vous exécutez la version 2023.7.2 d'Access Gateway ou une version antérieure. Dans ce cas, utilisez package okta-mgmt-user-2023.9.1-64a0a16e6.

    Pour toutes autres versions et configurations, passez à l'étape 4.

    1. Sélectionnez 5 - Système > 2 - Installer le paquet.
    2. À l'invite, saisissez le bon nom de package, comme indiqué précédemment, et appuyez sur Entrée.
    3. Lorsque la mise à niveau est terminée, fermez Console de gestion.
    4. Ouvrez Console de gestion et connectez-vous à nouveau.
  4. Installez le package okta-release-2025.3.1-a01a66b3d.

    Cette étape n'est requise que si vous exécutez Access Gateway version 2025.1.1 ou antérieure. Si votre version d'Access Gateway est 2025.3.1 ou ultérieure, passez à l'étape 5.

    1. Sélectionnez 5 - Système > 2 - Installer le paquet.
    2. Lorsque le programme d'installation vous demande un nom de paquet, saisissez okta-release-2025.3.1-a01a66b3d et appuyez sur Entrée.
  5. Installez le package okta-release-2026.5.1-73c148ab1.

    Cette étape n'est requise que si vous exécutez la version Access Gateway 2026.4.0 ou une version antérieure. Si votre version d'Access Gateway est 2026.5.1 ou ultérieure, passez à l'étape 6.

    1. Sélectionnez 5 - Système > 2 - Installer le paquet.
    2. Lorsque le programme d'installation vous demande un nom de paquet, saisissez okta-release-2026.5.1-73c148ab1 et appuyez sur Entrée.
  6. Sélectionnez 5 - Système > 4 - Mettre à jour et suivez les invites pour mettre à jour les packages Access Gateway restants.
  7. Redémarrez le nœud après avoir terminé la mise à niveau.

    Consultez la section Redémarrer du Menu système pour obtenir des instructions. Le processus de mise à jour de l'application démarre après le redémarrage. Consultez Comment vérifier si une mise à jour de l'application est en cours après la mise à niveau.

  8. Effacez les cookies du navigateur de l'ordinateur client.

    Effectuez cette opération avant d'accéder au Console Access Gateway Admin UI après le redémarrage.

  9. Activez les domaines approuvés sur les nœuds administrateur si ce n'est pas déjà fait.

    Si vous n'activez pas cette option, la déconnexion unique échoue. Consultez la section Gérer les domaines approuvés du menu de configuration réseau d'Access Gateway.