Polecenie "stop"

Polecenie służy do zatrzymywania serwisów. Serwisy te muszą być zarejestrowane, czyli utworzone lokalnie (zob. polecenie add) lub zeskanowane z istniejącej wcześniej instalacji (zob. polecenia migrate i scan).

Za wyjątkiem serwisów z grupy z3950 oraz sowasql - nie ma znaczenia, czy serwisy te zostały wcześniej uruchomione poleceniem start, ręcznie czy przez wywołania systemowe (np. start usługi Windows).

Składnia

sowizor stop <grupa:sid> [--force] [--kill]
sowizor stop all [--force] 
sowizor stop sowizor

Zatrzymywanie wybranych serwisów

Pozwala to na zatrzymywanie całej grupy serwisów, albo tylko serwisu o konkretnym identyfikatorze (sid). Dopuszcza się podanie samej nazwy grupy, samego identyfikatora serwisu albo kombinacji grupa:sid. Jedyny wyjątek stanowią serwisy Z39.50, które (z uwagi na technologię tej usługi) są zatrzymywane tylko grupowo. Jako grupa może wystąpić jedna z nazw: sowa1, sowa2, sowasql, rozpr lub z3950.

W przypadku serwisów z grup sowa1 oraz sowa2 dodatkowo sprawdzany jest aktualny stan zalogowanych sesji użytkowników (sesje anonimowe są pomijane). Jeśli podczas próby zatrzymania serwisu są zalogowane sesje (pracujący użytkownicy), wówczas serwis ten nie zostanie zatrzymany. Aby wymusić zatrzymanie serwisu, do którego są zalogowani użytkownicy, należy podać opcjonalny argument --force. Dotyczy to zarówno przypadku zatrzymywania konkretnego serwisu, jak i całej grupy.

Dla serwisów typu sowasql dodatkowo jest dostępny argument --kill - powoduje on bezwarunkowe zatrzymanie procesu serwera aplikacji.

sowizor stop sowasql
sowizor stop sowa2:kalisz_mbp_ks
sowizor stop kalisz_mbp_ks --force

Dwa ostatnie przykłady dotyczą tego samego serwisu (bowiem identyfikator sid musi być unikalny w ramach instalacji), przy czym pierwszy z nich - w przypadku stwierdzenia zalogowanych sesji - nie zatrzyma serwisu, drugi natomiast wymusi jego zatrzymanie.

Zatrzymywanie wszystkich serwisów

Parametr all służy do zamknięcia wszystkich aktualnie uruchomionych serwisów. Przy czym - w przypadku gdy istnieją serwisy z grup sowa1 lub sowa2 - dodatkowo sprawdzany jest aktualny stan zalogowanych sesji użytkowników. Serwisy, w których są zalogowani użytkownicy nie zostaną zatrzymane. Aby to pominąć, należy dodać opcjonalny argument --force.

Dodatkowo polecenie to zatrzymuje usługę sowizora.

Zatrzymywanie usługi sowizor

Z reguły usługa sowizor powinna być uruchomiona zawsze (z wyjątkiem aktualizacji pakietu sowizor, kiedy to jest ona automatycznie zatrzymywana). Jeśli z jakiegoś powodu wymagane jest jej czasowe zatrzymanie, należy uruchomić polecenie stop z parametrem sowizor.