Mise à niveau

Dernière publication : Nov 04, 2026
Related information
Gérer

Mise à niveau depuis la version 2403 ou antérieure

Si vous utilisez une version d'App Layering antérieure ou égale à la version 2403, vous devez utiliser la fonctionnalité de migration pour accéder à la version 2409 ou ultérieure. Il n'y a pas de mise à niveau sur place de la version 2403 vers la version 2409. Pour effectuer la mise à niveau, une nouvelle appliance exécutant la version 2409 ou ultérieure doit être déployée, puis la fonctionnalité de migration doit être utilisée pour migrer la configuration de l'appliance 2403 vers la nouvelle appliance déployée. Pour accéder à la fonctionnalité de migration, vous devrez d'abord confirmer que vous avez effectué la mise à niveau vers la dernière version de la version 2403. Le téléchargement de la dernière version de la version 2403 peut être trouvé ici, ou peut être mis à niveau via l'appliance.
Vous pouvez vous référer à la documentation Migrer l'appliance pour plus de détails. À un niveau élevé, voici les étapes requises pour que votre appliance fonctionne avec la version 2409 ou ultérieure :
  1. Téléchargez et déployez la dernière version disponible, configurez votre appliance et exécutez-la sur votre réseau.
  2. Prenez un instantané de VOTRE appliance 2403 actuelle ET des appliances nouvellement déployées.
  3. Mettez à niveau votre appliance 2403 vers la dernière version disponible, qui inclura la fonctionnalité de migration.
  4. Sur l'appliance 2403, dans le menu utilisateur en haut à droite, cliquez sur Migrer l'appliance.
  5. Il existe deux modes de migration : Copier et Déplacer :
    1. Le mode Copier répliquera les données de couche et la configuration vers la nouvelle appliance, mais ne déplacera ni ne modifiera aucune des configurations de l'ancienne appliance.
      • La nouvelle appliance nécessitera une configuration manuelle avant la première utilisation.
    2. Le mode Déplacer remappera les partages de fichiers réseau vers la nouvelle appliance et les supprimera de l'ancienne appliance.
      • Cela laissera l'ancienne appliance sans partage de fichiers réseau configuré, et la nouvelle appliance sera prête à l'emploi.
  6. Une migration comporte deux phases, et une confirmation de l'utilisateur est requise entre la phase un et la phase deux afin de terminer le processus de migration vers la nouvelle appliance.
  7. Une migration est une tâche et peut être surveillée et gérée via la liste des tâches dans l'interface utilisateur.

Mise à niveau à partir de la version 2409 ou ultérieure

Pour bénéficier des dernières corrections et fonctionnalités, y compris la compatibilité avec les autres progiciels que vous utilisez, nous vous encourageons à maintenir vos mises à niveau d'App Layering à jour. Le processus de mise à niveau est partiellement automatisé, l'appliance vérifiant périodiquement la disponibilité du dernier package. Elle télécharge les nouveaux packages, les vérifie et en extrait les fichiers. Les utilisateurs reçoivent un message lors de leur prochaine connexion, et les administrateurs disposant des autorisations appropriées peuvent lancer la mise à niveau.
Outre la mise à niveau de l'appliance App Layering, prévoyez également de mettre à niveau :
  • L'agent App Layering, s'il est installé sur votre hyperviseur et vos serveurs de provisioning.
  • Les images en couches publiées (nécessite le provisioning de vos serveurs avec les images).
Cet article explique comment effectuer chacune des mises à niveau associées.

Avant la mise à niveau

  • Vérifiez qu'un partage de fichiers réseau est configuré.
  • Sauvegardez l'appliance.

Vérifier qu'un partage de fichiers réseau est configuré

Vous pouvez confirmer le partage en vous connectant à l'appliance et en accédant à Système > Partage de fichiers réseau. Après vous être assuré d'avoir configuré le partage de fichiers, vous pouvez mettre à niveau l'appliance.

Sauvegarder l'appliance

Prenez un instantané ou un point de contrôle de l'appliance.

Mettre à niveau l'appliance

Les mises à niveau d'App Layering sont partiellement automatisées. L'appliance vérifie périodiquement la disponibilité des mises à niveau et télécharge la dernière version, à condition que les autorisations correctes et les autres exigences soient en place.
Le dossier Mise à niveau comprend la mise à niveau de l'appliance, la mise à niveau de l'agent et un dossier d'outils à utiliser sur votre couche de système d'exploitation.

Que se passe-t-il si une mise à niveau est détectée

Si une mise à niveau est détectée lors de la vérification automatisée, le dernier dossier compressé disponible est téléchargé sur votre appliance. L'appliance vérifie le téléchargement et extrait les fichiers en arrière-plan.
Pendant ce temps, chaque utilisateur reçoit l'un des messages suivants lors de sa prochaine connexion :
  • Démarrer la mise à niveau : Exécute la mise à niveau du logiciel de l'appliance App Layering (administrateurs uniquement).
  • Fermer : Ignore le message, ce qui vous permet de démarrer manuellement la mise à niveau ultérieurement à l'aide de l'onglet Utilisateur > Mettre à niveau l'appliance.
Pour plus de détails sur ce que l'appliance vérifie, consultez Fonctionnement détaillé des vérifications de mise à niveau.

Qui peut démarrer la mise à niveau

Seul un administrateur peut démarrer la mise à niveau.

Si votre pare-feu empêche les téléchargements automatiques du package de mise à niveau

Si les exigences du pare-feu empêchent le téléchargement automatique, téléchargez le package de mise à niveau depuis le site de téléchargement de Citrix®. Copiez le package sur le partage de fichiers réseau où l'appliance peut y accéder.
  1. Accédez au fichier .zip et extrayez les fichiers.
  2. Connectez-vous à la console de gestion, sélectionnez Utilisateur, puis cliquez sur Mettre à niveau l'appliance.
  3. Vérifiez le chemin de mise à niveau, puis cliquez sur Mettre à niveau. Le processus de mise à niveau démarre et ouvre une page d'état (Statuspage) dans le navigateur.
  4. Lorsque la mise à niveau est terminée, le statut passe à Statut de la mise à niveau : Terminé. Actualisez la page Web pour revenir à la console de gestion.
  5. Vérifiez que la mise à niveau a réussi en cliquant sur le lien À propos dans la console de gestion pour confirmer le numéro de version.

Mettre à niveau l'agent App Layering (si installé)

Ensuite, mettez à niveau l'agent App Layering. Ce composant permet à une appliance ou à une machine de packaging d'exécuter des commandes PowerShell localement. Vous pouvez vous attendre à trouver l'agent installé aux emplacements suivants, s'ils existent dans votre environnement :
  • Serveurs Hyper-V qu'App Layering utilise pour la création de couches ou la publication d'images.
  • Serveurs Citrix Provisioning™ où vous publiez des images en couches.
  • Serveurs où une configuration de connecteur exécute des scripts PowerShell. Pour afficher les configurations de connecteur existantes, ouvrez la console de gestion et sélectionnez Système > Connecteurs.
Pour mettre à niveau l'agent App Layering à ces emplacements :
  1. Copiez le fichier de mise à niveau de l'agent sur les serveurs où l'agent est installé.
  2. Double-cliquez sur le fichier de mise à niveau de l'agent et suivez les instructions pour mettre à niveau l'agent.

Mettre à niveau vos images en couches publiées

Les mises à niveau d'App Layering incluent des mises à jour de pilotes, de nouvelles fonctionnalités et les corrections de bogues documentées dans Nouveautés. Une fois l'appliance mise à niveau, mettez à niveau vos images publiées.
Pour mettre à niveau vos images publiées, sélectionnez chacun de vos modèles d'image, vérifiez les paramètres et utilisez-le pour publier de nouvelles versions des images en couches. Utilisez les nouvelles images pour provisionner vos systèmes.
Pour appliquer la mise à niveau à vos images en couches publiées :
  1. Connectez-vous à la console de gestion du layering.
  2. Sélectionnez l'onglet Images. Vos modèles d'image s'affichent.
  3. Si vous souhaitez vérifier ou mettre à jour les paramètres d'un modèle, sélectionnez le modèle d'image, puis cliquez sur Modifier le modèle. Modifiez les paramètres et cliquez sur Enregistrer le modèle et publier.
  4. Si le modèle d'image n'a pas besoin d'être modifié, sélectionnez simplement le modèle, puis cliquez sur Publier l'image en couches.
  5. Une fois publiées, utilisez les nouvelles images en couches pour provisionner vos systèmes.

Contexte : Fonctionnement détaillé des vérifications de mise à niveau

Lorsque l'appliance App Layering vérifie la présence d'une mise à niveau :
  • Si aucune mise à jour n'est disponible : Rien ne se passe. Une autre vérification est effectuée à l'intervalle planifié suivant.
  • Si une mise à jour est disponible, mais qu'aucun partage de fichiers réseau n'est configuré : L'utilisateur reçoit un message indiquant qu'une mise à niveau est disponible. Il vous demande de terminer la configuration du partage de fichiers réseau.
  • Si une mise à jour est disponible : Une tâche est lancée pour « Télécharger le média de mise à niveau ». Vous pouvez vérifier la progression via les tâches suivantes :
    • Téléchargement du média de mise à niveau vers le stockage local.
    • Vérification que la somme de contrôle du package de mise à niveau téléchargé avec succès est correcte.
    • Extraction du package de mise à niveau téléchargé vers le partage de fichiers réseau configuré. Le téléchargement est extrait vers le partage de fichiers de l'appliance : Emplacement : NetworkFileShare*AppLayeringVersion* Exemple : \\MyServer\AppLayeringFileShare\4.0.8
      • Si l'extraction est réussie, la prochaine fois qu'un utilisateur se connectera, il sera informé qu'une mise à niveau est disponible.
      • Si, à tout moment au cours de ce processus, une erreur nécessite l'intervention de l'administrateur, la tâche échoue avec une erreur. Par exemple :
        • Manque d'espace sur le stockage local.
        • Manque d'espace sur le partage de fichiers réseau.
        • Fichiers non valides trouvés.
        Remarque :
        Si une tâche échoue, elle est relancée lors du prochain intervalle de vérification, que le problème ait été résolu ou non.
  • Si une autre mise à jour est trouvée avant l'installation d'une mise à jour précédemment téléchargée - La nouvelle mise à niveau est téléchargée et, une fois terminée avec succès, devient « Mise à niveau disponible ».
  • Si une mise à niveau est en cours de téléchargement lorsqu'une autre est rendue disponible - Le téléchargement en cours est annulé et un nouveau téléchargement est démarré. Tous les fichiers liés au téléchargement en cours sont supprimés.

Facultatif : Comment vérifier manuellement les mises à niveau disponibles

Les vérifications automatiques des mises à niveau téléchargent toujours la dernière version, mais vous pouvez vérifier manuellement les mises à jour.
Pour vérifier manuellement une mise à jour :
  1. Connectez-vous à la console de gestion.
  2. Cliquez sur l'onglet Utilisateur, puis sur l'action Mettre à niveau l'appliance. La dernière version s'affiche dans le champ Disque de mise à niveau.
Si vous êtes connecté à un bureau en tant qu'administrateur et qu'un badge de mise à niveau s'affiche :
  1. Cliquez sur Démarrer la mise à niveau. Les informations de téléchargement s'affichent dans le champ Disque de mise à niveau.
  2. En tant qu'administrateur, vous pouvez sélectionner un autre Disque de mise à niveau.
Utilisez les étapes détaillées de la section précédente, Mettre à niveau l'appliance.