DOKUMENTACJA TECHNICZNA KAMSOFT S.A. 40-235 Katowice ul. 1-Maja 133 Tel. (032) 2090705, Fax. (032) 2090715 http://www.kamsoft.pl, e-mail: 5420@kamsoft.pl SYSTEM INFORMATYCZNY NR KATALOGOWY 2334PI06.00 WYDANIE 2014.02.0.1 I AKTUALIZACJI SYSTEMU Katowice, 2014 r. Strona 1 z 18
DOKUMENTACJA TECHNICZNA SPIS ZAWARTOŚCI 1. Instalacja systemu... 3 1.1. Wybór języka... 3 1.2. Powitanie, informacje ogólne... 3 1.3. Rodzaj instalacji i baza danych... 4 1.4. Połączenie z bazą danych Oracle... 4 1.5. Licencje... 5 1.6. Wybór produktów... 6 1.7. Ustawienia główne serwera Tomcat... 8 1.8. Ustawienie produktów dla serwera Tomcat... 8 1.9. Podsumowanie... 9 1.10. Instalacja... 10 1.11. Zakończenie procesu instalacji... 10 2. Czynności poinstalacyjne... 11 2.1. wdzanie poprawności kompilacji pakietów na schemacie SEW... 11 2.2. Wskazywanie pliku licencji... 11 2.3. Konfiguracja widoków w bazie danych (tylko w przypadku aktualizacji systemu )... 12 2.4. Konfiguracja systemu archiwizacji... 12 2.5. Konfiguracja poziomu zapisu logów... 13 3. Definiowanie operatora przy pomocy Administratora Windows.... 14 3.1. Utworzenie operatora... 14 3.2. Nadawanie uprawnień operatorom... 15 4. Konfiguracja po instalacyjna w hurtowni z oprogramowaniem KAMSOFT (wykonywana wyłącznie z oprogramowaniem KS-HFW)... 15 Strona 2 z 18
DOKUMENTACJA TECHNICZNA 1. INSTALACJA SYSTEMU Aby rozpocząć instalację systemu, należy w katalogu głównym instalatora uruchomić ksinstal.exe oraz postępować zgodnie z poniższymi punktami. 1.1. Wybór języka W pierwszej kolejności pojawia się okno z możliwością wyboru języka, który będzie użyty w procesie instalacji systemu. Do wyboru mamy dwa języki: Polski, Angielski. 1.2. Powitanie, informacje ogólne Okno instalatora podzielone jest na dwie sekcje. W dolnej części umieszczone są przyciski: Wstecz cofnięcie się do poprzedniego etapu, Dalej przejście do następnego etapu, Zamknij zakończenie pracy instalatora. Pozostały obszar przeznaczony jest do wyświetlania i zbierania informacji. Ilość etapów instalacji oraz prezentowane w nich informacje różnią się w zależności od udzielonych wcześniej odpowiedzi. Z wieloma obiektami powiązana jest informacja opisująca dany obiekt. Informacja ta zostaje wyświetlona po wskazaniu obiektu wskaźnikiem myszy. Strona 3 z 18
DOKUMENTACJA TECHNICZNA 1.3. Rodzaj instalacji i baza danych Na formatce istnieje możliwość wyboru rodzaju instalacji oraz bazy danych. W przypadku instalacji Rodzaj instalacji powinien zostać określony jako Serwer, natomiast w przypadku Bazy danych należy wybrać Oracle 1.4. Połączenie z bazą danych Oracle W oknie tym, należy podać niezbędne parametry i hasła identyfikujące bazę danych. W polu Nazwa bazy danych należy wpisać alias docelowej bazy danych. W przypadku pierwszej instalacji należy podać hasła do schematu SYS, SYSTEM, oraz KS, w celu umożliwienia instalatorowi dokonania powiązań ze schematem SEW. Strona 4 z 18
DOKUMENTACJA TECHNICZNA UWAGA W przypadku, gdy w systemie istnieją inne produkt firmy KAMSOFT korzystające ze schematu wspólnego KS, należy zwrócić szczególną uwagę w punkt 1.5 Wybór produktów czy instalator zamierza aktualizować produkt KS-ZSI. Aktualizacja KS-ZSI bez aktualizacji innych systemów korzystających ze schematu wspólnego może spowodować problemy z ich działaniem (np. system hurtowy KS-HRT z zainstalowaną starszą wersją KS-ZSI). UWAGA Może dojść do sytuacji, gdzie instalator nie będzie w stanie poprawnie odczytać ustawień kodowania znaków w Oracle. W przypadku pojawiania się poniższego komunikatu proszę wybrać Nie: 1.5. Licencje W przypadku, gdy w poprzednim punkcie podano hasło do schematu KS zostanie wyświetlone okno z możliwością wskazania pliku licencji. Jeżeli pole Plik licencji pozostanie puste, wówczas licencja zostanie odczytana z bazy danych. W przypadku, gdy nie podano hasła do schematu KS należy w polu Schemat podać nazwę użytkownika posiadającego dostęp do licencji (SEW), natomiast w polu Hasło do schematu wpisać hasło użytkownika SEW. Strona 5 z 18
DOKUMENTACJA TECHNICZNA 1.6. Wybór produktów Należy zaznaczyć wybrane do instalacji/aktualizacji produkty. W oknie Lista dostępnych produktów przedstawione są dostępne produkty wraz z odnaleziona już zainstalowaną ich wersją. Wybór produktów zaznaczonych kolorem szarym odbywa się automatycznie na podstawie odnalezionej wersji. Wyszukiwanie wersji odbywa się przy użyciu podanych poniżej informacji takich jak: ścieżka, użytkownik bazy danych i hasło. Lista opcji do uzupełnienia jest różna dla różnych produktów. Poniżej przedstawiono opis możliwych parametrów: Lokalna ścieżka produktu miejsce docelowe kopiowania plików aplikacji na dysku lokalnym, Użytkownik BD nazwa użytkownika bazy danych, który jest właścicielem obiektów aplikacji, Hasło użytkownika BD hasło użytkownika BD określonego w parametrze Użytkownik BD, Cień w osobnym schem. czy tabele cienie mają być tworzone w osobnym schemacie. Wartość należy pozostawić na NIE. Strona 6 z 18
DOKUMENTACJA TECHNICZNA W przypadku, gdy licencja pozwala zainstalować na kilku schematach, aktywny staje się przycisk i korzystając z niego należy wybrać właściwy schemat, na którym ma zostać zainstalowany system następnie nacisnąć OK. UWAGA W przypadku, gdy instalator ma zamiar zaktualizować produkt KS-ZSI, tzn. w oknie instalatora Wybór produktów (okno przedstawiono poniżej) jest zaznaczone pole przy produkcie KS-ZSI, a w systemie zainstalowane są inne programy firmy KAMSOFT korzystające ze wspólnego schematu KS, należy przerwać instalację i dokonać podmiany pliku ksinzsi.dll, znajdującego się w katalogu głównym instalatora, na plik ksinzsi.dll, starszej wersji udostępniony przez firmę KAMSOFT na serwerze FTP pod adresem: ftp://2200@ftp.kamsoft.pl/2230//wersje/, nazwa pliku: ksinzsi_old.zip. Hasło do serwera FTP można uzyskać przesyłając prośbę na maila: 5420@kamsoft.pl Po dokonaniu podmiany należy powtórzyć cały proces instalacji. Aktualizacja produktu KS-ZSI bez aktualizacji innych systemów korzystających ze schematu wspólnego może spowodować ich nieprawidłową pracę. Strona 7 z 18
DOKUMENTACJA TECHNICZNA 1.7. Ustawienia główne serwera Tomcat Następnie należy wprowadzić odpowiednie parametry dotyczące ustawień serwera Tomcat: Lokalizację, w której zostanie zainstalowany serwer Tomcat, Wskazać katalog, w którym zostanie zainstalowane środowisko JAVA, Prefiks portów (ustawiony na 0 pozwala wpisać różne prefiksy dla portów), dla przykładu ustawienie prefiksu portu na 2 spowoduje automatyczną edycję pozostałych portów, każdy z portów będzie zaczynał się od cyfry 2, Port zdalnego zamykania, Połączenie HTTP (port, początkowa liczba połączeń, maksymalna liczba połączeń), nie jest wymagane dla instalacji, Połączenie HTTPS (port dla połączeń szyfrowanych, początkowa liczba połączeń, maksymalna liczba połączeń). Podany port stanowi część składową adresu serwera hurtowni. Uzupełnienie pola jest wymagana podczas instalacji. W przypadku, gdy po podaniu numeru portu pole z tym numerem zostanie podświetlone na czerwono oznacza to, że podany port jest używany przez inną usługę i należy wskazać inny. 1.8. Ustawienie produktów dla serwera Tomcat Strona 8 z 18
DOKUMENTACJA TECHNICZNA Kolejnym oknem w instalatorze jest możliwość ustawienia powiadomień o wszelkich nieprawidłowościach, które mogą wystąpić podczas pracy serwera Tomcat (konfiguracja tej opcji nie jest konieczna i można od razu wybrać Dalej). Aby jednak ustawić powiadomienia o nieprawidłowościach należy uzupełnić wszystkie pola dla produktu : Adres SMTP, w tym polu należy podać adres serwera poczty wychodzącej, Użytkownik SMTP, nazwa użytkownika dla poczty wychodzącej, Hasło SMTP, podanie hasła dla tego użytkownika w celu prawidłowej konfiguracji, Adres email nadawcy, w tym polu podajemy adres nadawcy wiadomości, Adres email odbiorcy, pole które pozwala na podanie listy adresów odbiorców do których ma zostać wysłana informacja na temat nieprawidłowości występujących podczas pracy serwera Tomcat. Przedział czasu, podany w sekundach. Co ile jednostek czasu ma przesyłać powiadomienie. 1.9. Podsumowanie W oknie tym prezentowane jest zestawienie konfiguracji zdefiniowanej przez użytkownika. W przypadku potrzeby modyfikacji należy nacisnąć przycisk Wstecz, naciśnięcie przycisku Instaluj rozpocznie proces instalacji. W kolejnym kroku rozpocznie się proces instalacji/aktualizacji Strona 9 z 18
DOKUMENTACJA TECHNICZNA 1.10. Instalacja W czasie trwania instalacji jest wyświetlania informacja o aktualizowanych elementach i ogólnym postępie. Jeśli podczas jakiejś operacji wystąpi błąd, wyświetlany jest odpowiedni komunikat. W komunikacie tym opisane jest polecenie, które błąd spowodowało. Komunikat prosi o odpowiedź na pytanie, czy kontynuować instalację pomimo błędu. Komunikat pokazywany jest przez 10 sekund, po których upłynięciu udzielana jest odpowiedź Tak. Dodatkowo mamy dostępne przyciski: Nie przerywa proces, Zawsze tak odpowiada Tak na pozostałe błędy tego samego typu oraz Zatrzymaj zatrzymujący zegar odliczający 10 sekund do automatycznego naciśnięcia przycisku Tak. Wszystkie błędy programu oraz informacje o wykonanych czynnościach zapisywane są w pliku ksinstall.log w folderze instalatora. W przypadku wystąpienia niektórych błędów istnieje możliwość ich ręcznej korekcji. UWAGA Jeżeli podczas instalacji wyświetlone zostało okienko z możliwością wyboru zestawu słowników proszę wybrać Domyślny. 1.11. Zakończenie procesu instalacji Po zakończeniu instalacji program wyświetli informację o pomyślnym jej zakończeniu. Zaznaczenie pola Pokaż szczegółowy log instalacji spowoduje wyświetlenie informacji o przebiegu procesu instalacji. Z tego miejsca użytkownik może nacisnąć przycisk ESC Zamknij i tym samym zakończyć działanie instalatora. Strona 10 z 18
DOKUMENTACJA TECHNICZNA 2. CZYNNOŚCI POINSTALACYJNE Po instalacji lub aktualizacji systemu należy wykonać poniższe czynności finalizujące proces instalacji. 2.1. wdzanie poprawności kompilacji pakietów na schemacie SEW Po dokonaniu instalacji lub aktualizacji systemu należy sprawdzić w bazie danych na schemacie SEW czy są nie występują błędne pakiety. W przypadku stwierdzenia ich występowania należy skontaktować się z Sekcją Platformy KS-EWD (5420@kamsoft.pl) w celu udostępnienia źródeł błędnych pakietów. 2.2. Wskazywanie pliku licencji UWAGA Podpunkt ten należy wykonać tylko w sytuacji, gdy po instalacji lub aktualizacji, aplikacja Tomcat nie uruchamia się poprawnie z komunikatem wskazującym na niepoprawny lub uszkodzony plik licencji. Po instalacji należy odszukać opcję: I wskazać ścieżkę dostępu do pliku licencji. Strona 11 z 18
DOKUMENTACJA TECHNICZNA C:\KS\\licencja.ktl przykładowa ścieżka. Jeśli w nie można odnaleść opcji LIC_FILE należy ją dograć. W tym celu należy wykonać INSERT na schemacie SEW: INSERT INTO OPD (NOPD,ZMIE,WART,OPIS,INST,KODW) VALUES (68,'LIC_FILE',null,'Plik z licencją.','n','n'); 2.3. Konfiguracja widoków w bazie danych (tylko w przypadku aktualizacji systemu ) Po dokonaniu aktualizacji systemu instalator podmienia widoki zdefiniowane w bazie danych, wykonując jednocześnie kopie starych widoków poprzez dodanie przyrostka _OLD_<MMDD> gdzie: MM miesiąc utworzenia widoku DD dzień utworzenia widoku W takim przypadku należy porównać oba widoki (nowy bez przyrostka _OLD_<MMDD> ze starym z przyrostkiem _OLD_<MMDD>) w celu wykrycia różnic. Mogą wystąpić następujące przypadki: Oba widoki są dokładnie takie same wówczas można usunąć stary widok, W nowym widoku pojawiła się definicja nowej kolumny (reszta warunków jest bez zmian) wówczas można usunąć stary widok, Definicja kolumn w obu widokach jest taka sama, natomiast w starym widoku są inne warunki niż w nowym wówczas należy usunąć przyrostek _OLD_<MMDD> ze starego widoku, zastąpić nowy widok starym widokiem, odświeżyć listę widoków oraz usunąć widok przyrostkiem _OLD_<MMDD>, W nowym widoku pojawiła się definicja nowej kolumny oraz w starym widoku są inne warunki niż w nowym wówczas do nowego widoku należy przekleić warunki ze starego widoku, nadpisać nowy widok oraz usunąć widok przyrostkiem _OLD_<MMDD>. 2.4. Konfiguracja systemu archiwizacji UWAGA Aby możliwa była konfiguracja systemu archiwizacji należy posiadać operatora systemu. W przypadku, gdy nie jest on jeszcze założony należy przejść do rozdziału Definiowanie operatora przy pomocy Administratora Windows. Aby uruchomić archiwizację systemu należy w Administratorze WWW w zakładce ZADANIA włączyć Archiwizację: Strona 12 z 18
DOKUMENTACJA TECHNICZNA W systemie parametry dotyczące archiwizacji należy skonfigurować za pomocą poniższych opcji: ARCH_MAX_ROWS określa ilość wpisów, jaka może się znajdować w tabeli rejestru zleceń, wszystkie pozostałe rekordy rejestru zostaną przeniesione do archiwum po uruchomieniu zadania archiwizacji, ARCH_VALIDITY określa datę, jaką mogą posiadać wpisy w tabeli rejestru zleceń, wpisy ze starszą datą zostaną przeniesione do archiwum po uruchomieniu zadania archiwizacji, ARCH_DELETE_ROWS opcja określająca czy wpisy z tabel mają być usuwane czy też archiwizowane. 2.5. Konfiguracja poziomu zapisu logów Poziom zapisu logów ustala się w Administratorze WWW w opcji LOG_LEVEL. W zależności od ustalonej wartości, do plików z logami będą zapisywane bardziej lub mniej szczegółowe informacje. Dostępne są cztery wartości tej opcji: ERROR do pliku zostaną zapisane jedynie błędy, WARN do pliku zostaną zapisane błędy, oraz ostrzeżenia, INFO do pliku zostaną zapisane błędy, ostrzeżenia, oraz informacje, DEBUG najbardziej szczegółowy zapis do pliku. W pliku zostaną zapisane wszystkie kroki wykonane przez system. Wartością domyślną tej opcji jest poziom logowania ERROR. UWAGA W przypadku, gdy w systemie nie jest wykorzystywane źródło katalogowe należy w administratorze WWW w zakładce ŹRÓDŁA wyłączyć Lokalny katalog serwera (wyłączyć pole Aktywne) Strona 13 z 18
DOKUMENTACJA TECHNICZNA 3. DEFINIOWANIE OPERATORA PRZY POMOCY ADMINISTRATORA WINDOWS. Aby zdefiniować użytkownika systemu należy uruchomić plik KSSEW.exe znajdujący się w Lokalnej ścieżce produktu (domyślnie C:\KS\\). 3.1. Utworzenie operatora W menu głównym Administratora Windows należy kliknąć na Moduł administracyjny 61 Administrator Następnie należy podać nazwę oraz hasło operatora uprawnionego do dostępu do tej aplikacji. Domyślnie wyświetlone zostanie okno Autoryzacja z użytkownikiem KSADM (hasło dla użytkownika KSADM jest puste), aby przejść dalej należy wybrać OK. W oknie Administrator należy wybrać przycisk C1Uprawn. Następnie w zakładce Operatorzy należy wybrać przycisk okno pozwalające zdefiniować nowego operatora systemu., aby utworzyć operatora. Wyświetlone zostanie Strona 14 z 18
DOKUMENTACJA TECHNICZNA Możliwe jest także ustalenie hasła dla wprowadzanego użytkownika. W tym celu, należy użyć funkcji CF4 Zm. Hasło, po której wywołaniu wyświetlone zostanie okno umożliwiające ustalenie nowego hasła dla operatora. Aby ustalić hasło dla operatora systemu należy wypełnić pole Hasło, a następnie powtórzyć ustalone hasło w polu Potwierdzenie. Po poprawnym wypełnieniu pól należy tak ustalone hasło zatwierdzić, poprzez przycisk ENT OK oraz potwierdzić wprowadzone modyfikacje klikając na TAK. W celu zapisania wszystkich danych na Karcie nowego operatora należy wybrać ENT OK. 3.2. Nadawanie uprawnień operatorom W przypadku nadawanie uprawnień indywidualnych operatorowi, należy w tabeli uprawnień znajdującej się na zakładce Operatorzy zaznaczyć uprawnienie, jakie ma zostać przydzielone wybranemu operatorowi. Następnie posługując się myszą należy skierować kursor nad pole kolumny Może wybranego uprawnienia i poprzez dwukrotne klikniecie lewym przyciskiem w tym polu przełączać opcje określające nadanie lub odebranie uprawnienia. Wybór uprawnienia sygnalizowany jest przez pojawienie się w kolumnie Może jednego ze znaczników: Znacznik - sygnalizuje ze uprawnienie zostało nadane indywidualnie. Operator ma możliwość wykonywania funkcji systemowej określonej przez to uprawnienie, Znacznik - sygnalizuje ze operatorowi zablokowano możliwość wykonywania funkcji systemowej określonej przez to uprawnienie, Brak znacznika sygnalizuje ze uprawnieniu nie został nadany żaden status, w związku z tym operator nie może wykonywać funkcji systemowych określonych przez to uprawnienie. Wśród wszystkich uprawnień istnieje uprawnienie o nazwie Wszystkie uprawnienia, na liście zaznaczone na czerwono (identyfikowane jako moduł: SW00 i numerze 00000), które nadaje wszystkie uprawnienia do systemu. Zalecane jest, aby to uprawnienie mięli nadane tylko administratorzy systemu. 4. KONFIGURACJA PO INSTALACYJNA W HURTOWNI Z OPROGRAMOWANIEM KAMSOFT (WYKONYWANA WYŁĄCZNIE Z OPROGRAMOWANIEM KS-HFW) W celu prawidłowego działania pomiędzy klientem bezpośrednim (np.apteką), a hurtownią posiadającą system hurtowy KS-HRT należy, po prawidłowej instalacji, wykonać następujące czynności: W pliku server.xml znajdującym się w katalogu: c:\ks\tomcat\4.1.x\conf\, należy skonfigurować połączenie ze schematem hurtowym. Poniżej przedstawiono definicję zasobu (RESOURCE) jaki należy wprowadzić do pliku server.xml w celu konfiguracji połączenia z bazą danych. Kolorem niebieskim zaznaczono parametry serwera jakie należy podać. Strona 15 z 18
DOKUMENTACJA TECHNICZNA <DefaultContext reloadable="true">... ------------------------------------------------------------------------ <Resource name="hurt" auth="container" type="javax.sql.datasource"/> <ResourceParams name="hurt"> <name>factory</name> <value>org.apache.commons.dbcp.basicdatasourcefactory</value> <name>driverclassname</name> <value>oracle.jdbc.driver.oracledriver</value> <name>url</name> <value>jdbc:oracle:thin:@ip_serwera:port:alias</value> <name>username</name> <value>nazwa_schematu_hurtowego</value> <name>password</name> <value>hasło_do_schematu_hurtowego</value> <name>maxactive</name> <value>20</value> <name>maxidle</name> <value>20</value> <name>maxwait</name> <value>30000</value> <name>validationquery</name> <value>select * from dual</value> <name>logabandoned</name> <value>true</value> <name>removeabandoned</name> <value>true</value> <name>removeabandonedtimeout</name> <value>300</value> </ResourceParams> ------------------------------------------------------------------------... Strona 16 z 18
DOKUMENTACJA TECHNICZNA </DefaultContext> Oprócz tego w już istniejącym połączeniu, które zaczyna się od poniższego węzła: <ResourceParams name="jdbc/kssew"> <name>factory</name> <value>org.apache.commons.dbcp.basicdatasourcefactory</value>.. należy poprawić dwa parametry maxactive i maxidle na wartość 20 <name>maxactive</name> <value>20</value> <name>maxidle</name> <value>20</value> A następnie za parametrem maxwait dokleić kolejne parametry: validationquery, logabondoned,removeabandoned oraz removeabandonedtimeout <name>validationquery</name> <value>select * from dual</value> <name>logabandoned</name> <value>true</value> <name>removeabandoned</name> <value>true</value> <name>removeabandonedtimeout</name> <value>300</value> Na schemacie hurtowym należy wykonać skrypt hurt.sql, znajdujący się w folderze Skrypty w lokalizacji instalatora, UWAGA W celu poprawnej obsługi zamówień elektronicznych należy na schemacie hurtowym wykonać skrypt akt_hurt_zam_20100100.sql. Następnie na schemacie SEW należy wykonać skrypt sew_hurt.sql, znajdujący się w w/w lokalizacji. W Administratorze WWW, w zakładce OPCJE, należy skonfigurować opcję DST_HST_DIR jak przedstawiono poniżej: Strona 17 z 18
DOKUMENTACJA TECHNICZNA W kolumnie Wartość, należy podać ścieżkę dostępu do katalogu elektronicznej wymiany danych. Ważne jest, aby wprowadzona ścieżka była zgodna ze ścieżką podaną w systemie hurtowym. Strona 18 z 18