Testowanie i rozwiązywanie problemów po migracji
Praktyczny przewodnik po testach i stabilizacji SharePoint Server SE po migracji. Sprawdź, jak zweryfikować treści, uprawnienia i integracje, analizować logi oraz przygotować przełączenie środowiska i plan wycofania zmian.
Wprowadzenie: cele testów i stabilizacji po migracji do SharePoint Server SE
Zakończenie przenoszenia danych do SharePoint Server Subscription Edition (SE) nie oznacza jeszcze, że środowisko jest gotowe do codziennej pracy. Poprawne uruchomienie farmy i otwarcie strony głównej potwierdzają jedynie część powodzenia migracji. Właściwym celem weryfikacji jest ustalenie, czy użytkownicy mogą bezpiecznie i sprawnie wykonywać swoje zadania, a organizacja zachowuje ciągłość procesów opartych na SharePoint.
Testy po migracji i stabilizacja służą temu samemu celowi, ale pełnią różne funkcje. Testowanie dostarcza dowodów, że przeniesione środowisko działa zgodnie z oczekiwaniami, oraz ujawnia rozbieżności wymagające wyjaśnienia. Stabilizacja obejmuje usuwanie przyczyn wykrytych problemów, sprawdzanie skuteczności poprawek i obserwację zachowania systemu w czasie. Nie sprowadza się więc do jednorazowego usunięcia błędów zgłoszonych podczas pierwszego uruchomienia.
Weryfikacja powinna łączyć perspektywę techniczną z biznesową. Administratorzy oceniają niezawodność środowiska, natomiast właściciele procesów i użytkownicy potwierdzają jego przydatność w rzeczywistej pracy. Obie perspektywy są niezbędne: brak widocznych awarii nie gwarantuje poprawnego przebiegu procesu, a pomyślne wykonanie pojedynczego zadania nie dowodzi stabilności całej platformy. Szczególne znaczenie mają obszary, których niedostępność zatrzymuje pracę lub może prowadzić do utraty poufności informacji.
Celem nie jest odtworzenie każdego zachowania poprzedniego środowiska bez względu na jego zasadność. Migracja może wiązać się z zaplanowanymi zmianami wynikającymi z nowej konfiguracji lub wymagań wspieranej platformy. Trzeba zatem odróżnić oczekiwaną zmianę od regresji, czyli pogorszenia wcześniej dostępnej funkcjonalności. Takie rozróżnienie pomaga skupić działania naprawcze na rzeczywistych problemach, zamiast traktować każdą różnicę jako błąd migracji.
Rezultatem testów i stabilizacji powinna być uzasadniona ocena gotowości środowiska do eksploatacji: wiadomo, co działa prawidłowo, jakie ograniczenia pozostają i jaki mają wpływ na organizację. To nie obietnica całkowitego braku usterek, lecz świadoma kontrola ryzyka. Dzięki niej decyzja o korzystaniu z SharePoint Server SE opiera się na sprawdzonym działaniu platformy, a nie wyłącznie na technicznym statusie zakończenia migracji.
Przygotowanie do weryfikacji: zakres, kryteria akceptacji, porównanie źródło vs SE i plan testów
Weryfikacja migracji do SharePoint Server Subscription Edition (SE) wymaga ustalenia, co ma zostać zachowane, jakie zmiany są zamierzone i na jakiej podstawie środowisko zostanie zaakceptowane. Bez tych ustaleń trudno odróżnić błąd migracji od wcześniej istniejącego problemu lub świadomej zmiany konfiguracji. W Cognity często słyszymy pytania, jak praktycznie podejść do takiej weryfikacji – odpowiadamy na nie także na blogu. Podstawą przygotowań powinny być cztery elementy: zakres weryfikacji, mierzalne kryteria akceptacji, udokumentowany stan środowiska źródłowego oraz plan testów z przypisanymi odpowiedzialnościami.
Zakres weryfikacji i priorytety biznesowe
Zakres należy oprzeć na inwentaryzacji środowiska oraz rzeczywistym sposobie korzystania z SharePointa. Powinien obejmować nie tylko przenoszone zasoby, lecz także procesy biznesowe, zależności zewnętrzne i rozwiązania niestandardowe. Warto wskazać również wyłączenia: elementy wycofywane, zastępowane lub świadomie pozostawiane poza migracją. Każde takie wyłączenie wymaga uzasadnienia i akceptacji właściciela biznesowego.
Nie wszystkie obszary potrzebują jednakowej głębokości sprawdzenia. Priorytet powinien wynikać ze skutków ewentualnej awarii, a nie wyłącznie z wielkości witryny czy liczby dokumentów. Zasoby obsługujące procesy krytyczne, zawierające informacje wrażliwe lub wykorzystujące rozbudowane dostosowania wymagają szerszej weryfikacji. W przypadku powtarzalnych, mniej ryzykownych obszarów można zastosować reprezentatywną próbę, pod warunkiem udokumentowania zasad jej doboru i ograniczeń.
Kryteria akceptacji ustalone przed testami
Kryteria akceptacji opisują warunki uznania migracji za poprawną; scenariusze testowe określają natomiast, jak te warunki zostaną sprawdzone. Ogólne stwierdzenie „środowisko działa prawidłowo” nie wystarcza. Każde kryterium powinno wskazywać oczekiwany rezultat, sposób oceny oraz osobę uprawnioną do jego zatwierdzenia.
- Kompletność: wszystkie zasoby objęte migracją zostały rozliczone, a pominięcia odpowiadają zatwierdzonym wyłączeniom.
- Ciągłość pracy: uzgodnione scenariusze krytyczne kończą się oczekiwanym wynikiem dla właściwych ról użytkowników.
- Wydajność: wyniki mieszczą się w przyjętych granicach przy określonym obciążeniu i porównywalnych warunkach pomiaru.
- Obsługa usterek: nie pozostają otwarte błędy zakwalifikowane jako blokujące odbiór, a pozostałe mają zaakceptowany sposób postępowania, właściciela i termin usunięcia.
Progi wydajności, poziomy ważności błędów i dopuszczalne odstępstwa należy uzgodnić z biznesem oraz zespołem utrzymania przed rozpoczęciem weryfikacji. Pozwala to uniknąć zmieniania zasad odbioru pod wpływem uzyskanych wyników.
Punkt odniesienia: środowisko źródłowe a SharePoint Server SE
Porównanie wymaga wiarygodnego punktu odniesienia, czyli udokumentowanego stanu źródła z określonego momentu. Należy zachować inwentaryzację zasobów, istotne ustawienia, informacje o dostosowaniach oraz wyniki wybranych scenariuszy i pomiarów wykonanych przed migracją. W dokumentacji powinny znaleźć się także znane usterki źródła, aby nie przypisywać ich automatycznie nowemu środowisku.
Zgodność nie oznacza identyczności technicznej. SharePoint Server SE może różnić się od źródła konfiguracją, dostępnymi funkcjami lub sposobem realizacji określonych rozwiązań. Dlatego warto prowadzić rejestr oczekiwanych różnic, zawierający uzasadnienie zmiany i jej wpływ na użytkowników. Sama zgodność liczby elementów jest pomocna, ale nie dowodzi jeszcze poprawności migracji; podobnie różnica rozmiaru baz danych nie przesądza o utracie treści.
Trzeba też określić sposób uwzględnienia zmian powstałych po wykonaniu inwentaryzacji. Jeżeli użytkownicy nadal pracują w źródle, porównanie powinno odnosić się do uzgodnionego punktu odcięcia albo uwzględniać późniejsze przyrosty. W przeciwnym razie naturalne różnice między stanami mogą zostać uznane za błędy.
Plan testów, odpowiedzialności i dowody wykonania
Każdy przypadek testowy powinien mieć identyfikator, priorytet, warunki wstępne, wskazane dane i rolę użytkownika, oczekiwany rezultat oraz miejsce na wynik i dowód wykonania. Plan powinien określać kolejność działań: od kontroli umożliwiających dalszą weryfikację, przez scenariusze krytyczne, po szersze testy i ponowne sprawdzenie obszarów objętych poprawkami.
Należy rozdzielić odpowiedzialność za wykonanie testów technicznych, potwierdzenie przydatności biznesowej i formalną akceptację wyników. Potrzebne są również zasady zgłaszania usterek, eskalacji oraz wstrzymania testów, gdy problem uniemożliwia wiarygodną ocenę. Raporty, zrzuty ekranu i zgłoszenia powinny odwoływać się do identyfikatorów przypadków testowych oraz daty wykonania. Dzięki temu decyzja o akceptacji opiera się na możliwych do zweryfikowania wynikach, a nie na ogólnym przekonaniu, że migracja się powiodła.
3. Weryfikacja poprawności migracji: testy funkcjonalne i dostępność treści
Poprawne zakończenie operacji migracyjnych nie oznacza jeszcze, że witryny w SharePoint Server Subscription Edition (SE) są gotowe do pracy. Baza zawartości może być dostępna, a strony mogą się otwierać, mimo że część dokumentów, metadanych lub funkcji list nie działa zgodnie z oczekiwaniami. Weryfikacja powinna zatem odpowiedzieć na dwa odrębne pytania: czy przeniesiona treść jest kompletna i dostępna oraz czy użytkownik może wykonywać na niej wymagane operacje.
Kontrola dostępności obejmuje między innymi otwieranie stron i plików oraz obecność elementów list. Testy funkcjonalne sprawdzają natomiast zachowanie rozwiązania podczas pracy: zapis formularza, edycję dokumentu, filtrowanie widoku czy utworzenie kolejnej wersji. Sam podgląd zawartości nie zastępuje tych prób.
Witryny: struktura, strony i nawigacja
Weryfikację witryny warto rozpocząć od strony głównej, a następnie przejść do podwitryn, stron informacyjnych i miejsc, w których użytkownicy wykonują codzienne zadania. Należy sprawdzić nie tylko to, czy strona się wyświetla, lecz także czy pokazuje właściwą zawartość, zachowuje układ i nie zawiera niedziałających składników Web Part. Szczególnej uwagi wymagają strony z niestandardowymi formularzami, skryptami lub elementami interfejsu.
Osobnym punktem jest nawigacja wewnątrz treści: menu, kafelki, odsyłacze w tekstach i linki prowadzące bezpośrednio do dokumentów. Strona otwierająca się bez błędu może nadal kierować użytkownika do starego środowiska. W tym miejscu należy odnotować nieprawidłowy cel odsyłacza; konfiguracja adresów środowiska należy do odrębnego etapu weryfikacji.
Listy i biblioteki: kompletność oraz codzienna obsługa
Lista przechowuje przede wszystkim ustrukturyzowane dane, a biblioteka — pliki wraz z opisującymi je metadanymi. Dlatego kontrola list powinna koncentrować się na elementach, polach i formularzach, natomiast kontrola bibliotek musi dodatkowo obejmować rzeczywiste otwieranie dokumentów oraz operacje na plikach.
| Obszar | Co zweryfikować | Przykład nieprawidłowości |
|---|---|---|
| Elementy i dokumenty | Obecność zawartości, strukturę folderów, załączniki list oraz możliwość otwarcia i pobrania plików. | Dokument jest widoczny w bibliotece, ale nie można go otworzyć. |
| Metadane i typy zawartości | Wartości kolumn, pola wymagane, daty, autorów, typy zawartości oraz działanie pól odnośników i metadanych zarządzanych. | Element istnieje, lecz utracił klasyfikację albo wskazuje niewłaściwy element powiązany. |
| Widoki | Wyświetlane kolumny, sortowanie, filtrowanie i grupowanie, również na dużych listach. | Widok domyślny działa, ale widok używany przez zespół zwraca błąd lub nie pokazuje oczekiwanych danych. |
| Formularze i zapis | Dodawanie oraz edycję elementów, walidację pól, zapis załączników i dokumentów. | Formularz otwiera się poprawnie, ale zapis kończy się błędem. |
Zgodność liczby elementów jest pomocnym wskaźnikiem, ale nie dowodem kompletności. Takie same sumy nie wykluczają brakujących załączników, błędnych wartości pól ani podmienionych plików. Z kolei różnica w liczbie pozycji nie zawsze oznacza utratę danych — może wynikać z przyjętego zakresu migracji lub zmian wprowadzonych po wykonaniu zestawienia źródłowego. Każdą rozbieżność trzeba odnieść do konkretnej zawartości i uzgodnionego punktu porównania.
Wersjonowanie: historia i zachowanie po migracji
Weryfikacja historii wersji powinna objąć zarówno jej zachowanie, jak i dalsze działanie. Dla sprawdzanych elementów oraz dokumentów należy porównać liczbę i oznaczenia wersji, daty, autorów zmian oraz komentarze, jeśli były rejestrowane. W bibliotekach korzystających z wersji głównych i pomocniczych trzeba również potwierdzić ich obecność i status bieżącego dokumentu. Zakres oczekiwanej historii musi odpowiadać temu, co miało zostać przeniesione — nie każda metoda i konfiguracja migracji zachowuje ją w identyczny sposób.
Samo wyświetlenie historii nie wystarcza. Warto otworzyć wcześniejszą wersję i sprawdzić jej zawartość, a na przeznaczonym do tego materiale testowym wykonać edycję oraz zapis kolejnej wersji. Jeżeli biblioteka wymaga wyewidencjonowania, należy przetestować także wyewidencjonowanie i zaewidencjonowanie dokumentu. Przywracanie starszych wersji oraz próby usuwania najlepiej wykonywać na kontrolowanych kopiach, aby nie zmieniać rzeczywistej dokumentacji.
Ocena wyniku testów funkcjonalnych
Za potwierdzenie poprawności należy uznać działający scenariusz od początku do końca, a nie pojedynczy poprawnie wyświetlony ekran. Przykładowo: użytkownik otwiera bibliotekę, znajduje dokument w odpowiednim widoku, odczytuje go, zmienia metadane i zapisuje nową wersję. Każdy wykryty problem warto opisać przez wskazanie konkretnej witryny, listy lub pliku, wykonanej czynności oraz różnicy między wynikiem oczekiwanym a rzeczywistym. Taki zapis pozwala jednoznacznie potwierdzić skuteczność poprawki podczas ponownego testu.
Weryfikacja bezpieczeństwa i tożsamości: uprawnienia, grupy, uwierzytelnianie/claims, profile użytkowników
Po migracji do SharePoint Server Subscription Edition (SE) samo poprawne logowanie nie potwierdza, że zabezpieczenia działają prawidłowo. Użytkownik może zostać uwierzytelniony, a mimo to utracić dostęp do swoich dokumentów albo uzyskać uprawnienia szersze niż w środowisku źródłowym. Weryfikacja powinna potwierdzić zarówno dostęp dozwolony, jak i skuteczne blokowanie dostępu nieuprawnionego — zgodnie z zatwierdzonym modelem uprawnień, a nie wyłącznie ze stanem sprzed migracji.
Trzeba przy tym rozdzielić trzy obszary: uwierzytelnianie potwierdza tożsamość użytkownika, autoryzacja określa jego dostęp do zasobów, a profil użytkownika przechowuje informacje wykorzystywane przez funkcje personalizacji. Poprawność jednego obszaru nie oznacza poprawności pozostałych. W Cognity omawiamy weryfikację tych obszarów zarówno od strony technicznej, jak i praktycznej — zgodnie z realiami pracy uczestników szkoleń.
Uprawnienia: sprawdź rzeczywisty dostęp, nie tylko przypisania
Kontrolę należy przeprowadzić na poziomie witryn, list, bibliotek oraz elementów z unikatowymi uprawnieniami. Szczególnej uwagi wymagają miejsca, w których przerwano dziedziczenie, zastosowano niestandardowe poziomy uprawnień lub nadano dostęp bezpośrednio użytkownikom. Takie wyjątki najłatwiej przeoczyć podczas oceny zabezpieczeń całej kolekcji witryn.
Funkcja sprawdzania uprawnień pomaga ustalić, skąd wynika dostęp konkretnego konta, ale nie zastępuje testu wykonanego w jego kontekście. Konto administratora kolekcji witryn nie nadaje się do oceny ograniczeń zwykłego użytkownika — jego szerokie uprawnienia mogą ukryć problem.
- Odczyt: użytkownik otwiera dozwoloną treść, lecz nie może jej zmieniać.
- Edycja: użytkownik wykonuje operacje przewidziane dla przypisanego poziomu uprawnień, bez możliwości zarządzania zabezpieczeniami, jeżeli rola tego nie dopuszcza.
- Brak dostępu: użytkownik spoza uprawnionej grupy nie otwiera chronionego zasobu również po podaniu jego bezpośredniego adresu.
Nie należy traktować każdego nietypowego wpisu jako błędu. Przykładowo poziom Ograniczony dostęp może umożliwiać dotarcie do konkretnego udostępnionego elementu bez nadawania prawa odczytu całej witryny. Przed usunięciem takiego wpisu trzeba ustalić jego rolę.
Grupy SharePoint i grupy katalogowe: dwa różne mechanizmy
Grupy SharePoint porządkują przypisania uprawnień w obrębie kolekcji witryn. Grupy zabezpieczeń w Active Directory pozwalają zarządzać członkostwem centralnie i mogą być wykorzystywane przy nadawaniu dostępu w SharePoint. Zachowanie nazwy grupy po migracji nie wystarcza: znaczenie mają jej tożsamość, członkostwo oraz przypisane uprawnienia.
W grupach SharePoint sprawdź członków, właścicieli i zasady zarządzania członkostwem. Dla grup katalogowych potwierdź, że środowisko docelowe prawidłowo rozpoznaje grupę i uwzględnia członkostwo użytkowników. Jeżeli model dostępu opiera się na grupach zagnieżdżonych, uwzględnij je w testach. Po zmianach członkostwa wynik może zależeć od aktualności tokenu logowania i pamięci podręcznej, dlatego test należy powtórzyć po odświeżeniu sesji oraz z uwzględnieniem czasu propagacji zmian.
Uwierzytelnianie i claims: potwierdź ciągłość tożsamości
SharePoint Server SE wykorzystuje uwierzytelnianie oparte na oświadczeniach (claims). W tym modelu może korzystać między innymi z uwierzytelniania Windows lub zaufanego dostawcy tożsamości. Oświadczenie identyfikuje użytkownika w określonym kontekście dostawcy — sama zgodność nazwy wyświetlanej czy adresu e-mail nie dowodzi, że SharePoint rozpoznaje go jako to samo konto.
Jeżeli migracji towarzyszyła zmiana domeny, dostawcy tożsamości lub sposobu identyfikowania kont, należy sprawdzić, czy zachowano prawidłowe powiązanie użytkowników z istniejącymi uprawnieniami. Objawem niezgodności może być poprawne logowanie połączone z odmową dostępu lub występowanie kilku wpisów reprezentujących tę samą osobę. Nie należy maskować problemu tożsamości przez ponowne, masowe nadawanie uprawnień.
Weryfikacja powinna objąć każdy używany sposób logowania oraz rozpoznawanie użytkowników i grup w selektorze osób (People Picker). Możliwość wyszukania konta w selektorze nie jest jednak dowodem, że konto potrafi się zalogować ani że otrzymało właściwy dostęp.
Profile użytkowników: zgodność danych i powiązania z kontem
W profilach należy sprawdzić przede wszystkim powiązanie z właściwym kontem, obecność wymaganych atrybutów oraz poprawność ich aktualizacji z używanego źródła. Kontrola powinna uwzględniać brakujące lub zduplikowane profile, a także właściwości istotne dla organizacji, takie jak dział, stanowisko czy przełożony. Jeśli stosowano niestandardowe właściwości profilu, trzeba potwierdzić również ich wartości i ustawienia widoczności.
Profil użytkownika nie jest źródłem uprawnień do treści. Poprawnie wyświetlane dane profilowe nie potwierdzają poprawnej autoryzacji, a brak profilu nie musi oznaczać niemożności zalogowania. Błędy profili należy więc oceniać oddzielnie od błędów dostępu, aby nie korygować zabezpieczeń tam, gdzie problem dotyczy wyłącznie danych użytkownika.
5. Weryfikacja usług i integracji: wyszukiwanie, workflow, integracje i aplikacje, zadania czasomierza oraz aplikacje usługowe
Poprawne otwarcie witryny nie oznacza jeszcze, że środowisko SharePoint Server Subscription Edition (SE) obsługuje wszystkie procesy biznesowe. Dokument może być dostępny w bibliotece, ale nie pojawiać się w wyszukiwaniu. Formularz może przyjmować dane, mimo że powiązany obieg nie przekazuje zadania do kolejnego uczestnika. W tej części weryfikacji należy więc sprawdzić efekt działania usług i integracji, a nie tylko ich status w Administracji centralnej.
Poszczególne obszary wymagają różnych prób. Wyszukiwanie działa na indeksie aktualizowanym przez przeszukiwanie treści, workflow realizuje wieloetapowe procesy, a integracje wymieniają dane z innymi systemami. Zadania czasomierza wykonują operacje w tle. Aplikacje usługowe udostępniają natomiast współdzielone funkcje, z których korzystają aplikacje internetowe SharePoint. Sukces w jednym obszarze nie potwierdza poprawności pozostałych.
Wyszukiwanie: od przeszukania treści do użytecznego wyniku
Weryfikację wyszukiwania rozpocznij od aplikacji usługi wyszukiwania: jej topologii, stanu komponentów, źródeł zawartości oraz harmonogramów przeszukiwania. Przeniesienie baz zawartości nie przenosi automatycznie gotowego indeksu wyszukiwania. Jeżeli w docelowym środowisku utworzono nową aplikację usługi wyszukiwania, trzeba przeprowadzić przeszukiwanie i poczekać na przetworzenie treści, zanim wyniki będą miarodajne.
Następnie wykonaj próby na znanych dokumentach i elementach list. Sprawdź wyszukiwanie po tytule, fragmencie treści oraz istotnych metadanych. Dodaj lub zmodyfikuj element testowy i potwierdź, że zmiana trafia do wyników po odpowiednim cyklu przeszukiwania. Osobno zweryfikuj usunięcie elementu z wyników po jego skasowaniu i przetworzeniu tej zmiany.
Jeżeli rozwiązanie korzysta z niestandardowego schematu wyszukiwania, sprawdź właściwości zarządzane i ich mapowania, źródła wyników, reguły zapytań oraz filtry zawężające. Samo odnalezienie dokumentu nie wystarczy, gdy użytkownicy potrzebują filtrowania według działu, typu dokumentu lub statusu sprawy. Porównuj przede wszystkim obecność oczekiwanych treści i działanie funkcji wyszukiwawczych; identyczna liczba i kolejność wyników nie zawsze są właściwym kryterium.
Workflow: test pełnego przebiegu, nie tylko uruchomienia
Najpierw ustal, z jakiej platformy korzystają poszczególne obiegi i czy jest ona obsługiwana w docelowej wersji oraz konfiguracji SharePoint Server SE. Obiegi platformy SharePoint 2013 wymagają zewnętrznego silnika workflow; weryfikacja powinna obejmować jego konfigurację i rejestrację z farmą. W przypadku SharePoint Workflow Manager samo zainstalowanie komponentów nie potwierdza jeszcze poprawnej komunikacji z SharePoint.
Dla reprezentatywnych obiegów wykonaj scenariusze obejmujące uruchomienie, utworzenie zadania, decyzję uczestnika, zmianę danych oraz zakończenie procesu. Uwzględnij powiadomienia i wywołania usług zewnętrznych, jeśli występują. Obiegi z opóźnieniami lub oczekiwaniem na zdarzenie wymagają również sprawdzenia, czy proces prawidłowo wznawia działanie.
Oddziel test nowych instancji od oceny instancji rozpoczętych przed migracją. Możliwość uruchomienia nowego obiegu nie dowodzi, że wcześniejsze procesy zachowały stan i mogą być kontynuowane. Zależy to od silnika oraz przyjętej metody przeniesienia jego danych i konfiguracji. Nie uruchamiaj ponownie procesów produkcyjnych bez kontroli skutków: może to wygenerować podwójne zadania, wiadomości lub operacje w systemach zewnętrznych.
Integracje i aplikacje: potwierdzenie całej wymiany danych
Rozwiązania niestandardowe sprawdzaj według ich roli: osobno komponenty wdrażane do farmy, dodatki i aplikacje oraz integracje korzystające z API. Potwierdź zgodność używanych wersji z SharePoint Server SE, kompletność wdrożenia i poprawność konfiguracji zależności. Szczególną uwagę zwróć na zapisane na stałe adresy usług, identyfikatory zasobów i odwołania do poprzedniego środowiska.
Test powinien obejmować całą operację biznesową: wysłanie danych, ich przyjęcie przez system docelowy oraz zwrot lub zapis wyniku w SharePoint. Odpowiedź HTTP oznaczająca powodzenie nie gwarantuje, że dane zostały poprawnie przetworzone. Tam, gdzie integracja zapisuje informacje, sprawdź również obsługę błędu i ponowienia żądania — zwłaszcza ryzyko utworzenia duplikatów.
Próby wywołujące skutki poza SharePoint wykonuj na kontrolowanych danych i, jeśli to możliwe, z użyciem testowych punktów końcowych. Dotyczy to szczególnie wysyłki wiadomości, zakładania spraw, przekazywania dokumentów oraz aktualizacji rekordów w systemach dziedzinowych.
Zadania czasomierza: harmonogram i rzeczywisty rezultat
W przypadku zadań czasomierza (timer jobs) zweryfikuj stan usługi SharePoint Timer Service na właściwych serwerach, obecność wymaganych definicji zadań, ich harmonogramy i historię wykonań. Zadania dostarczane przez rozwiązania niestandardowe zasługują na osobną kontrolę: samo przeniesienie zawartości nie gwarantuje ich odtworzenia.
Status pomyślnego wykonania zestaw z oczekiwanym efektem, takim jak przetworzenie kolejki czy aktualizacja danych. Uwzględnij okno obserwacji — zadanie uruchamiane raz na dobę może po prostu jeszcze nie wykonać się od migracji. Ręczne uruchomienie stosuj selektywnie, po sprawdzeniu skutków i możliwości bezpiecznego powtórzenia operacji; nie uruchamiaj wszystkich zadań zbiorczo.
Aplikacje usługowe: dostępność funkcji w kontekście witryny
Dla używanych aplikacji usługowych (Service Applications) sprawdź nie tylko ich istnienie, lecz także powiązania proxy z odpowiednimi aplikacjami internetowymi, działanie wymaganych instancji usług i dostępność baz. Usługa może być poprawnie skonfigurowana na poziomie farmy, a mimo to pozostawać niedostępna dla konkretnej aplikacji internetowej z powodu niewłaściwego przypisania połączeń.
Wykonaj krótkie testy funkcji zależnych od tych usług. Dla Managed Metadata Service sprawdź dostęp do właściwych zestawów terminów oraz możliwość wyboru i zapisania wartości w kolumnie metadanych zarządzanych. Dla Secure Store Service potwierdź działanie połączenia, które rzeczywiście korzysta z zapisanych poświadczeń — sama obecność definicji aplikacji docelowej nie wystarcza.
Wynik weryfikacji zapisuj jako potwierdzenie konkretnego scenariusza, z czasem próby i zaobserwowanym rezultatem. Zamiast adnotacji „usługa działa” odnotuj na przykład, że zmieniony dokument pojawił się w wyszukiwaniu po przeszukaniu albo że obieg zakończył się wraz z aktualizacją danych. Taki zapis pozwala odróżnić gotowość techniczną komponentu od faktycznej sprawności procesu.
6. Diagnostyka techniczna: logi ULS, Event Viewer, Health Analyzer, błędy SQL/IIS oraz śledzenie requestów
Po migracji do SharePoint Server Subscription Edition (SE) ten sam objaw może mieć kilka przyczyn. Błąd otwarcia strony może wynikać z wyjątku w kodzie SharePoint, niedostępności puli aplikacji IIS albo problemu z połączeniem do SQL Server. Dlatego diagnostykę należy prowadzić od konkretnego nieudanego żądania do warstwy, która spowodowała awarię, zamiast analizować wszystkie ostrzeżenia z farmy jednocześnie.
Punktem wyjścia jest zapisanie czasu wystąpienia błędu wraz ze strefą czasową, adresu URL, wykonywanej operacji, konta użytkownika oraz identyfikatora korelacji, jeśli został wyświetlony. Warto również ustalić, czy problem jest powtarzalny i czy dotyczy wszystkich żądań, czy tylko tych obsługiwanych przez określony serwer.
Źródła diagnostyczne i ich zastosowanie
Poszczególne narzędzia pokazują różne fragmenty tego samego zdarzenia. Brak wpisu w jednym źródle nie wyklucza awarii — żądanie mogło zakończyć się, zanim dotarło do rejestrowanej przez nie warstwy.
| Źródło | Co pomaga ustalić | Najważniejsze ograniczenie |
|---|---|---|
| Logi ULS | Przebieg operacji wewnątrz SharePoint, wyjątki, komunikaty komponentów i kontekst błędu. | Zakres informacji zależy od ustawionego poziomu rejestrowania; wpisy mogą być rozproszone między serwerami. |
| Event Viewer | Awarie procesów, zatrzymania usług oraz zdarzenia systemowe i aplikacyjne, m.in. związane z IIS, .NET i łącznością. | Zwykle nie przedstawia pełnego przebiegu pojedynczego żądania SharePoint. |
| SharePoint Health Analyzer | Problemy wykrywane przez reguły kontrolujące konfigurację i kondycję farmy. | Nie zastępuje śledzenia żądań, a część reguł działa według harmonogramu. |
| Logi IIS i Failed Request Tracing | Wynik obsługi HTTP, czas przetwarzania oraz etap potoku IIS, na którym wystąpił problem. | Nie wyjaśniają samodzielnie wszystkich wyjątków aplikacyjnych ani przyczyn problemów SQL. |
| SQL Server ERRORLOG i narzędzia diagnostyczne SQL | Problemy z dostępnością baz, logowaniem, operacjami wejścia/wyjścia oraz — przy dodatkowym zbieraniu danych — blokadami i wykonaniem zapytań. | ERRORLOG nie rejestruje każdego wolnego zapytania ani wszystkich blokad. |
ULS i identyfikator korelacji
Logi ULS są podstawowym źródłem informacji o błędach warstwy SharePoint. Domyślnie znajdują się w katalogu C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\16\LOGS, ale lokalizacja może zostać zmieniona w konfiguracji diagnostyki. Należy sprawdzić rzeczywiste ustawienia farmy, a nie zakładać, że wszystkie serwery zapisują pliki w domyślnym miejscu.
Correlation ID łączy wpisy dotyczące danej operacji; nie jest kodem opisującym przyczynę błędu. Pozwala zawęzić analizę i zebrać powiązane komunikaty. Do scalania wpisów z serwerów farmy można wykorzystać polecenie Merge-SPLogFile, ograniczając zakres identyfikatorem korelacji i czasem zdarzenia. W analizie warto uwzględnić komunikaty poprzedzające końcowy wyjątek — ostatni wpis często opisuje skutek, a nie pierwotną przyczynę.
Jeżeli dostępne dane są niewystarczające, szczegółowość logowania należy zwiększyć tylko dla odpowiednich kategorii i na czas kontrolowanego odtworzenia problemu. Po zebraniu materiału trzeba przywrócić wcześniejsze ustawienia. Długotrwałe, szerokie logowanie na poziomie Verbose zwiększa objętość plików i może obciążać środowisko.
Śledzenie żądania między IIS, SharePoint i SQL Server
W logach IIS warto zestawić pola sc-status, sc-substatus, sc-win32-status i time-taken. Sam status HTTP 500 nie wskazuje jeszcze konkretnej przyczyny. Dodatkowy kod, czas obsługi oraz odpowiadające mu zdarzenia ULS pomagają określić dalszy kierunek analizy. Dla trudnych do wyjaśnienia błędów można czasowo włączyć Failed Request Tracing, z regułą ograniczoną do wybranych statusów lub czasu wykonania.
Event Viewer uzupełnia ten obraz o zdarzenia z dzienników Application i System, na przykład awarię procesu roboczego albo nieoczekiwane zatrzymanie usługi. Z kolei timeout połączenia z bazą widoczny w ULS wymaga sprawdzenia strony SQL: dostępności instancji, komunikatów ERRORLOG i bieżących warunków pracy. Analizę blokad lub kosztownych zapytań należy prowadzić z administratorem baz, korzystając w razie potrzeby z widoków diagnostycznych lub Extended Events. Nie należy naprawiać problemów przez bezpośrednią edycję tabel ani schematu baz SharePoint.
Przy zestawianiu danych trzeba uwzględnić synchronizację zegarów i format czasu. Logi IIS w formacie W3C zapisują znaczniki czasu w UTC, natomiast inne źródła mogą prezentować czas lokalny. Przesunięcie o godzinę może doprowadzić do powiązania błędu z niewłaściwym zdarzeniem.
Potwierdzenie przyczyny i skuteczności poprawki
Komunikaty Health Analyzer warto traktować jako wskazówki dotyczące kondycji farmy, nie automatyczny dowód przyczyny badanego incydentu. Każdą hipotezę należy sprawdzić na podstawie czasu, serwera i kontekstu operacji. Po wprowadzeniu poprawki trzeba ponownie wykonać tę samą czynność oraz sprawdzić odpowiadające jej logi. Zapis diagnozy powinien obejmować objaw, dowody, przyczynę, zmianę i wynik ponownej próby — samo zniknięcie komunikatu z ekranu nie potwierdza trwałego rozwiązania problemu.
7. Cutover — przełączenie środowiska na SharePoint Server SE
Cutover to moment, w którym użytkownicy zaczynają korzystać z docelowej farmy SharePoint Server Subscription Edition zamiast ze środowiska źródłowego. Nie sprowadza się do zmiany rekordu DNS: wymaga skoordynowania publikacji adresów, obsługi HTTPS, kierowania ruchu oraz zasad dostępu do danych. Warunkiem bezpiecznego przełączenia jest jednoznaczne określenie, które środowisko przyjmuje zapisy i od kiedy staje się środowiskiem produkcyjnym.
DNS i adresy URL: dokąd trafią użytkownicy
Jeżeli dotychczasowe adresy pozostają bez zmian, przełączenie może polegać na skierowaniu nazwy DNS na nowy punkt publikacji albo zmianie puli serwerów za istniejącym load balancerem. Pierwszy wariant zależy od pamięci podręcznej DNS klientów i resolverów; drugi pozwala sterować ruchem w warstwie pośredniczącej, ale wymaga uwzględnienia aktywnych połączeń i sesji.
Przy zmianie DNS warto odpowiednio wcześniej obniżyć TTL. Zrobienie tego dopiero w oknie przełączenia nie skróci czasu życia wpisów już zapisanych w pamięci podręcznej. Jeśli zmieniają się również adresy URL, trzeba ustalić sposób obsługi starych odnośników, zakładek i adresów wykorzystywanych przez systemy zewnętrzne. Przekierowanie przeglądarki nie zawsze będzie właściwym rozwiązaniem dla klientów aplikacyjnych i integracji.
AAM i certyfikaty: spójność adresów oraz HTTPS
DNS określa, dokąd kierowany jest ruch, natomiast Alternate Access Mappings (AAM) wiąże adresy przychodzące z publicznymi adresami URL i strefami aplikacji internetowej SharePoint. Konfiguracja powinna odpowiadać rzeczywistej ścieżce dostępu, w tym adresom i protokołom widocznym po przejściu przez reverse proxy. Niespójność może skutkować przekierowaniami do niewłaściwego hosta lub generowaniem odnośników z błędnym protokołem. Dla kolekcji witryn opartych na nazwach hostów należy uwzględnić właściwy im mechanizm zarządzania adresami — nie traktować AAM jako uniwersalnego rozwiązania.
Certyfikaty muszą obejmować nazwy używane przez klientów, mieć aktualny okres ważności i zaufany łańcuch certyfikacji. Istotne jest także miejsce zakończenia TLS: na urządzeniu pośredniczącym, na serwerach SharePoint lub na obu odcinkach połączenia. Certyfikat na load balancerze nie zabezpiecza automatycznie komunikacji z farmą. Konfiguracja HTTPS, powiązania IIS i sposób publikacji muszą być ze sobą zgodne; samo ustawienie AAM nie konfiguruje szyfrowania.
Reverse proxy i load balancer: kontrolowane skierowanie ruchu
Reverse proxy odpowiada przede wszystkim za pośredniczenie w publikacji usługi, a load balancer za rozdzielanie ruchu między serwery; jedno urządzenie może pełnić obie funkcje. Przed przełączeniem należy potwierdzić docelowe pule backendów, reguły routingu, obsługę nagłówka Host oraz sposób przekazywania ruchu HTTPS. Kontrole kondycji powinny odzwierciedlać gotowość usługi, nie tylko dostępność portu. Trzeba również ustalić sposób wygaszenia istniejących połączeń, aby nie odciąć ich przypadkowo w trakcie pracy użytkowników.
Okno przełączenia i komunikacja
Plan operacyjny powinien wskazywać kolejność działań, właściciela każdego kroku oraz osobę uprawnioną do decyzji o uruchomieniu produkcji. Przed rozpoczęciem użytkownicy powinni otrzymać informację o terminie, przewidywanej niedostępności lub trybie tylko do odczytu, ewentualnych zmianach adresów i kanale zgłaszania problemów. Zespół wsparcia potrzebuje również jasnego sposobu eskalacji incydentów.
- Zablokowanie zmian w źródle: zgodnie z przyjętą metodą migracji, tak aby końcowe przeniesienie danych obejmowało uzgodniony stan treści.
- Przełączenie publikacji: wykonanie zatwierdzonych zmian DNS lub routingu i potwierdzenie dostępu przez rzeczywisty adres użytkownika.
- Decyzja o udostępnieniu zapisów: dopiero po krótkiej kontroli działania ścieżki produkcyjnej i potwierdzeniu gotowości przez odpowiedzialne osoby.
- Komunikat o zakończeniu: wskazanie dostępnego środowiska, ewentualnych ograniczeń oraz zasad zgłaszania usterek.
Rollback: warunki powrotu i ochrona nowych danych
Plan wycofania przełączenia musi być gotowy przed rozpoczęciem prac. Powinien zawierać mierzalne przesłanki uruchomienia rollbacku, termin podjęcia decyzji, odpowiedzialności oraz procedurę przywrócenia poprzedniej ścieżki dostępu. Samo cofnięcie DNS nie zapewnia natychmiastowego powrotu wszystkich klientów, dlatego plan musi uwzględniać pamięć podręczną i istniejące połączenia.
Najważniejszą granicą jest rozpoczęcie zapisów w nowym środowisku. Od tego momentu prosty powrót do źródła grozi utratą dostępu do nowych lub zmienionych treści. Konieczne jest określenie sposobu zabezpieczenia tych zmian i ich późniejszego uzgodnienia. Nie należy zakładać możliwości podłączenia baz zaktualizowanych przez SharePoint Server SE do starszej farmy. Bezpieczny rollback opiera się na zachowanym, spójnym stanie źródła lub sprawdzonej procedurze odtworzenia, a nie na odwróceniu aktualizacji baz. Stare środowisko warto wycofać dopiero po formalnym potwierdzeniu stabilności nowej produkcji i zamknięciu uzgodnionego okresu obserwacji.
Troubleshooting po migracji: najczęstsze problemy, metody diagnozy, metryki do monitorowania i stabilizacja środowiska
Po migracji do SharePoint Server Subscription Edition (SE) część problemów ujawnia się dopiero podczas rzeczywistej pracy użytkowników: przy równoczesnym otwieraniu dokumentów, wykonywaniu operacji na dużych listach czy uruchamianiu procesów biznesowych. Celem troubleshootingu jest nie tylko przywrócenie działania, lecz także ustalenie przyczyny i potwierdzenie, że usterka nie powraca. Stabilizacja oznacza przewidywalne działanie środowiska pod reprezentatywnym obciążeniem, a nie sam brak zgłoszeń bezpośrednio po migracji.
Najczęstsze problemy — jak rozróżnić objaw od przyczyny
Podobne objawy mogą mieć różne źródła. Wolne otwieranie witryn nie musi oznaczać niedostatecznej wydajności serwerów SharePoint: przyczyną może być opóźnienie po stronie SQL Server, zależność od zewnętrznej usługi albo kosztowny element niestandardowy. Z kolei błąd występujący tylko u części użytkowników sugeruje inny kierunek analizy niż niedostępność tej samej funkcji dla całej organizacji.
W pierwszej kolejności warto rozróżnić trzy sytuacje: problem stały, problem pojawiający się pod obciążeniem oraz problem okresowy. Stały błąd konkretnej operacji ułatwia odtworzenie usterki. Pogorszenie działania wraz ze wzrostem liczby użytkowników wskazuje na potrzebę analizy wydajności i zależności. Zdarzenia okresowe wymagają sprawdzenia ich zbieżności z zadaniami w tle, kopiami zapasowymi lub innymi operacjami utrzymaniowymi — sama zbieżność czasowa nie potwierdza jednak przyczyny.
Po migracji mogą również wystąpić przejściowo dłuższe czasy odpowiedzi związane z inicjalizacją aplikacji i zapełnianiem pamięci podręcznych. Nie należy automatycznie uznawać utrzymującej się powolności za normalny etap stabilizacji. Taka ocena wymaga obserwacji trendu oraz potwierdzenia, że wydajność rzeczywiście się poprawia.
Metoda diagnozy: zawężanie zakresu i jedna zmiana naraz
Każde zgłoszenie powinno zawierać opis operacji, czas wystąpienia, adres zasobu, komunikat błędu oraz informację, czy problem jest powtarzalny. Jeśli dostępny jest identyfikator korelacji, warto dołączyć go do zgłoszenia. Następnie należy ustalić skalę: pojedynczy dokument, witryna, aplikacja internetowa czy cała farma; jeden użytkownik czy określona grupa.
Diagnozę przyspieszają porównania kontrolowane: ta sama operacja na innym zasobie, wykonana przez innego użytkownika lub przeprowadzona poza godzinami szczytu. Każde porównanie powinno sprawdzać konkretną hipotezę. Przykładowo poprawne działanie standardowej strony przy błędzie strony z elementem niestandardowym uzasadnia sprawdzenie tego elementu, ale jeszcze nie przesądza o jego winie.
Zmiany naprawcze należy wprowadzać pojedynczo, zapisując ich zakres, czas oraz wynik ponownego testu. Restart może doraźnie przywrócić usługę, lecz nie jest dowodem usunięcia przyczyny. Jeśli sytuacja na to pozwala, przed restartem trzeba zabezpieczyć dane diagnostyczne. Należy też unikać podnoszenia limitów lub progów wyłącznie po to, aby ukryć objaw — może to zwiększyć obciążenie pozostałych komponentów.
Takie podejście wymaga konsekwencji w testowaniu hipotez i dobrej współpracy osób odpowiedzialnych za poszczególne komponenty środowiska. W Cognity uczymy, jak skutecznie radzić sobie z podobnymi wyzwaniami — zarówno indywidualnie, jak i zespołowo.
Metryki, które pomagają ocenić stabilność
Monitoring powinien łączyć perspektywę użytkownika ze stanem infrastruktury. Najbardziej użyteczne są:
- Czasy odpowiedzi kluczowych operacji — obserwowane razem z liczbą żądań; oprócz średniej warto śledzić percentyle, np. p95, aby zauważyć wolniejsze żądania niewidoczne w średniej.
- Odsetek błędów i przekroczeń czasu oczekiwania — z rozróżnieniem operacji oraz komponentów, których dotyczą.
- Wykorzystanie CPU, pamięci i opóźnienia operacji dyskowych — na serwerach SharePoint i SQL Server, analizowane w tym samym przedziale czasowym.
- Blokowanie w SQL Server oraz czas wykonania zadań w tle — szczególnie gdy towarzyszą pogorszeniu działania funkcji dostępnych użytkownikom.
- Liczba nowych i powracających incydentów — z uwzględnieniem ich wpływu na pracę, a nie tylko łącznej liczby zgłoszeń.
Nie istnieje jeden uniwersalny zestaw wartości alarmowych dla każdej farmy. Progi należy odnosić do uzgodnionych wymagań, charakterystyki obciążenia i pomiarów bazowych. Porównanie ma sens wtedy, gdy obejmuje podobne operacje, wolumen danych i poziom ruchu.
Kiedy można zakończyć stabilizację
Okres wzmożonego nadzoru powinien objąć reprezentatywny cykl pracy, w tym godziny szczytu i istotne zadania okresowe. Warunkiem zakończenia stabilizacji jest usunięcie incydentów krytycznych, potwierdzenie skuteczności poprawek oraz brak nieakceptowalnego pogarszania się metryk. Pozostałe znane problemy powinny mieć właściciela, ocenę wpływu i uzgodniony plan działania. Dokumentacja przyczyn, zmian i wyników obserwacji pozwala przekazać środowisko do bieżącego utrzymania bez utraty wiedzy zdobytej podczas migracji.
Najczęściej zadawane pytania i odpowiedzi odnośnie Testowanie i rozwiązywanie problemów po migracji
Poprawność przeniesienia danych należy potwierdzić przez porównanie zawartości ze stanem źródłowym z uzgodnionego momentu, a nie tylko przez zliczenie elementów. Kontrola powinna obejmować:
- obecność dokumentów, elementów list i załączników;
- wartości metadanych oraz typy zawartości;
- historię wersji w zakresie objętym migracją;
- możliwość otwierania, edytowania i zapisywania treści.
Każdą rozbieżność trzeba odnieść do zatwierdzonych wyłączeń i zmian wprowadzonych w źródle po wykonaniu inwentaryzacji.
Poprawne logowanie potwierdza tożsamość użytkownika, ale nie gwarantuje prawidłowego powiązania konta z uprawnieniami do dokumentów. Po migracji trzeba sprawdzić identyfikację konta w modelu claims, członkostwo w grupach oraz dziedziczenie uprawnień. Szczególnej uwagi wymagają zmiany domeny lub dostawcy tożsamości. Test należy wykonać na zwykłym koncie użytkownika, ponieważ konto administratora może ukryć problem. Nie należy zastępować diagnozy masowym nadawaniem dostępu.
Dokumenty mogą nie pojawiać się w wynikach, ponieważ przeniesienie baz zawartości nie przenosi automatycznie gotowego indeksu wyszukiwania. Przy nowej aplikacji usługi wyszukiwania trzeba przeprowadzić przeszukiwanie i poczekać na przetworzenie treści. Jeżeli dokumentów nadal brakuje, należy sprawdzić źródła zawartości, stan komponentów oraz błędy przeszukiwania. Problemy z wyszukiwaniem według metadanych wymagają również kontroli właściwości zarządzanych i ich mapowań.
Workflow należy przetestować od uruchomienia do zakończenia procesu, sprawdzając zadania, decyzje uczestników i zapis wyników. Sam start obiegu nie potwierdza poprawnego działania silnika ani integracji. Test powinien objąć powiadomienia, wywołania usług zewnętrznych i wznowienie po oczekiwaniu, jeśli występują. Osobno trzeba zweryfikować instancje rozpoczęte przed migracją. Ponowne uruchamianie procesów produkcyjnych bez kontroli może utworzyć podwójne zadania lub operacje.
Correlation ID pozwala odnaleźć w logach ULS wpisy dotyczące konkretnej operacji, ale sam nie opisuje przyczyny błędu. Diagnostykę najlepiej przeprowadzić w następującej kolejności:
- zapisz identyfikator, czas ze strefą czasową, adres URL i wykonywaną czynność;
- zbierz powiązane wpisy z serwerów farmy, korzystając z Merge-SPLogFile;
- przeanalizuj komunikaty poprzedzające końcowy wyjątek;
- porównaj je z odpowiednimi zdarzeniami IIS, systemu lub SQL Server.
Przy spadku wydajności trzeba zestawić czasy odpowiedzi z obciążeniem SharePoint, SQL Server oraz używanych usług zewnętrznych. Porównuj te same operacje w podobnych warunkach, uwzględniając percentyl p95, błędy, wykorzystanie CPU i pamięci, opóźnienia dyskowe oraz blokowanie w SQL. Sprawdź także zbieżność spowolnień z zadaniami w tle. Utrzymującej się powolności nie należy tłumaczyć wyłącznie zapełnianiem pamięci podręcznych bez potwierdzenia poprawy w pomiarach.
Powrót jest możliwy w ramach przygotowanego planu rollbacku, ale po rozpoczęciu zapisów w nowej farmie wymaga zabezpieczenia nowych i zmienionych danych. Samo cofnięcie DNS nie zapewnia natychmiastowego powrotu wszystkich użytkowników ani spójności treści. Procedura powinna opierać się na zachowanym stanie źródła lub sprawdzonym odtworzeniu. Nie należy zakładać możliwości podłączenia baz zaktualizowanych przez SharePoint Server SE do starszej farmy.
Stabilizację można zakończyć po usunięciu incydentów krytycznych, potwierdzeniu skuteczności poprawek i spełnieniu uzgodnionych kryteriów działania środowiska. Obserwacja powinna objąć reprezentatywny cykl pracy, w tym godziny szczytu i istotne zadania okresowe. Sam brak zgłoszeń tuż po migracji nie wystarcza. Pozostałe usterki muszą mieć ocenę wpływu, właściciela i zaakceptowany plan działania, a wyniki testów oraz dokumentacja zmian powinny trafić do zespołu utrzymania.