                   EDIREX v.4.xx                     TELEDIN  14.1.2015 - 2020
--------------------------------------------------------------------------------

EDIREX je komunikan klient, umoujc penos zprv z a do schrnky systmu
TELEDIN CCF pomoc ifrovanho protokolu SSL, v automatickm dvkovm provozu.

Program vyuv interpret jazyka PERL, obsaen v instalaci.

Pro zprovoznn komunikace je poteba mt:
------------------------------------------
Zzenu komunikan schrnku v systmu TELEDIN CCF na dohodnut jmno.
Pslun autorizan kle vygenerovan pracovnky TELEDINu.
Instalan balk EDIREXu  - EDIREX_WIN_XXX.zip.  (XXX-cislo verze)
PC stanici s dnes bnm HW, se systmem Windows. EDIREX je mono instalovat na 
   libovoln, dnes bn verzi Windows.
 - Pi vtm pedpokldanm provozu je teba pamatovat na dostaten prostor na
   disku pro ukldn archivu zprv, co pi dnench kapacitch disk nebv
   problm.
 - Ideln je vyhrazen stroj, ale program me dobe pracovat i na bn
   pracovn stanici spolen nap. s bnmi kancelskmi aplikacemi. Problmy
   mohou nastat pi provozovn EDIREXu na stroji, kde ji b jin komunikan
   aplikace, databze, nebo systm obsahuje sloit prosted vvojovch, 
   komunikanch, ppadn dalch aplikac.
Program nevyaduje vytvoen specilnho uivatele pro provozovn, ale je
   poteba zajistit, aby kad uivatel systmu, pod kterm bude EDIREX
   spoutn, ml zajitn potebn sprvn systmov prosted spolu s 
   dostatenmi prvy ten a zpisu dat do poadovanch mst jak na loklnm
   disku, tak ppadn v lokln sti uivatele, pokud bude tato funkce
   vyadovna.
   Toto nastaven je na zodpovdnosti uivatele programu EDIREX, pi jeho
   nesplnn neme firma TELEDIN ruit za spolehliv doruovn zprv do msta
   uren.
Pipojen na Internet s povolenm odchozm portem 22 - konzultujte se sprvci
   Va st ppadn oteven firewallu, nastaven proxy serveru a podobn.
   V nkterch ppadech bude nutn i nastaven "Osobnho firewallu" na stanici,
   kde pob EDIREX, tak, aby umonil EDIREXu odchoz komunikaci na portu 22.
   (IP adresa primrnho EDIREX serveru je 212.31.80.228, sekundrnho 212.80.77.74)
 UPOZORNN - S nstupem modernjch firewall se zan objevovat chyba autorizace
   pi pstupu na schrnku - pokud se Vm objevuje chyba "Spojeni s bisvan.teledin.cz
   bylo navazano, ale autorizace byla neuspesna" a tato chyba petrvv del dobu 
   (pes 20 minut) me bt problm v nastaven Vaeho firewallu - nkter firewally
   kontroluj ceritifikty a zasahuj do nich, a pak se autorizace nezda - 
   je poteba tuto kontrolu pro toto spojen vypnout.

INSTALACE:
----------
Instalace vyaduje alespo zkladn znalosti systmu Windows a dkovch
pkaz.
Program se standardn instaluje do direktore C:\EDIREX, a dle v textu budeme
jako pklad pouvat tuto cestu.
Instalace do jinho msta je mon, oproti dvjm verzm ji ani nen teba
upravovat nastaven pro jinou instalan cestu.
Nemla by vadit ani cesta obsahujc mezery, ale lep je se takovmto nzvm
cest vyhnout.

Na disku C: vytvome direktor \EDIREX (ppadn jin, podle poteby), bu
dkovmi pkazy DOSu, nebo nap. pomoc EXPLORERu i TOTAL COMMANDERu:
c:\>c:
c:\>mkdir \EDIREX
c:\>cd \EDIREX

Instalan balk EDIREX_WIN_XXX.zip rozbalme do direktore C:\EDIREX.

Po rozbalen by ml direktor C:\EDIREX obsahovat direktore 
INARCHIV,OUTARCHIV,ERROR,Inbound,log,OUTBOUND,Perl,tmp, a soubory
EDIREX1.pm a dal.

Nyn ji meme provst prvn zkuebn sputn programu EDIREX a otestovn
funknosti pipojen sputnm pkazu "test.bat", nachzejcm se v adresi
C:\EDIREX:

Program se pipoj na testovac schrnku systmu TELEDIN CCF, pouije jmno 
uivatele TESTUSER a pslun autorizan kl testuser_rsa, kter je soust
instalace EDIREXu.

Pi spnm pipojen se mus objevit vpis v ernm DOSovm okn:

*********************************************
*     EDIREX       ver.V.4.01 12.5.2008 FN
*     TELEDIN      tel: ++420 221015250
*********************************************
* 20080512-09:19:33 ! TEST: Program EDIREX se pripoji na testovaci schranku !!!
* 20080512-09:19:33 - Start akce PRIJEM SOUBORU ZE SCHRANKY CCF.
* 20080512-09:19:33 - Oteviram spojeni pro testuser@svediptelcomm02.editel.cz ...
* 20080512-09:19:34 -- Spojeni je uspesne navazano.
* 20080512-09:19:34 --- Prohlizim schranku ...
* 20080512-09:19:34 ---- No Data on VANCCFS
* 20080512-09:19:34 - Start akce ODESLANI SOUBORU DO SCHRANKY CCF.
* 20080512-09:19:35 - Zadna data k odeslani.
* 20080512-09:19:35 -- Uzaviram spojeni.
* 20080512-09:19:35 **** End of session *****
Pokraujte stisknutm libovoln klvesy...


Pokud po dku "Oteviram spojeni..." program del dobu "vis" a nsledn
vype:

* 20070816-11:10:43 ! Nepodarilo se pripojit na server, proverte funkcnost site.

je problm v nefunknosti komunikace - nejpravdpodobnji bv problm v
nastaven podnikovho firewallu. Podejte Vaeho sprce st o proven 
funknosti st a o dostupnosti Internetu ze stanice, na kter je EDIREX
spoutn, na portu 22.

Po instalaci EDIREXu je mono sputnm scriptu ikony.bat vytvoit na ploe ikony
pro manuln spoutn EDIREXu. (Nen zarueno, e se poda na vech systmech a
jazykovch verzch)

ZKLADN NUTN NASTAVEN:
-------------------------
Po spnm testu pipojen na testovac schrnku CCF je jet poteba nastavit
EDIREX pro pstup do Va provozn schrnky systmu TELEDIN CCF:

Do adrese C:\EDIREX je poteba vloit autorizan kl (soubor id_rsa),
kter obdrte od TELEDINu. 
POZOR!: Jmno souboru kle MUS bt ve zde uvedenm tvaru, pi zasln souboru
se jmnem "id_rsa" (bez ppony) nkter e-mailov servery jmno bez ppony mohou
zmnit nap na id_rsa.dat. Zkontrolujte prosm, zda nedolo k tomuto problmu.
Pstupov prva kl nesm obsahovat dn prva pro uivatele "everyone"!

V souboru C:\EDIREX\EDIREX.cfg je poteba nastavit poloku "edirex_user" na
jmno psluejc k Va schrnce v systmu TELEDIN CCF, napklad:

edirex_user=uzivatel25

V ppad poteby je mono pomoc parametr v EDIREX.cfg tak nastavit komunikaci
prostednictvm proxy serveru - zapnout parametrem proxy=y, vznam dalch
parametr je zejm.

V tto chvli by ji mlo bt mon pipojen na Vai provozn schrnku,
komunikaci provte sputnm pkazu edirexio.bat, kter se pipoj k
Va schrnce:

C:\edirex>edirexio.bat

Pokud se objev hlen "! Serveru bylo dosazeno, ale autorizace byla
neuspesna." mte pravdpodobn nesprvn autorizan kle, nebo jste patn
zapsali jmno uivatele schrnky.
Pokud je jmno zadno sprvn, kontaktujte firmu TELEDIN pro sjednn npravy.
NOV!: Problm s autorizac me zpsobovat novj firewall - nkter firewally
zasahuj do penench kl a pak se autorizace nezda, je poteba na firewallu
tuto kontrolu pro toto spojen vypnout.
Ppadn dal problmy v innosti programu EDIREX by mly bt zejm z
vypisovanch hlen, pokud se Vm neda chyby odstranit, kontaktujte firmu
TELEDIN.

Vstup a vstup dat:
-------------------
Clov adres, kam maj bt pijat data umstna je mono nastavit podle
poteby v konfiguranm souboru EDIREX.cfg, poloce edirex_inbound=
(Defaultn C:\EDIREX\INBOUND)
nap.:
edirex_inbound=J:\SAP\vstup

Jak bylo uvedeno ve, v tomto adresi funguje monost "zamykn" soubor pi
koprovn do cle, pomoc vloenho adrese "temp".
! Za dostupnost clovho adrese odpovd uivatel EDIREXu.!
! EDIREX indikuje spnost zapsn dat do clov sloky ve svm logu audit.log.
! Pi nespnm pokusu o penos dat do clovho adrese data zstvaj v
! adresi c:\EDIREX\tmp\in a pi kadm sputn se je EDIREX sna penst do
! adrese uvedenho v parametru edirex_inbound, dokud se akce nezda.
Pijat data EDIREX archivuje v C:\EDIREX\INARCHIV.

Adres, odkud se odebraj data k odesln, je mono zmnit pomoc poloky 
edirex_outbound= (Defaultn C:\edirex\outbound)
nap.:
edirex_outbound=J:\SAP\vystup
!POZOR!: Z toho adrese se defaultn odelou pouze soubory podle wilcard "*.*"
! - tedy jmno MUS obsahovat teku. Pokud chceme, aby se odeslaly i soubory
! bez teky, musme nastavit parametr: Wildcards=*

! Za dostupnost zdrojovho adrese dat odpovd uivatel EDIREXu. EDIREX
! oznamuje nenalezen zdrojov sloky v logu, ale neme zdetekovat, zda jsou
! napklad data dky zvad v sti zdrojovou aplikac dat koprovna do jinho
! msta ne kde je oekv, ppadn zda napklad kvli nedostatenm prvm
! nemohl nast seznam odeslanch soubor ve zdrojov sloce.

DIAGNOSTIKA:
------------
Veker innost programu EDIREX se zaznamenv vetn asu do souboru
C:\EDIREX\log\audit.log.
V ppad chyby se vytv soubor C:\EDIREX\log\error.log - lze pout pro
automatickou detekci chyby z nadazenho programu.
Pro zskn podrobnjch vpis innosti programu je mono v souboru EDIREX.cfg
nastavit poloku edirex_biolit=0 na hodnoty 1 nebo 2.
! Pro zajitn spolehlivho doruovn zprv je velmi vhodn obas prohldnout
! konec souboru C:\EDIREX\log\audit.log, zda se zde vyskytuj vpisy o spnm
! navzn spojen, ppadn se objevuje njak problm.
Poznmka: Ojedinl hlen problmu s navznm spojen nen fatln chybou,
pokud je nsledn pokus nap. po 10 minutch ji spn. Krtk vpadek me
nastat kvli drb komunikanho serveru.
Pokud nespnost pihlen petrvv del dobu - nap. hodinu, zkontrolujte
funknost va st, ppadn kontaktujte firmu TELEDIN.

Dle jsou v direktori c:\EDIREX\log vytveny soubory inmsg.log a outmsg.log,
do nich se zapisuje pehled pijatch a odeslanch soubor i s uvedenm
asu jejich pijet nebo odesln.

AUTOMATICK SLEDOVN INNOSTI:
-------------------------------
Pro automatick sledovn sprvn innosti EDIREXu je mono vyut pznak
EdirexLastConn.txt, kter EDIREX obnov po kadm spnm pihlen na schrnku.
Adres, kam je tento pznak zapisovn je mono nastavit v konfiguraci EDIREX.cfg
Pokud pouvte software pro sledovn innosti provoznch systm, mete kontrolou
st tohoto pznaku detekovat, zda EDIREX "ije", ppadn e dolo k njakmu
problmu ve sprvn funkci EDIREXu, a ji z jakhokoliv dvodu.
Dalm uitenm pznakem innosti EDIREXu je pznak EdirexLastDownload.txt,
kter je EDIREXem obnoven po kadm spnm staen souboru ze schrnky, jeho
sledovnm opt meme vyvolat poplach v ppad, e v danm termnu nedorazila
oekvan data. Podrobnji lze tato data sledovat pomoc listingu staench soubor,
pokud napklad potebujeme zjistit, zda pila data uritho jmna.
Tyto vpisy jsou zapisovny do soubor C:\EDIREX\log\inmsg.log a outmsg.log.

Provozn informace:
-------------------
Z dvodu poteby zajitn stl bezchybn funknosti sluby EDIREX se provd
na naem serveru jednou denn restart tto sluby v ase 23:17 hod.
Restart trv asi 20 sekund a pi pokusu o pihlen v okamiku restartu EDIREX
nahls nezdaen pokus o pihlen - toto nen zsadn chyba - viz DIAGNOSTIKA.
Pokud spoutte EDIREX automaticky, zamezte, pokud je to mon pihlaovn v
tto dob, aby EDIREX negeneroval zbyten hlen o chyb pipojen.

PROVOZ:
-------
Program je poteba spoutt pomoc dvkovch pkaz:

edirexin.bat - pouze sthne data z pslun schrnky
edirexout.bat - pouze odele data do pslun schrnky.
edirexio.bat - sthne i odele data z a do schrnky, bhem jednoho pihlen.

Pi voln dvkovch soubor nemus bt aktuln adres nastaven na domovsk
adres EDIREXu. 

Program se po sputn pihls do Va pslun schrnky v systmu TELEDIN CCF
a sthne z n na lokln pota defaultn do direktore C:\EDIREX\INBOUND
soubory ekajc ve schrnce. spnost i nespnost vloen dat do INBOUND je
zaznamenna v logu audit.log.
(Data jsou ve skutenosti nejprve stahovna do sloky C:\EDIREX\tmp\in a teprve po
staen pesunuta do adrese zadanho v poloce "edirex_inbound="
v konfiguranm souboru EDIREX.cfg.)

!POZOR!:
! Nen zde pouita funkce MOVE ale COPY, protoe me bt poadovno, aby data
! byla ukldna na sov disk, kde se pak MOVE chov stejn jako COPY. Pro
! zajitn bezproblmovho pedvn dat do nsledujc aplikace je zvolena
! tato funkce: pokud je v clovm adresi (edirex_inbound=) nalezena sloka
! "temp", je datov soubor nejprve zkoprovn sem a nsledn se provede MOVE do
! clovho adrese. Takto se funkce MOVE chov poadovanm zpsobem i na
! sovm disku. (Pak se ji aplikace odebrajc data od EDIREXu nemus
! obvat, e oteve soubor, kter jet nen kompletn. - vhodn pro automatick
! pedvn dat)
! Pokud zde sloka "temp" nen, je provedeno pouze COPY do clov sloky. - Pak
! mus kompletnost dat ohldat obsluha - nap. runm sputnm nsledn
! aplikace a ve chvli, kdy m jistotu, e data jsou ji kompletn - tk se
! datovch soubor vt velikosti - od destek, i spe stovek KB a vce.
! Zvis tak na rychlosti pesunu dat na lokln sti.
! Pozn.: Informaci o tom, zda byl soubor pesunut pomoc funkce MOVE nebo COPY 
! je mono zjistit v logu.

Pokud EDIREX nalezne ve sloce C:\EDIREX\OUTBOUND njak data k odesln, odele
je do schrnky.
Vechny pijat soubory EDIREX souasn archivuje ve sloce C:\EDIREX\INARCHIV.
Vechny odeslan soubory EDIREX archivuje ve sloce C:\EDIREX\OUTARCHIV.

Zpsob provozovn komuniktoru EDIREX zvis na pedpokldan etnosti
pichzejcch a odchzejcch zprv a dob, za jakou mus dan zprva dorazit
do cle.

Pokud potme pouze s nkolika zprvami denn, u nich souasn nen kritick
rychlost doruen, sta, kdy EDIREX spustme nkolikrt za den run.

Pokud pedpokldme vt provoz zprv, u nich je dleit i doba doruen, je
nejlep nechat program EDIREX spoutt automaticky v zadanch intervalech
pomoc asovae - nap. WINCRON, AT a podobn. Za nejkrat rozumn interval
povaujeme asi 15 minut, krat intervaly zpsobuj kromn nemrnho zvyovn
zte serveru tak narstn objem log soubor jak na stran naeho serveru,
tak na stran zkaznka, ve kterch se pak obtnji hledaj potebn informace.
Pouze pokud je pro Vs pi doruen zprvy dleit "kad minuta", mete
pout i krat interval.

! Je ovem NADLE NUTN kontrolovat innost EDIREXu, m je doruen zprv
! asov krititj, tm astji!
Pokud zprvy skuten pichzej v oekvanch dobch, mme potvrzenu sprvnou
innost EDIREXu, ovem jestlie napklad nepila data v oekvanou dobu,
ppadn mme podezen na jin okolnosti, kter by mohly zpsobit nefunknost
komunikace nebo stanice, na kter b EDIREX, je dobr sprvnou funkci EDIREXu
zkontrolovat prohldnutm souboru C:\EDIREX\log\audit.log
Zdren dat me bt samozejmn zapiinno mnoha dalmi faktory po cel cest
zprvy.

DRBA:
-------
Je vhodn - zvlt pi intenzvnm provozu kontrolovat obsah archivnch
direktor INARCHIV a OUTARCHIV a ppadn odmazvat star soubory, pokud mme
jistotu, e je ji nepotebujeme a zabraly by msto na disku.
Dle je dobr kontrolovat dlku logovho souboru, nemla by pesahovat velikost
nkolika MB, pokud mme jistotu, e log nebudeme potebovat (komunikace chod,
nebudeme nap. dohledvat njak star soubor), meme soubor audit.log smazat,
automaticky se zalo nov. Pokud bychom chtli log odmazvat postupn, je mono
to provst tak, e souasn audit.log pejmenujeme na audit01.log, nsledn
vznikl audit.log po dosaen urit velikosti na audit02.log atd. a tyto
soubory pak meme postupn od nejstarch odmazvat.

DAL NASTAVEN:
----------------
Pomoc parametr v souboru C:\EDIREX\EDIREX.cfg je mono pizpsobit nkter
vlastnosti EDIREXu vaemu prosted a poadavkm.

Pozn.: dky v souboru EDIREX.cfg, zanajc # jsou komente a jsou
ignorovny. Meme je vyut napklad pi doasn zmn nkterho parametru
tak, e cel dek zkoprujeme, pvodn zakomentujeme pomoc # a pravu
provedeme v novm dku. Nvrat k pvodnmu nastaven provedeme opt zmnou
zakomentovn nepotebnho dku.

Jedinenost jmen:
-----------------
U odeslanch soubor je NUTN z hlediska dohledn konkrtnho souboru, aby
ji systm, kter vytv soubory s daty k odesln dbal na JEDINENOST JMEN
ODESLANCH SOUBOR, alespo v rmci jednoho dne, ale radji dle.
Pokud nemete tuto jednoznanost zajistit, je mono pout parametru
UnikatniJmena=1, kdy sm EDIREX doplnnm asovho daje ke jmnu
souboru zajist jedinenost jmen. asov daj je doplnn za prvn st jmna
souboru ped prvn tekou ve jmn. Pklad:

jmeno.bbb.edi -> jmeno071031142458468.bbb.edi

Pokud je jednoznanost jmen soubor zajitna, je vhodnj nastavenm
UnikatniJmena=0 vypnout pravu jmen soubor.
!POZOR! - zapnut tto funkce konzultujte prosm s pracovnky firmy TELEDIN,
zpracovn zprv od nkterch zkaznk pouv k identifikaci zprv prv
jmno souboru, zapnut funkce  "UnikatniJmena" by mohlo toto zpracovn
naruit.
! Tato funkce me zajistit jedinenost jmen pouze u soubor, kter ji EDIREX
! pevzal od Vaeho systmu, nee vechny problmy, kter by mohly nastat
! v ppad pouit stejnch jmen odeslanch soubor, nap. pi pedvn
! dat EDIREXu (monost pepsn pedchozch dat)
! Proto opt apelujeme na ZAJITN JEDINENOSTI JMEN ODESLANCH SOUBOR
! Vam systmem ! - jinak me hrozit ZTRTA DAT !

Ve jmnech soubor nejsou povoleny MEZERY z dvodu zamezen nslednch problm
pi zpracovn dat na stran zkaznka i providera. EDIREX v ppad vskytu
mezery ve jmn dat vyd chybov hlen a soubor nen penesen. Proto je dobr
mt nastaven zasln upozornn na chyby - viz nsledujc odstavec.
 
Zasln upozornn na chyby:
-----------------------------
EDIREX umouje zaslat upozornn na chyby jak pomoc e-mailu, tak pomoc
windows messaging systmu (vyskakovac pop-up okno se zprvou). Zasln zprvy
pomoc windows messaging vyaduje, aby na clovm potai bela sluba
"Messenger" ( V eskch Windows pod nzvem "Kurrn sluba" ).


Parametry pro zasln info a chyb e-mailem v EDIREX.cfg (Od verze 3.3):
-------------------------------------------------------------------------
SendErrorEmail=1 - povolen zasln e-mailu o chybch (0=neposlat)
SMTP_server=adresa[:port]  - e-mailov server, pes kter jsou zprvy zaslny
                             napr: 10.1.1.5  nebo s uvedenm portu:  212.78.14.6:77
                           - MUS bt nastaveno, jinak nelze zprvy odeslat.
                           - Pomoc dalch parametr (viz cfg soubor) lze nastavit
                             i autorizaci u sever, kter to poaduj.
                           - pi pouit ifrovan komunikace (nap port 465) mus
                              bt nastaveny i autorizan daje pro pihlen na 
                              SMTP server - Email_authid= a Email_authpwd=  !!
Email_FROM=EDIREX@teledin.cz  - adresa odeslatele, lze zmnit. Nastavte ji prosm
                                na adresu sprvce Va st a pod. Dostv odpovdi
                                v pripad nedoruitelnosti na Email_ERROR_TO...
Email_ERROR_TO=admin@firma.cz  - adresa primrnho pjemce zprv.Je mono zadat
                                 vce adres, oddlench rkami.

Email_auth=LOGIN    - Zpsob autorizace na SMTP serveru, povolit, pokud to vyaduje.
                      Je poteba zjistit, jak zpsob autorizace V server pouv.
Email_authid=       - jmno uivatele na SMTP serveru
Email_authpwd=      - heslo uivatele na SMTP serveru

---- Windows messaging: ------------------------------------------
SendErrorPopup=1 - povolen zasln zprv pomoc windows messaging (0=neposlat)
PopupComp1=pocitac1 - windowsov jmno potae, na kter je zprva zaslna
PopupComp2=  - jmno druhho potae
PopupComp3=  - jmno tetho potae
-------------------------------------------------------

Zasln zprv je mono ovit pomoc parametru "testmsg" pi sputn programu
EDIREX - nap.:
C:\edirex>edirexin.bat testmsg

Program zale testovac chybovou zprvu podle nastaven v EDIREX.cfg a skon.

Zasln informac o pijet dat:
---------------------------------
Pokud je nastavena e-mailov adresa v parametru:
Email_INFO_TO=
EDIREX zale na tuto adresu zprvu o pijet kadho novho souboru. Je mono zadat
vce adres, oddlench rkami.
Opt MUS bt nastaveno SMTP_server= a ppadn autorizace na SMTP serveru.

Odesln jen uritch typ soubor:
------------------------------------
Pomoc parametru "Wildcards" je mono nadefinovat, kter typy soubor se maj vybrat
a odeslat z adrese "edirex_outbound". Definice se provd zapsnm "wildcardu",
tak jak je bn ve Windows. Je mono definovat vce typ oddlench rkou.
Nezle na velikosti psma. Przdn parametr znamen "*.*" - tedy e ve jmn mus bt
teka. Pro odesln pln vech soubor nastavme "Wildcards=*".
Pklad:
Wildcards=*.txt,invoic*.*,*.edi

Stahovn jen uritch soubor ze schrnky:
--------------------------------------------
Pi sputn EDIREXu s parametrem "type" je mono jako dal parametr zadat seznam etzc
oddlench rkou. Ze schrnky pak budou staeny jen ty soubory, jejich jmna obsahuj
nkter z etzc v seznamu, s ROZLIENM VELIKOSTI ZNAK!. Lze pout pro stahovn jen
uritch typ zprv - napklad stahovat asto jeden typ malch soubor a nechat nkdy na 
pozdji staen velkch soubor, nebo napklad vybrat z jedn schrnky data uren pro
rzn poboky - po dohod s TELEDINEM.
Pklad sputn:  edirexio type .xml,.edi,ahoj,BEROUN
Pak budou staeny soubory : "zprava.xml" "2ahojte.txt" "dokument.edi.neco" "BEROUN123.xml"
NEbudou staeny soubory: "zprava.doc" "edizprava.txt" "beroun123.xml" "JIHLAVA837.xml"

!POZOR! - Pouit tto funkce me pi nepozornosti vst k "zhadnmu" nestahovn soubor,
          na kter ekte. Proto ji vdy vyuijte s rozmyslem a vdomm co dlte!

Mazn Temp adrese schrnky:
------------------------------
Data se do schrnky odeslaj tak, e se naped penej do adrese Temp ve schrnce,
a po dokonen penosu souboru se soubor pesune z Temp do vstupu schrnky. Nkdy se me
stt, e bhem penosu dat dojde k pdu spojen a v Temp zstane sten penesen soubor.
EDIREX se pi ptm spojen pokou nekompletn penesen soubor penst znovu, ovem
pokud v Temp le soubor stejnho jmna, EDIREX jej naped smae (oznm v logu "mazu tmp")
a pak zane optovn penos. Pokud se jedn o stejn data, nen problm, ten by ovem mohl
nastat, pokud by jste odeslali jin data v souboru se stejnm jmnem.
 - proto je NUTN ZAJISTIT JEDINENOST JMEN odeslanch soubor, i zdvodu nebezpe
   pepsn pedchozch dat napklad v archivech a jinde (viz ve). 
Mazn pedchozho souboru stejnho jmna v Temp lze zakzat pomoc parametru:
Zakaz_mazani_in_temp=1
Pak se ovem nkdy me stt e penos souboru kvli kolizi nelze provst a objev se chyba:
 "ERROR 200 -- Chyba pri SSH presunu souboru na server, mozna kolize se souborem v in/temp.". 
Zprovoznit penos lze nastavenm "Zakaz_mazani_in_temp=0", pokud vte, e pedchoz soubor
opravdu chcete smazat, nebo kontaktovnm pracovnk firmy TELEDIN a dohodnutm se na
dalm postupu.

DAL PARAMETRY:
----------------
EDIREX.cfg obsahuje i nkter dal parametry, jejich pouit je ovem specilnj,
jejich nastaven je poteba konzultovat s pracovnky firmy TELEDIN.

TESTOVN:
----------
Pro testovn pipojen a penos dat je mono vyut ji ve zmnn testovac
reim, kter se spust pomoc parametru "test". V testovacm reimu se EDIREX
pipoj na testovac schrnku TESTUSER, ze kter nejsou data odebrna k dalmu
zpracovn, take do n mete zaslat libovoln soubor, napklad pro otestovn
rychlosti a spolehlivosti penosov linky a podobn. Jinak je innost EDIREXu
shodn s provoznm reimem.
Schrnka funguje tak, e kad soubor, zaslan do tto schrnky je do 5 minut od
zasln pesunut na vstup tto schrnky, odkud jej mete sthnout zpt a dky
tomu mete otestovat i opan smr penosu soubor.
POZOR! Testovac schrnka je spolen pro vechny uivatele, take se me stt,
e Vmi zaslan soubor bude staen jinm uivatelem a naopak.

PECHOD na verzi 2.1 a novj:
-------------------------------
Pro pechod na nov verze sta rozbalit novou instalaci v pvodnm direktori
C:\EDIREX (Pro jistotu je dobr vytvoit si zlon kopii sloky C:\EDIREX)
a pevst parametry z pvodnho konfiguranho souboru EDIREX2.cfg do EDIREX.cfg.
POZOR!: Jmna nkterch parametr (hlavn u zasln e-mailem) byla zmnna na
logitj, proto je poteba je pevst pozorn run, pokud je pouvme.

Meme tak smazat celou sloku C:\PERL, kter ji nyn nen pouita.
EDIREX 2.1 je poteba volat pomoc novch script edirexin.bat, edirexout.bat
nebo edirexio.bat - !! zmnit v software, kter volal pvodn scripty !!
Dle je mono vyut nov mechanizmus pro pedvn soubor pomoc sloky temp -
popsno ve, pouhm vytvoenm sloky temp v clovm adresi.

Proveden upgrade z verz 3.XX a 4.XX na vy:
-----------------------------------------------
Nejjednodu a nejspolehlivj postup je:
Pejmenovat stvajc adres EDIREXu c:\EDIREX nap. na c:\EDIREX.old.
Run vytvoit nov adres c:\EDIREX. V nm rozbalit zip s novou verz EDIREXu.
Z pvodn instalace EDIREXu penst kl id_rsa z adrese c:\EDIREX.old\.ssh
(z verze 4.XX) nebo adrese c:\EDIREX.old\bin\.ssh (verze 3.XX) do adrese
c:\EDIREX . 
V souboru c:\EDIREX\EDIREX.cfg upravit poloku edirex_user=NOBODY podle nastaven
ve Vaem pvodnm konfiguranm souboru.
Pokud pouvte EDIREX ve standardnm nastaven, mlo by to bt ve a mete zat
pouvat novou verzi EDIREXu. Pokud jste mli v pvodnm EDIREXu nkter
nestandardn nastaven, nastavte odpovdajc poloky v novm konfiguranm
souboru c:\EDIREX\EDIREX.cfg podle star konfigurace v C:\EDIREX.old\EDIREX.cfg.
Dle je mon, e bude poteba ze star verze EDIREXU penst nkter pdavn
moduly a adrese, pokud je pouvte. To poznte podle nastaven ve star
konfiguraci.

Pesun EDIREXu na jin pota:
-------------------------------
Od verze 4.xx sta zkoprovat adres c:\EDIREX na nov pota a EDIREX bude
funkn. Proto doporuujeme kdy pouvte pedchoz verze, sthnout si novou z:
http://download.teledin.cz/edirex/ soubor EDIREX_WIN_XXX.zip, rozbalit na novm
potai a provst pechod podle pedchzho odstavce.
Zamezte prosm souasnmu spoutn EDIREXu na vce potach, me to vst k
potm v komunikaci, zmatku v ukldn zprv, ppadn ke ztrt dat.

HISTORIE VERZ:

ZMNY v EDIREXu 2.1 oproti starm verzm:
------------------------------------------
- Je kompletn pepracovn pro zven spolehlivosti funkce, pohodlnj
  instalaci a zlepen diagnostiky innosti programu.
- Nen ji nutno pro spoutn EDIREXu vytvet a pouvat specilnho uivatele.
- Pouv pouze jeden konfiguran soubor EDIREX.cfg msto
  EDIREX1.cfg a EDIREX2.cfg.
- Pouv msto jednoho spolenho archivu ARCHIV dva archivy -
  INARCHIV a OUTARCHIV pro oddlen ukldn pchozch a odchozch zprv.
- Je zmenena instalan velikost programu odstrannm nepotebnch knihoven
  v interpretu Perlu.
- Umouje testovac pipojen na schrnku TESTUSER pomoc parametru test
- zajiuje integritu pedvanch dat dky pomocnmu direktori temp
- Umouje zajistit jedinenost jmen odeslanch soubor

EDIREX v. 3.3:
-----------------
- ! Zmna nzvu parametr zasln zprv v EDIREX.cfg ! viz ve.
- Krom audit.log vytv speciln logy inmsg.log a outmsg.log se seznamy
  pijatch a odeslanch soubor. Vypisovan informace se budou v budoucnu
  roziovat - pprava pro pedvn dat do budouc GUI aplikace umoujc
  komfortn zobrazovat pehled pijatch a odeslanch soubor.
- Zasl e-mailem informaci o pijet dat.
- Upravena funkce "uniktn jmna" tak, aby asov daj nebyl pidvn na
  zatek jmna ale na konec prvn sti jmna.
- Balk EDIREXu ji obsahuje soubor "known_hosts", take nevyaduje pi
  prvnm sputn zadat "yes".
- Dal drobn vylepen funkce.

EDIREX v. 3.32:
-----------------
- Opraveno pesunut vstupnho souboru do outarchiv v EDI reimu
- Zmnn nzev parametru edirex_out na edirex_out_dir - pozor pi penosu cfg souboru do vy verze!

EDIREX v. 3.34:
-----------------
- V mdu IO se EDIREX nepokou pipojit dvakrt, pokud se prvn pipojen nezdailo,
  posl tak jen jeden chybov e-mail.

EDIREX v. 3.35:
-----------------
- Vnitn pravy
- Opraveno - pokud se ve vstupnm souboru objevily nkter dc znaky (nap. \1A),
  koprovn souboru se na tomto znaku zastavilo. Nyn speciln znaky nedlaj problm.
- Opravena chyba pi zasln popup zprv.

EDIREX v. 3.36, 3.37:
-----------------
- Upravena prce s pdavnm modulem ZpracujIn
- Pizpsoben pro penositelnost na UNIX

EDIREX v. 3.38:
---------------
- Je mono pomoc wildcards nastavit, kter soubory budou z "edirex_outbound" vybrny a odeslny.

EDIREX v. 3.39:
---------------
- Zmnn zpsob chovn EDIREXu pi zpisu do vstupnho adrese "edirex_inbound":
  Doposud byla v ppad nespnho pokusu o zpis pijatch dat do adrese "edirex_outbound" data
  pesunuta do "Inarchiv" a dle se EDIREX nepokouel data na vstup zapsat, pouze provedl zznam o 
  nespnosti zpisu do auditlogu.
  Nyn data po nespnm pokusu o zpis do "edirex_outbound" zstvaj v adresi "edirex_in_dir" a pi
  kadm sputn se EDIREX pokus data pesunout znovu. Opt je v ppad nespnosti proveden zpis do
  auditlogu a vyslno e-mail a pop-up varovn. A teprve v ppad spnho pesunu dat jsou data tak
  uloena do "Inarchiv" a je proveden zpis o spnm pesunu dat do "edirex_outbound".
  (Jedn se o situaci, e clov adres sice existuje, ale stejn do nj nen mono zapsat, nap. z dvodu
  zaplnn filesystmu, patnch prv a pod.
  Pokud vstupn a vstupn adrese ("edirex_inbound" a "edirex_outbound") neexistuj (nap. nepipojen
  sov disk), EDIREX kontroluje tuto skutenost hned na zatku sputn a vyd o n zprvu (pop-up a
  e-mail, pokud jsou nastaveny) a skon bez provdn jakkoliv dal innosti.)
- Otoen vznam nvratovho kdu pro CONTRL - 0=OK, ne0=kd chyby

EDIREX v. 4.01:
---------------
- Pro SSL komunikaci pouity jin knihovny, ji nen poteba prosted CYGWIN, pracuje i na WIN2008 server.
- Zjednoduena instalace - sta jen rozbalit instalaci, vloit pstupov kl, nastavit jmno uivatele
  v konfiguraci a program je funkn.

EDIREX v. 4.02:
---------------
- Vylepena spoluprce s SFTP procesem.
- Men pravy vpisu logu bhem stahovn dat.(Vpis OK)

EDIREX v. 4.03:
---------------
- Upraven zpis do spolenho souboru v mdu E - pi nezdaenm pokusu o oteven spolenho souboru
  zstanou zprvy v edirex_in.
- Doladn binmode v NactiCtrlHlavicku.
- Odchoz i pchoz soubory testuje na EDIFACT, zskan daje zapisuje do inmsg.log a outmsg.log
- Mal pravy u zpracovn Wildcards (umon odeslat i *)

EDIREX v. 4.04:
---------------
- prava generovn sluebnch dat.

EDIREX v. 4.05:
---------------
- V ppad, e je pi odesln ve schrnce v in/Temp adresi soubor stejnho jmna, je smazn a pepsn
  novm souborem. (Lze zakzat parametrem "Zakaz_mazani_in_temp=1" v EDIREX.cfg)
- V ppad, e je pi stahovn v out/Archiv soubor stejnho jmna, je ke jmnu novho souboru pidn as,
  a takto pesunut do archivu. V logu je tato udlost zaznamenna hlkou:
  "V remote archivu je soubor stejneho jmena, archivuji jako ..."

EDIREX v. 4.06:
---------------
- Upraveno chovn EDIREXu pi odesln - v BINARY mdu jsou odeslan soubory smazny z OUTBOUND a v ppad
  spnho odesln, jinak zde zstvaj.
  - Funguje POUZE v BINARY mdu a pi nepouvn funkce "uniktn jmna"!

EDIREX v. 4.07:
---------------
- Upraven pjem soubor vyadujcch odesln potvrzen. Pokud by dolo k pdu programu ped odeslnm potvrzen,
  soubor i s hlavikou je uchovn v tmp a pi ptm sputn zpracovn.
- Je umonno pepsn souboru v inbound pchozm souborem stejnho jmna, lze zakzat parametrem Zakaz_prepis_inbound=1

EDIREX v. 4.08:
---------------
- Pidna monost voln externho modulu ped odeslnm dat - parametr PreSendCall.

EDIREX v. 4.09:
---------------
- Pidna monost autorizace na SMTP serveru pro odesln chybovch a info zprv, pokud je vyadovna.
- POZOR! - v EDIREX.cfg zmnn nzev nkterch parametr, pi upgrade je poteba run nastavit v novm .cfg:
    SendInfoEmail -> Email_INFO_TO
    Email_TO -> Email_ERROR_TO
- Byly vyputny parametry Email_CC a Email_BCC , zprvy na vce pjemc lze zaslat zadnm vce adres
  oddlench rkami.

EDIREX v. 4.10:
---------------
- pravy souvisejc s problmovmi jmny soubor (je zakzna mezera ve jmn odeslanch i pijmanch soubor
  z dvodu zamezen vzniku nslednch problm pi zpracovn dat na stran klienta i providera)
  V ppad vskytu mezery ve jmn pijmanho nebo odeslanho souboru je odeslno chybov hlen a soubor
  je ignorovn.
  - Vskyt takovhoto souboru nezablokuje penos ostatnch soubor se sprvnmi jmny.

EDIREX v. 4.11:
---------------
- Pidna monost zadn staen jen uritch soubor ze schrnky pomoc parametru "type".

EDIREX v. 4.12:
---------------
- Pidna monost pipojen na alternativn adresu serveru, pokud sele pipojen na primrn adresu.
- Pstupov privtn kl id_rsa se nov ukld pmo do koenovho adrese EDIREXu, tedy obvykle do
  c:\EDIREX. Je zachovna kompatibilita i s pvodnm umstnm v c:\EDIREX/.ssh.

EDIREX v. 4.13:
---------------
- opravena chyba odesln doruenek v edirex_edi_type=E modu.

EDIREX v. 4.14:
---------------
- Doplnno vytven error.log.

EDIREX v. 4.15:
---------------
- Upraveno chovn pi odesln .ctr soubor.

EDIREX v. 4.16:
---------------
- (Windows) Pidna kontrola duplicity bhu EDIREXu pomoc mutex.

EDIREX v. 4.17:
---------------
- Vnitn pravy

EDIREX v. 4.18:
---------------
- (Windows) Kontrola volnho msta na disku - EDIREX se nespust, pokud nem alespo 2MB volnho msta na disku, kde je nainstalovn.
- (Windows) Um ukonit ppadn pedchzejc neukonen bhy programu, lze zakzat - parametr Kill_old
  - Kill_old=1 - killne pedchoz bh EDIREXu a pokrauje.  Kill_old=0 - nech pedchoz bh a ukon se.

EDIREX v. 4.19:
---------------
- Pomocn adrese in a out pesunuty pod tmp, aby nemtly uivatele.
- Pidna monost nastaven portu pro komunikaci se SMTP serverem.

EDIREX v. 4.20:
---------------
- Upraveno chovn - vyhodnocen chyb, logy a varovn e-maily, pi pipojen na druh server.

EDIREX v. 4.21:
---------------
- Upravena kontrola duplicitnch jmen soubor pi stahovn. ZakazPrepis=1

EDIREX v. 4.22:
---------------
- Opravena chyba pi zjiovn volnho msta na disku

EDIREX v. 4.23:
---------------
- Zamezen penesen potenciln nekompletnho souboru pi chyb spojen ve specifick situaci.

EDIREX v. 4.24:
---------------
- Pokud ve sluebnm adresi out ekaj potvrzenky doruen, jsou odeslny i pi sputn EDIREXu v in reimu.
- Pidno vypisovn do logu informace o mdu sputn.
- Pidno vypisovn do logu sla prvodky pi vytven doruenky.

EDIREX v. 4.25:
---------------
- Pidna monost komunikace pes proxy server.
  - zapnout v EDIREX.cfg parametrem proxy=y
  - nastavit dal potebn parametry pro proxy - zejm z konfigurace.

EDIREX v. 4.26:
---------------
- Zmna chovn - EDIREX pokrauje v pjmu i odesln zprv i v ppad vskytu chyb, pvodn ukonil innost
  pi vskytu prvn chyby.
  - Lze ovlivnit nastavenm parametr StopOnInError a StopOnOutError.

EDIREX v. 4.27:
---------------
- Pidno opakovn pokusu o pipojen na server - parametry:
  NumRetryConn=4  - defaultn 4 opakovn pokusu o pipojen.  (0=pi nespnm pokusu spojen neopakuje)
  DelayRetryConn=3  - defaultn 3 minuty mezi pokusy o pipojen.
  Pi nastavovn tchto parametr dejte pozor, aby maximln doba opakovn pipojen nekolidovala 
  s ptm sputnm Edirexu pomoc asovae.
- EDIREX po pnm pipojen zape pznak - soubor EdirexLastConn.txt
  do adrese urenho parametrem EdirexLastConn=
- EDIREX po pnm staen souboru zape pznak - soubor EdirexLastDownload.txt
  do stejnho adrese jako minul pznak. (EdirexLastConn=)
  - lze pout pro sledovn, kdy naposledy pila njak data.
  - Pro podobn el lze pout i as souboru inmsg.log v c:\Edirex\log. (Pro odchoz data - outmsg.log)

EDIREX v. 4.28:
---------------
- Zmna zjitn volnho msta pomoc pkazu dir.
  - Pidno C:\WINDOWS\system32 do path= v .bat souborech

EDIREX v. 4.29:
---------------
- Zmna monost konfigurace pracovnch adres Edirexu.
  - Pi instalaci do jinho ne standardnho adrese c:\EDIREX je nyn poteba nastavit domovsk adres Edirexu
    ji jen zmnou jedinho parametru EDIREX_HOME v souboru EDIREX_HOME.bat
  - V EDIREX.cfg v definicch cest k adresm je mono pout parametr $EDIREX_HOME
- Pi vymazn adres tmp a archiv si Edirex sm zkus vytvoit nov.
- Pi nenalezen pedefinovanch cest k tmp a archivm Edirex pouije standardn adrese, pokud to jde.

EDIREX v. 4.30:
---------------
- Odstranna poteba nastavovat domovsk adres EDIREXu.
  - Parametr EDIREX_HOME se nastav automaticky podle umstn pslunho sputnho .bat souboru
     (test.bat, edirexio.bat ... atd.)

EDIREX v. 4.30_2:
-----------------
- prava zjiovn volnho msta na disku (CZ + EN)
- Oprava hlen chyby v exec_send.

EDIREX v. 4.30_3:
-----------------
- Pidno hlen o nezdaenm mazn odeslanho souboru z tmp\out (kvli duplicitnm .ctr) v exec_send.

EDIREX v. 4.30_4:
-----------------
- Pidn parametr TestovatMisto= v EDIREX.cfg, umoujc vypnout testovn msta (=0)

EDIREX v. 4.31:
---------------
- Pokud se Edirexu nezda vzdlen pesunout staen soubor na serveru z OUT do OUT/Archive, smae i pslun staen soubor v tmp/in
   - napklad pi pdu spojen - kvli zamezen duplicit dat, soubor bude staen pi dalm pipojen

EDIREX v. 4.32:
---------------
- Pidno pesunut odeslanho souboru do tmp/out/sent, pokud se nepoda kopie do Archivu. (Kvli zamezen duplicitnho zasln zprv a potvrzenek.)
  Zprvy jsou ze sent pesunuty do Archivu ve chvli, kdy je to opt mon.

EDIREX v. 4.33:
---------------
- umouje i odesln e-mail ifrovanou komunikac (nap nastavenm portu 465 pro SMTP server)
  Pi pouit ifrovan komunikace mus bt nastaveny autorizan parametry Email_authid= a Email_authpwd=

EDIREX v. 4.33:
---------------
- Pidna hlka do logu o koprovn souboru z Outbound do Out

EDIREX v. 5.0:
--------------
- Pouit nov Bitvise client 9.33, kvli pouit novch ifer pro komunikaci.

EDIREX v. 5.1:
--------------
- Pouita nov verze programu mailsend-go pro odesln email.
