Problemy sieciowe w Gratyfikant nexo manifestują się najczęściej jako błąd połączenia z nexo.Serwis przy próbie uruchomienia aplikacji klienckiej. Komunikaty takie jak „Nie można połączyć się z serwerem", „Przekroczono limit czasu połączenia" lub „Odmowa połączenia" wskazują na przerwę w komunikacji między klientem a usługą nexo.Serwis. Diagnostyka wymaga metodycznego sprawdzenia każdego ogniwa łańcucha: od statusu usługi, przez sieć, aż po konfigurację zapory.
Sprawdzenie statusu usługi nexo.Serwis
Pierwszym krokiem diagnostycznym jest weryfikacja, czy usługa nexo.Serwis faktycznie działa na serwerze. Na serwerze (lub przez zdalne połączenie) uruchom:
sc query nexoSerwis
lub sprawdź w Usługi Windows (services.msc). Jeśli usługa jest zatrzymana, sprawdź dziennik zdarzeń: Podgląd zdarzeń → Dzienniki aplikacji i usług → nexo.Serwis. Najczęstsze przyczyny nieuruchomienia usługi to: błąd połączenia z SQL Server (nieprawidłowy connection string lub niedostępna instancja SQL), brakujący .NET Runtime w wymaganej wersji, uszkodzone pliki konfiguracyjne lub brak uprawnień konta usługi do plików danych.
Test połączenia sieciowego do nexo.Serwis
Ze stacji klienckiej należy sprawdzić dostępność portu nexo.Serwis (domyślnie 25487). W PowerShell:
Test-NetConnection -ComputerName ADRES_SERWERA -Port 25487
Wynik TcpTestSucceeded : True oznacza, że port jest osiągalny. Wynik False wskazuje na problem sieciowy lub zablokowanie przez zaporę. Dodatkowo sprawdź:
- Czy serwer odpowiada na ping:
ping ADRES_SERWERA - Czy zapora Windows na serwerze nie blokuje portu 25487 – sprawdź reguły w Zapora Windows Defender → Reguły dla ruchu przychodzącego.
- Czy zapory sieciowe (UTM, router) nie blokują ruchu na tym porcie.
Diagnostyka SQL Server – problemy po stronie bazy danych
Jeśli nexo.Serwis uruchamia się, ale klienci zgłaszają błędy sesji lub wolne działanie, problem może leżeć w komunikacji nexo.Serwis z SQL Server. Sprawdź dostępność SQL Server:
sqlcmd -S NAZWA_SERWERA\INSTANCJA -U nexo_user -P haslo -Q "SELECT @@VERSION"
W przypadku błędu „Named Pipes Provider" lub „TCP Provider" sprawdź, czy protokół TCP/IP jest włączony w SQL Server Configuration Manager i czy SQL Server Browser działa (wymagany dla instancji nazwanych). Sprawdź też, czy konto usługi nexo.Serwis ma dostęp do instancji SQL Server.
Problemy z certyfikatami SSL i TLS
Nowsze wersje nexo.Serwis mogą wymagać szyfrowanego połączenia z SQL Server. Jeśli po aktualizacji pojawia się błąd certyfikatu, należy sprawdzić, czy w connection stringu jest ustawiony parametr TrustServerCertificate=True (dla środowisk wewnętrznych z certyfikatem samopodpisanym) lub zainstalować właściwy certyfikat SSL na SQL Server.
Logi nexo.Serwis – kluczowe źródło informacji
Logi usługi nexo.Serwis znajdują się w %ProgramData%\Insert\nexo.Serwis\Logs\. Pliki logów zawierają szczegółowe informacje o błędach połączenia, nieudanych autoryzacjach i problemach z migracją bazy. Szukaj wpisów o poziomie ERROR lub CRITICAL – zawierają one kod błędu i opis, który pozwala precyzyjnie zidentyfikować przyczynę problemu.
