Aktualizacja Oprogramowania do Obsługi Świadczeń do wersji G-1.01-2-5.5 Spis treści: WSTĘP... 2 AKTUALIZACJA W ŚRODOWISKU WINDOWS... 3 PRZEBIEG AKTUALIZACJI WERSJI JEDNOSTANOWISKOWEJ... 3 PRZEBIEG AKTUALIZACJI WERSJI SIECIOWEJ Z SERWEREM WINDOWS... 3 INSTALACJA OPROGRAMOWANIA JAVA JDK... 4 INSTALACJA SERWERA APLIKACYJNEGO JBOSS ORAZ AKTUALIZACJA PLIKÓW PROGRAMU... 5 AKTUALIZACJA W ŚRODOWISKU LINUX... 6 PRZEBIEG AKTUALIZACJI WERSJI SIECIOWEJ Z SERWEREM LINUX... 6 INSTALACJA OPROGRAMOWANIA JAVA JDK NA SERWERZE LINUX... 7 INSTALACJA SERWERA APLIKACYJNEGO JBOSS NA SERWERZE LINUX... 8 SPRAWDZENIE POPRAWNOŚCI DZIAŁANIA APLIKACJI... 9 Strona 1 z 9
Wstęp Pakiet aktualizacyjny G-1.01-2-5.5 Oprogramowania do Obsługi Świadczeń wprowadza zmiany technologiczne dla przyszłej komunikacji z Centralnym Systemem Informatycznym Zabezpieczenia Społecznego (CSIZS) w ramach projektu Emp@tia - Platforma komunikacyjna zabezpieczenia społecznego. Więcej na temat projektu można znaleźć pod adresem: http://empatia.mpips.gov.pl/projekt-empatia.html. Nowe wymagania, ogłoszone w dniu 19 września 2013 roku w wersji 1.02, narzucają na dostawcę systemu dziedzinowego aby architektura aplikacji była wielowarstwowa. Dostawcy systemów dziedzinowych mają czas do końca 2014 roku, aby spełnić to wymaganie. Pierwszym krokiem w tym kierunku jest wprowadzenie w pakiecie aktualizacyjnym G-1.01-2-5.5 serwera aplikacyjnego JBoss, na którym będzie pracowała aplikacja wymieniająca dane z CSIZS. Zmiany technologii dotyczą również modułów Stypendia Socjalne oraz Dodatki Mieszkaniowe i będą wprowadzane stopniowo w roku 2014 wraz ze zmianami w modułach Świadczeń Rodzinnych i Funduszu Alimentacyjnego. Serwer aplikacyjny JBoss będzie pracował na porcie sieciowym 8280. Jeśli na serwerze lub na wersji jednostanowiskowej jest już zainstalowany inny JBoss (np. dla oprogramowania POMOST Std) pracujący na domyślnym porcie sieciowym 8080, nie będzie on kolidował z nową instalacją JBossa dla Świadczeń. Jednak w przypadku, gdy aplikacja POMOST Std zajmuje zalecany port dla Oprogramowania do Obsługi Świadczeń, należy zmienić grupę portów używanych dotychczas przez Pomosta (w tym celu najlepiej skorzystać z narzędzia Panel Sterowania POMOST Std ). Aktualizator G-1.01-2-5.5.exe wykryje automatycznie czy został uruchomiony na wersji jednostanowiskowej, serwerze, czy na stacji roboczej i w zależności od tego przeprowadzi różne czynności. Aktualizację wersji jednostanowiskowej Świadczeń należy poprzedzić instalacją oprogramowania Java Development Kit (JDK) w wersji 7 update 15. W przypadku wersji sieciowej Świadczeń (niezależnie od tego czy na serwerze znajduje się tylko baza danych czy znajdują się również pliki programu), analogicznie jak na wersji jednostanowiskowej, należy w pierwszej kolejności zainstalować na serwerze Javę JDK 7 update 15, a następnie uruchomić na serwerze pakiet aktualizacyjny G-1.01-2-5.5.exe (dla użytkowników pracujących na serwerach linuksowych został przygotowany osobny skrypt instalacyjny G-1.01-2-5.5.sh ). Aktualizacja stacji roboczych będzie przebiegać tak jak dotychczas, tzn. aktualizator dokona jedynie aktualizacji plików aplikacji w domyślnej lub wskazanej przez użytkownika lokalizacji. Nie jest wymagane instalowanie na stacjach roboczych oprogramowania Java Runtime Environment (JRE), gdyż klienci będą posługiwać się środowiskiem Java wbudowanym w aplikację. W dalszej części niniejszego dokumentu, zamieszczono szczegółowe informacje o przebiegu aktualizacji Świadczeń do wersji G-1.01-2-5.5 w środowisku Windows oraz Linux. Strona 2 z 9
Aktualizacja w środowisku Windows Przebieg aktualizacji wersji jednostanowiskowej 1. Pobrać: a) aktualizator G-1.01-2-5.5.exe (bezpośrednio z programu wybierając menu Pomoc -> Sprawdź dostępność aktualizacji lub z serwera FTPS * ) b) instalator Javy JDK jdk-7u15-windows-i586.exe lub jdk-7u15-windows-x64.exe w zależności od architektury systemu 32/64bit (z serwera FTPS * ) 2. Zatrzymać pracę w Świadczeniach i wykonać kopię bezpieczeństwa bazy danych 3. Zainstalować Javę JDK 7u15 (patrz rozdział Instalacja oprogramowania Java JDK na str. 4) 4. Uruchomić aktualizator G-1.01-2-5.5.exe w celu zainstalowania JBossa oraz zaktualizowania plików programu (patrz rozdział Instalacja serwera aplikacyjnego JBoss oraz aktualizacja plików programu na str. 5). Po zakończeniu instalacji plików należy przejść do kolejnego punktu bez uruchamiania serwera JBoss. 5. Uruchomić Świadczenia w celu wykonania aktualizacji bazy danych (tę czynność należy wykonać przy wyłączonym JBossie) 6. Wykonać ponowny rozruch komputera. Przebieg aktualizacji wersji sieciowej z serwerem Windows 1. Pobrać: a) aktualizator G-1.01-2-5.5.exe (bezpośrednio z programu wybierając menu Pomoc -> Sprawdź dostępność aktualizacji lub z serwera FTPS * ) b) instalator Javy JDK jdk-7u15-windows-i586.exe lub jdk-7u15-windows-x64.exe w zależności od architektury systemu 32/64bit (z serwera FTPS * ) 2. Zatrzymać pracę w Świadczeniach i wykonać kopię bezpieczeństwa bazy danych 3. Zainstalować na serwerze Javę JDK 7u15 (patrz rozdział Instalacja oprogramowania Java JDK na str. 4) 4. Uruchomić aktualizator G-1.01-2-5.5.exe na serwerze w celu zainstalowania Jbossa oraz zaktualizowania plików programu (patrz rozdział Instalacja serwera aplikacyjnego JBoss oraz aktualizacja plików programu na str. 5). Po zakończeniu instalacji plików należy przejść do kolejnego punktu bez uruchamiania serwera JBoss. 5. Uruchomić aktualizator G-1.01-2-5.5.exe na wszystkich stacjach roboczych w celu zaktualizowania plików programu (tę czynność należy przeprowadzić analogicznie jak przy okazji każdej innej aktualizacji oprogramowania Świadczenia) 6. Uruchomić Świadczenia na serwerze lub na jednej ze stacji roboczych w celu wykonania aktualizacji bazy danych (tę czynność należy wykonać przy wyłączonym JBossie) 7. Wykonać ponowny rozruch serwera. *) SERWER FTPS, na którym znajdują się niezbędne pliki instalacyjne: HOST: ftp.sygnity.pl (port: 990, szyfrowanie: SSL/TSL, tryb pasywny) UŻYTKOWNIK: sygftp HASŁO: JuY44f KATALOG: SR i /SR/2-5.5 Instrukcja połączenia z serwerem FTPS:http://public.sygnity.pl/sites/default/files/inne/instrukcjaftps.pdf Strona 3 z 9
Instalacja oprogramowania Java JDK Rekomendowaną wersją Javy dla Oprogramowania do Obsługi Świadczeń G-1.01-2-5.5 jest wersja JDK 7 update 15. Oprogramowanie Java JDK należy zainstalować na komputerze, na którym pracują Świadczenia w wersji jednostanowiskowej, natomiast w przypadku instalacji sieciowej Świadczeń, Javę JDK należy zainstalować jedynie na serwerze. Na komputerach, na których jest już zainstalowana wymagana Java JDK, nie ma konieczności dokonywania jej reinstalacji. Uruchamiamy pobrany z serwera FTPS plik instalatora Javy ( jdk-7u15-windows-i586.exe dla 32-bitowego systemu lub jdk-7u15-windows-x64.exe dla 64-bitowego systemu), po zapoznaniu się z wyświetloną informacją powitalną wybieramy przycisk Next >. W kolejnym oknie możemy wybrać produkty, które mają zostać zainstalowane oraz zmienić folder docelowy instalacji zalecamy pozostawić w tym miejscu domyślne ustawienia i wybrać przycisk Next > w celu rozpoczęcia procesu instalacji plików Javy JDK. Następnie pojawi się okno, w którym potwierdzamy lokalizację docelową dla plików Javy JRE i wybieramy przycisk Next > w celu rozpoczęcia procesu instalacji plików. Po zakończeniu instalacji Javy pojawi się okno informujące o zakończeniu instalacji i wybieramy przycisk Close. Po zainstalowaniu Javy należy sprawdzić czy została ona poprawnie zainstalowana. W tym celu w wierszu poleceń (konsola DOS/cmd) wpisujemy z dowolnego poziomu następujące polecenie: java -version Jeśli Java jest poprawnie zainstalowana, powinniśmy otrzymać odpowiedź: java version "1.7.0_15" Java(TM) SE Runtime Environment (build 1.7.0_15-b03) Strona 4 z 9
Instalacja serwera aplikacyjnego JBoss oraz aktualizacja plików programu Uruchamiamy plik aktualizatora Świadczeń G-1.01-2-5.5.exe i zapoznajemy się z wyświetloną informacją powitalną. W kolejnym oknie korzystamy z domyślnej podpowiedzi ścieżki do aplikacji lub wskazujemy samodzielnie lokalizację aplikacji. Jeśli aktualizator wykryje we wskazanej lokalizacji bazę danych oraz pliki klienckie programu (wersja jednostanowiskowa bądź tzw. niepełny serwer), wyświetlone zostanie okno, w którym wybieramy pomiędzy instalacją serwera aplikacyjnego JBoss wraz z aktualizacją plików programu lub tylko aktualizacją plików bez instalacji serwera JBossa zalecamy pozostawić wybór pierwszej opcji, aczkolwiek jeśli nie zostanie zainstalowany teraz JBoss, będzie możliwe jego późniejsze doinstalowanie poprzez ponowne uruchomienie aktualizatora G-1.01-2-5.5.exe i wybranie pierwszej opcji. Na serwerze, na którym znajduje się baza danych bez plików klienckich, aktualizator od razu przejdzie do kolejnego okna, w którym należy potwierdzić ścieżki do zainstalowanego Firebirda oraz Javy JDK. W przypadku, gdy podpowiadana lokalizacja nie jest właściwa, za pomocą przycisku Zmień wskazujemy poprawną, a następnie wybieramy przycisk Dalej >. W kolejnym oknie wybieramy w jakim trybie będzie pracował serwer aplikacyjny JBoss. Wybranie opcji Zainstaluj serwer JBoss jako usługę systemową... spowoduje, że na liście usług systemowych zostanie dodana usługa JBossSwiadczenia uruchamiana automatycznie wraz ze startem systemu operacyjnego (JBoss będzie pracował w tle bez widocznej konsoli, a jego uruchamianie i zatrzymanie będzie możliwe z poziomu listy usług lokalnych systemu (Panel Sterowania -> Narzędzia administracyjne -> Usługi ). Z kolei wybranie opcji Zainstaluj serwer JBoss jako aplikację... spowoduje, że serwer będzie uruchamiany po zalogowaniu się do systemu operacyjnego na podstawie skrótu umieszczonego w Autostarcie (w trakcie pracy będzie widoczna konsola JBossa, a sterowanie nim będzie możliwe za pomocą ikon dostępnych na pulpicie Uruchomienie serwera JBossŚwiadczenia i Zatrzymanie serwera JBossŚwiadczenia ). Następnie wybieramy przycisk Dalej > w celu uruchomienia procesu instalacji plików, a na finalnym oknie wybieramy przycisk Zakończ. Strona 5 z 9
Aktualizacja w środowisku Linux Rekomendowaną wersją systemu Linux na potrzeby serwera aplikacyjnego JBoss dla Oprogramowania do Obsługi Świadczeń jest Fedora w wersji min. 16. Jednak niniejsza instalacja ma zastosowanie do większości systemów Linux, pochodzących z rodziny Red Hat. Przebieg aktualizacji wersji sieciowej z serwerem Linux 1. Pobrać: a) aktualizator G-1.01-2-5.5.exe (bezpośrednio z programu wybierając menu Pomoc -> Sprawdź dostępność aktualizacji lub z serwera FTPS * ) b) instalator serwera aplikacyjnego Jboss G-1.01-2-5.5.sh (z serwera FTPS * ) c) instalator Javy JDK jdk-7u17-linux-i586.rpm lub jdk-7u17-linux-x64.rpm w zależności od architektury systemu 32/64bit (z serwera FTPS * ) 2. Zatrzymać pracę w Świadczeniach i wykonać kopię bezpieczeństwa bazy danych 3. Uruchomić aktualizator G-1.01-2-5.5.exe na wszystkich stacjach roboczych w celu zaktualizowania plików programu (tę czynność należy przeprowadzić analogicznie jak przy okazji każdej innej aktualizacji oprogramowania Świadczenia) 4. Uruchomić Świadczenia na jednej ze stacji roboczych w celu wykonania aktualizacji bazy danych (tę czynność należy przeprowadzić analogicznie jak przy okazji każdej innej aktualizacji oprogramowania Świadczenia) 5. Zainstalować na serwerze Javę JDK 7u15 (patrz rozdział Instalacja oprogramowania Java JDK na serwerze Linux na str. 7) 6. Uruchomić plik instalacyjny G-1.01-2-5.5.sh na serwerze w celu dokonania instalacji Jbossa (patrz rozdział Instalacja serwera aplikacyjnego JBoss na serwerze Linux na str. 8) 7. Wykonać ponowny rozruch serwera. *) SERWER FTPS, na którym znajdują się niezbędne pliki instalacyjne: HOST: ftp.sygnity.pl (port: 990, szyfrowanie: SSL/TSL, tryb pasywny) UŻYTKOWNIK: sygftp HASŁO: JuY44f KATALOG: SR i /SR/2-5.5 Instrukcja połączenia z serwerem FTPS:http://public.sygnity.pl/sites/default/files/inne/instrukcjaftps.pdf Strona 6 z 9
Instalacja oprogramowania Java JDK na serwerze Linux Rekomendowaną wersją Javy dla Oprogramowania do Obsługi Świadczeń jest wersja JDK 7 update 15. Na serwerach, na których jest już zainstalowana wymagana Java JDK, nie ma konieczności dokonywania jej reinstalacji. W celu dokonania instalacji Javy, należy zalogować się na systemowe konto administratora (root), wydając w konsoli polecenie: $ su (i podać hasło administratora). Przechodzimy w konsoli do katalogu, w którym znajduje się pobrany plik, wydajemy polecenie: # chmod u+x jdk-7u*-linux-*.rpm Instalujemy Javę: # rpm -ivh jdk-7u15-linux-xxxx.rpm, gdzie XXXX odpowiada oznaczeniu architektury Po instalacji w katalogu zostają zbędne pliki rpm, które możemy usunąć: # rm jdk-*-linux-*.rpm sun-javadb-*.rpm Aby na tym etapie zweryfikować poprawność instalacji Javy, należy wykonać polecenie: # ls /usr/java w rezultacie powinniśmy otrzymać: default jdk1.7.0_15 latest Następnie należy skonfigurować Javę w systemie. W tym celu będąc dalej zalogowanym na koncie administratora wydajemy polecenie (należy zwrócić uwagę na jego składnię, tak aby nie popełnić żadnego błędu): # alternatives --install /usr/bin/java java /usr/java/jdk1.7.0_15/bin/java 2, gdzie 2 jest numerem kolejnym instalacji, w zależności od potrzeb numer może być wyższy; polecenie to rejestruje nowo zainstalowaną Javę w systemie, nie zwraca ono żadnego komunikatu. Następnie wykonujemy polecenie: # alternatives --config java Polecenie to powinno zwrócić listę wyboru z zainstalowaną wcześniej Javą, przykładowo: Jeśli istnieją 2 programy dostarczające "java": Wybór Polecenie ----------------------------------------------- * 1 /usr/lib/jvm/jre-1.7.0-gcj/bin/java 2 /usr/java/jdk1.7.0_15/bin/java Proszę nacisnąć przycisk Enter, aby zachować bieżący wybór[+] lub podać numer wyboru: 2 Wskazujemy wcześniej zainstalowaną wersję Java, czyli zgodnie z przedstawionym przykładem 2. Po tej operacji powinniśmy mieć odpowiednio skonfigurowaną Javę, a wpisując polecenie: # java -version powinniśmy otrzymać odpowiedź: java version "1.7.0_15" Java(TM) SE Runtime Environment (build 1.7.0_15-b03) Strona 7 z 9
Instalacja serwera aplikacyjnego JBoss na serwerze Linux Do poprawnej instalacji Jbossa w środowisku Linux wymagane jest narzędzie systemowe dos2unix, w przypadku jego braku należy je zainstalować wykonując polecenie: # yum install dos2unix (dla innych dystrybucji niż Fedora należy odnaleźć pakiet zawierający powyższe narzędzie i go zainstalować) W celu dokonania instalacji JBossa, należy zalogować się na systemowe konto administratora (root), wydając w konsoli polecenie: $ su (i podać hasło administratora). Przechodzimy w konsoli do katalogu, w którym znajduje się pobrany plik, wydajemy polecenie: # chmod u+x G-1.01-2-5.5.sh a następnie: #./G-1.01-2-5.5.sh Podczas instalacji postępujemy zgodnie z instrukcjami pojawiającymi się w konsoli, zatem kolejno: potwierdzamy ścieżkę do serwera Firebird, akceptujemy instalację czcionek, potwierdzamy lokalizację baz danych Świadczeń, wskazujemy folder docelowy dla JBossa, definiujemy hasło dla nowo powstałego użytkownika systemowego sr oraz decydujemy czy ma zostać zainstalowana usługa systemowa do obsługi JBossa. Usługa JBossSwiadczenia będzie uruchamiana wraz ze startem systemu, ponadto sterowanie JBossem pracującym w trybie usługi będzie możliwe za pomocą polecenia service JBossSwiadczenia [start/stop/status/restart], a także skryptami uruchom_serwer_swiadczenia.sh i zatrzymaj_serwer_swiadczenia.sh znajdującymi się w katalogu domowym użytkownika sr (w tym wypadku skrypty te będą się odwoływać do polecenia service). Jeśli nie zostanie zainstalowana usługa, uruchamianie i zatrzymywanie JBossa w trybie aplikacji będzie możliwe za pomocą skryptów uruchom_serwer_swiadczenia.sh i zatrzymaj_serwer_swiadczenia.sh znajdujących się w katalogu domowym użytkownika sr, które w tym wypadku będą się odwoływać do skryptu../jboss/bin/jbossswiadczenia). Uwaga 1: Dla prawidłowego działania JBossa w środowisku Linux, konieczne jest aby w pliku /etc/hosts dla wpisu 127.0.0.1 (localhost) dodany był alias z nazwę serwera. Uwaga 2: Aby poprawnie wyświetlały się wartości kwotowe w systemie Linux, należy odpowiednio skonfigurować format liczb w ustawieniach lokalnych. W oknie "Kraj/region i język" na zakładce Kraj wskazujemy wartość "Polska", natomiast na zakładce Liczby określamy formatowanie liczb kwotowych, wprowadzając: Separator dziesiętny,, Liczbę miejsc po przecinku 2, Oznaczenie liczb ujemnych - i Zestaw cyfr Arabskie (0123456789). Strona 8 z 9
Sprawdzenie poprawności działania aplikacji Podczas logowania do aplikacji Świadczenia weryfikowane jest połączenie z serwerem aplikacyjnym JBoss. W przypadku niemożności nawiązania połączenia z JBossem zostanie wyświetlony komunikat podpowiadający możliwe przyczyny problemu. Adres serwera aplikacyjnego JBoss oraz numer portu, z którym łączy się klient, zapisywany jest na bazie danych podczas instalacji JBossa. W razie potrzeby adres ten można zmodyfikować wybierając w głównym oknie programu menu Administracja -> Narzędzia -> Konfiguracja połączenia z serwerem JBoss. Zdefiniowany w tym miejscu adres hosta musi odpowiadać adresowi IP serwera, na którym pracuje JBoss (dla wersji jednostanowiskowej można użyć http://localhost ), a numer portu musi być zgodny z tym na którym pracuje JBoss (domyślnie 8280). Do prawidłowego nawiązania połączenia stacji klienckich z serwerem aplikacyjnym, w przypadku włączonej zapory sieciowej na serwerze, konieczne jest zdefiniowanie wyjątku dla portu sieciowego 8280. W celu sprawdzania statusu serwera aplikacyjnego JBoss, można użyć skryptu znajdującego się w podkatalogu \SYG_SwiadczeniaRodzinne\JBossSR\narzedzia\StatusSerwera\. Strona 9 z 9