Instrukcja instalacji usługi Sygnity SmsService Usługa Sygnity SmsService jest przeznaczone do wysyłania wiadomości tekstowych na telefony klientów zarejestrowanych w Systemach Dziedzinowych Sygnity wykorzystywanych w obszarze Zabezpieczenia Społecznego (Oprogramowanie do Obsługi SR/FA/SW/DM /ST, POMOST Std) 14 lutego 2018r.
W niniejszym dokumencie zostały szczegółowo opisane procedury postępowania przy instalacji usługi Sygnity SmsService w środowisku Windows, która jest przeznaczone do wysyłania wiadomości tekstowych na telefony klientów zarejestrowanych w Systemach Dziedzinowych Sygnity, tj. Oprogramowaniu do Obsługi Świadczeń Rodzinnych (SR), Funduszu Alimentacyjnego (FA), Świadczeń Wychowawczych (SW), Dodatków mieszkaniowych (DM), Stypendiów (ST) oraz POMOST Std. Wiadomości te będą zawierać informacje na temat procesu decyzyjnego złożonych w Jednostce wniosków o przyznanie świadczeń. Usługę Sygnity SmsService można zainstalować w środowisku Windows zarówno na stacji klienckiej lub serwerze z systemami dziedzinowymi, jak i na komputerze bez systemów dziedzinowych. Uwaga! Niezbędnym wymogiem do poprawnego działania usługi jest: możliwość nawiązania połączenia sieciowego z serwera systemów dziedzinowych do ww. usługi poprzez port TCP domyślnie port o numerze 9184; możliwość nawiązania połączenia sieciowego poprzez port 8443, przez który odbywa się komunikacja z platformą obsługującą wysyłanie powiadomień SMS; zainstalowana Java JRE 8 lub Java JDK 8. Uwaga! Jeśli usługa jest instalowana na serwerze, na którym zainstalowana jest Java JDK w wersji 7 (wcześniej zalecaną przy instalacji systemów dziedzinowych jest wersja JDK 7 update 15), to należy ją zaktualizować do wersji udostępnionej na serwerze FTPS (Java JDK 8). Plik instalacyjny usługi SmsService_v1.1.0 należy skopiować na dysk komputera, na którym będzie prowadzona instalacja, następnie uruchomić go. Po uruchomieniu pliku otworzy się okno "Instalacja Sygnity SmsService", w którym będą prezentowane kolejne kroki, umożliwiające instalację usługi. Po przeczytaniu zawartych w oknie informacji wybieramy przycisk Dalej >. 2
Wskazujemy lokalizację katalogu, w którym chcemy zainstalować usługę W przypadku, gdy podpowiedziana lokalizacja nie jest właściwa, to za pomocą przycisku Zmień wskazujemy poprawną. Wybieramy przycisk Dalej>. Następnie uzupełniamy parametry konfiguracji usługi: Port usługi port, na którym będzie nasłuchiwać instalowana aplikacja; Port konsoli usługi port, na którym uruchamiana będzie konsola administracyjna usługi, służąca do sprawdzenie jej stanu; Uwaga! Instalator podpowiada domyślne porty: 9184 (Port usługi), 9185 (Port konsoli usługi). Jeśli nie ma do tego przeciwskazań, to zaleca się pozostawienie domyślnie podpowiedzianych portów. Numer klienta numer otrzymany w odpowiedzi na złożone zamówienie usługi; Adres email Jednostki adres, na który wysyłane będą komunikaty administracyjne dotyczące stanu usługi, np. powiadomienia o kończącym się pakiecie SMS ów Wybieramy przycisk Dalej>. 3
Wybieramy rodzaj sposobu uruchamiania usługi. Wybranie opcji Zainstaluj SmsService jako usługę uruchamianą przy starcie systemu operacyjnego spowoduje, że na liście usług systemowych zostanie dodana usługa, uruchamiana automatycznie wraz ze startem systemu operacyjnego. Wybranie opcji Zainstaluj SmsService jako aplikację uruchamianą przy starcie systemu operacyjnego spowoduje, że serwer będzie uruchamiany po zalogowaniu się do systemu operacyjnego na podstawie skrótu umieszczonego w Autostarcie. Wybieramy przycisk Dalej>. Otworzy się okno zawierające informację o parametrach wykonywanej instalacji. Po przeczytaniu zawartych w oknie informacji wybieramy przycisk Dalej>. 4
Rozpocznie się proces instalacji plików. Po zakończeniu instalacji plików, jeśli w trakcie konfiguracji nie pojawią się żadne błędy, otworzy się okno, informujące o pomyślnym zainstalowaniu usługi. Po wybraniu przycisku Zakończ nastąpi zakończenie instalacji usługi. Jeśli w trakcie instalacji nie pojawiły się żadne problemy ani komunikaty o błędach, możemy uznać, że instalacja usługi zakończyła się powodzeniem. Po zakończeniu instalacji musimy zrestartować komputer. Po zainstalowaniu usługi Sygnity SmsService w systemach dziedzinowych należy: włączyć funkcjonalność obsługi powiadomień SMS. Szczegółowy sposób włączenia funkcjonalności znajduje się w rozdziale Włączenie obsługi powiadomień SMS i/lub E-mail w oddzielnych instrukcjach korzystania z funkcjonalności powiadomień w systemach dziedzinowych; skonfigurować połączenie z usługą Sygnity SmsService, wybierając menu Administracja>Usługi>Konfiguracja usług i wprowadzając oknie Konfiguracja usługi na zakładce Usługa SMS adres serwera, na którym została zainstalowana usługa oraz numery portów, z których korzysta usługa Sygnity SmsService. 5
Uwaga! Domyślnie system jako Adres serwera podpowiada adres: http://localhost. Jeżeli usługa została zainstalowana na tym samym serwerze co serwer systemów dziedzinowych, to nie ma potrzeby zmieniania domyślnego adresu serwera. Jeżeli usługa została zainstalowana na innym serwerze niż serwer systemów dziedzinowych, to konieczne jest wprowadzenie adresu serwera, na którym została zainstalowana usługa Sygnity SmsService. Uwaga! Domyślnie system podpowiada numery portów: 9184 (Port usługi), 9185 (Port konsoli). Jeżeli podczas instalacji usługi pozostawione zostały domyślne porty, to nie ma potrzeby zmiany domyślnych portów. Jeżeli zainstalowana usługa korzysta z innych portów, to konieczne jest wprowadzenie właściwych portów. Za pomocą przycisku Sprawdź połączenie mamy możliwość sprawdzenia poprawności konfiguracji połączenia z usługą. Wynik sprawdzenia zostaje wyświetlony w polu Test usługi. Dodatkowo na zakładce Usługa SMS należy dokonać rejestracji klienta (Jednostki) na platformie obsługującej przesyłanie powiadomień SMS. W tym celu wprowadzamy Login i Hasło dla klienta usługi, a następnie wybieramy przycisk Rejestruj Klienta. Informacja o tym, czy rejestracja klienta przebiegła prawidłowo zostanie wyświetlona w polu Test usługi. Uwaga! Przeprowadzenie rejestracji klienta (Jednostki) na platformie obsługującej przesyłanie powiadomień SMS konieczne jest, aby było możliwe wysyłanie powiadomień SMS. Podczas rejestracji klienta (Jednostki) jest generowany, a następnie wysyłany klucz sprzętowy, za pomocą którego usługa identyfikuje się w komunikacji z platformą obsługującą przesyłanie powiadomień SMS. W przypadku zmian konfiguracji sprzętowej serwera, na którym usługa jest zarejestrowana, należy ponownie wykonać rejestrację klienta. Począwszy od wersji 1.1.0 usługi Sygnity SmsService możliwe jest wyłączenie generowania klucza sprzętowego poprzez zmianę w pliku conf/config.yml (w katalogu, w który zainstalowano usługę). W tym celu należy zmodyfikować linię: czystalykluczsprzetowy : N na czystalykluczsprzetowy : T Po tej zmianie należy ponownie zarejestrować klienta i od tej pory zmiany sprzętowe nie będą już miały znaczenia. Szczegółowy sposób konfiguracji połączenia z usługą oraz obsługi funkcjonalności powiadomień w systemach dziedzinowych został opisany w oddzielnych dokumentach Instrukcja korzystania z funkcjonalności elektronicznych powiadomień (SMS, E-mail) dostępnej w Oprogramowaniu do obsługi Świadczeń (SR/FA/SW/DM/ST) i Instrukcja korzystania z funkcjonalności elektronicznych powiadomień (SMS, E-mail) dostępnej w systemie POMOST Std. W przypadku udostępnienia nowej wersji usługi, należy wykonać jej aktualizację. Aktualizacja usługi jest niezależna od aktualizacji systemu dziedzinowego, w którym usługa jest wykorzystywana. W tym celu na dysk komputera, na którym będzie prowadzona instalacja należy skopiować paczkę aktualizacyjną udostępnioną na serwerze FTPS, a następnie uruchomić instalator. Uwaga! Instrukcja instalacji, konfiguracji oraz obsługi programów Total Commander i FileZilla w zakresie przesyłu plików z serwera i na serwer FTPS znajduje się pod linkiem: http://public.sygnity.pl/sites/default/files/inne/instrukcjaftps.pdf Uwaga! Przed przystąpieniem do aktualizacji należy zatrzymać usługę Sygnity SmsService! 6
Jeżeli usługa została wcześniej zainstalowana w innej wersji, wówczas instalator to wykryje i otworzy się okno aktualizacji usługi. Po przeczytaniu zawartych w oknie informacji wybieramy przycisk Dalej >. Rozpocznie się proces instalacji plików. Po zakończeniu instalacji plików pojawi się okno informujące o zakończeniu instalacji, w którym wybieramy przycisk OK. Aby nowe funkcjonalności były dostępne w systemie dziedzinowym, to po zakończeniu aktualizacji usługi należy również zaktualizować system dziedzinowy. 7