Popis konfigurace MobilChange v registry

Tento dokument popisuje záznamy MobilChange v registry Windows.

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys]
Veškerá konfigurace systému MobilChange je v tomto klíči.

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\admin]
Adresa a popis administrátora. Na tuto adresu jsou odesílány informační a chybové hlášky.
"language"="cz" -> jazyk kterým budou posílány informační a chybové hlášky administrátorovi
"name"="jmeno prijmeni"
"addr"="jmeno@firma.cz"
"gateway"="s" -> podle typu e-mail systému (s=SMTP, e=Exchange, l=Lotus Notes)

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\database]
Konfigurace připojení k databázovému stroji. Podrobnosti zde.

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\global\admin]
Adresa a popis administrátora. Na tuto adresu jsou odesílány informační a chybové hlášky. Mělo by zde být to samé, jako v MobilChange\admin.
"name"="jmeno prijmeni"
"language"="cz"
"gateway"="s"
"addr"="jmeno@firma.cz"
"addrtype"="SMTP"

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\global\dial]
Konfigurace, zda se má upravovat číslo, je-li zadáno v jiném nežli mezinárodním formátu.
"normalize"="1" -> normalizovat číslo ano/ne
"StatePrefix"="420" -> mezinárodní číslo státu, kde jsme

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\global\smtp_pop3]
Konfigurace SMTP/POP3 gatewaye
"sms_subdomain_mode"="1" -> 0 = adresy ve tvaru číslo@sms, 1 = číslo@sms.doména.xx - viz sms_domain.
"addr_mode"="0" -> formátování adresy u odesílaných SMTP zpráv: 0=EMWAC/obecný mailový server, 1=OpenMail
Pro následující dvě položky platí:
US ASCII = 0, ISO 8859-1 = 1, ISO 8859-2 Latin-2 = 2, Windows CP1250 = 3, MS DOS Latin-2 (CP 852) = 4, CZ Kamenicky (CP 895) = 5, CZ MAC = 6, CZ KOI8CS = 7. Více viz. http://www.ums.cz/kb/KBFX20000314-112116BRO.html
"encoding_local"="3" -> kódová stránka používaná ve Windows
"encoding_transport"="2" ->kódová stránka v odesílaných SMTP e-mailech
"pop3_server"="pop3.firma.cz" -> POP3 server, ze kterého budou čteny zprávy k odeslání. Pokud POP3 server běží na jiném než standardním portu 110 (např. 3110), zadejte jej jako pop3.firma.cz:3110
"smtp_server"="smtp.firma.cz" ->SMTP server na který budou odesílány odchozí zprávy.
"pop3_logon"="mobilchange@firma.cz" -> login pro přihlášení k POP3 serveru.
"pop3_password"="" -> POP3 heslo
"server"="SMS" -> jméno lokálního serveru
"pop3_fullname"="mobilchange@firma.cz" -> Email adresa za které jsou odesílány zprávy "od MobilChange"
"ForceUseCrLf"="0" -> 0=POP3 příkaz bude ukončen LF, 1=POP3 příkaz bude ukončen CRLF.
"out_addr_mode"="0"-> typ "SMS" adresy pro odchozí zprávy - 1=OpenMail (user@cislo.sms), 0=jiné ("uživatel" <cislo@sms>)
"sms_domain"="sms.firma.cz" -> "vlastní" SMTP doména (viz. sms_subdomain_mode)

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\global\system]
"AllowInternetSenders"="0" -> (Exchange gateway) Povolit posílání SMS internetovým uživatelům přes váš MobilChange? 1 polovoluje odesílání uživatelům se SMTP adresou odesilatele (ne EX). Viz http://www.ums.cz/kb/KBMX19991108-160331BRO.html a http://www.ums.cz/kb/KBMX20020124-163204BRO.html
"InternetSendersCauseSecWarning = "1" -> (Exchange gateway) Pokud AllowInternetSenders=1, pak tato položka nastavuje, zda se pro SMTP odesilatele zapíše do eventlogu hlášení typu "audit failure".
"AllowIMCEAaddress"="1" -> (Exchange gateway) Pokud AllowInternetSenders=1, pak tato položka nastavuje, zda jsou akceptovány e-maily, jejichž adresy v To: jsou stále ve tvaru IMCEA-..., tj. nebyly přeloženy EX Internet Mail Connectorem.
"OnlyOneGateway-SendAllEmails"="1" -> Má gateway posílat všechny e-maily, nebo jen ty, které jsou označeny pro ní? V případě souběhu více gateway nutno nastavit na "0"
"DefaultGateway"="s" -> Přes kterou gateway budou odcházet e-maily, ve kterých není gateway přesně specifikována? Platí jen pro OnlyOneGateway-SendAllEmails=0.
"AllowAutoCreateUsers"="1" -> Povolit systému zakládat uživatele automaticky přijetím emailu, 0 = zakázat.

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\global\timing]
"gw1"="2500" -> Časy po kterých jsou kontrolovány nové zprávy (ms).
"gw2"="2500"
"pop3"="2500"
"exgw_maxmsgs"="10000" -> (Exchange gateway) Po tomto množství zpráv bude gateway automaticky restartována (údržba).
"exgw_maxtime"="7200" -> (Exchange gateway) Po tomto čase (sec) bude gateway automaticky restartována (údržba).

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\info\smtp_tag]
Konfigurace "zavináčových příkazů" pro gatewaye SMTP/POP3 a Lotus Notes

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\Install]
Dočasné proměnné setupu – aby si setup pamatoval, co uživatel nastavil.

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\language]
V podklíčích tohoto klíče je uložena překladová tabulka mezi chybovými stavy MobilChange a jednotlivými jazyky, formátovací řetězce pro datum a čas a použité kódové stránky.

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\line]
V tomto klíči je seznam linek, které jsou spouštěny po startu mxkernelu. V případě potřeby dočasného vyřazení některé linky stačí odmazat v tomto klíči.
"active"="line1,line2" -> Aktivní linky.

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\line\xxxx]
Konfigurace linky, viz tento dokument

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\log]
Konfigurace provozního logu.
"filelog"=dword:00000000 -> 1 = zapisovat log do souboru (adresář \mobilchange\log).
"stdoutlog"=dword:00000001 -> 1 = zapisovat log na konzoli (je-li MX spuštěna na konzoli)
"EventLogFilter"=dword:00000004 -> Do event logu zapisovat pouze zprávy s prioritou vyšší než "4" (tj. warning a chyba)
"WriteStatLog"=dword:00000001 -> Zapisovat statistický log o odchozím provozu na jednotlivých linkách - vytváří se soubory mobilchange/log/stat.<jméno linky>.<YYYYMMDD>.csv.

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\log\level]
Nastavení četnosti zápisů do provozního logu.
"*"=dword:00000005 -> Defaultní hodnota pro aplikace, které nemají explicitně dané hodnoty.
Následují hodnoty pro některé aplikace:
"dispatch"=dword:00000005
"in"=dword:00000005
"out"=dword:00000005
"line.line1"=dword:00000005

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\mobil]
V podklíčích je seznam mobilních telefonů, na něž byly v poslední době posílány SMS. V případě, že přijde odpověď, je do pole Od: SMTP zprávy dosazena hodnota "name".
Viz též system\WriteMobilInfo.
"expiration"=dword:0005a300 -> Doba, po kterou jsou uchovávány informace o číslech, na které byly odesílány SMS zprávy a jejich popis.

Ukázka záznamu o jednom konkrétním telefonu:
[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\mobil\420724283044]
"name"="David Novák"
"expiration"=dword:3f76df48

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\receiving]
V podklíčích je konfigurace zpracování příchozích SMS.

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\receiving\auto]
Tento klíč a jeho podklíče zajišťují vazbu mobilní číslo <-> mailbox, tj. A odešle na 123; když pak přijde SMS z 123, je doručena pro A
"active"=dword:00000001 -> Má být ukládáno číslo, na které je odesílána SMS zpráva a email odesílatele pro případnou odpověď?
"expiration"=dword:0002a300 -> Čas po který je tato informace uchovávána. Sekundy.
"next"=dword:00000001 -> Pokud se najde automatický příjemce, má se ještě zpráva doručit defaultnímu příjemci? Viz. receiving\public\
"delete_timer"=dword:000003e8 -> Jak často se mají mazat vyexpirované záznamy. Jednotkou je průběh hlavní smyčkou procesu out (viz timing.out)

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\receiving\public]
Defaultní příjemce SMS.
"name"="jmeno prijmeni"
"addr"="jmeno@firma.cz"
"language"="cz"

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\receiving\recipient]
V podklíčích se nastavují routovací pravidla pro příchozí SM. Detailní popis je v tomto dokumentu. Pro nastavování použijte mxRouteCfg.

Toto je příklad jednoho směrovacího pravidla:
[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\receiving\recipient\81055327171]
"addr"="$1@$2"
"desc"="SMS->E-mail (#name@domain.com text...)"
"from"=".*"
"body"="^#([^ ]+)[@*]([^ ]+) (.*)"
"language"="zz"
"next"="END"
"output"="$0"

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\receiving\report]
Zde jsou seznamy všech textů, které může operátor vrátit jako textový Delivery/Nondelivery/Info Report v reakci na odeslání SMS. Popis hledejte zde. Každý operátor má vlastní podklíč.

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\sending]
"send_wait"=dword:00000001 -> Pokud je 0 a daná linka podporuje DR, neposílají se uživatelům emaily "Vaše SMS byla odeslána, teď čekáme na delivery report od SMSC". Globální nastaveni - vypne to všem uživatelům. Je možno vypnout per uživatel v mxUserManageru.
"timeoutdr_checkperiod" -> perioda kontroly timeoutu u SMS čekajících na DR, defaultně 900 sekund (platí od verze 4.6.23)

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\sending\route]
V tomto klíči je uložena konfigurace routingu odchozích zpráv , která se nastavuje pomocí mxRouteCfg. Čtěte též zde.

Příklad routingu:
[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\sending\route\100]
"priorities"="nl" -> Zprávy s nízkou a střední prioritou
"recipient"=".*" -> Jdoucí na libovolné číslo
"line"="line1" -> Odchází po lince line1
"desc"="BMG" -> Popis pravidla

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\statexp2]
Konfigurace nástroje Statexport2, podrobnosti zde.

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\system]
"WriteMobilInfo"=dword:00000001 -> Zapisovat informace o mobilních číslech, na které jsou odesílány zprávy. Viz. mobil/
"DR_to_prio"=dword:00000000 -> 1 = pokud má odesílaná zpráva nastaveno "požadovat Delivery Report", zvýší se jí priorita na "high".

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\timing]
Nastavení časování jednotlivých komponent
"*"=dword:000001f4 -> jak často probíhá činnost u ostatních (nezadaných) procesů
"dispatch"=dword:000007d0 -> dispatch: jak často se kontroluje běh jednotlivých procesů mxkernel
"in"=dword:000007d0 -> jak často probíhá činnost procesu in
"out"=dword:000007d0 -> jak často probíhá činnost procesu out
"line.line1"=dword:000007d0 -> jak často probíhá činnost procesu line1

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\user]
Klíč obsahující tabulku uživatelů (pokud se nepoužívá databáze). Každý uživatel má svůj podklíč pojmenovaný podle jeho SMTP adresy. Viz též zde.

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\whitesp]
Konfigurace "kompresoru" zpráv – odstraňovače nadbytečných mezer.
"whitesp"="20 0a 0d 09" -> Které znaky jsou mezery? Místo libovolného počtu "whitespace" znaků bude jen jedna mezera.
"punctuation"=",.;\"!?-+=><()[]{}:-+@#$%^&*/\\" -> Jaké znaky jsou interpukce? Za interpunkcí budou vypuštěny mezery.

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\wco]
Konfigurace WAP Connection for Outlook

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\WapGW]
Konfigurace MobilChange WAP Gatewaye

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\stringnums]
Překlad textových jmen měsíců na čísla měsíců. Používá se zejména při zpracování textových Delivery Reportů.

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\StatX]
Sem si jednotlivé moduly MobilChange ukládají, kolik již odeslaly/přijaly SMS.

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\smsrmnd]
Konfigurace SMS Reminderu for Outlook, včetně seznamu přihlášených uživatelů. Popis je zde.

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\smsfw]
Konfigurace aplikace SMS Forward/SMS Notification for Outlook. Popis je zde.

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\outlook]
Konfigurace aplikace Mobile Connection for Outlook. Popis je zde.

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\lnmobile]
Konfigurace aplikace Mobile Connection for Notes. Popis je zde.

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\Scripting]
V tomto klíči a v jeho podklíčích je uložena konfigurace logování skriptových aplikací. Popis je zde.
"LogGlobalSetting"=DWORD:0

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\charset]
V podklíčích jsou uloženy překladové tabulky pro jednotlivá kódování znaků.

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\alias]
Zde je možné ukládat aliasy, použitelné následně při směrování SMS.

[HKEY_LOCAL_MACHINE\SOFTWARE\Datasys\MobilChange\config]
V podklíčích tohoto klíče jsou povolené revize firmware u jednotlivých ovladačů hardware. Pokud firmare GSM modemu neodpovídá žádné verzi ze seznamu, ovladač se nespustí.

zpět na začátek