Differences

This shows you the differences between two versions of the page.

--- instalace:eet_service [2017/03/20 19:34] – admin
+++ instalace:eet_service [2017/03/28 08:48] (current) – admin
@@ Line 9: / Line 9: @@
 ===== Instalace služby na serveru =====
-Z našich webových stránek je třeba stáhnout soubor PlantisEetSetup.exe. Po stažení soubor spusťte. V průvodci instalací zkontrolujte složku, do které se má služba nainstalovat - výchozí je složka C:\PlantisEet. Po dokončení instalace je nutné provést konfiguraci.
+Před instalací služby prosím **nejprve nainstalujte aktuální verzi aplikace Plant-IS,** spusťte ji a dokončete převod dat. Některé aktualizace přidávají do databáze nová pole, pokud byste používali starší verzi Plant-ISu, mohlo by se stát, že tato pole nebudou v databázi existovat a služba nebude správně fungovat, protože tatro pole potřebuje.
+Z našich webových stránek je třeba **stáhnout soubor [[https://www.arbosoft.cz/download/PlantisEetSetup.exe|PlantisEetSetup.exe]].** Po stažení soubor spusťte. V průvodci instalací zkontrolujte složku, do které se má služba nainstalovat - výchozí je složka **C:\PlantisEet** a doporučujeme ji ponechat, popř. změnit jen disk (není doporučeno službu instalovat do Program Files, protože služba ve své složce mění soubory). Po dokončení instalace je nutné provést konfiguraci.
 ===== Konfigurace služby =====
-Ve složce, do které jste službu nainstalovali, se nachází konfiguračnísoubor Config.ini. Ten je třeba upravit. Ve výchozím stavu je obsah souboru přibližně následující:
+Ve složce, do které jste službu nainstalovali, se nachází konfigurační soubor **Config.ini**. Ten je třeba upravit, ve výchozím stavu nebude služba správně fungovat. Původní obsah souboru je přibližně následující:
 <code>
@@ Line 46: / Line 48: @@
 ==== Konfigurace - sekce "main" ====
-V této sekci jsou hlavní parametry, které ovlivňují chování služby.
+V této sekci jsou hlavní parametry, které ovlivňují chování služby. Zcela zásadní jsou parametry pro připojení k databázi, ty je nutné vyplnit (zkopírovat ze souboru data.ini, který je ve stejné složce jako Plantis.exe).
 **Log** - cesta k souboru, do které služba zapisuje protokol o své činnosti
-**Server, Database, LoginName, PasswordNr, Password** - parametry pro připojení k databázi aplikace Plant-IS. Doporučujeme těchto 5 parametrů zkopírovat ze souboru data.ini, který najdete ve stejné složce jako Plantis.exe. Zkopírujte údaje z té sekce, která definuje vaše standardní datové prostředí (ostrá data).
+**Server, Database, LoginName, PasswordNr, Password** - parametry pro připojení k databázi aplikace Plant-IS. Doporučujeme těchto 5 parametrů zkopírovat **ze souboru data.ini,** který najdete ve stejné složce jako Plantis.exe. Zkopírujte údaje z té sekce, která definuje vaše standardní datové prostředí (ostrá data).
-**Debug** - pro interní potřebu
+**Debug** - pro interní potřebu; pro normální provoz je hodnota 0
 **ResendIntervalMinutes** - po kolika minutách se má služba pokoušet o automatické odeslání datových zpráv (standardní hodnota je 30 minut)
@@ Line 62: / Line 64: @@
 **ErrorMaxMinutes** - po kolika minutách již nemá být zasíláno hlášení o tom, že datová zpráva nebyla úspěšně odeslána (standardní hodnota je 14400, tj. 10 dní)
-**InfoEnable** - hodnota 1 znamená, že bude zasílána informace o tom, že došlo k dodatečnému odeslání, hodnota 0 tyto informace po dodatečném odeslání potlačí (standardní hodnota je 1, tj. informace bude zaslána)
+**InfoEnable** - hodnota 1 znamená, že bude zasílána informace o tom, že došlo k dodatečnému odeslání, hodnota 0 tyto informace po dodatečném odeslání potlačí (standardní hodnota je 1, tj. informace bude zaslána). Hodnota 1 také povoluje každodenní zasílání e-mailu potvrzujícího správné fungování služby.
 **EetPlayground** - hodnota 1 znamená, že datové zprávy budou odesílány do Playgroundu EET, což může být užitečné při testování. Hodnota by měla korespondovat s hodnotou v data.ini. (Standardní hodnota je 0, tj. zprávy jsou odesílány do ostrého prostředí EET.)
@@ Line 68: / Line 70: @@
 ==== Konfigurace - sekce "smtp" ====
-V této sekci jsou parametry pro zasílání hlášení prostřednictvím e-mailu.
+V této sekci jsou parametry pro zasílání hlášení prostřednictvím e-mailu. Aby zasílání e-mailů fungovalo, je třeba vyplnit všechny níže uvedené hodnoty.
+**Enable** - hodnota 1 znamená, že zasílání hlášení prostřednictvím e-mailu je povoleno, hodnota 0 zasílání zakazuje (standardní hodnota je 1)
+**Host** - zde je třeba zadat IP adresu (např. 127.0.0.1) nebo plně kvalifikované doménové jméno (např. server.domena.cz) SMTP serveru, přes který se mají hlášení odesílat
+**Port** - port, na kterém SMTP server naslouchá příchozím spojením (standardní hodnota je 25)
+**UserName** - uživatelské jméno pro ověření uživatele při odesílání; pokud SMTP server nevyžaduje ověření, ponechte prázdné (standardní hodnota je prázdná)
+**Password** - heslo pro ověření uživatele při odesílání; pokud SMTP server nevyžaduje ověření, ponechte prázdné (standardní hodnota je prázdná)
+**From** - adresa odesilatele hlášení (doporučuje se vyplnit existující adresu), např. admin@domena.cz (standardní hodnota je prázdná)
+**Organization** - název organizace (standardní hodnota je prázdná)
-Enable - hodnota 1 znamená, že zasílání hlášení prostřednictvím e-mailu je povoleno, hodnota 0 zasílání zakazuje (standardní hodnota je 1)
+**EmailInfo** - e-mailová adresa (nebo více adres, pro oddělení použijte čárku nebo středník), na kterou jsou zasílány normální informace (např. informace o tom, že došlo k dodatečnému odeslání datové zprávy). Pokud je adresa vyplněná, je na ni jednou denně zasláno i potvrzení o tom, že služba je spuštěna a pracuje.
-Host - zde je třeba zadat IP adresu (např. 127.0.0.1) nebo plně kvalifikované doménové jméno (např. server.domena.cz) SMTP serveru, přes který se mají hlášení odesílat
+**EmailWarning** - e-mailová adresa (nebo více adres, pro oddělení použijte čárku nebo středník), na kterou jsou zasílána upozornění (např. informace o tom, že datová zpráva nebyla odeslána do 5 hodin po vystavení účtenky)
-Port - port, na kterém SMTP server naslouchá příchozím spojením (standardní hodnota je 25)
+**EmailError** - e-mailová adresa (nebo více adres, pro oddělení použijte čárku nebo středník), na kterou jsou zasílána hlášení o chybách (např. informace o tom, že datová zpráva nebyla odeslána v limitu 48 hodin po vystavení účtenky)
-UserName - uživatelské jméno pro ověření uživatele při odesílání; pokud SMTP server nevyžaduje ověření, ponechte prázdné (standardní hodnota je prázdná)
+===== Spuštění služby =====
-Password - heslo pro ověření uživatele při odesílání; pokud SMTP server nevyžaduje ověření, ponechte prázdné (standardní hodnota je prázdná)
+Služba se nainstaluje tak, že se automaticky spustí po startu serveru. Pro první spuštění je tedy buď možné restartovat server, nebo v nabídce Start najít Služby, v nich položku Plant-IS - EET module a tu spustit.
-From - adresa odesilatele hlášení (doporučuje se vyplnit existující adresu), např. admin@domena.cz (standardní hodnota je prázdná)
+===== Kontrola funkčnosti =====
-Organization - název organizace (standardní hodnota je prázdná)
+Služba vytváří protokol o své činnosti - standardně je protokol uložen v souboru PlantisEet.log ve složce, ve které je služba nainstalovaná. Protokol je možné zobrazit např. pomocí Poznámkového bloku. Během prvních několika dní po instalaci a spuštění služby doporučujeme protokol kontrolovat, zda v něm nejsou zaznamenány nějaké chyby (připojení k databázi, odesílání e-mailů apod.).
-EmailInfo - e-mailová adresa (nebo více adres, pro oddělení použijte čárku nebo středník), na kterou jsou zasílány normální informace (např. informace o tom, že došlo k dodatečnému odeslání datové zprávy)
+Při normálním provozu by měla služba každý den poslat e-mail potvrzující její funkčnost. Dále jsou zasílány informační e-maily při dodatečném odeslání datové zprávy EET, upozornění, pokud není datová zpráva odeslána v limitu zadaném parametrem WarningAfterMinutes (standardně 5 hodin), a oznámení o chybě, pokud není datová zpráva odeslána v limitu zadaném parametrem ErrorAfterMinutes (standardně 48 hodin).
-EmailWarning - e-mailová adresa (nebo více adres, pro oddělení použijte čárku nebo středník), na kterou jsou zasílána upozornění (např. informace o tom, že datová zpráva nebyla odeslána do 5 hodin po vystavení účtenky)
+===== Odinstalování služby =====
-EmailError - e-mailová adresa (nebo více adres, pro oddělení použijte čárku nebo středník), na kterou jsou zasílána hlášení o chybách (např. informace o tom, že datová zpráva nebyla odeslána v limitu 48 hodin po vystavení účtenky)
+Pokud by bylo v budoucnu třeba službu odinstalovat, je nutné ji nejprve v Start, Služby zastavit. Poté je možné provést odinstalaci pomocí ovládacích panelů Windows (odebrat položku Plant-IS EET service).