Si votre dispositif virtuel 22.09.X dispose d'une connectivité Internet, vous pouvez mettre à niveau le dispositif en ligne.

Conditions préalables

  • Les conditions préalables répertoriées dans la section Conditions préalables pour la mise à niveau en ligne de Workspace ONE Access doivent être respectées.
  • Vérifiez que le dispositif virtuel est sous tension et qu'il fonctionne.
  • Pour Workspace ONE Access 23.09, l'UI de la page de configuration de Mobile SSO CertProxy a été repensée. Si vous avez activé les paramètres du proxy de certificat Android SSO dans Configuration VA > Mobile SSO dans votre environnement, vous êtes invité à mettre à jour les paramètres CertProxy suivants lors de la mise à niveau.
    • Nombre d'équilibreurs de charge. Entrez le nombre d'équilibreurs de charge qui se trouvent entre le service CertProxy et l'instance de Workspace ONE Access ou entrez 0 si aucun équilibreur de charge n'est utilisé.
    • Nom d'en-tête de l'équilibreur de charge IP du client (source IP distante). Il s'agit de la source utilisée pour obtenir l'adresse IP de l'instance de CertProxy à partir de la demande HTTP. La valeur peut être l'en-tête X-Forwarded-For ou X-Real-Ip. Si le nombre d'équilibreurs de charge est égal à 0, l'option Source IP distante est automatiquement définie sur Demander une adresse distante.
    • Liste autorisée d'adresses IP de l'instance de CertProxy à partir desquelles accepter les demandes d'authentification. La configuration actuelle des adresses IP est préremplie. Vous pouvez apporter des modifications ou cliquer sur Entrer pour conserver la configuration actuelle. Pour modifier la liste autorisée, entrez les adresses IP des instances de CertProxy séparées par un point-virgule, au format CIDR, format de sous-réseau délimité par un espace ou en tant qu'adresse IP unique.
      Important : Si le nombre d'équilibreurs de charge est égal à 0 et que la destination CertProxy est définie sur localhost, vous devez ajouter l'adresse IP de localhost à la liste d'adresses IP dans la liste autorisée. En général, il s'agit de 127.0.0.1.

Procédure

  1. Connectez-vous au dispositif virtuel Workspace ONE Access existant en tant qu'utilisateur racine.
  2. Exécutez la commande updatemgr.hzn suivante. 
    /usr/local/horizon/update/updatemgr.hzn updateinstaller
  3. Exécutez la commande suivante pour vérifier qu'une mise à niveau en ligne existe. 
    /usr/local/horizon/update/updatemgr.hzn check
  4. Exécutez la commande suivante pour mettre à jour le dispositif. 
    /usr/local/horizon/update/updatemgr.hzn update
    1. Si le service CertProxy est activé, les paramètres suivants doivent être mis à jour.
      1. Please provide number of load balancers between CertProxy and Access instance:
        Note : Si vous n'utilisez pas d'équilibreur de charge, entrez  0 comme valeur. Lorsque vous entrez 0, la question CertProxy suivante ne s'affiche pas.
      2. Please provide client IP load balancer header name (x-forwrded-for/x-real-ip):
      3. Please provide list of CertProxy instance IP addresses, separated by a semicolon, either in CIDR format, subnet format delimited by a space, or as a single IP:
        Important : Si le nombre d'équilibreurs de charge est égal à 0 et que la destination CertProxy est définie sur localhost, vous devez ajouter l'adresse IP de localhost à la liste d'adresses IP dans la liste autorisée. En général, il s'agit de 127.0.0.1.
    2. À l'invite Would like to execute script /usr/local/horizon/update/reindexingIndices.hzn?, entrez y lorsque vous mettez à niveau le premier nœud d'un cluster. Lorsque vous mettez à niveau les autres nœuds du cluster, entrez n.
      Pour une mise à niveau à nœud unique, le paramètre est  y par défaut.
  5. Exécutez de nouveau la commande updatemgr.hzn check pour vérifier qu'une mise à jour plus récente n'existe pas. 
    /usr/local/horizon/update/updatemgr.hzn check
  6. Redémarrez le dispositif virtuel.
    reboot
  7. Vérifiez la version du dispositif mis à niveau. 
    vamicli version --appliance
    La nouvelle version est affichée.
  8. Après la mise à niveau de tous les nœuds dans votre déploiement de Workspace ONE Access, utilisez le tableau de bord de diagnostics pour surveiller la santé des informations système.
    1. Connectez-vous à la console Workspace ONE Access.
    2. Pour ouvrir le tableau de bord des diagnostics, sélectionnez Surveiller > Résilience.
    3. Si votre déploiement comporte plusieurs dispositifs Workspace ONE Access, sélectionnez celui à surveiller.
    4. Vérifiez l'état des différents services.
      Pour vérifier, par exemple, la santé du service OpenSearch, examinez la section Composants intégrés et confirmez que les valeurs des éléments OpenSearch sont conformes aux attentes. Par conséquent, la valeur d' OpenSearch - Santé est Vert, les informations sur les nœuds de cluster sont exactes, etc.

Résultats

La mise à niveau est terminée.

Pour les tâches qui peuvent avoir besoin d'être effectuées après la mise à niveau vers la version 23.09, reportez-vous à la section Configuration après la mise à niveau de Workspace ONE Access.