...

Sowizor wymaga interpretera Python w wersji 23.7 8 oraz (opcjonalnie) polecenia virtualenv. Ponadto konieczny jest dostęp do internetu (pobieranie danych przez HTTP i HTTPS  z portów 80 i 443).

...

Aktualnie najnowsze wydawane dystrybucje systemu Linux są już zwykle wyposażone w interpreter Python w wersji 2.7. (wyjątkiem jest Redhat/CetOS, który nadal dystrybuuje wersję 2.6)3.8. Aby to zweryfikować należy wydać polecenie:

pythonpython3 -V

...

W przypadku, gdy na serwerze znajduje się starsza wersja interpretera Python , wówczas proces instalacyjny wykonuje automatycznie kompilację ze źródeł Pythona 2.7. W tym celu wymagana jest obecność na serwerze kompilatora i pakietów developerskich kilku używanych bibliotek.

apt-get install gcc make sqlite3 libssl-dev libreadline-dev libsqlite3-dev zlib1g-dev pkg-config

yum install gcc make sqlite-devel readline-devel zlib-devel openssl-devel pkg-config

rug install gcc make sqlite-devel readline-devel zlib-devel openssl-devel pkg-config

Jeśli z jakiś względów instalacja bibliotek deweloperskich z repozytorium dystrybucji będzie niemożliwa, skrypt instalacyjny będzie próbował kompilować te biblioteki ze źródeł.

...

i nie ma możliwości jej instalacji z oficjalnych repozytoriów dystrybucji, zalecamy aktualizację lub zmianę dystrybucji systemu Linux.

Instalacja

Przed przystąpieniem do instalacji należy upewnić się, że w katalogu domowym (lub jednym z jego podkatalogów) znajduje się prawidłowy plik licencji. Zostanie on automatycznie użyty przez skrypt instalacyjny.

...

wget http://download.sokrates.pl/sovvizor.py
pythonpython3 sovvizor.py
source ~/sowang3/bin/activate

W przypadku wystąpienia błędu należy postępować zgodnie z komunikatami wyświetlanymi na ekranie. W szczególności - w przypadku, gdy skrypt próbował kompilować ze źródeł - należy upewnić się, że spełnione są wszystkie wymienione wcześniej wymagania.

Szczegółowa informacja o postępie instalacji zamieszczana jest w pliku sovvizor.log

Po instalacji zalecane jest ponowne zalogowanie się na konto użytkownika (lub ponowne wczytanie pliku ~/.bashrc).

Rozwiązywanie problemów z bibliotekami

Jeśli wymagana jest kompilacja interpretera Python ze źródeł, a nie są zainstalowane wszystkie wymagane biblioteki w wersji deweloperskiej, instalator wyświetli komunikat, w którym zasugeruje ponowne uruchomienie polecenia z opcjami wymuszającymi instalację wybranych bibliotek ze źródeł. Np. poniższe polecenie będzie wymuszało kompilowanie ze źródeł biblioteki sqlite3

python sovvizor.py --with-sqlite3

Dostępne są następujące opcje:

--verbose - włącza tryb "gadatliwy" - komunikaty zamiast do pliku logu (sovvizor.log) są wysyłane na ekran
--build - wymusza kompilację interpretera Python ze źródeł, nawet gdy w systemie jest dostępna odpowiednia jego wersja
--no-readline - wyłącza wymóg kompilacji biblioteki readline (jako efekt nie będzie dostępnego trybu interaktywnego - należy używać tylko w razie problemów z kompilacją readline)
--with-sqlite3 - wymusza kompilację ze źródeł biblioteki sqlite3
--with-ssl - wymusza kompilację ze źródeł biblioteki SSL
--with-zlib - wymusza kompilację ze źródeł biblioteki zlib
--with-readline - wymusza kompilację ze źródeł biblioteki readline
--with-ncurses - wymusza kompilację ze źródeł biblioteki ncurses (zwykle konieczne, gdy podano opcję --with-readline)

Instalacja Windows

W przypadku nowej instalacji - należy utworzyć katalog c:\sowa (może być na innym dysku) - i zamieścić w nim prawidłowy plik licencji. Będzie to jednocześnie wskazywać na docelowy folder instalacyjny dla całego systemu SOWA.

Przy pomocy dowolnej przeglądarki internetowej pobieramy plik z adresu: http://download.sokrates.pl/sovvizor.exe i go uruchamiamy.

Instalator automatycznie pobiera i instaluje wszystkie niezbędne pakiety oprogramowania.poprawnej instalacji należy ponadto wykonać poniższe polecenie:

pip install psycopg2