PowerStore: Skrypt weryfikacji hosta dla ESXi

Omówienie

Specyfikacje najlepszych praktyk hosta można znaleźć w przewodnikach połączenia z hostem E-Lab. Podręcznik serwera VMware ESXi określa zalecane wartości parametrów konfiguracji hosta wraz z ich wpływem (stabilność, wydajność, oszczędność miejsca) i istotnością (obowiązkowe, ostrzeżenie lub zalecane). Ten skrypt sprawdza poprawność hosta pod kątem zgodności z tymi najlepszymi praktykami.
 

Skrypt sprawdzania poprawności korzysta z PowerCLI w wersji 6.5 lub nowszej, która jest powłoką VMware dla systemu Windows. Skrypt działa na VMware vCenter, sprawdzając konfigurację dla wszystkich lub niektórych hostów. Wymaga on poświadczeń VMware vCenter i nie korzysta z poświadczeń hosta.

Przypadki użycia.

Skrypt sprawdzania poprawności hosta zaleca się stosować w następujących przypadkach:

1. Przed aktualizacją oprogramowania (NDU)
2. Weryfikacja nowego hosta
3. Rozwiązywanie problemów
4. Okresowa kontrola poprawności działania

Uwagi dotyczące procedury

Egzekucja:
Procedura ta jest wykonywana przy użyciu PowerCLI działającego w systemie Windows przy użyciu VMware vCenter. Konsola musi być uruchomiona jako administrator. Poświadczenia vCenter muszą być wymagane dla uprawnień administratora.

Wpływ na klaster lub hosta:
Skrypt odczytuje bieżącą konfigurację. Skrypt nie modyfikuje klastra ani hosta.
Zagadnienia dotyczące aktualizacji niewpływającej na pracę użytkownika (NDU): Ta procedura nie wprowadza żadnych zmian w klastrze ani hoście.

Czas realizacji:
Wykonanie skryptu dla tego zadania zajmuje około jednej (1) minuty na każdego hosta ESXi.

Uruchamianie skryptu sprawdzania poprawności hosta ESXi z poziomu PowerCLI

1. Pobierz z tego artykułu ESX_Configuration_Validation skrypt. 

   Nazwa pakietu	PowerStore_ESXi_Configuration_Validation_1.0.19.0_pkb.zip  Nazwa pliku pojawiająca się w załączniku może mieć inny sufiks.
   Nazwa skryptu	check_esx_config.ps1
   Wersja	1.0.19.0
   Suma kontrolna MD5	64c97ce4218c97f03b718e68aa88c120
   Suma kontrolna SHA256	7d065192bc1715dd8c134e99158bfabeb74f8b733c7226c8f781a9fe39a26828

2. Pobierz VMware PowerCLI w wersji 6.5 lub nowszej. Być może jest już zainstalowany na komputerze osobistym. Jeśli jeszcze ich nie zainstalowano, pobierz je zgodnie z opisem w poniższym punkcie dotyczącym plików do pobrania.
3. Otwórz konsolę PowerCLI jako administrator. Jedną z metod wykonania tej czynności jest otwarcie narzędzia PowerCLI z menu Start przy użyciu opcji Uruchom jako administrator. Alternatywnie PowerCLI można uruchomić z poziomu konsoli PowerShell.

4. Ustaw parametr ExecutionPolicy uruchamiając następujące polecenie:

> Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

5. Ustaw konfigurację PowerCLI tak, aby ignorowała nieprawidłowy certyfikat (PowerCLI 10.x i nowsze wersje).

> Set-PowerCLIConfiguration -InvalidCertificateAction Ignore 

6. Wywołaj metodę check_esx_config :

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

Obsługiwane parametry:

Dane wyjściowe skryptu walidacji hosta ESXi

Skrypt drukuje dane wyjściowe do konsoli PowerCLI i do plików dziennika. Katalog wyjściowy o nazwie <vCenter_Server>_<date>_<time> jest tworzony w katalogu Dzienniki.

W przypadku każdej weryfikacji konfiguracji dane wyjściowe wskazują, czy walidacja jest poprawna, a jeśli nie, jaka jest istotność nieprawidłowej konfiguracji. Prefiks w wiadomości odpowiada ważności elementu: PROBLEM, OSTRZEŻENIE lub UWAGA, tekst walidacji i oczekiwana wartość

W konsoli wyświetlane są wszystkie komunikaty dotyczące akcji wykonywanych przez skrypt. W ostatniej sekcji danych wyjściowych konsoli wszystkie wykryte problemy podsumowano według ważności i kategorii. Ponadto out jest zapisywany w plikach dziennika. Pliki dziennika są uporządkowane według sekcji i zaleca się je używać do zrozumienia wyników skryptu.

Następujące pliki znajdują się w katalogu wyjściowym:

• all.log - Zawiera wszystkie dane wyjściowe (takie same jak te, które są wypisywane do konsoli).
• error.log - Zawiera tylko komunikaty o błędach lub ostrzeżenia i podejrzewane błędy.
• Dell_EMC_EULA.txt - UMOWA LICENCYJNA NARZĘDZI PROGRAMOWYCH FIRMY DELL

Przykład pliku wyjściowego 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].
***************************************************************************************************

Jak zweryfikować podpis paczki

• Pobierz następujące dwa pliki:

1. Podpis

2. Klucz publiczny 

• Przenieś te pliki do maszyny deweloperskiej (najlepiej z systemem Linux, ponieważ w tym przykładzie jest używany gpg który jest preinstalowany w większości systemów Linux):
• Zaimportuj klucz za pomocą 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

• Sprawdź podpisany pakiet za pomocą 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

• Aby zatwierdzić klucz jako "zaufany" (krok opcjonalny) 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]

Znane problemy

1. Skrypt HVS nieprawidłowo ostrzega o parametrach „Reclaim”. Prawidłowe wartości parametrów "Reclaim" to:

• Low dla „Reclaim Priority”.
• Priority dla „Reclaim Method”.

[~] 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 

Pobieranie:

• PowerCLI 6.5 lub PowerCLI 12.5

• Skrypt sprawdzania poprawności znajduje się w załączniku do tego artykułu. W witrynie pomocy technicznej firmy Dell wybierz opcję Załączniki w lewym panelu tego artykułu.

Historia wersji:

• 1.0.15:
  • Pierwsze wydanie
• 1.0.18
  • Certyfikat zgodności z PowerCLI 12.5
  • Magazyny danych zmapowane za pośrednictwem NVMe są teraz prawidłowo obsługiwane.
  • Zaktualizowano zastrzeżenie w celu wyjaśnienia, że obsługa wielu ścieżek nie ocenia zasad dotyczących ścieżek HPP NVMe. 
  • Moduł systemowy sprawdza, czy są dostępne konta HBA FC, ocenia zalecane ustawienie NVMe: vmknvme_hostnqn_format=0
  • Lokalizacja pliku dziennika została przeniesiona na koniec danych wyjściowych. 
  • iSCSI VMkernel oceniany dla zalecanego interwału braku operacji iSCSI wynoszącego 5 sekund
  • Usunięto kolekcję zbędnych modułów
  • Dane wyjściowe obejmują pozytywne opinie na temat pomyślnych testów, których brakowało.
  • Rozwiązano problem z weryfikacją config.vpxd.ResourceManager.maxCostPerHost
  • Rozwiązano problem z weryfikacją domyślnej częstotliwości przełączania ścieżek okrężnych NMP Opcje PSP: policy=iops;iops=1.
• 1.0.19
  • Odniesienia do przewodnika konfiguracji hosta firmy Dell zostały zmienione na podręcznik łączności E-Lab. Zaktualizowano również odpowiednie walidacje i zastrzeżenia. 
  • Zaktualizowano obsługiwane wersje oprogramowania ESXi.