Rozwiązanie społecznościowe

Brak dysku SSD NVMe w interfejsie internetowym ZimaOS: sprawdź mapowanie zatok

A ZimaCube NVMe was detected by PCIe but mapped incorrectly in the UI; IceWhale's local-storage.conf reset fixed the original ZimaCube case.

Jeśli dysk SSD NVMe jest wykrywany przez system Linux, ale wyświetlany w niewłaściwej kieszeni ZimaCube lub nieprawidłowo pokazywany w interfejsie pamięci masowej, problem może dotyczyć metadanych mapowania kieszeni ZimaOS, a nie samego dysku SSD. Najpierw sprawdź wykrywanie PCIe, a następnie użyj resetu pliku local-storage.conf tylko na sprzęcie, dla którego IceWhale udokumentowało lub zaleciło to obejście.

Wątek źródłowy wskazuje ważne ograniczenie dotyczące modeli: usunięcie NVME=... wiersz i uruchom ponownie zimaos-local-storage.service naprawiło pierwotny przypadek dotyczący ZimaCube, ale później IceWhale stwierdziło, że ta metoda dotyczy ZimaCube i nie działa w ten sam sposób na standardowym urządzeniu Intel NUC.

Widok pamięci masowej ZimaOS pokazujący grafikę kieszeni NVMe z nieprawidłowym lub brakującym stanem dysku SSD
Dysk SSD był obecny w systemie, ale interfejs kieszeni ZimaOS nieprawidłowo pokazywał gniazdo NVMe. Źródło: forum społeczności IceWhale.

Krok 1: Potwierdź istnienie NVMe na poziomie PCIe

Uruchom:

lspci | grep -i -E 'non-volatile|nvme'
lsblk -o NAME,SIZE,MODEL,SERIAL

Jeśli dysk SSD nie pojawia się w żadnym z widoków sprzętowych, problem nie dotyczy wyłącznie grafiki kieszeni ZimaOS.

Przydatny jest przewodnik rozwiązywania problemów z pamięcią masową, gdy NVMe nie jest wykrywany na poziomie sprzętowym, a nie tylko nieprawidłowo przedstawiany w internetowym interfejsie użytkownika.

Krok 2: Sprawdź mapowanie kieszeni ZimaCube

W przypadku urządzenia ZimaCube, którego dotyczył problem, IceWhale poprosiło o:

sudo -i
cat /etc/casaos/local-storage.conf

Konfiguracja zawierała jawne NVME=... mapowanie, które nie odpowiadało już lokalizacji dysku SSD.

Krok 3: Resetuj tylko na właściwym modelu

IceWhale poleciło użytkownikowi ZimaCube usunąć NVME=... wiersz, a następnie uruchom:

systemctl restart zimaos-local-storage.service

Pierwotny użytkownik potwierdził, że to naprawiło interfejs.

Dlaczego przeniesienie dysku SSD może odtworzyć problem

Później użytkownik przeniósł dysk SSD z jednej kieszeni do innej i nieprawidłowe mapowanie pojawiło się ponownie. Ma to sens, jeśli zapisana w pamięci podręcznej mapa niestandardowych kieszeni nie odpowiada już nowemu fizycznemu gniazdu.

Nie stosuj tego bezrefleksyjnie do dowolnego sprzętu

Dane wyjściowe terminala pokazujące lspci oraz konfigurację local-storage CasaOS z mapowaniem gniazd NVMe
Późniejszy test na urządzeniu innym niż ZimaCube pokazał, dlaczego obejście z plikiem local-storage.conf było specyficzne dla modelu. Źródło: forum społeczności IceWhale.

Użytkownik korzystający z urządzenia Intel NUC wykonał tę samą edycję, a wiersz NVMe pojawił się ponownie bez naprawienia interfejsu. IceWhale wyraźnie zaznaczyło, że ta metoda dotyczy ZimaCube, a szersza obsługa niestandardowych przedziałów dysków dla innych modeli była nadal w opracowaniu.

Najpierw sprawdź bieżący interfejs pamięci masowej

Aktualny przewodnik konfiguracji pamięci masowej ZimaOS opisuje bieżące wykrywanie dysków i konfigurację pamięci masowej. Jeśli dysk SSD jest widoczny jako normalna pamięć masowa, ale grafika zatoki jest nieprawidłowa, potraktuj to jako problem z prezentacją lub mapowaniem.

Ostrożnie korzystaj z uprawnień administratora

Wątek źródłowy wyjaśniał również, że edycja /etc/casaos/local-storage.conf wymaga uprawnień administratora. Nie wymuszaj zapisu do pliku ze zwykłej sesji użytkownika.

Oddziel wykrywanie fizyczne od prezentacji zatok

Strona pamięci masowej ZimaCube próbuje przypisać wykryte kontrolery NVMe do etykiet fizycznych zatok. Ta dodatkowa warstwa prezentacji wyjaśnia, dlaczego dysk może być prawidłowo widoczny w systemie Linux, a mimo to pojawiać się pod niewłaściwą literą lub z nietypową grafiką zatoki.

Przed edycją konfiguracji zapisz model dysku SSD, adres PCI oraz fizyczne gniazdo. Dzięki temu uzyskasz mapę stanu przed i po zmianie oraz zmniejszysz ryzyko „naprawienia” niewłaściwego urządzenia.

Utwórz kopię zapasową local-storage.conf przed edycją

Jeśli pomoc techniczna IceWhale zaleci modyfikację pliku, najpierw utwórz jego kopię:

sudo -i
cp /etc/casaos/local-storage.conf /etc/casaos/local-storage.conf.bak

Następnie wprowadź wyłącznie żądaną zmianę. Unikaj przepisywania niezwiązanych ustawień pamięci masowej, ponieważ plik zawiera więcej niż tylko mapowanie NVMe.

Najpierw uruchom ponownie usługę pamięci masowej, a nie cały serwer

Zweryfikowana poprawka dla ZimaCube polegała na ponownym uruchomieniu zimaos-local-storage.service po wyczyszczeniu nieaktualnego mapowania. To węższy test niż ponowne uruchomienie całego serwera NAS i ułatwia sprawdzenie, czy usługa pamięci lokalnej prawidłowo odbudowała mapę zatok.

Jeśli mapowanie ciągle powraca

Gdy to samo nieaktualne mapowanie pojawia się ponownie po każdym ponownym uruchomieniu, przestań wielokrotnie edytować plik. Zapisz wygenerowaną konfigurację, lspci, lsblk, fizyczne gniazdo oraz aktualną wersję ZimaOS na potrzeby pomocy technicznej. Ciągłe odtwarzanie mapowania oznacza, że inny komponent je zapisuje.

, fizyczne gniazdo oraz aktualną wersję ZimaOS na potrzeby pomocy technicznej. Ciągłe odtwarzanie mapowania oznacza, że inny komponent je zapisuje. {ilink("https://shop.zimaspace.com/pages/zimaos-installation-troubleshooting-guide","przewodnik rozwiązywania problemów z pamięcią masową","Zbierz informacje o wykrywaniu sprzętu i metadanych pamięci masowej przed wielokrotnym wprowadzaniem zmian na poziomie systemu")}

Najczęściej zadawane pytania

Czy usunięcie wiersza NVME wymaże dysk SSD?

Opisane obejście zmieniało konfigurację mapowania zatok, a nie zawartość dysku. Mimo to przed wprowadzeniem systemowych zmian dotyczących pamięci masowej wykonaj kopię zapasową ważnych danych.

Dlaczego dysk SSD jest widoczny w lspci, ale nie jest poprawnie wyświetlany w interfejsie?

Wskazuje to raczej na metadane pamięci masowej ZimaOS lub mapowanie zatok niż na podstawowe wykrywanie PCIe.

Czy mogę zastosować tę poprawkę na komputerze Intel NUC?

Nie jako ogólna zasada. IceWhale wyraźnie zaznaczyło, że obejście dotyczyło ZimaCube.

Co zrobić, jeśli dysku SSD nie ma na liście lspci?

Następnie najpierw sprawdź gniazdo sprzętowe, dysk SSD, ustawienia BIOS/PCIe oraz fizyczne połączenie.