Powykonawcza Dokumentacja
Wykonawca: Asseco Poland S.A. Ul. Olchowa 14, 35-322 Rzeszów Informacje o dokumencie: Autor Zespół ds. Wytwarzania i Analizy Tytuł Produkt 33.3 Dokumentacja administratora OTM Projekt CSIZS Wersja 1.03 Liczba stron 9 Data utworzenia 2013-06-21 Data ost. modyfikacji 2015-01-08 Odbiorca dokumentu Ministerstwo Pracy i Polityki Społecznej Kontakt do uwag lukasz.ruszlewicz@otago.pl Nazwa pliku 2015-01-08_EMP_DOK_Produkt_33.3_v1.03 Wersja Data Wersji Autor Opis 0.10 2013-06-21 Zespół ds. Analizy Zdefiniowanie szablonu Produktu 1.01 2013-10-17 Zespół ds. Wdrożeń Uzupełnienie dokumentu 1.02 2013-12-12 OTAGO Dodanie rozdziału o instalacji programu OTM na środowisku linux 1.03 2015-01-08 OTAGO Uwzględnienie zmiany w interfejsach komunikacyjnych Strona 2 z 9
Załączniki Nazwa załącznika 1. 2. Wersja Strona 3 z 9
Spis treści: 1. WSTĘP... 5 1.1. CEL DOKUMENTU... 5 1.2. ŹRÓDŁA INFORMACJI... 5 1.3. DOKUMENTY POWIĄZANE... 5 1.4. POJĘCIA I SKRÓTY UŻYWANE W DOKUMENCIE... 5 2. INFORMACJE OGÓLE... 6 2.1. INFORMACJE OGÓLNE DLA UŻYTKOWNIKA... 6 2.2. INSTALACJA... 6 2.3. LOGOWANIE... 6 3. OPCJE DOSTĘPNE DLA ADMINISTRATORA... 6 4. OPIS ZARZĄDZANIA ZMIANAMI W INTERFEJSACH KOMUNIKACYJNYCH... 6 5. INSTALACJA SERWERA AKTUALIZACJI... 7 5.1. OPIS PROCESU INSTALACJI OPROGRAMOWANIA... 7 5.2. PROCEDURY PRODUKCYJNEGO URUCHAMIANIA I WDROŻENIA POSZCZEGÓLNYCH SKŁADOWYCH... 8 5.3. PROCEDURY POSTĘPOWANIA ZESPOŁU ADMINISTROWANIA ZESPOŁU ADMINISTRACYJNEGO ZAPEWNIAJĄCE CIĄGŁOŚĆ FUNKCJONOWANIA LUB PRZYWRÓCENIE CIĄGŁOŚCI W PRZYPADKU JEJ UTRATY... 8 6. KOPIA ZAPASOWA... 9 6.1. PROCEDURA WYKONANIA KOPII ZAPASOWEJ... 9 6.2. PROCEDURA PRZYWRACANIA Z KOPII ZAPASOWEJ... 9 Strona 4 z 9
1. Wstęp 1.1. Cel dokumentu Celem dokumentu jest przedstawienie sposobu konfiguracji konserwacji i sposobu utrzymania serwera aktualizacji OTM. 1.2. Źródła informacji Wiedza ogólna z zakresu konfiguracji serwera www typu Apache. 1.3. Dokumenty powiązane Produkt 10.5 Projekt OTM Produkt 34.3 Powykonawcza dokumentacja użytkownika OTM 1.4. Pojęcia i skróty używane w dokumencie Poniżej przedstawione zostały najważniejsze skróty i pojęcia użyte w dokumencie: Tabela 1. Pojęcia i skróty L.p. Pojęcie/Skrót Wyjaśnienie 1 Apache Serwer www umożliwiający udostępnianie plików w sieci internet. Strona 5 z 9
2. Informacje ogóle 2.1. Informacje ogólne dla użytkownika Ogólny opis aplikacji OTM zawiera rozdział 2 produktu 34.3. 2.2. Instalacja Opis procesu instalacji programu zawiera rozdział 3 produktu 34.3. Natomiast proces rejestracji programu niezbędny do przeprowadzenia by możliwa była codzienna praca na programie zawiera podrozdział 5.3 produktu 34.3 2.3. Logowanie Zasady logowania do programu OTM opisuje podrozdział 4.2 produktu 34.3. 3. Opcje dostępne dla administratora Wszystkie opcje dostępne w programie OTM opisane są produkcie 34.3 wraz ze wskazaniem potrzebnych uprawnień do ich wykonania. 4. Opis zarządzania zmianami w interfejsach komunikacyjnych Aplikacja lokalna OTM instalowana na urządzeniach zwanych Terminalami Mobilnymi wykorzystuje następujące interfejsy (webservice y): - Konto Webservice udostępniany przez PI będąca składową CSIZS. Zadaniem tej usługi jest wymienianie danych pomiędzy MZT a OTM danych o kontach użytkowników. Struktura tego webservice u jest definiowana przez architekta MZT. - Terminal Webservice udostępniany przez PI będąca składową CSIZS. Zadaniem tej usługi jest wymienianie danych pomiędzy MZT a OTM danych o kontach terminali mobilnych. Struktura tego webservice u jest definiowana przez architekta MZT. - Uzytkownik Webservice udostępniany przez PI będącą składową CSIZS. Zadaniem tej usługi jest wymienianie danych pomiędzy MZT a OTM danych o listach jednostek przypisanych do konta administratora. Struktura tego webservice u jest definiowana przez architekta MZT. - OTM-SD Webservice udostępniany przez System Dziedzinowy, z którym łączy się OTM w celu wymiany danych o wywiadach środowiskowych. Struktura tego webservice u jest definiowana przez architekta programu OTM. Strona 6 z 9
Przebieg zmiany webserviców Konto, Terminal i Uzytkownik: Odnotowanie potrzeby zmiany przez architekta MZT Wprowadzenie zmian do webservice u Przekazanie zmian do zespołu wytwarzającego OTM wraz z logiem zmian Implementacja nowej postaci webservice u na środowisku testowym Implementacja zmian w OTM Testy integracyjne próbnej wersji OTM ze środowiskiem testowym Implementacja zmienionej wersji webservice u na środowisku produkcyjnym Publikacja aktualizacji OTM obsługującej nowa postać webservice u Przebieg wprowadzenia zmiany webservice u OTM-SD: Odnotowanie potrzeby zmiany webservice u Zmienienie webservice u Implementacja w OTM obsługi nowej postaci webservice u Publikacja nowej postaci webservice u przez Zamawiającego Udostępnienie aktualizacji programu OTM zawierającej obsługę nowej postaci webservice u 5. Instalacja serwera aktualizacji 5.1. Opis procesu instalacji oprogramowania Do uruchomienia serwera aktualizacji niezbędne jest przygotowanie dowolnego serwera http, tak aby był w stanie udostępnić katalog zawierający pliki dostarczone przez Wykonawcę (update_info.xml, paczka aplikacji, paczka formularzy). Niniejszy podrozdział opisuje sposób instalacji serwera Apache na środowisku RetHat Linux. Instalację serwera Apache inicjuje się komendą yum install httpd. Po zainstalowaniu programu należy wykonać jego inicjalne uruchomienie za pomocą komendy chkconfig httpd on. Automatyczne uruchamianie serwera po restarcie środowiska ustawia się komendą chkconfig - -levels 235 httpd on. Za ustawienia serwera odpowiadają zapisy w pliku /etc/httpd/conf/httpd.conf. Mapowanie zasobu z danego katalogu na adres publiczny odpowiadają zapisy z tagu <VirtualHost>. W definicji tagu można zawrzeć port pod którym będą udostępniane zasoby na adresach zdefiniowanych w pliku ale nie jest to obowiązkowe. Definicję udostępniania pliku update_info.xml położonego w katalogu /etc/otm/ pod adresem http://elearning.mpips.gov.pl:80/update_info.xml pokazano poniżej: Strona 7 z 9
<VirtualHost *:80> DokumentRoot /etc/otm ServerName http://elearning.mpips.gov.pl </VirtualHost> 5.2. Procedury produkcyjnego uruchamiania i wdrożenia poszczególnych składowych Działanie serwera aktualizacji OTM jest oparte o udostępnienie pliku update_info.xml zawierającego wszystkie potrzebne informacje dla funkcji aktualizacji programu OTM. Plik update_info.xml zawiera informacje o wersji programu i formularzy do której aktualizuje program, o położeniu plików aktualizujących i o podpisie tych plików. Aby utworzyć serwer aktualizacji należy w katalogu udostępnianym przez serwer do sieci publicznej internet skopiować plik update_info.xml oraz paczki z aplikacją OTM i formularzami dostarczone przez Wykonawcę. W pliku update_info.xml w tagu <downloadurl> należy wpisać adres dostępny z sieci internet, pod którym serwer Apache udostępnia pliki aktualizujące dostarczone przez Wykonawcę. W Węźle formularze należy wpisać położenie pliku formularze.zip zaś w węźle aplikacja należy wpisać adres pod którym udostępniany jest plik app.zip. Aby sprawdzić poprawność tej konfiguracji można do przeglądarki internetowej wpisać adresy z tagu <downloadurl>. Jeśli przeglądarka zacznie je pobierać to będzie oznaczać, że udostępnienie działa prawidłowo. W razie konieczności, paczki aktualizacji mogą być umieszczone na innym serwerze. W takim wypadku należy zmienić adresy w pliku update_info.xml na właściwe dla położenia plików. 5.3. Procedury postępowania zespołu administrowania zespołu administracyjnego zapewniające ciągłość funkcjonowania lub przywrócenie ciągłości w przypadku jej utraty Serwer aktualizacji jako ogólnodostępne narzędzie jakim jest serwer typu www nie wymaga szczególnych zabiegów konserwacyjnych. Utrzymywanie środowiska polega na bieżącym aktualizowaniu dystrybucji zgodnie z zaleceniami dostawcy systemu operacyjnego na którym zainstalowany jest serwer aktualizacji OTM.. Problemy z funkcjonowaniem serwera można zdiagnozować za pomocą logów systemowych np. dla serwera Apache2 umieszczone są one w katalogu /var/log/apache2 lub /var/log/httpd (zależnie od dystrybucji Linuxa) Weryfikację działania serwera można przeprowadzić za pomocą dostępnych w dystrybucji narzędzi np. apachetop, ps, top. Uruchomienie, restart i zatrzymanie serwera wykonuje się za pomocą standardowych mechanizmów dystrybucji np. Strona 8 z 9
apache2ctl start stop restart service apache2 start stop restart /etc/init.d/apache2 start stop restart /etc/init.d/httpd start stop restart 6. Instalacja OTM na środowisku linux Aby zainstalować program OTM na środowisku linux należy: 1) Zainstalować najnowaszą wersję oprogramownaia java 2) Pobranie ze strony polityki bezpieczeństwa http://www.oracle.com/technetwork/java/javase/downloads/jce-7-download-432124.html 3) Wgrać polityki bezpieczeństwa do katalogu java/jre7/lib/security 4) Skopiowanie OTM do dowolnego katalogu (wziąć dowolną wersję z katalogu OTAGO\produkty\czysty program)) 5) Nadać plikom programu OTM prawa wykonalności dla użytkownika, który ma korzystać z aplikacji 7. kopia zapasowa 7.1. Procedura wykonania kopii zapasowej Należy wykonywać kopię zapasową całych nodów zgodnie ze wskazaniem zawartym w dokumencie produktu 33.1. Należy także po skonfigurowaniu ustawień serwera aktualizacji wykonać jego backup jak też należy tą czynność powtarzać po każdym nadpisaniu plików aktualizujących program OTM (update_info.xml, formularze.zip i app.zip) dostarczanych przez Wykonawcę. 7.2. Procedura przywracania z kopii zapasowej Należy przywrócić konfigurację środowiska z kopii zapasowej lub przygotować nowe środowisko. Jeśli środowisko zostało zainstalowane na nowo to należy skonfigurować serwer Apache zgodnie z opisem z pkt 5.1. Strona 9 z 9