La vérification de mise à jour/migration valide un hôte par rapport aux prérequis pour une version cible de Cloud Exchange avant que vous ne l'installiez, ne la mettiez à jour ou ne la migriez. La vérification est en lecture seule. Rien n'est modifié sur l'hôte.
Vous exécutez la vérification à partir de la ligne de commande avec le script ce_healthcheck. Il affiche un résultat pour chaque prérequis et se termine par un verdict global.
Cloud Exchange v7.0.0 et les versions ultérieures peuvent également exécuter le contrôle depuis l’interface utilisateur. Pour plus de détails, consultez la page Paramètres généraux. Utilisez la ligne de commande pour les versions antérieures à 7.0.0, ou sur un hôte où Cloud Exchange n’est pas encore installé.
Conditions préalables
- Accès root à l’hôte. La vérification doit être effectuée avec
sudo. - Python 3.6 ou ultérieur sur l’hôte.
- Accès HTTPS sortant depuis l’hôte vers
raw.githubusercontent.com/netskopeoss/ta_cloud_exchange, pour télécharger le script et les définitions du contrôle.
Télécharger le script de vérification de mise à jour/migration
Téléchargez le script et les définitions de vérification dans le répertoire d’installation de Cloud Exchange.
- Allez dans le répertoire d’installation Cloud Exchange :
- Containerized Deployment: Le répertoire
ta_cloud_exchangequi contient le fichierdocker-compose.yml. - Cloud Exchange as a VM: Le répertoire
/opt/cloudexchange/cloudexchange.
- Containerized Deployment: Le répertoire
- Exécutez ces commandes pour télécharger le script et les définitions de contrôle, et pour rendre le script exécutable :
curl -fsSL -O https://raw.githubusercontent.com/netskopeoss/ta_cloud_exchange/main/ce_healthcheck chmod +x ce_healthcheck
Exécutez le contrôle de mise à niveau/migration depuis le répertoire d’installation. Le contrôle détecte le type de déploiement et la version installée à partir des fichiers de ce répertoire.
Exécuter la vérification de la mise à niveau/migration
La vérification détecte le contexte d'exécution, le type de déploiement et la version installée sur l'hôte, et les affiche avant d'exécuter les vérifications. Aucune demande n'est effectuée. Vous pouvez remplacer toute valeur détectée par les options listées dans Options.
Déploiement autonome
- Dans le répertoire d’installation, exécutez cette commande :
sudo python3 ./ce_healthcheck
- Examinez le résultat de chaque vérification à l’écran. La vérification enregistre également un rapport détaillé sous
ce_healthcheck_report.jsondans le dossier actuel. - Lisez le résumé et le verdict général à la fin de la sortie. Pour plus de détails, consultez Comprendre les résultats.
Si vous ne spécifiez pas de version, la vérification valide l’hôte par rapport à la dernière version de Cloud Exchange couverte par les définitions de vérification. Pour valider par rapport à une version spécifique, ajoutez l’option --target-version. Par exemple :
sudo python3 ./ce_healthcheck --target-version 7.0.0
Déploiement HA
Exécutez le contrôle sur chaque nœud du cluster. Chaque nœud signale ses propres résultats, y compris si ce nœud peut atteindre les autres nœuds sur les ports HA.
- Sur le premier nœud, allez dans le répertoire d'installation et exécutez la commande qui correspond à l'état du nœud :
- Existing HA cluster: Exécutez
sudo python3 ./ce_healthcheck. La vérification détecte le déploiement de la HA. - Nodes you have not set up yet: Exécutez
sudo python3 ./ce_healthcheck --deployment HA. Un nœud qui n’a aucune configuration HA ne peut pas être détecté comme HA, donc vous définissez vous-même le type de déploiement.
- Existing HA cluster: Exécutez
- Examinez les résultats à l’écran et corrigez tout élément en échec.
- Répétez ces étapes sur chaque autre nœud du cluster.
Sur un nœud qui n’a pas encore de configuration HA, la vérification ne peut pas tester la connexion aux autres nœuds ; la vérification de la connectivité du nœud pair HA affiche donc Non applicable. Une fois le cluster configuré, exécutez à nouveau la vérification sur chaque nœud.
Options
La vérification accepte ces options :
| Option | Description |
|---|---|
--deployment SA|HA | Définissez le type de déploiement au lieu de le détecter. |
--target-version <version> | Définissez la version de Cloud Exchange par rapport à laquelle effectuer la validation. |
--mode install|upgrade|migrate | Définissez le contexte d’exécution au lieu de le détecter. Le contexte de migration exécute les mêmes vérifications que l’installation. |
--list-versions | Répertorier les versions de Cloud Exchange qui peuvent être sélectionnées. |
--html <path> | Enregistrez un rapport HTML partageable. |
--report <path> | Enregistrez le rapport JSON détaillé à un emplacement spécifique. |
--manifest-path <path> | Utilisez un fichier local pour les définitions de vérification au lieu de les télécharger. |
--json | Affichez le rapport complet sur l’écran au format JSON au lieu des résultats. |
--quiet | Supprimer les notes de valeur détectée. |
Exemples de commandes
Exécutez ces commandes dans le répertoire d'installation de Cloud Exchange. Remplacez 7.0.0 par la version de Cloud Exchange avec laquelle vous voulez valider.
| Cas d'utilisation | Command |
|---|---|
| Vérifiez un hôte avant d’installer Cloud Exchange en tant que déploiement autonome. | sudo python3 ./ce_healthcheck --mode install --deployment SA --target-version 7.0.0 |
| Vérifiez un hôte avant de l’installer en tant que nœud d’un cluster de haute disponibilité (HA). | sudo python3 ./ce_healthcheck --mode install --deployment HA --target-version 7.0.0 |
| Vérifiez un déploiement existant avant de le mettre à niveau. | sudo python3 ./ce_healthcheck --mode upgrade --target-version 7.0.0 |
| Vérifiez la New machine avant d'y migrer. | sudo python3 ./ce_healthcheck --mode migrate --target-version 7.0.0 |
| Vérifiez un hôte existant par rapport à la version qui y est installée. | sudo python3 ./ce_healthcheck --target-version <installed_version> |
| Consultez les versions de Cloud Exchange couvertes par le contrôle. | ./ce_healthcheck --list-versions |
| Enregistrez un rapport HTML partageable et le rapport JSON à l’emplacement de votre choix. | sudo python3 ./ce_healthcheck --html ./ce_healthcheck_report.html --report ./ce_healthcheck_report.json |
| Exécutez la vérification à partir d’un script et lisez le rapport complet au format JSON. | sudo python3 ./ce_healthcheck --json --quiet |
| Exécutez la vérification sur un hôte qui accède à Internet par le biais d’un proxy. | sudo HTTPS_PROXY=http://<proxy_host>:<proxy_port> python3 ./ce_healthcheck |
Quand effectuer la vérification de mise à niveau/migration
- Avant d’installer, de mettre à niveau ou de migrer un déploiement, et de nouveau après avoir traité tout élément signalé.
- Après une modification apportée à l'hôte, telle que le redimensionnement de la machine, l'ajout d'un disque ou une modification des règles de pare-feu ou de proxy.
- Avant d’ouvrir une demande de support concernant une installation ou une mise à niveau ayant échoué, afin que le support Netskope puisse voir l’état de l’hôte.
Comprendre les résultats
Chaque contrôle rapporte l'un des cinq résultats.
| Result | Meaning | Que faire |
|---|---|---|
| Pass | L’hôte satisfait à cette exigence. | Aucune action n'est requise. |
| Avertissement | L’exigence est remplie, mais certains éléments nécessitent votre attention. Par exemple, une valeur est inférieure au niveau recommandé plutôt qu’inférieure au minimum requis, ou un port requis est déjà utilisé par le service Cloud Exchange qui est censé l’utiliser. | Examinez l'élément et la mesure corrective présentée avec celui-ci. Un avertissement ne bloque pas une mise à niveau. |
| Failed | L'hôte ne remplit pas une exigence obligatoire. L'installation ou la mise à niveau risque d'échouer ou de laisser le déploiement dans un mauvais état. | Corrigez l'élément en utilisant la mesure corrective présentée avec celui-ci, puis exécutez à nouveau la vérification. |
| Sans objet | La vérification ne s'applique pas à cet hôte, comme les vérifications de cluster HA sur un déploiement autonome, ou les vérifications Podman sur un hôte qui exécute Docker. | Aucune action n'est requise. |
| Non vérifié | La vérification n'a pas pu être effectuée sur cet hôte, de sorte que l'exigence n'est ni confirmée ni exclue. Par exemple, une version n'a pas pu être lue ou une commande n'a pas pu être exécutée. | Passez en revue le motif indiqué avec l’élément. Traitez-le comme non confirmé, et non comme réussi. |
La vérification se termine par un compte de chaque résultat, suivi d’un verdict global.
| Verdict | Meaning |
|---|---|
| Cet hôte remplit les prérequis de la version de Cloud Exchange. | Toutes les vérifications applicables ont été réussies. Vous pouvez continuer. |
| Cet hôte remplit les conditions préalables obligatoires pour la version de Cloud Exchange. Examinez les avertissements ci-dessus avant de continuer. | Rien d'obligatoire n'a échoué, mais certains éléments nécessitent votre attention. |
| Verified n of total checks for Cloud Exchange version; n could not be verified. No mandatory prerequisite failed. Review the items above before proceeding. | Rien de obligatoire n'a échoué, mais une partie de l'hôte n'a pas été évaluée. Examinez les éléments non vérifiés avant de continuer. |
| Une ou plusieurs vérifications des prérequis ont échoué. Veuillez vous assurer que les exigences système minimales sont respectées pour poursuivre. | Ne continuez pas. Traitez chaque élément ayant échoué et exécutez à nouveau la vérification. |
| Aucune des vérifications prérequises pour la version de Cloud Exchange n’a pu être validée sur cet hôte. Il ne s’agit pas d’une réussite. | Rien n’a été réellement évalué. Relancez la vérification après avoir mis en place les conditions nécessaires à sa réalisation. |
La vérification se termine par le code 0 lorsqu’aucune vérification n’a échoué, et par le code 1 lorsqu’au moins une vérification a échoué. Elle se termine par le code 2 lorsqu’elle ne peut pas s’exécuter.
Lorsque vous exécutez la vérification à partir de l'interface utilisateur sur un déploiement HA, les nœuds qui n'ont pas pu être atteints sont indiqués séparément et ne sont pas inclus dans les totaux.
Rapports
- JSON report: Un enregistrement détaillé de l’exécution, comprenant les valeurs mesurées collectées à partir de l’hôte. La vérification l’enregistre sous
ce_healthcheck_report.jsondans le dossier actuel après chaque exécution. Utilisez l’option--reportpour l’enregistrer à un autre emplacement. Joignez ce rapport à un dossier d’assistance. - HTML report: Un résumé lisible de l'exécution qui s'ouvre dans n'importe quel navigateur, répertoriant chaque vérification, son résultat et sa mesure corrective. La vérification ne l'enregistre que lorsque vous utilisez l'option
--html. Utilisez ce rapport pour partager les résultats avec votre équipe.
Les deux rapports incluent des détails sur l’hôte, et seul l’utilisateur root peut les lire. Utilisez sudo pour ouvrir ou copier un rapport. Stockez et partagez les rapports avec le même soin que n’importe quel autre enregistrement système.
Si la vérification ne peut pas être exécutée
| Message | Que faire |
|---|---|
| Cette vérification doit être exécutée en tant que root, de la même manière que l’installation. | Exécutez à nouveau la vérification avec sudo. |
| Impossible de télécharger les définitions de vérification de la mise à niveau/migration à partir de url. | L’hôte n’a pas accès à Internet en sortie, ou un proxy ou un pare-feu le bloque. Autorisez l’accès à raw.githubusercontent.com/netskopeoss/ta_cloud_exchange, puis exécutez à nouveau la vérification. |
| La version version de Cloud Exchange n’existe pas dans ces définitions de vérification, donc cet hôte n’a pas été validé. | Select une version couverte. Exécutez ./ce_healthcheck --list-versions pour voir les versions disponibles. |
| Impossible de lire les définitions de vérification de mise à niveau/migration à partir de path. | Assurez-vous que le chemin que vous avez donné à --manifest-path existe et que vous pouvez lire le fichier. |