PowerStore: Hostvalidatiescript voor ESXi
Summary: Een juiste configuratie van de hosts is essentieel voor optimale PowerStore-activiteiten. In dit artikel wordt het script voor het hostvalidatiescript beschreven dat valideert dat de ESXi-host is geconfigureerd volgens de best practices. ...
Instructions
Overzicht
De specificaties voor de best practices voor hosts vindt u in de E-Lab Host Connectivity Guides. De VMware ESXi Server Guide specificeert de aanbevolen waarden voor hostconfiguratieparameters met hun impact (stabiliteit, prestaties, ruimte-efficiëntie) en prioriteit (verplicht, waarschuwing of aanbevolen). Dit hostvalidatiescript valideert de host op conformiteit met deze best practices.
Het validatiescript maakt gebruik van PowerCLI versies 6.5 en hoger, een VMware-shell voor Windows. Het script wordt uitgevoerd op het VMware vCenter en valideert de configuratie voor alle of enkele hosts. Het vereist VMware vCenter-referenties en gebruikt de referenties van de host niet.
Gebruiksscenario's.
Het hostvalidatiescript wordt aanbevolen te gebruiken in de volgende gevallen:
- Voorafgaand aan software-update (NDU)
- Validatie van een nieuwe host
- Probleemoplossing
- Periodieke healthcheck
Procedurele opmerkingen
Uitvoering:
Deze procedure wordt uitgevoerd met PowerCLI die wordt uitgevoerd op Windows met behulp van het VMware vCenter. De console moet worden uitgevoerd als administrator. De vCenter-referenties moeten voor administratorbevoegdheden zijn.
Cluster- of hostimpact:
Het script leest de huidige configuratie voor. Het script wijzigt het cluster of de host niet.
Overwegingen voor niet-verstorende upgrades (NDU): Deze procedure introduceert geen wijzigingen in het cluster of de host.
Uitvoeringsduur:
Het script voor deze taak duurt ongeveer één (1) minuut per ESXi-host om te voltooien.
Het ESXi hostvalidatiescript uitvoeren vanuit de PowerCLI
- Download uit dit artikel de
ESX_Configuration_Validationscript.Pakketnaam PowerStore_ESXi_Configuration_Validation_1.0.19.0_pkb.zip
De bestandsnaam die in de bijlage wordt weergegeven, kan een ander achtervoegsel hebben.Scriptnaam check_esx_config.ps1Versie 1.0.19.0 MD5-checksum 64c97ce4218c97f03b718e68aa88c120SHA256-checksum 7d065192bc1715dd8c134e99158bfabeb74f8b733c7226c8f781a9fe39a26828
Opmerking: Zie voor de verificatie van de handtekening van het pakket de optionele stap 'De handtekening van het pakket verifiëren'.
- Download de VMware PowerCLI, versie 6.5 of hoger. Deze is mogelijk al op uw pc geïnstalleerd. Download het bestand zoals beschreven in het gedeelte Downloads hieronder als het nog niet is geïnstalleerd.
- Open een PowerCLI-console als beheerder. Een methode om dit uit te voeren is door de PowerCLI te openen vanuit het menu Start met behulp van de optie Als administrator uitvoeren. PowerCLI kan ook worden uitgevoerd vanuit een PowerShell-console.
- Stel de
ExecutionPolicydoor de volgende opdracht uit te voeren:
> Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
- Stel de PowerCLI-configuratie in om een ongeldig certificaat te negeren (PowerCLI 10.x en hoger).
> Set-PowerCLIConfiguration -InvalidCertificateAction Ignore
- Roep de
check_esx_configbevelen:
> cd ESX > .\check_esx_config.ps1 [parameters]
Ondersteunde parameters:
| Parameter | Commentaar | Verplicht (behalve bij gebruik van -version or -help opties) |
|---|---|---|
-vcenter_server |
Servernaam of IP-adres vCenter | Ja |
-vcenter_user |
vCenter-gebruikersnaam | Ja |
-vcenter_password |
vCenter-wachtwoord | Ja |
-esx_host |
Door komma's gescheiden lijst met ESXi-hostnamen/IP-adressen of 'alle' Als |
Ja |
-logpath |
Volledig pad van logboekmap. Als Als de gebruiker een niet-bestaande map heeft opgegeven, vraagt het script om bevestiging om deze te maken. |
Nee |
-batch |
Als er geen parameter is opgegeven, vraagt het script niet om invoer. | Nee |
-version |
Druk de scriptversie af en sluit de script af. | Nee |
-help |
Druk de Help-pagina af en sluit de Help-pagina af. | Nee |
Uitvoer van het ESXi hostvalidatiescript
Het script drukt de uitvoer af naar de PowerCLI-console en logboekbestanden. Een uitvoermap met de naam <vCenter_Server>_<date>_<time> wordt gemaakt in de map Logs.
Voor elke configuratievalidatie geeft de uitvoer aan of de validatie correct is of, zo niet, de ernst van de onjuiste configuratie. Een voorvoegsel in het bericht komt overeen met de ernst van het item: PROBLEEM, WAARSCHUWING of KENNISGEVING, de validatietekst en de verwachte waarde
Alle berichten voor acties die door het script worden uitgevoerd, worden weergegeven in de console. In het laatste gedeelte van de console-uitvoer worden alle gevonden problemen samengevat op ernst en categorie. Bovendien wordt out opgeslagen in logbestanden. De logbestanden zijn ingedeeld in secties en worden aanbevolen om te worden gebruikt voor inzicht in de resultaten van het script.
De volgende bestanden bevinden zich in de uitvoermap:
all.log- Bevat alle uitvoer (hetzelfde als wat op de console is afgedrukt).error.log- Bevat alleen foutmeldingen of waarschuwingen en vermoedelijke fouten.Dell_EMC_EULA.txt- De LICENTIEOVEREENKOMST VOOR SOFTWARETOOLS VAN DELL
Voorbeeld van het error.log uitvoerbestand:
*************************************************************************************************** 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]. ***************************************************************************************************
De handtekening van het pakket verifiëren
- Download de volgende twee bestanden:
- Handtekening
| Bestand |
|
|---|---|
| Grootte | 659 bytes |
| MD5 | 16acecc8b0fba8ec255b63ccc2403ed8 |
| SHA256 zei: | 903d826db7c0af897fd3300069c0271d14c3467df7f55fff211bbbc7c44b1041 |
- Openbare sleutel
| Bestand |
|
|---|---|
| Grootte | 1306 bytes |
| MD5 | fe97eba75623bd1d5ff307f1fbb1a5ae |
| SHA256 zei: | de141fc22a35deaa0753006b80a87c54d8b4e8ca47f434be3c61807a4d0b6d1d |
- Verplaats deze bestanden naar uw dev VM (bij voorkeur Linux, omdat in dit voorbeeld wordt gebruikt
gpgdie op de meeste Linux-systemen vooraf is geïnstalleerd): - Importeer de sleutel met behulp van
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
- Controleer het ondertekende pakket met behulp van
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
- De sleutel certificeren als 'vertrouwd' (een optionele stap)
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]
Bekende problemen
- Het HVS-script waarschuwt ten onrechte voor de parameters Reclaim. De juiste waarden voor Reclaim-parameters zijn:
- Reclaim Priority gebruiken Laag
- Prioriteit voor het gebruik van de methode terugvorderen
[~] 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
Downloads:
of - Het validatiescript is als bijlage bij dit artikel gevoegd. Selecteer bij Dell Support Bijlagen in het linkerzijpaneel van dit artikel.
Revisiegeschiedenis:
- 1.0.15:
- Eerste release
- 1.0.18
- Gecertificeerd voor PowerCLI 12.5
- Datastores, toegewezen via NVMe, worden nu correct afgehandeld.
- Disclaimer bijgewerkt om uit te leggen dat multipathing het HPP NVMe-padbeleid niet evalueert.
- De systeemmodule controleert op FC HBA's en evalueert de aanbevolen NVMe-instelling: vmknvme_hostnqn_format=0
- De locatie van het logbestand is verplaatst naar het einde van de uitvoer.
- iSCSI VMkernel geëvalueerd voor het aanbevolen iSCSI no-op interval van 5 seconden
- Verzameling overbodige modules verwijderd
- De output omvat positieve feedback voor succesvolle tests die ontbraken.
- Opgelost: probleem met validatie van config.vpxd.ResourceManager.maxCostPerHost
- Opgelost: probleem met de standaard NMP Round Robin-padswitchfrequentie PSP-opties:
policy=iops;iops=1.
- 1.0.19
- Verwijzingen naar de Dell hostconfiguratiehandleiding zijn gewijzigd in de E-Lab connectiviteitsgids. Relevante validaties en disclaimers zijn ook bijgewerkt.
- Ondersteunde ESXi-versies zijn bijgewerkt.