Wersja 5.1.5 2015-06-16

Wersja 5.1.5 2015-06-16

2 Spis treści 1. WSTĘP... 3 2. INSTALACJA W SYSTEMACH WINDOWS... 4 2.1. INSTALACJA APLIKACJI MODUŁU EREJESTRACJA ORAZ BAZY DANYCH EREJESTRACJA... 4 2.2. WYMAGANIA... 4 2.2.1. INSTALACJA.NET FRAMEWORK... 4 Instrukcja dla Windows 7, Windows Server 2008... 4 Instrukcja dla Windows 8... 5 Rozwiązanie problemów z.net Framework... 5 2.2.2. INSTALACJA IIS... 6 2.3. PROCES INSTALACJI... 7 2.4. WERYFIKACJA INSTALACJI... 13 3. INSTALACJA W SYSTEMACH LINUX... 20 3.1. INSTALACJA BAZY DANYCH EREJESTRACJA... 20 3.2. INSTALACJA APLIKACJI MODUŁU EREJESTRACJA... 20 3.2.1. WYMAGANIA... 20 3.2.2. KONFIGURACJA SERWERA... 21 3.2.3. POMOC... 23 4. KONFIGURACJA MODUŁU EREJESTRACJA... 24

3 1. Wstęp System erejestracja składa się z następujących komponentów: Portal erejestracja strona internetowa napisana w technologii ASP.NET MVC 3 oparta na platformie.net Framework firmy Microsoft (dla systemu Windows) lub platformie Mono (dla systemu Linux). Bazy danych er bazy danych PostgreSQL dedykowane dla portalu erejestracja. Web Service er usługa internetowa wystawiająca funkcje operujące na bazie danych erejestracja oraz funkcje proxy zawierające analogiczne metody takie jak Web Service mm. Web Service mm usługa internetowa wystawiająca funkcje operujące na bazie danych mmedica (PostgreSQL) oraz funkcje proxy zawierające analogiczne metody jak Web Service er. Proces instalacji modułu erejestracja w ogólnym podejściu składa się z następujących kroków: instalacji bazy danych erejestracja oraz instalacji aplikacji modułu erejestracja, konfiguracji usług IIS, konfiguracji modułu erejestracja.

4 2. Instalacja w systemach Windows 2.1. Instalacja aplikacji modułu erejestracja oraz bazy danych erejestracja Instalacja aplikacji modułu erejestracja oraz bazy danych erejestracja w systemach Windows realizowana jest za pomocą instalatora erfullinstall.exe. 2.2. Wymagania Przed przystąpieniem do instalacji modułu erejestracja za pomocą instalatora erfullinstall.exe, należy sprawdzić czy jest zainstalowany: Internet Information Services (IIS) w wersji 7.0 lub wyższej (oprogramowanie dostępne jest na OS: Windows Vista, Windows Server 2008, Windows 7, Windows Server 2008 R2, Windows 8, Windows Server 2012). Istnieje możliwość instalacji komponentów erejestracji na IIS w wersji 6.0, jednak nie jest to możliwe za pomocą instalatora erejestracji. W takim przypadku dokonuje się instalacji manualnej. Java Runtime Environment (JRE) 32 bit w wersji 1.7 lub wyższej..net Framework w wersji 4.0 lub wyższej. 2.2.1. Instalacja.NET Framework Instrukcja dla Windows 7, Windows Server 2008 Do działania programu erejestracja wymagany jest.net Framework w wersji przynajmniej 4.0, dlatego najpierw należy sprawdzić, która z wersji zainstalowana jest na komputerze. W dalszej kolejności dokonuje się aktywacji działania usługi. Wersje zainstalowanych aplikacji znajdują się w katalogu: C:\Windows\Microsoft.NET\Framework\. Brak w niej folderu z wersją 4.0 lub wyższą oznacza, że na komputerze nie jest zainstalowana wymagana technologia. Jeśli system nie posiada wymaganej wersji technologii, należy wykonać aktualizację Windowsa bądź pobrać aktualną wersję.net Framework ze strony Microsoft (Download Center strony www.microsoft.com). Może się zdarzyć, że usługa po instalacji nie będzie wspierać IIS. W takim wypadku należy: a) Uruchomić wiersz polecenia w trybie administratora nacisnąć przycisk start, w polu wyszukiwania wpisać frazę cmd. Po pojawieniu się w menu ikony, należy klikać na nią prawym przyciskiem myszy i wybrać opcję Run as administrator.

5 b) W oknie wiersza polecenia wpisać: C:\Windows\Microsoft.NET\Framework\[WERSJA.NET4]\aspnet_regiis.exe -i Pod frazą [Wersja.NET4] należy wpisać dokładną nazwę wcześniej wyszukiwanego folderu rozpoczynającego się od frazy v4. W przypadku, gdy istnieje wiele takich folderów, należy wybrać ten, który posiada najnowszą wersję (najwyższy numer rozdzielony znakami kropek). Polecenie należy potwierdzić przyciskiem Enter. W przypadku sukcesu operacji, na końcu okna wiersza polecenia powinna pojawić się fraza Finished installing ASP.NET. Instrukcja dla Windows 8 Pierwszym krokiem będzie otworzenie Programs nad Features oraz otworzenie w jego oknie zakładki Turn Windows features on or off. Spowoduje to otwarcie okna Windows Features, w którym możliwe jest włączanie oraz wyłączanie różnych usług systemu Windows. W drzewku katalogów należy zaznaczyć usługi.net Extensiliblity oraz ASP.NET dla najnowszej wersji, która nie jest niższa niż 4. Zmiany należy potwierdzić przyciskiem OK oraz poczekać do momentu zakończenia wykonywanych operacji. Rys. 1. Instalacja.NET Framework Rozwiązanie problemów z.net Framework W przypadku wystąpienia błędu H Result 0xc80003f3 podczas instalacji.net Framework w wersji 4.0 lub wyższej (kiedy nie jest zainstalowany) należy wykonać następujące kroki: 1. Stworzenie pliku z rozszerzeniem.bat o treści podanej poniżej oraz jego uruchomienie w trybie administratora. Może on zostać zapisany gdziekolwiek na dysku. Utworzenie pliku następuje po-

6 przez otwarcie programu Notatnik i skopiowanie do niego poniższej treści, a następnie zapisanie z rozszerzeniem *.bat, ze wcześniejszą zmianą typu zapisywanego pliku na All Files. W dalszej kolejności uruchomienie tego pliku w trybie administratora (np. z poziomu menu kontekstowego kliknięcie na jego ikonę prawym przyciskiem myszy). regsvr32 MSXML3.dll /s net stop wuauserv cd /d %windir%\softwaredistribution rd /s /q DataStore net start wuauserv regsvr32 softpub.dll regsvr32 mssip32.dll 2. Przejście do usług poprzez panel sterowania i zatrzymanie usługi Windows Update. 3. Przejście do katalogu Windows (domyślnie C:\Windows) i zmiana nazwy folderu SoftwareDistribution przykładowo na SoftwareDistribution.old. 4. Przejście do usług i uruchomienie usługi Windows Update. 5. Uruchomienie instalatora.net Framework w wersji 4.0 lub wyższej. 2.2.2. Instalacja IIS Aby zainstalować usługi IIS, dodać lub usunąć składniki przy użyciu Panelu sterowania, należy wykonać następujące czynności: 1. W menu Start kliknąć polecenie Panel sterowania. 2. Nacisnąć dwukrotnie na ikonę Dodaj lub usuń programy. 3. Kliknąć przycisk Dodaj/Usuń składniki systemu Windows. 4. W polu listy Składniki wejść w pozycję Serwer aplikacji. 5. Kliknąć przycisk Szczegóły. 6. Wejść w pozycję Menedżer internetowych usług informacyjnych. 7. Nacisnąć przycisk Szczegóły w celu wyświetlenia listy opcjonalnych składników usług IIS. Szczegółowe informacje o opcjonalnych składnikach usług IIS można uzyskać poprzez kliknięcie opcji Składniki opcjonalne znajdującej się w temacie. 8. Wybrać wszystkie składniki opcjonalne, które chce się zainstalować. 9. Klikać przycisk OK do chwili, aż zostanie ponownie wyświetlony Kreator składników systemu Windows. 10. Nacisnąć Dalej i zakończyć działanie Kreatora składników systemu Windows.

7 2.3. Proces instalacji System erejestracja może działać w tzw. modelu rozproszonym, gdzie świadczeniodawca posiada wiele placówek połączonych siecią rozległą. Przedstawiony w tym rozdziale proces instalacji uwzględnia najprostszy przypadek, w którym wszystkie aplikacje modułu erejestracja, baza danych modułu erejestracji oraz baza danych programu mmedica, mają się znajdować na tym samym komputerze. Instalacja przebiega według następujących kroków: a) Uruchamiamy plik erfullinstall.exe. Wyświetla się formatka powitalna. Naciskamy strzałkę w prawo. Rys. 2. Instalator systemu erejestracja Zapoznajemy się z umową licencją. W przypadku akceptacji klikamy w strzałkę w prawo. Rys. 3. Umowa licencyjna

8 b) Zaznaczamy komponenty, które chcemy zainstalować. W omawianym przypadku są to: baza danych (Baza danych er), portal (Portal erejestracja), erws (Web Service er), mmws (Web Service mm). Po wybraniu komponentów klikamy strzałkę w prawo. Rys. 4. Wybór komponentów, które mają zostać zainstalowane Jeśli na komputerze nie został zainstalowany.net Framework w wersji 4.0 lub wyższej, do wyboru możliwa będzie jedynie instalacja bazy danych.

9 Rys. 5. Ograniczona dostępność komponentów w przypadku braku odpowiedniej wersji.net Framework c) Wybieramy rodzaj instalacji. Dla omawianego przypadku należy zaznaczyć instalację lokalną. Opcja Instalacja na serwerze w sieci jest przeznaczona dla procesu instalacji bazy danych PostgreSQL na OS Linux. Po wybraniu opcji naciskamy strzałkę w prawo. Rys. 6. Rodzaj instalacji d) W kolejnym kroku wyświetla się formatka PostgreSQL. Jeśli jest to pierwsza instalacja silnika bazy danych, istnieje możliwość modyfikacji ścieżki do plików binarnych PostgreSQL, ścieżki do katalogu z danymi oraz portu nasłuchu. Po uzupełnieniu naciskamy strzałkę w prawo.

10 Rys. 7. Podgląd konfiguracji oprogramowania PostgreSQL e) W następnym etapie definiujemy nazwy bazy danych er. Po uzupełnieniu naciskamy strzałkę w prawo. Rys. 8. Ustawienia bazy danych f) W kolejnym etapie wyświetli się formatka konfiguracji Portalu bez możliwości edytowania danych konfiguracyjnych połączenia do bazy danych er. Naciskamy strzałkę w prawo.

11 Rys. 9. Konfiguracja Portalu erejestracji g) W kolejnym etapie wyświetla się formatka konfiguracji Web Service er bez możliwości edytowania danych konfiguracyjnych połączenia do bazy danych erejestracji. Naciskamy strzałkę w prawo. Rys. 10. Konfiguracja WebService erejestracji h) Następnie wyświetla się formatka konfiguracji Web Service mm. Dla omawianego przypadku należy podać wartość localhost w polu Adres, a wartość 5432 w Port. Dalej wymagany jest wybór bazy danych mmedica, z którą ma mieć miejsce wymiana danych. Po uzupełnieniu naciskamy strzałkę w prawo.

12 Rys. 11. Konfiguracja WebService mmedica i) W oknie Rozpoczęcie instalacji naciskamy strzałkę w prawo. j) Poprawnie wykonaną instalację finalizuje formatka Zainstalowane bazy danych oraz formatka Gotowe. Rys. 12. Instalacja komponentów

13 Rys. 13. Zainstalowane bazy danych erejestracji Rys. 14. Zakończenie pracy instalatora Po zakończeniu instalacji należy przystąpić do konfiguracji modułu erejestracji za pośrednictwem strony www: http://localhost/portal. Proces konfiguracji Portalu został opisany w rozdziale 3. 2.4. Weryfikacja instalacji Opis weryfikacji instalacji został opracowany w oparciu o model, w którym zarówno mmws jak i erws znajdują się na jednym komputerze (szczegóły zamieszczono w opisie architektury modułu erejestracja). Jeżeli występują problemy z działaniem modułu erejestracji, należy otworzyć aplikację do zarządzania serwerem IIS (Internet Information Services (IIS) Manager), a w dalszej kolejności:

14 a) Zweryfikować, czy komponenty er zostały poprawnie skonfigurowane. Dane powinny być zgodne z poniższym zrzutem. Wartość Managed pipeline mode umieszczona w tabeli może różnić się zawartością, różnice mogą być skutkiem odmiennych wersji IIS. Dla IIS w wersji 6.0 przypisana zostaje opcja Classic, z kolei dla nowszych wersji Integrated. Przy porównywaniu zawartości zrzutów proszę zwrócić uwagę również na strukturę aplikacji znajdującą się w lewej części okna. Rys. 15. Widok Features programu IIS Zweryfikować zawartość aplikacji Default Web Site. Należy zwrócić uwagę, by przeglądać zawartość content view. Poza standardowymi plikami IIS oraz aplikacji nie powinno być innych plików, w szczególności z rozszerzeniem *.config. Rys. 16. Zawartość aplikacji Default Web Site Zweryfikować, czy zawartość aplikacji erws wygląda tak jak na poniższym zrzucie: Rys. 17. Zawartość aplikacji erws Zweryfikować, czy zawartość aplikacji mmws wygląda tak jak na poniższym zrzucie:

15 Rys. 18. Zawartość aplikacji mmws Zweryfikować, czy zawartość aplikacji Portal wygląda tak jak na poniższym zrzucie: Rys. 19. Zawartość aplikacji Portal Zweryfikować działanie mmws poprzez kliknięcie prawym przyciskiem myszy na aplikację mmws i wybranie z menu Manage Application -> Browse: Rys. 20. Weryfikacja działania aplikacji mmws Przed wykonaniem tej czynności należy się upewnić, czy IIS jest uruchomiony dla Default Web Site. W celu uruchomienia usługi należy wejść w Default Web Site, a następnie z opcji dostępnych z prawej stronie okna Manage Web Site wybrać Start.

16 Rys. 21. Uruchamianie usług dla Default Web Site Po wykonaniu powyższych czynności powinna wyświetlić się następująca strona: Rys. 22. Widok aplikacji mmws W następnym kroku do adresu w przeglądarce należy dopisać mmws.asmx. Powinno to wywołać wyświetlenie strony z metodami:

17 Rys. 23. Widok aplikacji mmws/mmws.asmx Dalej należy kliknąć na metodę GetDate: Rys. 24. Medota GetDate Następnie należy kliknąć na przycisk Invoke. Wygenerowana zostanie strona z aktualną datą:

18 Rys. 25. Widok po kliknięciu przycisku Invoke Zweryfikować działanie aplikacji Portal poprzez wpisanie w przeglądarce adresu http://localhost/portal. Rys. 26. Widok aplikacji Portal W ostatnim kroku należy sprawdzić w aplikacji IIS, czy zarejestrowano typ MIME font/x-woff o rozszerzeniu.woff. W tym celu należy kliknąć lewym przyciskiem myszy na Default Web Site, a następnie oknie obok drzewka aplikacji wybrać ikonę z podpisem MIME types. Należy zwrócić uwagę, by pod tabelą zaznaczyć opcję widoku na Features View. W typach MIME powinna wyświetlić się następująca pozycja: Rys. 27. Typy MIME Jeśli dany plik nie istnieje należy go dodać za pomocą opcji Add znajdującej się po prawej stronie listy Actions, a następnie uzupełnić ją według poniższego wzoru:

19 Rys. 28. Tworzenie nowego pliku MIME Analogicznie należy utworzyć dwa kolejne typy MIME o następujących wartościach: File name extension.jnilib, MIME type application/octet-stream File name extension.so, MIME type application/octet-stream UWAGA! Wystąpienie błędu w którymkolwiek z powyższych kroków oznacza, że instalacja modułu została wykonana w niepoprawny sposób.

20 3. Instalacja w systemach Linux 3.1. Instalacja bazy danych erejestracja Instalacja w systemach Linux odbywa się dwuetapowo. Pierwszym etapem jest zainstalowanie serwera PostgreSQL wg instrukcji Instalacja 9.0 na linuksie.pdf. Drugim etapem jest zainstalowanie bazy danych poprzez uruchomienie instalatora mmerinstall.exe z poziomu stacji roboczej z systemem Windows. 3.2. Instalacja aplikacji modułu erejestracja Niniejszy opis procesu instalacji erejestracji został sporządzony na przykładzie systemu Ubuntu. Wszystkie komponenty (erws, mmws, Portal) są instalowane na tym samym serwerze, co powoduje, że serwer powinien mieć dostęp bezpośrednio do bazy erejestracjadb i MMEDICA. 3.2.1. Wymagania Aby dokonać instalacji modułu erejestracja na systemie Linux należy spełniać następujące wymagania: Posiadać zainstalowany serwer Apache w wersji 2. Posiadać zainstalowane następujące komponenty: o libapache2-mod-mono, o mono-apache-server4, o mono-develop, o mono-runtime w wersji 2.10.8, o Java Runtime Environment w wersji 7 lub wyższej. Zgodnie z instrukcjami konfiguracji mono_mod należy się upewnić, że moduł jest uruchomiony i poprawnie skonfigurowany. Instrukcja znajduje się na stronie https://help.ubuntu.com/community/modmono. Rezultat konfiguracji można zobaczyć pod adresem file:///var/www/html/index.html Posiadać zainstalowany i poprawnie skonfigurowany silnik bazy danych PostgreSql z zabezpieczeniami dodanymi przez Asseco. Umożliwić połączenie do baz danych mmedica oraz erejestracja.

21 3.2.2. Konfiguracja serwera W celu skonfigurowania serwera wykonaj następujące kroki: Do katalogu /var/www należy przekopiować katalogi ze źródłami: erws, mmws, Portal. Należy skonfigurować plik /etc/apache2/sites-available/default <VirtualHost *:80> ServerName localhost DocumentRoot "/var/www" <Directory "/var/www"> Options Indexes Includes FollowSymLinks MultiViews AllowOverride All Order allow,deny Allow from all Deny from env=blocked SetHandler mono </Directory> </VirtualHost> Należy skonfigurować plik /etc/mono-server4/debian.webapp: <apps> <web-application> <name>erws</name> <vpath>/erws</vpath> <path>/var/www/erws</path> <vhost>localhost</vhost> </web-application> <web-application> <name>mmws</name> <vpath>/mmws</vpath> <path>/var/www/mmws</path> <vhost>localhost</vhost> </web-application> <web-application> <name>portal</name> <vpath>/</vpath> <path>/var/www/portal</path> <vhost>localhost</vhost> </web-application> </apps> W katalogu /etc/mono należy utworzyć katalog o nazwie registry z pełnymi prawami dla użytkownika, na którym jest uruchomiona usługa apache2. Należy wykonać następujące polecenia: sudo mozroots --import --ask-remove --machine sudo certmgr -ssl -m https://hetmantest.epuap.gov.pl/

22 W przypadku wykorzystania w Portalu serwera poczty wychodzącej SMTP opartego o technologię TLS może być wymagane pobranie certyfikatów bezpieczeństwa za pomocą następujących poleceń (na przykładzie serwera pocztowego Gmail): sudo mozroots --import --ask-remove --machine sudo certmgr -ssl smtps://smtp.gmail.com:465 sudo certmgr -ssl -m smtps://smtp.gmail.com:465 W przypadku użytkowania innego serwera SMTP należy wpisać w miejscu smtp.gmail.com właściwy adres serwera poczty wychodzącej. Należy dodać do Apache obsługę następujących typy plików MIME (MIME type): 1. typ: application/octet-stream (o rozszerzeniu jnilib) 2. typ: application/octet-stream (o rozszerzeniu so) 3. typ: application/x-font-woff (o rozszerzeniu woff) W tym celu należy otworzyć plik zawierający konfigurację typów MIME mime.types, który w zależności od dystrybucji znajduję się najczęściej pod ścieżką: /etc/mime.types lub /user/local/etc/httpd/conf/mime.types. Następnie sprawdzić, czy w pliku znajdują się powyższe wpisy, w przypadku braku należy je dodać. Konwencja dodawania wpisów jest następująca: typ rozszerzenie rozszerzenie rozszerzenie Przykładowe wpisy: application/x-font-woff woff application/octet-stream bin jnilib so Po edycji pliku należy go zapisać, a także zrestartować usługę Apache, np. sudo service apache2 restart Należy skonfigurować połączenie do bazy danych erejestracjadb dla Portalu w pliku /var/www/portal/ web.config w sekcji connectionstrings ustawiając adres IP serwera (zaznaczony na żółto) oraz port (zaznaczony na czerwono): <connectionstrings> <add name="erejestracjadb" connectionstring="server=5.5.5.1,5432;database=erejestracjadb;"/> </connectionstrings> Należy skonfigurować połączenie do bazy danych erejestracjadb dla erws w pliku /var/www/erws/web.config w sekcji connectionstrings ustawiając adres IP serwera (zaznaczony na żółto) oraz port (zaznaczony na czerwono): <connectionstrings> <add name="erejestracjadb" connectionstring="server=5.5.5.1,5432;database=erejestracjadb;"/>

23 </connectionstrings> Należy skonfigurować połączenie do bazy danym MMEDICA dla mmws w pliku /var/www/mmws/web.config w sekcji connectionstrings ustawiając adres IP serwera (zaznaczony na żółto) oraz port (zaznaczony na czerwono): <add name="mmedicadb" connectionstring="server=5.5.5.1,5432;database=mmedica;"/> </connectionstrings> 3.2.3. Pomoc W razie problemów można skorzystać z pomocy pod następującymi adresami internetowymi: http://www.mono-project.com http://www.mono-project.com/mod_mono https://help.ubuntu.com/community/modmono

24 4. Konfiguracja modułu erejestracja W celu konfiguracji modułu erejestracja należy: Wejść na stronę http://localhost/portal i zalogować się na konto administratora: o u: admin, o p: test2013. Zmienić hasło administratora klikając na menu Moje konto i wybierając zmień hasło. Przejść do strony Słowniki świadczeniodawcy za pomocą menu Administracja -> Słowniki -> Słowniki świadczeniodawcy Dodać nowego świadczeniodawcę poprzez kliknięcie przycisku Dodaj, a następnie wpisać adres serwisu mmws skojarzonego z bazą MMEDICA, np. http://localhost/mmws/mmws.asmx Skonfigurować dane potrzebne do komunikacji z epuap (należy wejść w panel konfiguracji za pomocą menu Administracja -> Konfiguracja, a następnie otworzyć zakładkę epuap): o Wybrać certyfikat prywatny do komunikacji z epuap w polu Wybrany plik certyfikatu prywatnego o Wpisać hasło do ww. certyfikatu w polu Hasło do certyfikatu. o Wpisać nazwę skrytki epuap w polu Nazwa skrytki. o Wpisać nazwę organizacji w epuap w polu Nazwa organizacji. W przypadku edycji hasła sieciowego er należy to hasło również wprowadzić również w programie mmedica w konfiguracji (Administracja -> Konfiguracja w zakładce Ogólne). Należy skonfigurować ustawienia serwera pocztowego SMTP (Administracja -> Konfiguracja w zakładce SMTP). Po uzupełnieniu wszystkich wymaganych pól należy konfigurację zapisać i wysłać testowy email na adres administratora. Adres e-mail administratora można zmienić w menu Administracja -> Listy -> Lista Użytkowników po naciśnięciu przycisku Edytuj. W przypadku kiedy wiadomość testowa nie została wysłana należy sprawdzić poprawność ustawień poczty SMTP.