Polecenie "set"

Polecenie to służy do zmiany ustawień serwisów.

Składnia

sowizor set <sid> <attribute> <value>

Jako <attribute> należy podać nazwę atrybutu ustawień serwisu. W większości przypadków - a zwłaszcza w przypadku atrybutu port - serwis należy wcześniej wyłączyć (zob. polecenie stop).

Zmiana numeru portu

(dostępne dla serwisów SOWA1, SOWA2 i SOWASQL)

Pozwala to na zmianę numeru portu TCP, na którym nasłuchuje serwer aplikacji.

Przykład zmiany portu serwisu krakow_kbp_ks

sowizor set krakow_kbp_ks port 45900

Dostępność portu na firewallu

W przypadku instalacji, dla których sowizor odpowiada m. in. za generowanie reguł firewalla (iptables), ustawieniem tym można określić, czy dany serwis jest przez firewall dostępny z zewnątrz, czy nie. Atrybut ten musi być wyrażony jako wartość logiczna - można użyć wartości 0, 1 lub tekstowego określnika (w języku polskim lub angielskim). Np. true, yes, nie, N.

Przykład udostępnienia przez firewall serwisu krakow_kbp_ks

sowizor set krakow_kbp_ks fw 1

Priorytet procesu

W przypadku systemu Linux - można tym ustawieniem zmienić domyślny priorytet dla procesu (np. priorytet dla procesu serwera Z3950 może być mniejszy od innych serwisów). Wartość atrybutu wyrażona jest liczbą z przedziału 0 do 19, gdzie 0 oznacza priorytet najwyższy, zaś 19 priorytet najniższy.

Przykład ustawienia najniższego priorytetu dla serwisu krakow_kbp_z3950

sowizor set krakow_kbp_z3950 priority 19

Metoda archiwizacji bazy danych

Dla serwisów posiadających własną bazę danych - w szczególności dla serwisów serwerów aplikacji SOWA1, SOWA2 i SOWASQL - można określić okresy, w jakich wykonywane są kopie zapasowa bazy danych oraz zbioru plików multimedialnych.

Atrybut wyrażany jest za pomocą dwóch znaków, z których pierwszy definiuje częstotliwość kopii bazy danych, drugi zaś częstotliwość kopii plików multimedialnych.

znak	opis
D	kopie wykonywane codziennie (w nocy)
W	kopie wykonywane w cyklach tygodniowych (w niedzielę)
M	kopie wykonywane w cyklach miesięcznych (1go dnia miesiąca)
0	kopie nie są wykonywane

Przykład ustawienia archiwizacji codziennej baz i mieisęcznej multimediów dla serwisu krakow_kbp_ks

sowizor set krakow_kbp_ks arch DM

Atrybuty połączenia z bazą PostgreSQL

W przypadku serwisów SOWASQL przechowywane są ustawienia dotyczące lokalizacji i sposobu łączenia się z serwerem bazy danych PostgreSQL.

atrybut	opis
db_host	adres hosta do połączeń z bazą danych (np. 127.0.0.1)
db_port	numer portu - domyślnie to 5432
db_pg	adres i port połączenia do PostgreSQL, gdy db_host i db_port wskazują np. na PgBouncera. Parametr ten winien mieć wówczas postać: host:port
db_name	nazwa bazy danych
db_user	nazwa użytkownika bazy danych
db_pass	hasło dostępowe (zob. uwagi)

W przypadku ustawiania hasła należy je podać w postaci zaszyfrowanej (w kodowaniu numerycznym). Aby ustawić zupełnie nowe hasło należy podać wartość "new" - wówczas program poprosi o podanie nowego hasła, zaszyfruje je i zapisze do konfiguracji.

Przykłady ustawiania atrybutów dostępu do PostgreSQL

sowizor set krakow_kbp_ks db_host 192.168.100.100
sowizor set krakow_kbp_ks db_pass 445100144364610016412451001547445100144333190913444100
sowizor set krakow_kbp_ks db_pass new