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
-
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.
-
Connectez-vous au Access Gateway Console de gestion.
-
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.
-
Sélectionnez .
-
À l'invite, saisissez le bon nom de package, comme indiqué précédemment, et appuyez sur Entrée.
-
Lorsque la mise à niveau est terminée, fermez Console de gestion.
-
Ouvrez Console de gestion et connectez-vous à nouveau.
-
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.
-
Sélectionnez .
-
Lorsque le programme d'installation vous demande un nom de paquet, saisissez
okta-release-2025.3.1-a01a66b3d et appuyez sur Entrée.
-
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.
-
Sélectionnez .
-
Lorsque le programme d'installation vous demande un nom de paquet, saisissez
okta-release-2026.5.1-73c148ab1 et appuyez sur Entrée.
-
Sélectionnez et suivez les invites pour mettre à jour les packages Access Gateway restants.
Remarque :
La page Mise à jour en cours peut apparaître vide une fois la mise à niveau terminée. Si cela se produit, validez la mise à niveau :
- Appuyez sur CTRL+C sur votre clavier pour revenir à la page précédente. Un message d'échec de mise à niveau peut s'afficher.
- Connectez-vous au Shell et exécutez la commande suivante :
sudo tail -1 /opt/oag/upgrades/current/yumUpdateOutput.log
Le Shell affiche « Terminé ! » lorsque la mise à niveau se termine avec succès.
- Suivez les étapes restantes dans les instructions d'installation.
-
Redémarrez le nœud après avoir terminé la mise à niveau.
-
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.
-
Activez les domaines approuvés sur les nœuds administrateur si ce n'est pas déjà fait.