Polecenie "add"

Polecenie to pozwala utworzyć nowy serwis określonego typu. Obecnie pozwala na tworzenie serwisów SOWA1, SOWA2, 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:

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.

Dodawanie serwisu SIP2

Moduł SIP2 (zob. /wiki/spaces/SOWA2/pages/296186), 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. /wiki/spaces/SOWA2/pages/296167).