Logi instalacji SQL Server

Logi instalacji SQL Server to pliki zapisywane w katalogu Setup Bootstrap, wskazujące przyczynę nieudanego wdrożenia.

Gdzie SQL Server zapisuje logi instalacyjne

Logi instalacji SQL Server są tworzone przez program instalacyjny w katalogu Setup Bootstrap. Typowa lokalizacja ma postać %ProgramFiles%\Microsoft SQL Server\160\Setup Bootstrap\Log dla SQL Server 2022 oraz %ProgramFiles%\Microsoft SQL Server\150\Setup Bootstrap\Log dla SQL Server 2019. Numer w ścieżce identyfikuje główną wersję komponentów instalacyjnych. Wewnątrz katalogu Log znajdują się podkatalogi odpowiadające poszczególnym uruchomieniom instalatora, zwykle oznaczone datą i godziną.

Najważniejsze pliki to Summary.txt, Detail.txt oraz raport kontroli reguł zapisany jako plik HTML, często występujący pod nazwą SystemConfigurationCheck_Report.htm. Nazwy dodatkowych plików mogą zależeć od wersji SQL Server, wybranych składników i rodzaju wykonanej operacji. Przy analizie należy zachować cały katalog konkretnego uruchomienia, ponieważ pliki opisują różne etapy tego samego procesu: sprawdzenie wymagań, przygotowanie instalacji, instalowanie składników i końcowy wynik.

Jak czytać Summary.txt i Detail.txt

Summary.txt jest skróconym raportem wyniku działania instalatora. Można w nim znaleźć nazwę komputera, wersję instalatora, rodzaj akcji, listę składników, wynik poszczególnych etapów oraz kod błędu. Wiersze oznaczone jako Failed, Error albo Failure wskazują miejsce, w którym instalacja została uznana za nieudaną, ale sam wpis końcowy nie zawsze wyjaśnia pierwotną przyczynę. Często trzeba przejść do wcześniejszych komunikatów dotyczących konkretnej reguły lub składnika.

Detail.txt zawiera znacznie bardziej szczegółowy przebieg pracy Setup Bootstrap. W tym pliku warto wyszukiwać ciągi error, exception, failed, return value 3, a także nazwy składników, takie jak Database Engine Services, SQL Server Replication, Full-Text and Semantic Extractions for Search albo SQL Server Browser. Istotne jest ustalenie kolejności zdarzeń. Komunikat zapisany po wcześniejszym błędzie może być tylko skutkiem przerwania instalacji, a nie jej źródłem.

Reguły konfiguracji i kody błędów

Przed rozpoczęciem instalowania SQL Server instalator wykonuje zestaw reguł sprawdzających środowisko. Raport HTML może wskazać między innymi nieprawidłową konfigurację systemu, brak wymaganej funkcji systemu Windows, konflikt nazwy instancji, niewystarczające uprawnienia, oczekujący restart albo niezgodność komponentów. Reguła zakończona stanem Failed zwykle wymaga usunięcia wskazanej przeszkody przed ponowną próbą. Stan Warning nie zawsze blokuje instalację, ale powinien zostać zinterpretowany w kontekście wybranego składnika.

W logach mogą pojawić się kody HRESULT, kody Windows Installer oraz komunikaty usług systemowych. Sam kod, na przykład ogólny kod niepowodzenia, nie jest wystarczającą diagnozą bez otaczającego tekstu i nazwy operacji. Należy porównać czas wystąpienia błędu z nazwą podkatalogu uruchomienia, sprawdzić, czy instalator działał z odpowiednimi uprawnieniami, oraz odróżnić błąd pobierania lub rozpakowania pakietu od błędu konfiguracji instancji.

Powiązanie logów z diagnostyką komputera

Logi instalacyjne SQL Server pozwalają ustalić, czy problem dotyczy samego programu instalacyjnego, systemu Windows, składnika dodatkowego czy konfiguracji instancji. Nie należy utożsamiać ich z plikiem ERRORLOG silnika SQL Server. ERRORLOG opisuje działanie usługi Database Engine po jej uruchomieniu, natomiast logi Setup Bootstrap dokumentują proces instalowania i konfigurowania produktu. Jeżeli instalacja nie utworzyła usługi silnika, właściwych informacji należy szukać przede wszystkim w katalogu Setup Bootstrap.

Przy diagnostyce laptopa lub komputera PC kopia logów powinna obejmować cały katalog danego uruchomienia, raport reguł oraz dokładną wersję SQL Server. Trzeba również zapisać wybraną edycję, nazwę instancji i składniki zaznaczone w instalatorze. Takie dane umożliwiają odtworzenie kolejności działań i odróżnienie problemu z konfiguracją systemu od usterki sprzętowej, na przykład błędów dysku lub niestabilnej pamięci operacyjnej, które mogą przerywać rozpakowywanie i zapisywanie plików.