Polecenie "list"

Polecenie służy do przeglądania i filtrowania listy dostępnych serwisów. Zwłaszcza w przypadku dużej liczby serwisów możliwość filtrowania jest szczególnie przydatna.

Sprawdzany jest także status uruchomienia poszczególnych serwisów - dla serwisów uruchomionych wyświetlany jest numer procesu (pid). Specjalny, opcjonalny atrybut --users dodatkowo pozwala wyświetlić liczbę zalogowanych sesji  w poszczególnych serwisach.

Składnia

sowizor list [filtr1 [filtr2 [...]]] [--users] [--count]
sowizor list <sid> [--users]

Prezentacja listy

Lista prezentowana jest w postaci tabelarycznej. Kolejne kolumny tabeli mają następujące znaczenie:

1. opts - opcje serwisu wyrażone w postaci dwóch znaków. Pierwszy znak określa status automatycznego startu usługi. Usługi oznaczone znakiem + (plus) są automatycznie uruchamiane przy starcie systemu, zaś znakiem - (minus) nie są uruchamiane. Drugi znak natomiast określa, czy konfiguracja serwisu jest nadzorowana przez sowizora. Znak - (minus) oznacza, że jest to ręcznie konfigurowany serwis, znak + (plus) oznacza serwis, którego konfiguracja jest dynamicznie generowana, natomiast znak ! (wykrzyknik) - to serwis, który był generowany dynamicznie, ale wprowadzono do jego konfiguracji modyfikacje, przez co niedostępny jest proces automatycznej aktualizacji jego konfiguracji.
2. lic - numer licencji klienta
3. name (sid) - nazwa, czyli identyfikator serwisu (tzw. sid). Nazwa musi być unikalna w obrębie danej instalacji.
4. port - każdy serwis związany jest z portem TCP, na którym nasłuchuje na połączenia
5. cid/tid - to nazwa typu katalogu (w przypadku katalogów bibliotecznych) lub nazwa celu (w przypadku serwisów Z39.50). W dużym skrócie - oznacza to szablon konfiguracyjny danego serwisu i dotyczy tylko serwisów, których konfiguracją zarządza sowizor.

Opcjonalnie - jako dalsze kolumny (już bez oznaczeń w nagłówku) wyświetla się:

• liczba zalogowanych użytkowników (ujęta w nawiasy, tylko w razie podania opcji --users)
• numer procesu pid (ujęty w nawiasy kwadratowe, tylko jeśli serwis jest uruchomiony)
• czas od momentu uruchomienia serwisu

Filtrowanie listy

Jeśli lista katalogów jest długa, można podać jako kolejne parametry polecenia słowa, które zostaną użyte w charakterze filtrów. Oto dostępne rodzaje filtrów:

Filtry można dowolnie ze sobą łączyć, aby uzyskać precyzyjne wyniki:

sowizor list sowa2 enabled konin

Powyższa komenda pozwala wyświetlić listę wszystkich włączonych (enabled) serwisów typu SOWA2, które zawierają w nazwie słowo "konin".

Zliczanie listy serwisów

Podanie opcjonalnego atrybutu --count pozwala na zliczanie serwisów pasujących do zadanego filtru. Jest to szczególnie praktyczne przy tworzeniu skryptów wsadowych. Polecenie zamiast listy serwisów wyświetli po prostu liczbę dopasowanych do filtru serwisów.

sowizor list enabled stopped --count

Wyświetlanie ustawień serwisu

Jeśli jako jedyny parametr polecenia podana zostanie pełna nazwa serwisu (sid), wyświetlona zostanie lista ustawień dla tego konkretnego serwisu. Każdy serwis posiada listę ustawień podstawowych oraz ustawień dodatkowych (extra), zależnych od typu serwisu.

Ustawienia podstawowe:

• sid - identyfikator (nazwa) serwisu
• type - typ serwisu
• cid - identyfikator szablonu konfiguracyjnego
• lic - numer licencji
• fw - ustawienia dostępności na firewall (1 - dostępny z zewnątrz, 0 - niedostępny)
• prior - priorytet serwisu w skalli od 0 do 19 (gdzie 0 to priorytet najwyższy)
• start - określa czy autostart serwisu jest włączony (enabled) czy wyłączony (disabled)
• arch - schemat archiwizacji bazy danych i ew. załączników multimedialnych danego serwisu (D - dzienny, W - tygodniowy, M - miesięczny)
• insp - czy serwis podlega inspekcji, a jeśli tak, to czy wykryta została ingerencja w pliki konfiguracyjne

Ustawienia dodatkowe (serwisy typu sowa1, sowa2, sowasql):

• records - lista typów rekordów instalowanych dla danego serwisu
• sendlog - określa, czy baza serwisu podlega zdalnej archiwizacji

Ustawienia dodatkowe (serwisy typu sowasql):

• db_host - adres serwera SQL
• db_port - port serwera SQL
• db_name - nazwa bazy danych
• db_user - nazwa użytkownika bazy danych
• db_pass - hasło użytkownika bazy danych (zaszyfrowane)

Ustawienia dodatkowe (serwisy typu z3950):

• ip - adres serwera aplikacji systemu SOWA (cel serwisu)
• port - port serwera aplikacji systemu SOWA