Skip to main content
Une version plus récente de ce produit est disponible.
La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

Exécutez des vérifications de l'état du stockage Element avant la mise à niveau du stockage

Contributeurs
PDF

Vous devez exécuter des vérifications de l'état avant de mettre à niveau le stockage Element pour garantir que tous les nœuds de stockage du cluster sont prêts pour la prochaine mise à niveau du stockage Element.

Ce dont vous avez besoin

  • Services de gestion: Vous avez mis à jour le dernier bundle de services de gestion (2.10.27 ou version ultérieure).

    Important Vous devez effectuer la mise à niveau vers le dernier pack de services de gestion avant de mettre à niveau votre logiciel Element.

  • Noeud de gestion : vous exécutez le noeud de gestion 11.3 ou ultérieur.

  • Logiciel Element : votre version de cluster exécute le logiciel NetApp Element version 11.3 ou ultérieure.

  • Contrat de licence utilisateur final (CLUF) : à partir des services de gestion 2.20.69, vous devez accepter et enregistrer le CLUF avant d'utiliser l'interface utilisateur ou l'API de NetApp Hybrid Cloud Control pour exécuter les contrôles d'état du stockage d'Element :

    1. Ouvrez l'adresse IP du nœud de gestion dans un navigateur Web :

      https://<ManagementNodeIP>

    2. Connectez-vous au contrôle de cloud hybride NetApp en fournissant les identifiants de l'administrateur du cluster de stockage.

    3. Sélectionnez Upgrade en haut à droite de l'interface.

    4. Le CLUF s'affiche. Faites défiler vers le bas, sélectionnez J'accepte les mises à jour actuelles et futures, puis sélectionnez Enregistrer.

Options de vérification de l'état

Vous pouvez exécuter des vérifications de l'état à l'aide de l'interface utilisateur NetApp Hybrid Cloud Control (HCC), de l'API HCC ou de la suite HealthTools :

Vous pouvez également en savoir plus sur les vérifications de l'état du stockage exécutées par ce service :

Avec NetApp Hybrid Cloud Control, exécutez des vérifications de l'état du stockage Element avant la mise à niveau du stockage

Avec NetApp Hybrid Cloud Control (HCC), vous pouvez vérifier qu'un cluster de stockage est prêt à être mis à niveau.

Étapes

  1. Ouvrez l'adresse IP du nœud de gestion dans un navigateur Web :

    https://<ManagementNodeIP>

  2. Connectez-vous au contrôle de cloud hybride NetApp en fournissant les identifiants de l'administrateur du cluster de stockage.

  3. Sélectionnez Upgrade en haut à droite de l'interface.

  4. Sur la page mises à niveau, sélectionnez l'onglet stockage.

  5. Sélectionnez le bilan de santé icônedu cluster que vous souhaitez vérifier si la mise à niveau est prête.

  6. Sur la page Storage Health Check, sélectionnez Run Health Check.

  7. En cas de problème, procédez comme suit :

    1. Consultez l'article de la base de connaissances spécifique répertorié pour chaque problème ou effectuez la solution spécifiée.

    2. Si vous spécifiez une base de connaissances, suivez la procédure décrite dans l'article correspondant de la base de connaissances.

    3. Après avoir résolu les problèmes de cluster, sélectionnez Re-Run Health Check.

Une fois la vérification de l'état de santé terminée sans erreur, le cluster de stockage est prêt à être mis à niveau. Reportez-vous à la section mise à niveau du nœud de stockage "instructions"pour continuer.

Exécutez des vérifications de l'état du stockage Element avant la mise à niveau du stockage

Vous pouvez utiliser l'API REST pour vérifier qu'un cluster de stockage est prêt à être mis à niveau. Le contrôle de l'état vérifie qu'il n'existe aucun obstacle à la mise à niveau, par exemple les nœuds en attente, les problèmes d'espace disque et les défaillances de cluster.

Étapes

  1. Recherchez l'ID de cluster de stockage :

    1. Ouvrez l'interface de l'API REST du nœud de gestion sur le nœud de gestion :

      https://<ManagementNodeIP>/mnode

    2. Sélectionnez Authorise et procédez comme suit :

      1. Saisissez le nom d'utilisateur et le mot de passe du cluster.

      2. Entrez l'ID client comme mnode-client si la valeur n'était pas déjà renseignée.

      3. Sélectionnez Autoriser pour démarrer une session.

      4. Fermez la fenêtre d'autorisation.

    3. Dans l'interface utilisateur de l'API REST, sélectionnez GET /assets.

    4. Sélectionnez essayez-le.

    5. Sélectionnez Exécuter.

    6. Depuis la réponse, copiez le "id" de la section du "storage" cluster que vous avez l'intention de vérifier que la mise à niveau est prête.

      Remarque N'utilisez pas la "parent" valeur de cette section, car il s'agit de l'ID du nœud de gestion et non de l'ID du cluster de stockage. 
    "config": {},
"credentialid": "12bbb2b2-f1be-123b-1234-12c3d4bc123e",
"host_name": "SF_DEMO",
"id": "12cc3a45-e6e7-8d91-a2bb-0bdb3456b789",
"ip": "10.123.12.12",
"parent": "d123ec42-456e-8912-ad3e-4bd56f4a789a",
"sshcredentialid": null,
"ssl_certificate": null

  2. Exécutez des vérifications d'état sur le cluster de stockage :

    1. Ouvrez l'interface de l'API REST de stockage sur le nœud de gestion :

      https://<ManagementNodeIP>/storage/1/

    2. Sélectionnez Authorise et procédez comme suit :

      1. Saisissez le nom d'utilisateur et le mot de passe du cluster.

      2. Entrez l'ID client comme mnode-client si la valeur n'était pas déjà renseignée.

      3. Sélectionnez Autoriser pour démarrer une session.

      4. Fermez la fenêtre d'autorisation.

    3. Sélectionnez POST /Health-chèques.

    4. Sélectionnez essayez-le.

    5. Dans le champ paramètre, entrez l'ID de cluster de stockage obtenu à l'étape 1.

      {
  "config": {},
  "storageId": "123a45b6-1a2b-12a3-1234-1a2b34c567d8"
}

    6. Sélectionnez Exécuter pour exécuter un contrôle d'intégrité sur le cluster de stockage spécifié.

      La réponse doit indiquer l'état initializing :

    {
  "_links": {
    "collection": "https://10.117.149.231/storage/1/health-checks",
    "log": "https://10.117.149.231/storage/1/health-checks/358f073f-896e-4751-ab7b-ccbb5f61f9fc/log",
    "self": "https://10.117.149.231/storage/1/health-checks/358f073f-896e-4751-ab7b-ccbb5f61f9fc"
  },
  "config": {},
  "dateCompleted": null,
  "dateCreated": "2020-02-21T22:11:15.476937+00:00",
  "healthCheckId": "358f073f-896e-4751-ab7b-ccbb5f61f9fc",
  "state": "initializing",
  "status": null,
  "storageId": "c6d124b2-396a-4417-8a47-df10d647f4ab",
  "taskId": "73f4df64-bda5-42c1-9074-b4e7843dbb77"
}

    1. Copiez le healthCheckID qui fait partie de la réponse.

  3. Vérifier les résultats des vérifications d'intégrité :

    1. Sélectionnez GET ​/Health-checks​/{healHealthCheckId}.

    2. Sélectionnez essayez-le.

    3. Entrez l'ID du contrôle de l'état dans le champ paramètre.

    4. Sélectionnez Exécuter.

    5. Faites défiler jusqu'au bas du corps de réponse.

      Si toutes les vérifications de l'état réussissent, le retour est similaire à l'exemple suivant :

    "message": "All checks completed successfully.",
"percent": 100,
"timestamp": "2020-03-06T00:03:16.321621Z"

  4. Si le message retour indique qu'il y a eu des problèmes concernant l'intégrité du cluster, effectuez les opérations suivantes :

    1. Sélectionnez GET ​/Health-checks​/{healHealthCheckId}/log

    2. Sélectionnez essayez-le.

    3. Entrez l'ID du contrôle de l'état dans le champ paramètre.

    4. Sélectionnez Exécuter.

    5. Examinez toutes les erreurs spécifiques et obtenez les liens associés à l'article de la base de connaissances.

    6. Consultez l'article de la base de connaissances spécifique répertorié pour chaque problème ou effectuez la solution spécifiée.

    7. Si vous spécifiez une base de connaissances, suivez la procédure décrite dans l'article correspondant de la base de connaissances.

    8. Après avoir résolu les problèmes de cluster, exécutez à nouveau GET ​/Health-checks​/{healCheckId}/log.

Utilisez HealthTools pour exécuter les vérifications de l'état du stockage Element avant la mise à niveau du stockage

Vous pouvez vérifier que le cluster de stockage est prêt à être mis à niveau à l'aide de la sfupgradecheck commande. Cette commande vérifie des informations, telles que les nœuds en attente, l'espace disque et les défaillances de cluster.

Si votre nœud de gestion se trouve sur un site invisible, le contrôle du niveau de préparation de la mise à niveau nécessite le metadata.json fichier téléchargé pendant l'"Mises à niveau de HealthTools"exécution.

Description de la tâche

Cette procédure explique comment gérer les contrôles de mise à niveau qui produisent l'un des résultats suivants :

  • L'exécution de la sfupgradecheck commande a réussi. Votre cluster est prêt à être mis à niveau.

  • Les vérifications dans sfupgradecheck l'outil échouent avec un message d'erreur. Votre cluster n'est pas prêt pour la mise à niveau et des étapes supplémentaires sont requises.

  • Votre contrôle de mise à niveau échoue et un message d'erreur indique que HealthTools est obsolète.

  • La vérification de la mise à niveau échoue car votre nœud de gestion se trouve sur un site sombre.

Étapes

  1. Lancer sfupgradecheck la commande :

    sfupgradecheck -u <cluster-user-name> MVIP
    Remarque Pour les mots de passe contenant des caractères spéciaux, ajoutez une barre oblique inverse (\) avant chaque caractère spécial. Par exemple, mypass!@1 doit être saisi comme mypass\!\@.

    Exemple de commande d'entrée avec une sortie d'exemple dans laquelle aucune erreur n'apparaît et que vous êtes prêt à être mis à niveau :

    sfupgradecheck -u admin 10.117.78.244
    check_pending_nodes:
Test Description: Verify no pending nodes in cluster
More information: https://kb.netapp.com/support/s/article/ka11A0000008ltOQAQ/pendingnodes
check_cluster_faults:
Test Description: Report any cluster faults
check_root_disk_space:
Test Description: Verify node root directory has at least 12 GBs of available disk space
Passed node IDs: 1, 2, 3
More information: https://kb.netapp.com/support/s/article/ka11A0000008ltTQAQ/
SolidFire-Disk-space-error
check_mnode_connectivity:
Test Description: Verify storage nodes can communicate with management node
Passed node IDs: 1, 2, 3
More information: https://kb.netapp.com/support/s/article/ka11A0000008ltYQAQ/mNodeconnectivity
check_files:
Test Description: Verify options file exists
Passed node IDs: 1, 2, 3
check_cores:
Test Description: Verify no core or dump files exists
Passed node IDs: 1, 2, 3
check_upload_speed:
Test Description: Measure the upload speed between the storage node and the
management node
Node ID: 1 Upload speed: 90063.90 KBs/sec
Node ID: 3 Upload speed: 106511.44 KBs/sec
Node ID: 2 Upload speed: 85038.75 KBs/sec

  2. En cas d'erreurs, des actions supplémentaires sont nécessaires. Voir les sous-sections suivantes pour plus de détails.

Votre cluster n'est pas prêt pour la mise à niveau

Si un message d'erreur associé à l'une des vérifications de l'état s'affiche, effectuez la procédure suivante :

  1. Consultez le sfupgradecheck message d'erreur.

    Exemple de réponse :

The following tests failed:
check_root_disk_space:
Test Description: Verify node root directory has at least 12 GBs of available disk space
Severity: ERROR
Failed node IDs: 2
Remedy: Remove unneeded files from root drive
More information: https://kb.netapp.com/support/s/article/ka11A0000008ltTQAQ/SolidFire-
Disk-space-error
check_pending_nodes:
Test Description: Verify no pending nodes in cluster
More information: https://kb.netapp.com/support/s/article/ka11A0000008ltOQAQ/pendingnodes
check_cluster_faults:
Test Description: Report any cluster faults
check_root_disk_space:
Test Description: Verify node root directory has at least 12 GBs of available disk space
Passed node IDs: 1, 3
More information: https://kb.netapp.com/support/s/article/ka11A0000008ltTQAQ/SolidFire-
Disk-space-error
check_mnode_connectivity:
Test Description: Verify storage nodes can communicate with management node
Passed node IDs: 1, 2, 3
More information: https://kb.netapp.com/support/s/article/ka11A0000008ltYQAQ/mNodeconnectivity
check_files:
Test Description: Verify options file exists
Passed node IDs: 1, 2, 3
check_cores:
Test Description: Verify no core or dump files exists
Passed node IDs: 1, 2, 3
check_upload_speed:
Test Description: Measure the upload speed between the storage node and the management node
Node ID: 1 Upload speed: 86518.82 KBs/sec
Node ID: 3 Upload speed: 84112.79 KBs/sec
Node ID: 2 Upload speed: 93498.94 KBs/sec

Dans cet exemple, le nœud 1 est faible sur l'espace disque. Vous trouverez plus d'informations dans l' "base de connaissances"article (KB) répertorié dans le message d'erreur.

HealthTools est obsolète

Si un message d'erreur s'affiche indiquant que HealthTools n'est pas la dernière version, suivez ces instructions :

  1. Vérifiez le message d'erreur et notez que la vérification de la mise à niveau a échoué.

    Exemple de réponse :

    sfupgradecheck failed: HealthTools is out of date:
installed version: 2018.02.01.200
latest version: 2020.03.01.09.
The latest version of the HealthTools can be downloaded from: https://mysupport.netapp.com/NOW/cgi-bin/software/
Or rerun with the -n option

  2. Suivez les instructions décrites dans la réponse.

Votre nœud de gestion se trouve sur un site sombre

  1. Vérifiez le message et notez que la vérification de la mise à niveau échoue :

    Exemple de réponse :

    sfupgradecheck failed: Unable to verify latest available version of healthtools.

  2. Téléchargez un "Fichier JSON" depuis le site de support NetApp sur un ordinateur qui n'est pas le nœud de gestion et renommez-le metadata.json .

  3. Exécutez la commande suivante :

    sfupgradecheck -l --metadata=<path-to-metadata-json>

  4. Pour plus de détails, reportez-vous aux informations supplémentaires "Mises à niveau de HealthTools"relatives aux sites invisibles.

  5. Vérifiez que la suite HealthTools est à jour en exécutant la commande suivante :

    sfupgradecheck -u <cluster-user-name> -p <cluster-password> MVIP

Vérifications de l'état du stockage effectuées par le service

Les vérifications de l'état du stockage font les vérifications suivantes par cluster.

Vérifiez le nom Nœud/Cluster Description

vérifier_les_résultats_async

Cluster

Vérifie que le nombre de résultats asynchrones dans la base de données est inférieur à un nombre de seuils.

vérifier_les_défauts_cluster

Cluster

Vérifie qu'il n'y a pas d'erreur de blocage de mise à niveau (comme défini dans la source d'élément).

vérifier_la_vitesse_de_chargement

Nœud

Mesure la vitesse de chargement entre le nœud de stockage et le nœud de gestion.

contrôle_vitesse_connexion

Nœud

Vérifie que les nœuds sont connectés au nœud de gestion pour le service des packages de mise à niveau et estime la vitesse de connexion.

vérifier les noyaux

Nœud

Vérifie si le vidage de panne du noyau et les fichiers « core » du nœud. Le contrôle échoue pour les pannes d'une période récente (seuil de 7 jours).

check_root_disk_space

Nœud

Vérifie que le système de fichiers racine dispose de suffisamment d'espace libre pour effectuer une mise à niveau.

check_var_log_disk_space

Nœud

Vérifie que /var/log l'espace libre correspond à un certain seuil de pourcentage libre. Si ce n'est pas le cas, le contrôle tourne et purge les anciens journaux afin de tomber sous le seuil. La vérification échoue si la création d'un espace libre suffisant a échoué.

check_pending_nodes

Cluster

Vérifie qu'il n'y a aucun nœud en attente sur le cluster.

Trouvez plus d'informations