Pobierz

PETROIL Serwer 2.0
Instrukcja instalacji i konfiguracji
Wersja dokumentu 1.0
Wstęp.......................................................................................................................................... 3
1. Wymagania sprzętowe i systemowe .................................................................................. 4
2. Instalacja i konfiguracja ..................................................................................................... 5
2.1
Instalacja..................................................................................................................... 5
2.2
Konfiguracja............................................................................................................... 6
3. Program do konfiguracji serwera PetrOil Setting .............................................................. 7
3.1
Konfiguracja logowania zdarzeń................................................................................ 7
3.2
Konfiguracja licencji programu ................................................................................. 8
3.3
Zarządzanie operatorami programu ........................................................................... 9
3.4
Ustawienia typu komunikacji ze sterownikiem ....................................................... 10
3.5
Ustawienie parametrów dystrybutora....................................................................... 11
3.6
Ustawienia parametrów COM’a............................................................................... 12
4. Plik konfiguracyjny config.xml........................................................................................ 14
5. Przeglądarką logów Petroil Log....................................................................................... 16
Wstęp
PETROIL Serwer jest aplikacją synchronizującą aplikacje klienta do obsługi stacji paliw. Jej
zadaniem jest:
- odczyt stanu dystrybutorów
- ustawianie stanu dystrybutorów
- zarządzanie dostępem do bufora tankowań
- uwierzytelnianie operatorów
1. Wymagania sprzętowe i systemowe
Komputer, na którym działa program powinien spełniać następujące wymagania:
• Pamięć operacyjna: min 512 MB,
• Procesor: min. 1GHz.
• Port RS232 do komunikacji ze sterownikiem
• Karta sieciowa
System operacyjny, na którym działa oprogramowanie powinien spełniać następujące
wymagania:
• Microsoft Windows 2000 Professional
• Microsoft Windows XP Professional.
• MS SQL Server 2005.
2. Instalacja i konfiguracja
Aplikacja PETROIL Serwer 2.0 instalowana jest na komputerze do którego dostęp będą
posiadały wszystkie aplikacje klienta zainstalowane na innych komputerach. W czasie
procesu instalacji i konfiguracji potrzebne będą następujące dane:
• adres serwera bazy danych na którym znajdzie się baza danych programu
• nazwa bazy danych programu
• dane licencyjne
• ewentualny adres serwera na którym znajduje się klucz licencyjny ( o ile klucz ten
nie będzie znajdował się na tym samym komputerze do baza danych programu )
2.1
Instalacja
W celu instalacji programu PETROIL Serwer 2.0 należy uruchomić instalator PETROIL.msi.
Po uruchomieniu instalatora należy zaznaczyć instalacje aplikacji serwera – patrz rysunek
poniżej. Aplikacja klienta może zostać zainstalowana razem z aplikacją serwera na jednym
komputerze.
Należy również wprowadzić dane wymagane
oprogramowani o które poprosi instalator.
do
prawidłowego
skonfigurowania
Instalator oprócz kopiowania plików wykona następujące czynności:
• Utworzy skrót do programu w menu START
• Skonfiguruje źródła ODBC o nazwie PETROIL dla dostępu do bazy danych
• Skonfiguruje źródło ODBC o nazwie PETROIL_KEY w przypadku zdalnego serwera
z kluczem licencyjnym
Pozostałe opcje do skonfigurowania opisane są w rozdziale 2.2.
2.2
Konfiguracja
Po zakończeniu procesu instalacji przed uruchomieniem aplikacji serwera należy wykonać
jeszcze kilka czynności konfiguracyjnych:
1. Tworzenie i konfiguracja bazy danych:
•
•
•
•
Utworzyć bazę danych o nazwie np. PETROIL na serwerze którego adres został
podany w czasie procesu instalacji
Stworzenie obiektów programu w bazie danych poprzez uruchomienie skryptu
dbPetroil.sql który został zainstalowany w katalogu programu.
Utworzyć w bazie danych użytkownika petroservice z uwierzytelnieniem SQL dla
usługi programu, oraz dodać go do roli db_petroservice w utworzonej bazie danych
Utworzyć w bazie danych użytkownika petroclient z uwierzytelnieniem SQL dla
aplikacji klienckich, oraz dodać go do roli db_petrooperator w utworzonej bazie
danych
2. Konfiguracja dostępu do klucza licencyjnego:
•
•
•
Jeśli klucz licencyjny znajduje się na innym komputerze niż baza danych programu
utworzenie użytkownika petroservice z takim samych hasłem jak użytkownik
dostępu do bazy programu
Stworzenie obiektów dostępu do klucza licencji w bazie danych poprzez
uruchomienie skryptu licencjel.sql który został zainstalowany w katalogu programu.
Skrypt uruchamiamy na serwerze na którym znajduje się klucz licencyjny.
Dodać użytkownika petroservice do roli db_petrokey w bazie danych master na
serwerze na którym znajduje się klucz licencyjny
3. Konfiguracja parametrów logowania:
•
•
•
•
•
Uruchomić z menu START program do konfiguracji PetrOil Setting. Pierwsze
uruchomienie aplikacji powoduje wyświetlenie ostrzeżenia o braku połączenia z bazą
danych gdyż nie zostało skonfigurowane konto dostępu do bazy danych. Po
zamknięciu okienka z ostrzeżeniem zostanie wyświetlone okno do konfiguracji
logowania do bazy danych.
W oknie na karcie Ustawienia logowania zdarzeń należy wprowadzić login i hasło
wcześniej stworzonego użytkownika petroservice dla usługi logu. Po zapisaniu
danych należy zamknąć program konfiguracyjny i uruchomić jeszcze raz.
Po ponownym uruchomieniu wyświetlone zostanie okno do logowania się operatora
programu, należy zalogować się na utworzone konto z loginem administrator i pustym
hasłem
Na karcie Licencja należy wprowadzić kod licencyjny programu
Na karcie Operatorzy programu należy zmienić hasło dla operatora administrator
4. Konfiguracja parametrów dystrybutorów w pliku konfiguracyjnym config.xml – parz
rozdział 4
3. Program do konfiguracji serwera PetrOil Setting
Konfiguracja ustawień serwera możliwa jest po uruchomieniu aplikacji konfiguracyjnej
PetrOil Setting dostępnej w menu START->Programy->PETROIL 2.0 Po uruchomieniu
aplikacji wyświetlone zostanie okno do logowania operatora.
W celu zmiany konfiguracji programu należy wprowadzić login i hasło operatora z
uprawnieniami kierownika.
Po zalogowaniu wyświetlone zostanie okno zawierające zakładki które umożliwiają:
• Ustawienia logowania zdarzeń ( patrz rozdział 3.1 )
• Konfiguracji licencji programu ( patrz rozdział 3.2 )
• Zarządzanie operatorami programu ( patrz rozdział 3.3)
• Ustawienie typu komunikacji ( patrz rozdział )
• Ustawienie parametrów dystrybutora ( patrz rozdział )
• Ustawienie portu COM ( patrz rozdział )
3.1
Konfiguracja logowania zdarzeń
Zakładka Ustawienia logowania zdarzeń umożliwia skonfigurowanie parametrów połączenia
z bazą danych programu:
• Nazwę źródła ODBC
• Nazwę bazy danych programu
• Login i hasło użytkownika SQL do logowania do bazy danych programu
Zapisanie parametrów logowania zdarzeń następuje po wciśnięciu przycisku Zapisz.
Parametry te będą obowiązywać od następnego uruchomienia programu.
3.2
Konfiguracja licencji programu
Zakładka Licencja umożliwia wprowadzenie kodu licencyjnego dostarczonego razem z
aplikacją. W celu prawidłowego skonfigurowania licencji należy wprowadzić:
• Nazwę firmy lub NIP
• Kod licencyjny unikalny dla danej firmy i posiadanego klucza licencyjnego
• Maksymalną liczbę połączeń klientów z serwerem
• Położenie klucza licencyjnego
UWAGA !!!
• Uruchomienie usługi możliwe jest tylko przy prawidłowych danych licencyjnych i
dostępnym sprzętowym kluczu licencyjnym
• jeśli klucz znajduje się na innym serwerze niż baza danych musi być
skonfigurowane dodatkowe źródło ODBC którego nazwa jest taka sama jak źródła
do bazy danych programu plus słowo „_KEY”.
• Użytkownik do serwera z kluczem licencyjnym musi być talki sam jak do bazy
danych programu ( taki sam login i hasło )
3.3
Zarządzanie operatorami programu
Zakładka Operatorzy programu umożliwia zarządzanie operatorami korzystającymi z
oprogramowania. Dostępne są dwa typy operatorów:
• Kierownik
• Operator
UWAGA !!!
1.
Typ operatora określa operacje jakie może on wykonywać w programie Nie
wszyscy mają dostęp do wszystkich opcji programu.
2.
Operator programu powinien mieć taki sam login i hasło w programie Petroil jak i
w programie księgowym co pozwoli na pominiecie etapu wprowadzania danych
przy logowaniu do programu księgowego.
W oknie Ustawienia programu dostępne są następujące operacje:
• Dodanie nowego użytkownika – należy kliknąć przycisk Nowy operator a następnie
po wprowadzeniu danych kliknąć Zapisz zmiany
• Edycja operatorów – należy zaznaczyć operatora na liście a następnie po
wprowadzeniu nowych danych kliknąć Zapisz zmiany.
• Zablokowanie \ Odblokowanie operatora - w przypadku gdy chcemy zablokować lub
odblokować operatora należy wybrać operatora z listy a następnie kliknąć Zamień
status.
3.4
Ustawienia typu komunikacji ze sterownikiem
Zakładka Ogólne pozwala na skonfigurowanie typu komunikacji ze sterownikiem. Możliwe
są dwa tryby pracy:
• Jedno poleceniowy – program adresuje za każdym razem dystrybutor i wysyła do
niego polecenie
• Multi poleceniowy – program raz adresuje dystrybutor a następnie wysyła ciąg
poleceń
UWAGA !!! Ze względów wydajnościowych zaleca się używanie trybu multi
poleceniowego.
3.5
Ustawienie parametrów dystrybutora
Zakładka Dystrybutory pozwala na skonfigurowanie ustawień dystrybutorów:
• konfigurację typu paliwa i jego ceny
• konfigurację liczników bufora tankowań dla danego dystrybutora
Aby skonfigurować dystrybutor należy najpierw zaznaczyć konfigurowany dystrybutor na
liście a następnie za pomocą dostępnych kontrolek zmienić żądane parametry:
3.6
•
aby zmienić typ i cenę paliwa należy w grupie kontrolek Parametry węża wskazać
konfigurowany wąż, a następnie w celu zmiany zaznaczyć Zmień ustawienia węża.
Spowoduje to uaktywnienie kontrolek do zmiany parametrów typu i ceny paliwa. Po
wybraniu nowych ustawień należy kliknąć przycisk zapisz.
•
do zmiany parametrów bufora tankowań służy grupa kontrolek Parametry bufora
tankowań. W celu włączenia pracy dystrybutora w trybie bufora należy zaznaczyć
Włącz prace w trybie buforowym, odznaczenie tej opcji powoduje uniemożliwienie
pracy dystrybutora w tym trybie. Po ustawieniu pracy buforowej i maksymalnej liczby
tankowań w celu zapisania ustawień należy kliknąć przycisk zapisz.
Ustawienia parametrów COM’a
Zakładka Ustawienia COM’a jest odpowiedzialna za parametry łącza jakie jest zestawiane po
kablu RS232 ze sterownikiem dystrybutorów. Parametry tego łącza nie są zależne od systemu
i za każdym razem podczas uruchamiania oprogramowania są ustawiane na nowo.
Opcja: Numer portu jest odpowiedzialna za numer portu COM do którego został podłączony
kabel do sterownika dystrybutorów
Opcja: Sposób wysyłania polecenia wskazuje w jaki sposób są wysyłane polecenia do
sterownika:
• w całości – wartość określa wysyłanie polecenia jednorazowo – opcja nie jest zalecana
jeżeli długość kabla przekracza 10m.
• Znak po znaku – wartość określa wysyłanie polecenia znak po znaku.
Opcja: Czas oczekiwania na wysyłanie – opcja ważna tylko w przypadku wysyłania poleceń
znak po znaku. Opcja umożliwia wprowadzenie odstępu czasowego pomiędzy wysłaniami
kolejnych znaków danego polecenia. Zaleca się ustawienie jak najmniejszej wartości celem
przyspieszenia działania programu. Opcja powinna być wykorzystywana tylko po konsultacji
z autorami oprogramowania
Opcja: Liczba bitów na sekundę – opcja odpowiedzialna za ustalenie maksymalnej prędkości
z jaką będą wysyłane polecenia do sterownika. UWAGA Prędkość ustawiona na sterowniku
dystrybutorów powinna odpowiadać prędkości ustawionej w parametrach oprogramowania
Opcja: Bity danych – liczba bitów przypadających na jeden znak – nie zaleca się zmiany tej
opcji
Opcja: Parzystość – opcja powinna mieć wartość Nieparzyste
Opcja: Bit stopu – liczba bitów stopu
Opcja: Czas odczytu – opcja odpowiedzialna za czas odczytu danych z RS232 - opcja
powinna przyjmować jak najmniejszą wartość
Opcja: Czas oczekiwania na zdarzenie – opcja odpowiedzialna za oczekiwanie na pojawianie
się pierwszego znaku odpowiedzi. Im mniejszy czas odczytu ty program krócej będzie czekał
w przypadku braku komunikacji ze sterownikiem
Opcja: Handshake – zalecana wartość HandshakeOff
4. Plik konfiguracyjny config.xml
Plik konfiguracyjny config.xml zawiera podstawową konfigurację sterownika
oprogramowania. Pliku nie należy modyfikować chyba że na stacji zaistnieje sytuacja dodania
lub usunięcia dystrybutora.
Cała konfiguracja poszczególnych dystrybutorów objęta jest tagami <DISPENSER></
DISPENSER> gdzie atrybut counter wskazuje na liczbę dystrybutorów w konfiguracji
Przykład:
<DISPENSER counter="4" >
……
……
……
……
</DISPENSER>
Przykład zawiera konfigurację 4 dystrybutorów.
Konfiguracja jednego dystrybutora jest objęta tagami <DISP></DISP>.
Konfiguracja jednego węża jest objęta tagami <NOZZLE ></<NOZZLE>
Na konfigurację dystrybutora wchodzą odpowiednie atrybuty obiektu XML DISP a
mianowicie
• NAME - nazwa dystrybutora
• number – numer dystrybutora ten na sterowniku
• nozzles - liczba węzy danego dystrybutora
• islight – flaga informująca o tym czy dany dystrybutor wspiera zapalanie i gaszenie
• isautocounter – falaga informująca o możliwości tankowania w trybie buforowym
• maxautocounter – maksymalna liczba tankowań w trybie buforowym
Na konfigurację węża wchodzą atrybuty obiektu XML NOZZLE, a mianowicie
• fuel_type – typ paliwa
• active_unit_prices – cena paliwa
• fuel_total_volume – licznik litrów
• fuel_total_amount – licznik należności
• crc – atrybut nie używany
Wartość NOZZLE wskazuje numer węża np. < NOZZLE >1</ NOZZLE> wskazuje na
pierwszy wąż
Przykład konfiguracji jednego dystrybutora jedno wężowego:
<DISP NAME="Dys-1" number="1" nozzles="1" islight="0" isautocounter="1" maxautocounter="6" >
<NOZZLE fuel_type="1" active_unit_prices="4.56" fuel_total_volume="0" fuel_total_amount="0" crc=""
>1</NOZZLE>
</DISP>
Opis:
Konfiguracja zawiera dystrybutor o nazwie Dys-1. Liczb węzy dystrybutora 1. Dystrybutor
nie obsługuje zapalania i gaszenia (islight=0). Dystrybutor pozwala na tankowanie w trybie
do bufora z maksymalnym licznikiem 6-ciu tankowań.
Powyższa przykład zawiera konfigurację jednego węża o numerze 1. Z typem paliwa =1
(fuel_type=1), z aktualną ceną 4,56. Pozostałe parametry nie są zmieniane i należy je wpisać
w takiej konfiguracji jak w przykładzie.
Przykładowy plik XML.
<config>
<conf_prg>Konfiguracja programu</conf_prg>
<WRK>c:wrk</WRK>
<DB/>
<LOG FILE="" LOGDATA="" />
<COMMAND CommandType="1" WaitOnReadStatus="200" />
<COM number="1" IsSendOnOne="0" Baudrate="9600" DataBits="Data7" Parity="EVENPARITY"
StopBits="TWOSTOPBIT" ReadTimeout="10" WaitEvent="3" WaitOnSend="0"
Handshake="HandshakeOff"></COM>
<DISPENSER counter="4" >
<DISP NAME="Dys-1" number="1" nozzles="1" islight="0" isautocounter="1" maxautocounter="6" >
<NOZZLE fuel_type="1" active_unit_prices="4.56" fuel_total_volume="0" fuel_total_amount="0"
crc="" >1</NOZZLE>
</DISP>
<DISP NAME="Dys-2" number="2" nozzles="1" islight="0" isautocounter="0" maxautocounter="0" >
<NOZZLE fuel_type="5" active_unit_prices="4.18" fuel_total_volume="0" fuel_total_amount="0"
crc="" >1</NOZZLE>
</DISP>
<DISP NAME="Dys-3" number="3" nozzles="1" islight="0" isautocounter="0" maxautocounter="0" >
<NOZZLE fuel_type="6" active_unit_prices="4.18" fuel_total_volume="0" fuel_total_amount="0"
crc="" >1</NOZZLE>
</DISP>
<DISP NAME="Gaz" number="4" nozzles="1" islight="0" isautocounter="1" maxautocounter="10" >
<NOZZLE fuel_type="4" active_unit_prices="1.79" fuel_total_volume="0" fuel_total_amount="0"
crc="" >1</NOZZLE>
</DISP>
</DISPENSER>
<USER_PROG counter="1" >
<USER name="ala" passhash="49" typeUser="2" />
</USER_PROG>
</config>
5. Przeglądarka logów Petroil Log
Usługa aplikacji Petroil loguje zdarzenia do bazy danych . W celu przeglądania logu
programu należy uruchomić z menu START->Programy-PetrOil 2.0 aplikacje PetrOil Log.
Aplikacja ta umożliwia filtrowanie wpisów w logu programu po następujących kryteriach:
• przedział czasowy w którym dokonane zostały wpisy
• typ operacji: błędy, ostrzeżenia, informacje
• login operatora wykonującego operacje
• adres klienta wysyłającego żądanie
• identyfikatorze transakcji