GMSTHostService Pomoc do programu 1/14
Spis treści 1.Rejestracja...3 1.1.Pierwsza rejestracja...3 1.2.Ponowna rejestracja produktu...8 2.Podstawowe informacje o GMSTHostService...8 3.Przykładowa konfiguracja środowiska dla GMSTHostService...10 3.1.Konfiguracja systemowego firewalla...10 3.2.Przygotowanie bazy danych...11 3.2.a)Przygotowanie bazy danych do pracy...12 3.3.Konfiguracja GMSTHostService...13 4.Bezpieczeństwo...14 2/14
1. Rejestracja Aby rozpoaczać rejestrację, należy włączyć GmstHostConfigurator a następnie wybrać Registration. Ilustracja 1: Okno startowe usługi GMSTHostService W przypadku zainstalowania programu na systemie operacyjnym posiadającym rozbudowane funkcje administracyjne (np. MS Windows: Vista, 7, 8) aby program zarejestrować należy uruchomić go w trybie administratora, w przeciwnym przypadku na ekranie pojawi się komunikat a rejestracja nie będzie możliwa. 1.1. Pierwsza rejestracja Ilustracja 2: Brak uprawnień administratora Po wybraniu polecenia Rejestracja otworzone zostanie okno rejestracji produktu. Akceptacja warunków licencji uaktywni opcje Rejestracji produktu. Naciśnięcie przycisku Next spowoduje przejście do kolejnego kroku. 3/14
Ilustracja 3: Pierwsza rejestracja, licencja Każdy zakupiony program posiada kartę instalacyjną, na której nadrukowany jest unikatowy 32 cyfrowy klucz produktu. Klucz ten należy wprowadzić w linię edycyjną. Ilustracja 4: Przykładowa karta rejestracyjna 4/14
Ilustracja 5: Okno do wpisania klucza produktu Ilustracja 6: Okno wpisana danych użytkownika programu Jeśli wpisany klucz jest poprawny, program uaktywni przycisk Next i po jego naciśnięciu wyświetlone zostanie okno wpisu danych użytkownika programu. Po wypełnieniu pozostałych pól program uaktywni przycisk Dalej. Kolejnym korkiem jest 5/14
wybór sposobu rejestracji: Ilustracja 7: Wybór sposobu rejestracji By Internet program łączy się z serwerem, rejestruje użytkownika i od razu aktywuje program, Save registration data in file on Desktop wybór tej opcji spowoduje zapis danych do pliku tekstowego na pulpicie ekranu. Plik ten można wysłać poprzez e-mail do DASL Systems na adres serwis@dasl.pl, Jeżeli jest to kolejna rejestracja, można wybrać opcję Do not send registration. I have already activation code. Program przejdzie wtedy od razu do trybu wpisywania klucza aktywującego. Jeśli rejestracja została przeprowadzona przez Internet, w przypadku poprawnej rejestracji zostanie wyświetlony komunikat o pomyślnym zakończeniu procesu, program automatycznie pobierze z serwera kod aktywacyjny, bez udziału użytkownika. Ilustracja 8: Okno potwierdzające udaną rejestrację przez internet 6/14
W przypadku, gdy rejestracja przez Internet została przyjęta, ale z jakichś przyczyn wstrzymana, wówczas zostanie wyświetlony odpowiedni komunikat, a w ciągu 48 godzin od rejestracji (dotyczy dni roboczych) Użytkownik otrzyma drogą mailową klucz aktywacyjny, bądź informację (również drogą mailową) o przyczynie wstrzymania rejestracji). W przypadku otrzymania klucza aktywacyjnego przez e-mail, otrzymane klucze należy wprowadzić do programu. Aby tego dokonać należy włączyć rejestrację programu i wybrać Step 2 Activation. Ilustracja 9: Krok drugi, aktywacja Program przejdzie do trybu wpisywania klucza aktywującego. Po wpisaniu klucza, w przypadku pozytywnej weryfikacji kluczy, program zostanie zarejestrowany. 7/14
Ilustracja 10: Okno potwierdzające rejestracje produktu 1.2. Ponowna rejestracja produktu Uwaga! Licencja na program jest jednostanowiskowa. Instalacja na innym stanowisku może odbyć się na następujących warunkach: 1. Należy przesłać oświadczenie, że poprzednio aktywowana kopia programu jest odinstalowana lub wyrejestrowana.wtedy po wysłaniu oświadczenia należy zarejestrować się ponownie na nowym stanowisku. 2. Nie można zarejestrować i aktywować programu na innym stanowisku do 6 miesięcy od ostatniej aktywacji. Jeżeli użytkownik aktywuje program na tym samym komputerze i tym samym środowisku systemowym, może posłużyć się tymi samymi danymi, których użył podczas ostatniej rejestracji. Należy pamiętać jednak, że nazwa użytkownika musi być identyczna (co do znaku i wielkości liter), dlatego zalecamy korzystanie z danych elektronicznych i wpisywanie ich do formularza metodą kopiuj/wklej. 2. Podstawowe informacje o GMSTHostService Aby uruchomić program, należy posiadać aktualny.net Framework (min. 4.5). Jest to standardowa biblioteka systemu Microsoft Windows. Z uwagi na różnorodne przeznaczenie maszyn(serwerów, komputerów) nie każda wersja systemu Windows posiada zainstalowany dodatek.net Framework. Aby zainstalować aktualną wersję dodatku należy wejść na http://www.microsoft.com/pl-pl/download/details.aspx?id=30653 8/14
Ilustracja 11: Główne okno konfiguracji usługi GMSTHostService Service URL: Adres rozgłoszeniowy usługi GMSTService. Domyślnie adres przyjmuje http://localhost:1234/gmstservice. Adres usługi można zmienić. Aby to zrobić należy wpisać w polu Service URL wybrany adres. Użytkownik powinien zadbać, aby port podany w URL nie był zablokowany na firewallu. W przypadku zablokowania portu na zewnętrznym bądź wewnętrznym firewallu, użytkownicy zdalni nie będą mogli się połączyć z usługą GMST. Ilustracja 12: Konfiguracja portu dla usługi Database connection string: Ciąg znaków zawierający dane dostępu do bazy danych. Aktualnie GMSTHostService wspiera MS SQL serwer. Zalecana wersja to MS SQL Serwer 2008 lub nowszy. Domyślnie pole to przyjmuje wartość Data Source=localhost;Initial Catalog=GMSTdb;Persist Security Info=True;User ID=gmst;Password=gossen Pole to musi zostać uzupełnione zgodnie z obowiązującym wzorem łącza dla baz MS SQL. Przykładowe łącza: 9/14
Server=myServerAddress;Database=myDataBase;User Id=myUsername; Password=myPassword; Server=myServerAddress;Database=myDataBase;Trusted_Connection=True; Server=myServerName\myInstanceName;Database=myDataBase;User Id=myUsername;Password=myPassword; Użytkownik bazy danych powinien mieć uprawnienia do tworzenia tabel i transakcji, dodawania, usuwania i edycji wierszy w poszczególnych tabelach oraz na łączenie się z bazą danych. Usługa wspiera zarówno bazy w wersji EXPRESS jak i STANDARD. Wersja EXPRESS jest darmową wersją silnika bazy danych MS SQL Serwer. Guzik Start Service jest dostępny tylko w przypadku, gdy usługa zostanie zarejestrowana! 3. Przykładowa konfiguracja środowiska dla GMSTHostService. 3.1. Konfiguracja systemowego firewalla GMSTHostService korzysta z technologi WCF Self-Host Services. Aby można było korzystać z usługi, należy upewnić się, że żadna aplikacja nie nasłuchuje na wybranym przez administratora porcie komunikacyjnym. Z uwagi na konieczność rejestracji usługi WCF program należy uruchomić jako administrator. Jeżeli nie ma możliwości uruchamiania usługi z prawami administratora, system należy skonfigurować zgodnie ze wskazówkami Microsoftu (link: https://msdn.microsoft.com/en-us/library/ms733768.aspx). Aby wejść w ustawienia Firewalla należy otworzyć Control Panel, następnie System and Security Windows Firewall. Ilustracja 13: Standardowe okno konfiguracji Windows Firewall Po otwarciu głównego okna dla Firewalla, należy wybrać Advanced settings, a następnie skonfigurować reguły przychodzące (Inbound Rules). 10/14
Ilustracja 14: Dodawanie nowej reguły Następnie należy postępować zgodnie ze wskazówkami widocznymi na ekranie. Zalecana konfiguracja firewallu to: Rule Type: PORT Protocol and Ports: TCP, Specific local port: <your_port_number> Action: Allow the connection, Profile: Domian, Private, Public, Name: GMSTHostServicePortConfiguration Wybrany port należy zapisać/zapamiętać aby poźniej wpisać go w oknie konfiguracji usługi!(ilustracja 12). 3.2. Przygotowanie bazy danych. W przypadku braku dostępu do bazy danych MS SQL Serwer, na wybranym stanowisku/serwerze należy zainstalować w/w oprogramowanie. Aby pobrać MS SQL Serwer należy użyć łącza: http://www.microsoft.com/pl-pl/server-cloud/products/sql-server-editions/sql-serverexpress.aspx W zależności od potrzeby należy wybrać darmową (Express) lub inna wersję silnika bazy danych. Do zarządzania bazą danych, jej użytkownikami, backupami itp. zalecamy skorzystanie z oprogramowania Microsoft SQL Server Management Studio. Program można pobrać z: http://www.microsoft.com/en-us/download/details.aspx?id=8961 11/14
3.2.a) Przygotowanie bazy danych do pracy Do konfiguracji bazy danych zaleca się użycie programu Microsoft Managment Studio. Po zainstalowaniu bazy danych, należy włączyć Managment Studio. W okienku logowania należy podać adres bazy danych, oraz wybrać sposób uwierzytelniania. Ilustracja 15: Okno logowania do bazy danych Po połączeniu z bazą danych, należy utworzyć użytkownika bazy danych. Aby tego dokonać należy wybrać z drzewa nawigacyjnego gałązkę Security->Logins. Ilustracja 16: Dodawanie nowego użytkownika bazy danych Następnie należy wprowadzić dane użytkownika oraz wybrać rodzaj logowania. Jeżeli serwer nie leży w tej samej domenie/sieci i będzie wystawiony na zewnątrz należy wybrać SQL Serwer authentication. 12/14
Ilustracja 17: Dodawanie użytkownika Należy zadbać o to, by użytkownik bazy danych miał odpowiednie prawa dostępu. Wymagane akcje, podejmowane w ramach działania usługi GMSTHostService to, tworzenie struktury bazy danych (pierwszy start), otwieranie transakcji, cofanie transakcji, akceptowanie transakcji, dodawanie, edytowanie, usuwanie wierszy. Ilustracja 18: Przykład uprawnień użytkownika bazy danych Tak skonfigurowana baza danych pozwala na automatyczne utworzenie bazy danych dla GMSTHostService. 3.3. Konfiguracja GMSTHostService Należy uruchomić program GMSTHostConfigurator. Pamiętając numer portu który został otworzony wcześniej (dział 3.1) wpisujemy w polu Service URL adres pod którym będzie rozgłaszana usługa (np. http://192.168.1.17:1234/gmstservice ). W polu connection string wpisujemy łącze do bazy danych, które powinno uwzględniać takie informacje jak nazwa i hasło użytkownika, adres bazy danych oraz typ zabezpieczeń. Aby ustalić łącze do bazy danych możemy posłużyć się 13/14
programem Microsoft Management Studio. Wybierając z menu opcję properties wyświetlą się opcje połączenia z bazą. W dla tego przypadku konfiguracji, połączenie z bazą danych będzie realizowane przez następujący ciąg znaków: Server=DASL7\SQLEXPRESS;Database=GMSTdb;User Id=GMST; Password=*************;Trusted_Connection=False; 4. Bezpieczeństwo Każde zapytanie do usługi GMSTHostService wymaga przesłania ramki z autoryzacją. Dopiero po wstępnej walidacji ramki, usługa zezwoli na połączenie. Kroki te mają zapewnić bezpieczeństwo składowania danych, oraz zabezpieczenie przed niepowołanym dostępem. Jednakże dla pełnego szyfrowania danych zalecane jest połączenie z hostem na którym wystawiona jest usługa GMSTHostService za pomocą zabezpieczonej sieci VPN. 14/14