ECOLKO - Inštalácia aplikácie na nový počítač (OS MS Windows 7 Professional alebo novší)

Transcription

1 ECOLKO - Inštalácia aplikácie na nový počítač (OS MS Windows 7 Professional alebo novší) Aplikácia ecolko Elektronické COLné KOnanie (softvér spoločnosti dflex Nitra s.r.o.) pracuje na princípe SERVER - KLIENT. Ako tenký klient sa používa Internet Explorer 8.0 a vyšší. Program je výkonovo škálovateľný: - od malých kancelárií (1 až 10 užívateľov), kde sa používa desktopový operačný systém MS Windows 7 Professional a databáza MS SQL Express 2008 (alebo vyšší), ktorá je distribuovaná zdarma. - až po väčšie firmy (desiatky užívateľov), kde sa používa MS Windows Server 2008 (alebo vyšší) a databáza MS SQL 2008 Standard (alebo vyšší). V závislosti na riešení a počte užívateľov sa volí aj príslušný hardware. Minimálna odporúčaná konfigurácia: CPU Intel Core 2 Duo 2Ghz RAM 4 GB HDD 250 GB OBSAH 1. Inštalačný balík (súčasti) Pokyny pre inštaláciu Súčasti operačného systému pre server ecolko Podporné programy pre server ecolko MS.NET Framework FONTY (Typy písma) Crystal Reports Programy potrebné k činnosti klienta ecolko Adobe Acrobat Reader MS XML Parser Internet Explorer Inštalácia Databázového stroja pre server ecolko Vytvorenie virtuálneho WEB-u pre server ecolko Inštalácia zákazníckeho konta pre server ecolko Inštalácia windows služby DF.ECOLKO.SERVER - kontrola Klient podateľne (EKR, EKR.CEP) pre server ecolko Podpisovanie správ v prostredí klienta ecolko SÚHRN : K činnosti programu je potrebné na nový počítač inštalovať nasledovný software: 1

2 1. Inštalačný balík (súčasti) a.) Inštalačný balík obsahuje všetky potrebné súčasti pre inštaláciu aplikácie ecolko. b.) Podadresár 0_Prereq obsahuje aplikácie Podporné programy potrebné pre správny chod ecolko. c.) Podadresár 1_SQLExpress2008 obsahuje inštalačné skripty InstalDFSQL_x86.cmd a InstalDFSQL_x64.cmd ako aj priložený konfiguračný súbor ConfigDFSQL.ini potrebné pre korektnú inštaláciu databázového stroja MS SQL 2008 EXPRESS s mennou inštanciou DFSQL. d.) Podadresár 2_ECOLKO_5_3_3_Full obsahuje samotne inštalačné súbory pre ecolko. 2

3 2. Pokyny pre inštaláciu!!! Dôležité pri spúšťaní skriptov cez command line je dôležité, aby mal užívateľ práva administrátora. Command line spúšťame ako správca. Samotný proces inštalácie pozostáva z týchto krokov: A.) Inštalácia programov z adresára /0_Prereq. - Programy (01_Fonty, 02_MSXML_Parser, 03_Acrobat_Reader, 04_Crystal_Reports) sú dôležité pre správny chod aplikácie (viď kapitola 4 a 5) - Programy (05_Ditec_DSigner_v3, 06_Ditec_EKR.Klient, 07_Ditec_CEP.EKR.Klient) sú dôležité pre správnu komunikáciu aplikácie ecolko a elektronickou podateľňou EKR a EKR.CEP (viď kapitola 10 a 11) - V príslušných podadresároch sú pribalené aj pokyny pre inštaláciu produktov od firmy Ditec B.) Inštalácia databázového stroja (inštancia DFSQL) z adresára /1_SQLExpress spustíme skript InstalDFSQL_x86.cmd alebo InstalDFSQL_x64.cmd v závislosti od použitého OS (32bit/64bit) - Skript používa súbor ConfigDFSQL.ini, ktorý obsahuje dôležité nastavenia, napríklad názov inštancie databázového stroja DFSQL - Spustením tohto skriptu sa databázový stroj nainštaluje so všetkými nastaveniami (viď kapitola 6) - Po inštalácii SQL bude zrejme potrebný reštart počítača. C.) Inštalácia samotnej aplikácie ecolko, skript 2_instal_eCOLKO.cmd - Skript vytvorí adresár C:\DF.ECOLKO - prekopíruje potrebne súbory do adresára C:\DF.ECOLKO - nainštaluje potrebné databázy - nainštaluje službu ecolko Server - spustí službu ecolko Server - (doplňujúce informácie viď kapitola 9) D.) Vytvorenie virtuálneho WEB-u pre server ecolko - Je potrebné, aby bolo nainštalovaný Internet Information Services (IIS) Manager, ktorý je súčasťou operačného systému Windows (viď kapitola 3) - Následne môžeme vytvoriť web podľa pokynov v kapitole 7. E.) Inštalácia zákazníckeho konta - (viď kapitola 8)!!! Jednotlivé kroky sú bližšie opísané v nasledovných kapitolách!!! 3

4 3. Súčasti operačného systému pre server ecolko Vo Windows, pridať-odobrať programy/ Súčasti operačného systému Windows, pridáme IIS verzia 6.0 a vyššia (Internet Information Service) bez služby FTP a SMTP. Pre Windows 7 (profesionálna edícia) by nastavenie malo vypadať takto: 4

5 4. Podporné programy pre server ecolko zo stránky alebo voľne stiahnuteľné zo stránok firmy Microsoft alebo dodané na inštalačnom médiu. Podporné programy sa nachádzajú na inštalačnom médiu v sekcii 0_Prereq. Všetky potrebné súčasti overte a inštalujte ako prvé. Viaceré komponenty budú vyžadovať reštart počítača. Na záver dokumentu je pripojená príloha Kontrolný list, ktorá je pomôckou pri inštalácii MS.NET Framework 3.5 Overíme verziu.net FRAMEWORK 3.5 v adresári: C:\Windows\Microsoft.NET\Framework\v3.5\... (Ideálne, ak v nej existuje ešte adresár Microsoft.NET Framework 3.5 SP1, čo znamená, že na verziu bol aplikovaný Service Pack 1) FONTY (Typy písma) Fonty "0_Prereq\01_Fonty" čiarového kódu code128b.ttf a fre3of9x.ttf. V prípade, že nie je inštalovaný MS OFFICE, tak inštalovať aj zvyšné fonty. Inštalácia fontov je možná z Windows menu štart/nástroje/ovládacie panely/ písma. Po inštalácii fontov je potrebný reštart operačného systému. Chýbajúce fonty zapríčiňujú problémy rozpadu písma v tlačových zostavách, kde sa typ písma, ktorý neexistuje, nahradí iným (podobným) písmom a keďže sa jedná o neproporcionálne písmo, dĺžka slov následne nesedí Crystal Reports Inštalujeme podporu pre export súborov vo formáte PDF, ktorá sa nachádza v sekcii "0_Prereq\04_CRYSTAL REPORTS" na inštalačnom médiu. Pri 64 bitových systémoch je potrebné nainštalovať obidve verzie pre 32 bit systémy aj pre 64 bitové systémy. 5

6 5. Programy potrebné k činnosti klienta ecolko. Poznámka: Na server sa inštalujú vtedy, ak je server sám sebe aj klientom (napr.: inštalácia na jedinom PC vo firme) Adobe Acrobat Reader Verzia 5.5 až 7.0 verzia 5.5. CE sa nachádza v sekcii "0_prereq\03_Acrobat_Reader" na inštalačnom médiu. Dôležité: Obmedzenie verzií súvisí s tlačou na predtlačené formuláre (v prípade ihličkových tlačiarní) MS XML Parser V prípade podpisovania a posielania správ inštalujeme Microsoft XML Parser 4.0 SP2 - nachádza sa v sekcii "0_prereq\02_MS_XML_Parser" na inštalačnom médiu Internet Explorer IE 8.0 a vyššie verzie sú súčasťou operačného systému Windows 7 6

7 6. Inštalácia Databázového stroja pre server ecolko Pre inštaláciu databázového stroja použijeme Microsoft SQL Server 2008 R2 Express with Service Pack 2 ďalej len SQL Server z dôvodu podpory a dokumentácie od Microsoftu. V závislosti od použitého OS (32bit/64bit), zvolíme inštaláciu SQL Servera. - link Microsoft: Môžeme inštalovať SQL Server s grafickým rozhraním SQL Server Management Studio Express (odporúčané, použité aj v inštalačnom balíku): SQL Server je zdarma šírená licencia databázy od Microsoftu. Použijeme mennú inštanciu DFSQL. Prekopírujeme inštalačné súbory do pomocného adresára napr. C:\EcolkoInstall a spustíme skript InstalDFSQL_x86.cmd alebo InstalDFSQL_x64.cmd v závislosti od použitého OS (32bit/64bit). Spustením tohto skriptu sa databázový stroj nainštaluje so všetkými nastaveniami. Je dôležité, aby sa inštalácia spúšťala s priloženým ConfigDFSQL.ini súborom, pretože tento obsahuje dôležité nastavenia, napríklad názov inštancie databázového stroja DFSQL. Po inštalácii SQL bude zrejme potrebný reštart počítača. 7

8 7. Vytvorenie virtuálneho WEB-u pre server ecolko Spustime manažéra služby IIS. - (ovládací panel / nástroje pre správu / Internet Information Services (IIS) Manager) alebo (štart/spustiť a napísať inetmgr). 1.) Vytvoríme aplikačný pool (názov ECOLKO, mode Classic) 2.) Nastavíme vlastnosti aplikačného poolu ECOLKO (Enable 32-bit Apps = True) 8

9 3.) Na Default Web Site pravé tlačidlo myši/nový virtuálny adresár - pridáme aplikáciu ECOLKO. ( názov WEBu: ecolko, cesta: C:\df.ecolko\aplikacia\web, pool: ECOLKO ) 4.) Pridáme (overíme) nový default dokument s názvom DEFAULT.HTML a posunieme ho na prvé miesto hore. Tento úkon zabezpečí spúšťanie defaultnej stránky aplikácie v novom okne, čím sa odstránia z aplikácie tlačidlá prehliadača, ktoré by mohli spôsobovať problémy (šípka vľavo a vpravo). 9

10 5.) Nastavíme MIME TYP s príponou.dfx a typom DFLEX/statistika. Je to štatistický súbor s výkazmi, ktoré sa mesačne (do 5-teho pracovného dňa nasledujúceho mesiaca) zasielajú na statistika@dflexnr.sk 6.) Nastavíme (overíme) ANONYMNÚ autentifikáciu: 10

11 Ak je aktívny Windows Firewall, nezabudnite si otvoriť na lokálny počítač port http (TCP 80) Ak je vytvorený virtuálny WEB, aplikácia sa štartuje na lokálnom počítači prostredníctvom Internet Explorera volaním Miesto localhost ( ) je možné použiť IP adresu alebo meno počítača a pripájať sa na server z iných počítačov v sieti.!!! Doležité - Tenký klient (browser) má svoje špecifiká práce a pri práci v aplikácii ECOLKO sa neustále udržuje kontakt so serverom. - Akékoľvek zasahovanie do komunikácie medzi serverom a klientom (napríklad PROXY CACHE, lokálna cache klienta) môže končiť s chybou.!!! Doležité - Aby sme zamedzili užívateľovi klientskej aplikácie ecolko pracovať (ako je možno zvyknutý pri prezeraní internetu) s tlačidlami dozadu a dopredu, otvárame nové okno bez tohto menu. - Avšak priamym zavolaním default.aspx stránky v URL je možné obísť toto otvorenie nového okna (... rozhodnutie ostáva na zvážení administrátora klientskej aplikácie ecolko). 11

12 8. Inštalácia zákazníckeho konta pre server ecolko Na dodanom inštalačnom médiu je adresár zákazník. Spustením skriptu VytvorKonto.cmd sa vytvorí zákaznícke konto, uvedené v inštalačnom protokole. Správne vytvorenie konta si overíme prihlásením sa do aplikácie V tom istom adresári je textový súbor s kľúčom na príslušný mesiac. Adresár zákazník je možné zaslať aj prostredníctvom elektronickej pošty. 12

13 9. Inštalácia windows služby DF.ECOLKO.SERVER - kontrola Aplikačný server sa nainštaluje ako windows služba - DF.ECOLKO.SERVER. V inštalačných pokynoch je použitý skript na spustenie inštalácie 2_instal_eCOLKO.cmd, ktorý vykoná všetky potrebne úkony. V prípade potreby dodatočných úprav (napr. odobratie aplikácie ecolko) môžete použiť samostatné skripty uvedené nižšie. Službu nainštalujeme spustením inštalačného skriptu: "C:\DF.ECOLKO\aplikacia\bin\ws_install.cmd" V prípade potreby môže byť služba odinštalovaná spustením skriptu: "C:\DF.ECOLKO\aplikacia\bin\ws_uninstall.cmd" Služba DF.ECOLKO.SERVER pristupuje na Internet. Po inštalácii služby, v prípade, že to konfigurácia Vášho PROXY vyžaduje, zmeníte spúšťanie služby DF.ECOLKO.SERVER pod doménovým účtom (na záložke LOGON). Ak to nie je nutné, ponecháme službu pod štandardným účtom local system. Meno a heslo k PROXY nastavíme v konfigurácii EKR podateľne, ako aj v konfigurácii EKR.CEP podateľne. 13

14 10. Klient podateľne (EKR, EKR.CEP) pre server ecolko V prípade, že budete posielať správy na podateľňu CRSR prostredníctvom servera ecolko nainštalujte klienta tejto služby (EKR_klient, EKR.CEP_klient). EKR_klient klientsky software pre posielanie XML správ na podateľňu Colnej správy. - Slúži na podávanie elektronických vyhlásení (.xml správ) pre moduly espd(emcs) a Garancie (zábezpeka) EKR.CEP_klient klientsky software pre posielanie XML správ na podateľňu Colnej správy (novší klient, ktorý pracuje s Centrálnym elektronickým priečinkom(cep)). - Slúži na podávanie elektronických vyhlásení (.xml správ) pre moduly etranzit, evývoz a edovoz %A1vate%C4%BEovcoln%C3%BDchsyst%C3%A9mov.aspx Poznámka: K posielaniu správ cez podateľňu (EKR, EKR.CEP) je potrebné vlastniť elektronický súkromný podpisový kľúčový pár (certifikát) pre Zaručený Elektronický Podpis (ZEP). 14

15 11. Podpisovanie správ v prostredí klienta ecolko Pre vypĺňanie a kontrolu správ (.xml) v prostredí ecolko stačí počítač so systémom na ktorom beží MS Internet Explorer 8.0 a vyšší. Poznámka: Spoločnosti komunikujúce cez podateľňu EKR, EKR.CEP si "musia" pre potreby komunikácie aplikácie ecolko vyžiadať MENO a HESLO, ktoré nahrádza komerčný certifikát pre firmy. Citácia z mailu CRSR: "Ak požadujete na zabezpečenie komunikácie po spustení produkčnej prevádzky novej elektronickej podateľne CR SR prihlasovacie meno a heslo, zašlite nám Vašu požiadavku na ovú adresu helpdesk.ekr@colnasprava.sk. Ako identifikačné údaje uveďte obchodný názov spoločnosti, pridelené evidenčné číslo (čísla) dohody o využívaní vybratých elektronických služieb colnej správy, meno a priezvisko odosielajúcej osoby a kontaktné údaje. Následne Vám oznámime pridelené prihlasovacie údaje." koniec citátu. Ďalšie údaje, ako proxy server a pod., nakonfigurujete neskôr cez klienta aplikácie ecolko. Pre potreby podpisovania dokumentov Zaručeným Elektronickým Podpisom (ZEP) sa na klienta inštalujte USB token s osobným certifikátom užívateľa. Obslužný software (driver) k tokenu dodáva certifikačná autorita, ktorá token vydala. Ďalej je potrebné na klienta nainštalovať prípadne preveriť inštalácie : Dôležité!: Postupujte prosím podľa Postupu pri inštalácii aplikácie DSigner/XAdES a D.Viewer. A.).NET framework B.) MS XML PARSER 4.0Sp2 C.) Pre potreby podpisovania dokumentov a odosielania podaní je nutné mať nainštalované nasledovné komponenty, voľne stiahnuteľné z ústredného portálu verejných služieb ľuďom. Momentálne je k dispozícii Aplikácia D.Signer/XAdES, cesta na stiahnutie je: D.) Podpisová politika pre príslušný rok 15

16 12. SÚHRN : Vytlačíme si kontrolný list, ktorý je ako príloha tohto dokumentu. Má slúžiť ako pomôcka pri inštalácii podporných programov a programu ECOLKO. Inštalujeme súčasť operačného systému Windows - IIS server (WEB server)- viď kap. 3 KROK 0 - Kontrolujeme existenciu podporných programov, ak ich nemáme inštalované nájdeme ich v sekcii 0_prereq na inštalačnom médiu (viď kap. 2, pokyny pre inštaláciu) KROK1 Inštalujeme databázový stroj (viď kap. 2, pokyny pre inštaláciu) KROK2 Inštalujeme samotný program ECOLKO spustením 2_instal_ECOLKO.cmd na inštalačnom médiu (viď kap. 2, pokyny pre inštaláciu) MEDZIKROK Ak máme k dispozícii licenčný súbor, spustíme dávku VytvorKonto.cmd. Dávka je v adresári ZAKAZNIK alebo dodaná mailom KROK3 Skontrolujeme nainštalovanie Windows servisu DF.ECOLKO.Server spustenim start/run/services.msc (konzola pre správu Windows services) KROK4 Ak budeme komunikovať elektronicky s podateľňou CRSR alebo EKR.CEP, inštalujeme klientov podateľne EKR, EKR.CEP. (vyžaduje inštaláciu DSigner/XAdES) KROK5 Vytvoríme virtuálny WEB podľa postupu popísaného v kapitole 7 tohoto dokumentu (Vytvorenie virtuálneho WEB-u) Dokumentácia k programu je v help súbore (na ľavej strane štartovacej stránky programu kliknite na odkaz Príručka ) Ďalšie technické informácie o údržbe programu nájdete v dokumente Pripomienky a návrhy k produktu ECOLKO zasielajte na adresu servis@ecolko.sk V prípade potreby volajte technickú podporu dflex Nitra: Marcel Holeš Tel: klapka 313 Mail: mho@dflexnr.sk Ing. Daniel Berec Tel: klapka 314 Mail: dbe@dflexnr.sk Revízia dokumentu: júl

17 ECOLKO Verzia 5.3.* 1. Súčasť MS IIS 6.0 a vyšší WEB Server Popis Pridať/Ubrať programy Súčasti Windows. Originál inštalačné médium k Windows 2..NET Framework 3.5 Overenie 3. Crystal Reports pre.net Pre export súborov do PDF formátu. Inšt. médium sekcia 0_PREREQ/04 4. Fonty (Písma) 5. Adobe Acrobat Reader 6. MS XML Parser SQL Express 2008 (alebo vyšší) databázový stroj 8. Aplikácia ECOLKO 9. Inštalácia klientského konta Inšt. médium sekcia 0_PREREQ/01 Inšt. médium sekcia 0_PREREQ/03 Inšt. médium sekcia 0_PREREQ/02 Inšt. médium /1_SQLExpress InstalDFSQL_x86.cmd - InstalDFSQL_x64.cmd Inšt. médium 2_instal_eCOLKO.cmd VytvorKonto.cmd dodané mailom 10. Inštalácia DSigner/XAdES Inštalácia podľa pokynov v kapitole Inštalácia podpisovej politiky Inštalácia podľa pokynov v kapitole 9 Inštalácia podľa pokynov 12. Inštalácia podateľne EKR v kapitole 8 (vyžaduje inštaláciu DSigner/XAdES) 13. Inštalácia podateľne EKR.CEP 14. Inštalácia WEB-u Inštalácia podľa pokynov v kapitole 8 (vyžaduje inštaláciu DSigner/XAdES) Podľa kapitoly 7: - Vytvorenie virtuálneho webu pre server ecolko 15. Spustenie aplikácie 17