PowerStore : script de validation de l’hôte pour ESXi

Présentation

Les spécifications relatives aux pratiques d’excellence relatives à l’hôte sont disponibles dans les guides de connectivité de l’hôte E-Lab. Le Guide de VMware ESXi Server spécifie les valeurs recommandées pour les paramètres de configuration hôte avec leur impact (stabilité, performances, efficacité du stockage) et leur gravité (obligatoire, avertissement ou recommandé). Ce script de validation de l’hôte valide la conformité de l’hôte à ces pratiques d’excellence.
 

Le script de validation utilise PowerCLI, versions 6.5 et ultérieures, qui est un shell VMware pour Windows. Le script s’exécute sur VMware vCenter en validant la configuration pour tout ou partie des hôtes. Il nécessite les informations d’identification de VMware vCenter et n’utilise pas les informations d’identification de l’hôte.

Cas d’utilisation.

Il est recommandé d’utiliser le script de validation de l’hôte dans les cas suivants :

1. Avant la mise à jour logicielle (NDU)
2. Validation d’un nouvel hôte
3. Dépannage
4. Contrôle du bilan de santé

Remarques sur les procédures

Exécution:
Cette procédure est exécutée à l’aide de PowerCLI exécuté sur Windows à l’aide de VMware vCenter. La console doit être exécutée en tant qu’administrateur. Les informations d’identification vCenter doivent correspondre à des privilèges d’administration.

Impact sur le cluster ou l’hôte :
le script lit la configuration actuelle. Le script ne modifie pas le cluster ou l’hôte.
Considérations relatives à la mise à niveau sans perturbation (NDU) : Cette procédure n’introduit aucune modification dans le cluster ou l’hôte.

Durée d’exécution :
Le script de cette tâche prend environ une (1) minute par hôte ESXi.

Exécution du script de validation de l’hôte ESXi à partir de PowerCLI

1. Téléchargez à partir de cet article le ESX_Configuration_Validation script. 

   Nom du package	PowerStore_ESXi_Configuration_Validation_1.0.19.0_pkb.zip  Le nom de fichier figurant dans la pièce jointe peut avoir un suffixe différent.
   Nom du script	check_esx_config.ps1
   Version	1.0.19.0
   MD5 Checksum	64c97ce4218c97f03b718e68aa88c120
   SHA256 Somme de contrôle	7d065192bc1715dd8c134e99158bfabeb74f8b733c7226c8f781a9fe39a26828

2. Téléchargez VMware PowerCLI, version 6.5 ou ultérieure. Il est peut-être déjà installé sur votre ordinateur personnel. S’il n’est pas déjà installé, téléchargez-le comme décrit dans la section Téléchargements ci-dessous.
3. Ouvrez une console PowerCLI en tant qu’administrateur. Pour ce faire, ouvrez PowerCLI à partir du menu Démarrer à l’aide de l’option Exécuter en tant qu’administrateur. Vous pouvez également exécuter PowerCLI à partir d’une console PowerShell.

4. Définissez l’option ExecutionPolicy en exécutant la commande suivante :

> Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

5. Définissez la configuration PowerCLI pour ignorer un certificat non valide (PowerCLI 10.x et versions ultérieures).

> Set-PowerCLIConfiguration -InvalidCertificateAction Ignore 

6. Invoquez l’attribut check_esx_config WMIC suivante :

> cd ESX
> .\check_esx_config.ps1 [parameters]

Paramètres pris en charge :

Sortie du script de validation de l’hôte ESXi

Le script imprime sa sortie dans la console PowerCLI et les fichiers journaux. Un répertoire de sortie nommé <vCenter_Server>_<date>_<time> est créé dans le répertoire Logs.

Pour chaque validation de configuration, le résultat indique si la validation est correcte ou, dans le cas contraire, la gravité de la configuration incorrecte. Un préfixe dans le message correspond à la gravité de l’élément : PROBLEM, WARNING ou NOTICE, le texte de validation et la valeur

attendue Tous les messages pour les actions effectuées par le script s’affichent dans la console. Dans la dernière section de la sortie de la console, tous les problèmes détectés sont résumés par gravité et par catégorie. En outre, les résultats sont enregistrés dans des fichiers journaux. Les fichiers journaux sont organisés par sections et recommandés pour comprendre les résultats du script.

Les fichiers suivants se trouvent dans le répertoire de sortie :

• all.log - Contient toutes les sorties (identiques à celles qui sont imprimées sur la console).
• error.log - Contient uniquement des messages d’erreur ou des avertissements et des erreurs suspectées.
• Dell_EMC_EULA.txt - Le CONTRAT DE LICENCE DELL SOFTWARE TOOLS

Exemple du fichier de sortie error.log :

***************************************************************************************************
Started processing at [22/07/2024 19:31:52] India Standard Time.
***************************************************************************************************
 
Running script version [1.0.19.0].
 
***************************************************************************************************
 
#########   START VALIDATIONS FOR ESX abc.abc.abc.com   ###########
NOTICE:# 0 PowerStore datastores were found
NOTICE:# Checking VM disks provisioning
NOTICE:# Checking VM SCSI controllers type
#########   FINISHED VALIDATIONS FOR ESX abc.abc.abc.com   ###########
 
 
#########################################################
########### Overview section for host abc.abc.abc.com ############
#########################################################
Warning issues for Configuration setting occurs 2 times
#########################################################
############ Detail section for host abc.abc.abc.com #############
#########################################################
WARNING:# NVMe Qualified Name format is not set. It must be set to 0.
WARNING:# Disk.DiskMaxIOSize is set to 32767 rather than the recommended value of 1024.
 
 
***************************************************************************************************
Problems found: 0 issues (0 instances)
Warnings found: 1 issues (2 instances)
Notices found: 0 issues (0 instances)
***************************************************************************************************
Finished processing at [22/07/2024 19:35:15].
***************************************************************************************************

Comment vérifier la signature du colis

• Téléchargez les deux fichiers suivants :

1. Signature

2. Clé publique 

• Déplacez ces fichiers vers votre machine virtuelle de développement (de préférence Linux, car dans cet exemple, il s’agit d’utiliser gpg qui est préinstallé dans la plupart des systèmes Linux) :
• Importez la clé à l’aide de gpg gpg --import gpg_public_key.txt

Expected output gpg: key B16F06CB37196B9C: public key "Dell Technologies Inc. support@dell.com" imported

gpg: Total number processed: 1

gpg:               imported: 1

• Vérifiez le package signé à l’aide de la commande suivante : gpg gpg --verify PowerStore_ESXi_Configuration_Validation_1.0.19.0.zip.asc.signed PowerStore_ESXi_Configuration_Validation_1.0.19.0.zip

Expected output gpg: Signature made Thu 04 Jul 2024 07:06:24 AM EDT
 
gpg:                using RSA key EC31223156602232B2EBE7B0B16F06CB37196B9C
 
gpg: Good signature from "Dell Technologies Inc. support@dell.com" [unknown]
 
gpg: WARNING: This key is not certified with a trusted signature!
 
gpg:          There is no indication that the signature belongs to the owner.
 
Primary key fingerprint: EC31 2231 5660 2232 B2EB  E7B0 B16F 06CB 3719 6B9C

• Pour certifier la clé comme étant « approuvée » (étape facultative) : gpg --edit-key EC31223156602232B2EBE7B0B16F06CB37196B9C

Enter “trust” when gpg prompts, then enter “5” (trust ultimately), then “y” to confirm. Finally, enter “q” to quit the gpg prompt.
 
Expected output à gpg (GnuPG) 2.2.20; Copyright (C) 2020 Free Software Foundation, Inc.
 
This is free software: you are free to change and redistribute it.
 
There is NO WARRANTY, to the extent permitted by law.
 
pub  rsa3072/B16F06CB37196B9C
 
     created: 2024-04-29  expires: 2027-04-29  usage: SCE
 
     trust: unknown       validity: unknown
 
[ unknown] (1). Dell Technologies Inc. support@dell.com
 
 
gpg> trust
 
pub  rsa3072/B16F06CB37196B9C
 
     created: 2024-04-29  expires: 2027-04-29  usage: SCE
 
     trust: unknown       validity: unknown
 
[ unknown] (1). Dell Technologies Inc. support@dell.com
 
 
Please decide how far you trust this user to correctly verify other users' keys
 
(by looking at passports, checking fingerprints from different sources, etc.)
 
 
  1 = I don't know or won't say
 
  2 = I do NOT trust
 
  3 = I trust marginally
 
  4 = I trust fully
 
  5 = I trust ultimately
 
  m = back to the main menu
 
 
Your decision? 5
 
Do you really want to set this key to ultimate trust? (y/N) y
 
 
pub  rsa3072/B16F06CB37196B9C
 
     created: 2024-04-29  expires: 2027-04-29  usage: SCE
 
     trust: ultimate      validity: unknown
 
[ unknown] (1). Dell Technologies Inc. support@dell.com
 
The shown key validity is not necessarily correct
 
unless you restart the program.
 
 
gpg> q
 
  
Rerun the gpg verification now gpg --verify PowerStore_ESXi_Configuration_Validation_1.0.19.0.zip.asc.signed PowerStore_ESXi_Configuration_Validation_1.0.19.0.zip
 
Expected output gpg: Signature made Thu 04 Jul 2024 07:06:24 AM EDT
 
gpg:                using RSA key EC31223156602232B2EBE7B0B16F06CB37196B9C
 
gpg: checking the trustdb
 
gpg: marginals needed: 3  completes needed: 1  trust model: pgp
 
gpg: depth: 0  valid:   1  signed:   0  trust: 0-, 0q, 0n, 0m, 0f, 1u
 
gpg: next trustdb check due at 2027-04-29
 
gpg: Good signature from "Dell Technologies Inc. support@dell.com" [ultimate]

Incidents recensés

1. Le script HVS avertit par erreur les paramètres de récupération. Les valeurs correctes pour les paramètres Reclaim sont les suivantes :

• Pour Récupération de la priorité, utilisez Faible
• Pour Récupération de la méthode, utilisez Priorité

[~] esxcli storage vmfs reclaim config get --volume-label VMFS1
 Reclaim Granularity: 1048576 Bytes
 Reclaim Priority: low      <<<<<<<<<<<< priority Low
 Reclaim Method: priority   <<<<<<<<<<<< use priority and not fixed
 Reclaim Bandwidth: 26 MB/s 

Téléchargements :

• PowerCLI 6.5 ou PowerCLI 12.5

• Le script de validation est joint à cet article. Dans le support technique Dell, sélectionnez Pièces jointes dans le panneau latéral gauche de cet article.

Historique des révisions :

• 1.0.15 :
  • Version initiale
• 1.0.18
  • Certifié pour PowerCLI 12.5
  • Les datastores, mappés via NVMe, sont désormais gérés correctement.
  • Mise à jour de la clause de non-responsabilité pour expliquer que le multipathing n’évalue pas les stratégies de chemins HPP NVMe. 
  • Le module système vérifie si les adaptateurs HBA FC évaluent le paramètre NVMe recommandé : vmknvme_hostnqn_format=0
  • L’emplacement du fichier journal a été déplacé à la fin de la sortie. 
  • VMkernel iSCSI évalué pour l’intervalle no-op iSCSI recommandé de 5 secondes
  • Collecte de modules superflue retirée
  • La sortie inclut des commentaires positifs pour les tests réussis qui étaient manquants.
  • Problème résolu pour la validation de config.vpxd.ResourceManager.maxCostPerHost
  • Problème résolu pour la validation de la fréquence de commutation de chemin de permutation circulaire NMP par défaut Options PSP : policy=iops;iops=1.
• 1.0.19
  • Les références au Guide de configuration hôte Dell ont été remplacées par le Guide de connectivité E-Lab. Les validations et les clauses de non-responsabilité pertinentes ont également été mises à jour. 
  • Les versions ESXi prises en charge ont été mises à jour.