Polecenie "add"
Polecenie to pozwala utworzyć nowy serwis określonego typu. Obecnie pozwala na tworzenie serwisów SOWA1 lub SOWA2, a dodatkowo (w systemie Linux) na tworzenie serwisów SOWASQL, Z39.50, ZED, ASIO, WSIO, SIP2 oraz OAI-PMH.
Składnia
sowizor add sowa1|sowa2|sowasql|zed|asio|wsio|sip2|sowaipmh [<source-sid>] [--licence <path>] sowizor add z3950 [<target>]
Dodawanie serwisu SOWA1, SOWA2 lub SOWASQL
Podanie parametru sowa1, sowa2 lub sowasql pozwala na utworzenie nowego serwisu (odpowiednio SOWA1, SOWA2 i SOWASQL) na podstawie szablonu konfiguracyjnego zawartego w pakiecie server-sowaX-cfg.
Konwencją nazewnictwa serwisów tego typu jest łączenie prefiksu nazwy (zbudowanego zwykle od nazwy biblioteki i wspólnego dla wszystkich serwisów lokalnych) z sufiksem charakteryzującym katalog. Np.:
krakow_kbp_ks - prefiksem jest krakow_kbp (od Kraków KBP), zaś sufiksem ks (od księgozbiór) - połączone znakiem _ tworzą razem identyfikator serwisu (sid).
Program w pierwszej kolejności wyświetli listę aktualnie zainstalowanych serwisów SOWA1, SOWA2 lub SOWASQL. Dodanie serwisu wymaga odpowiedzi na szereg pytań zadanych w oknie terminala:
- Prefiks nazwy - jeśli są już inne serwisy ze wspólnym prefiksem, program zaproponuje taki sam
- [sowa2/sowasql] Jeśli serwis został wcześniej zadeklarowany w CRM - zaproponuje autoinstalację jednego z nich
- [sowa2/sowasql] Wybór schematu katalogu (zob. dalej) i opcjonalnych typów rekordów
- Nazwa katalogu - dotyczy nazwy prezentowanej np. w menu klienta
- Sufiks nazwy - program próbuje podpowiedzieć sufiks na podstawie typu i nazwy serwisu. Zwykle podaje się 2 lub 3 znaki sufiksu.
- [tylko na Windows] Nazwa serwisu Windows - należy podać nazwę serwisu Windows, pod którą będzie zainstalowany i uruchamiany serwer aplikacji SOWY
- Numer portu dla serwisu
- [sowasql] Adres i port serwera baz danych, nazwa i hasło użytkownika oraz nazwa bazy danych SQL.
Program utworzy pustą bazę danych, szablonową konfigurację i poprosi o ustawienie hasła dla użytkownika SOKRATES (administracyjny). Następnie zainstaluje i uruchomi serwis.
Schematy katalogu SOWA2 / SOWASQL
Serwis SOWA2 może być domyślnie skonfigurowany jako katalog biblioteczny określonego przeznaczenia. Schemat taki decyduje o zakresie standardowo skonfigurowanych formatów, zestawień, typów dokumentów etc. Obecnie dostępne są schematy:
| nazwa | grupa | opis | typy rekordów | serwery |
|---|---|---|---|---|
| marc21 | usmarc | Katalog księgozbioru MARC-21 | U, A, C, X, Y, (K) | sowa2, sowasql |
| marc21-akc | usmarc | Katalog księgozbioru MARC-21 z akcesją | U, A, C, F, X, Y, (D, E, K, V) | sowa2, sowasql |
| marc21-bib | usmarc | Bibliografia Regionalna MARC-21 | U, A, B, C | sowa2, sowasql |
| marc21-cz | usmarc | Katalog czasopism MARC21 | U, A, C, D, N, P, R, W, Z | sowa2, sowasql |
| marc21-zasob | usmarc | Katalog MARC-21 z zasobami czasopism | U, A, C, X, Y, Z, (K) | sowa2, sowasql |
| marc21-akc-zasob | usmarc | Katalog MARC-21 z akcesją i zasobami czasopism | U, A, C, F, X, Y, Z, (D, E, K, V) | sowa2 |
| marc21-zeszyt | usmarc | Katalog MARC-21 z zeszytami czasopism | U, A, C, N, X, Y, (K) | sowa2 |
| marc21-zz | usmarc | Katalog MARC-21 z zasobami i zeszytami czasopism | U, A, C, N, X, Y, Z, (K) | sowa2 |
| marc21-all | usmarc | Katalog MARC-21 (książki + czasopisma) | U, A, C, D, N, P, R, W, X, Y, Z, (D, K) | sowa2, sowasql |
| marc21-akc-all | usmarc | Katalog MARC-21 z akcesją (książki + czasopisma) | U, A, C, D, F, N, P, R, W, X, Y, Z, (D, E, K, V) | sowa2, sowasql |
| text | text | Bibliografia Regionalna (format TEXT) | T, 1, 2, 3, 4, 6, 7 | sowa2 |
| dzs | text | Dokumenty Życia Społecznego (format TEXT) | T, 1, 2, 3, 6, 7 | sowa2 |
| zagadnie | text | Kartoteka Zagadnieniowa (TEXT) | T, 2, 3, 4, 6 | sowa2 |
Ponadto są zdefiniowane schematy służące do aktualizacji starych instalacji katalogów, które nie powinny być używane w poleceniu add (marc21-gro, marc21-kra i pocztowki).
Niektóre schematy posiadają opcjonalne typy dokumentów (rekordów) - w powyższej tabeli są one ujęte w nawiasy. Przy tworzeniu takiego katalogu program dodatkowo zapyta o listę opcjonalnych typów dokumentów, które mają zostać wykorzystane.
Ustawianie licencji
Domyślnie każdy serwis instalowany jest przy użyciu licencji głównej, która jest skonfigurowana w sowizorze. Może jednak zajść konieczność instalacji serwisu przy użyciu innej licencji niż główna. Plik licencji należy umieścić w dowolnej ścieżce na dysku i utworzyć serwis podając opcję --licence ze ścieżką jako parametr.
sowizor add sowa2 --licence /path/to/file/sokrates.lic
Tworzenie serwisu na bazie istniejącego
W przypadku tworzenia serwisu SOWA2 lub SOWASQL można wybrać istniejący serwis źródłowy. Wówczas nowy serwis zostanie utworzony na bazie konfiguracji wskazanego serwisu. Jest to szczególnie przydatne przy przenoszeniu systemu SOWA2 na system SOWASQL.
Istnieją pewne ograniczenia:
- serwis źródłowy musi być zarządzany przez sowizora (zob. migrate)
- serwis SOWA2 nie może być utworzony na bazie serwisu SOWASQL
- w przypadku przejścia serwisu SOWA2 na SOWASQL niektóre ustawienia nie są przenoszone, gdyż systemy te nie są w pełni kompatybilne. Dlatego po tej operacji należy zweryfikować konfigurację SOWASQL.
Dodawanie serwisu Z39.50
Parametr z3950 pozwala na utworzenie serwisu Z39.50, dla którego docelowym źródłem przeszukiwania danych jest albo istniejący serwis SOWA2 albo istniejący serwis SOWASQL. Docelowy serwis musi być wcześniej albo utworzony poleceniem sowizor add sowa2 - albo zarejestrowany w CRM w firmie SOKRATES-software.
sowizor add z3950
Na podstawie typu docelowego serwisu program przeprowadzi automatyczną walidację konfiguracji serwisu SOWA2 lub SOWASQL, a następnie wygeneruje serwis Z39.50 służący do przeszukiwania baz katalogów bibliotecznych przez protokół Z3950.
Dodawanie serwisu WSIO
Moduł WSIO (zob. /wiki/spaces/SOWAALL/pages/688134), aby mógł być automatycznie uruchamiany i zatrzymywany przez sowizora, musi zostać także zarejestrowany jako serwis.
sowizor add wsio
Polecenie w pierwszej kolejności weryfikuje, czy szablony SOWA-NG są już skonfigurowane dla usługi WSIO (w szczególności, czy określony został port usługi). Jeśli nie - automatycznie uruchomiona zostanie konfiguracja szablonów.
W kolejnych krokach program zapyta o:
- serwis SOWY, który będzie integrowany (trzeba wskazać jego numer)
- nazwę użytkownika w serwisie SOWA, który posiada uprawnienia do wykonywania operacji integrujących (zwykle jest to specjalny użytkownik "integrator")
- hasło tego użytkownika
Od tego momentu będzie można uruchamiać (i zatrzymywać) usługę WSIO za pomocą sowizora.
Dopuszczalne jest utworzenie tylko jednego serwisu WSIO w ramach instalacji!
Dodawanie serwisu SIP2
Moduł SIP2 (zob. bramka protokołu SIP2), po wykonaniu konfiguracji samego modułu, musi zostać zarejestrowany jako serwis, dla celów jego automatycznego uruchamiania i zatrzymywania.
sowizor add sip2
Polecenie to automatycznie rejestruje serwis SIP2 na podstawie jego bieżącej konfiguracji. (zob. konfigurowanie SIP2).