From ISP admin
Contents |
SMS brána ENGLISH
Systém ISPadmin podporuje zasílání a přijímání SMS zpráv prostřednictvím k serveru připojeného mobilního telefonu nebo sms brány. Zasílání sms zpráv je možné využívat hned několika způsoby. Sms brána může být využita pro posílání oznámení z Nagiosu o výpadku zařízení, pro zasílání zpráv technikům z modulu Plánování, k zasílání upomínek klientům při neuhrazené faktuře a k automatickému odesílání SMS na hardwarové SMS resetátory v případě problému se zařízením. Taktéž můžete v menu Ostatní / Volné sms odesílat svoje vlastní sms na libovolná telefonní čísla a je také možné nastavit systém tak, aby si mohli Vaši uživatelé odesílat určitý omezený počet SMS ze svého klientského rozhraní, což je možné považovat za určitou výhodu oproti konkurenci. Dále je také možné zaslat z menu Ostatní / Hromadné / Sms hromadnou SMS většímu množství klientů (například upozornění, že tehdy a tehdy nepůjde Internet, protože se bude měnit zařízení atd.) a nebo můžete z karty klienta poslat informační SMS konkrétnímu klientovi.
Konfiguraci je možné provést samostatně podle níže uvedeného návodu nebo můžete kontaktovat naši technickou podporu a nechat si provést nastavení vzdáleně. V případě vzdálené instalace SMS brány naší technickou podporou stačí pouze připojit GSM zařízení k serveru přes sériový port (COM1, COM2, mimořádně USB) a o zbytek se již postaráme.
Nejlevnější možností je použití starších modelů NOKIA a SIEMENS, které lze stále pořídit v elektrobazarech nebo na portálu aukro.cz. Tato zařízení se připojí přes příslušný datový kabel na sériový port (COM1, COM2, mimořádně USB) serveru ISPadmin. Ikdyž dostupnost těchto kabelů dnes už nebude tak velká, můžete projít nabídku na kabelmanie.cz nebo aukro.cz.
Ovšem v případě použití ojetých mobilních telefonů se může stát, že je se zařízením něco v nepořádku a nepodaří se ho zprovoznit nebo zařízení pracuje nespolehlivě. Z tohoto důvodu doporučujeme zakoupit zařízení k tomuto účelu přímo vyrobené a se zárukou od výrobce. Velmi dobré zkušenosti máme s produkty Cinterion, které jsou založeny na modulu Siemens. Dále je také možné použít SMS bránu Ateus 2N EasyGate (modul MC55i). Případně může být použit i jiný mobilní telefon, který je uveden na stránce aplikace gnokii jako podporované zařízení. Teoreticky by mělo být možné připojit kterékoliv zařízení podporující AT příkazy. V případě použití nevyzkoušeného typu telefonu však není možné dopředu zaručit, zda bude toto zařízení komunikovat se serverem korektně.
Průběžně testujeme možnost připojení mobilních telefonů a sms bran přes rozhraní USB. Z důvodu nedostatku vhodných zařízení je to však dlouhodobější záležitost. V současné době tedy oficiálně nepodporujeme možnost připojení SMS brány přes USB rozhraní. Pokud ovšem tento způsob připojení preferujete (třeba z důvodu chybějícího COM portu na serveru), měli byste se o instalaci správných USB ovladačů a o otestování postarat samostatně, jelikož se jedná o správu a konfiguraci OS Linux nikoliv o záležitost systému ISPadmin. Můžete se inspirovat tímto stručným návodem. Připojení mobilního telefonu přes USB kabel obecně nedoporučujeme, protože se často vyskytují problémy s linuxovými ovladači k těmto USB kabelům, viz:
Citace: Připojení telefonu přes USB kabel je poměrně problematické, každý výrobek se chová jinak, liší se přitom i kabely různých dodavatelů pro stejné modely. Často může pomoci vyzkoušet hardware jiného výrobce, mimo jiné bylo pozorováno, že zatímco s originálním kabelem od NOKIA se spojení často nedaří, neznačkový model kabelu z bazaru odvede lepší práci. Pokud máte možnost, rozhodně se vyplatí kabel před nákupem vyzkoušet.
Pokud u serveru s ISPadminem COM port (RS232) nemáte, jsou dvě možnosti jak to řešit:
- 1) zakoupit USB-serial adaptér nebo kartu s přídavnými sériovými porty. Důležitá je ovšem podpora Linuxu ze strany výrobce!!! Pokud si nevíte rady, můžete vyzkoušet například: AXAGO ADS-50 USB - serial adapter nebo AXAGO PCIA-S2 PCI karta 2x serial.
- 2) připojit telefon nebo sms bránu přes USB přímo k serveru. V současné době lze přes USB s 90% úspěšností připojit produkty Cinterion a telefon Nokia 6230i (s USB kabelem CA-53).
V obou případech je potřeba přidat do jádra podporu USB a případně doinstalovat potřebný software dodávaný výrobcem. Může se ovšem stát, že zařízení nebude možné tímto způsobem zprovoznit ani po těchto zásazích (velice záleží na konkrétním typu zařízení).
Přehled testovaných zařízení
Doporučujeme: Cinterion (SIEMENS MC35i, MC52i, MC55i, TC35i Terminal)
- Zařízení je určené přímo pro tyto potřeby
- Postaveno na osvědčených modulech firmy SIEMENS
- Dodáváno i s propojovacím kabelem (RS232) + možnost pořízení USB redukce (neotestováno)
- Produktový manuál kompletně v češtině.
- Autorizovaný distributor pro ČR (dotazy, podpora, reklamace)
- Orientační cena 2 200 Kč
|
Používané modely:
SIEMENS MC35, MC39i, TC35i, MC75i, ES75 Cinterion MC35i, MC52i, MC55i, TC35i Terminál GSM 2N Ateus-EasyGate s modulem SIEMENS MC55i |
Nezprovozněno:
|
Poznámka: V případě použití jiného GSM zařízení než zde uvedeného jako ověřené, nemusíme být schopni zaručit jeho kompatibilitu s ISPadminem. Zmiňované funkční modely jsou však ověřené mnohými providery a bez větší péče fungují spolehlivě i několik let, proto doporučujeme jejich pořízení.
Nejčastější příčinou nezprovoznění podporovaného GSM zařízení bývá nastavený PIN kód na SIM kartě(musí být vypnutý) a nevhodný typ propojovacího kabelu. Kabelů existuje velké množství a to i pro stejné modely. Komunikace s aplikací gnokii prostřednictvím některých kabelů nemusí být spolehlivá nebo dokonce vůbec možná(toto se týká hlavně starých GSM telefonů né SMS bran).
Postup zprovoznění SMS brány
Po připojení GSM zařízení příslušným kabelem k serveru je dále potřeba mít přístup k příkazové řádce serveru lokálně nebo vzdáleně přes SSH. Po přihlášení provedete úpravy dvou konfiguračních souborů a ověříte funkčnost nastavení. Jako poslední krok povolíte SMS zprávy v nastavení ISPadmina a můžete provést i další související nastavení viz. níže uvedené nastavení SMS zpráv v systému.
1) gnokii
Komunikaci s mobilním telefonem zajišťuje aplikace gnokii. Konfigurační soubor se nachází v "/etc/gnokiirc". Pro zprovoznění komunikace mezi serverem a SMS bránou můžete využít již použité konfigurační soubory nebo si tento konfigurační soubor můžete upravit ručně podle specifického nastavení.
- V případě, že máte ISPadmin ve Vmware, je nutné namapovat COM port viz. printscreen.
- Možnost A - Stažení konfiguračního souboru
Vzorové konfigurační soubory aplikace gnokii k jednotlivým modelům GSM zařízení jsou k dispozici zde. Odpovídající konfigurační soubor je potřeba nakopírovat do adresáře /etc/. Pokud máte telefon správně připojen, měl by se po zadání příkazu gnokii ---identify správně ohlásit. Pokud se tak nestane velmi pravděpodobně je telefon připojen nepodporovaným kabelem (ze strany gnokii), případně může být vadný COM port (Ujistěte se, že není zakázán v BIOSu).
Pro jednoduché stažení konfiguračního souboru můžete použít tento příkaz, pouze zaměňte URL k požadovanému souboru:
wget http://wiki.ispadmin.eu/download/gnokiirc/SIEMENS%20MC35i/gnokiirc -O "/etc/gnokiirc"
Nyní můžete vyzkoušet zda bude SMS brána správně identifikována:
gnokii --identify
Příklad správného výpisu pro SMS bránu Cinterion MC35i:
GNOKII Version 0.6.26 Couldn't read /root/.gnokiirc config file. Couldn't read /root/.gnokiirc config file. IMEI : 351551036108659 Manufacturer : SIEMENS Model : MC35i Product name : MC35i Revision : REVISION 02.00
Příklad správného výpisu pro telefon NOKIA 5110:
GNOKII Version 0.6.26 Couldn't read /root/.gnokiirc config file. Couldn't read /root/.gnokiirc config file. IMEI : 490543317034167 Manufacturer : Nokia Model : 5110 Product name : NSE-1 Revision : SW 05.27, HW 4210
Pokud proběhla identifikace správně, můžete odeslat sms zprávu z příkazové řádky:
echo "text testovaci sms" | gnokii --sendsms "vase_telefoni_cislo"
- Možnost B - Ruční editace konfiguračního souboru
Jestliže zařízení nekomunikuje, můžete provést ruční úpravu konfiguračního souboru aplikace gnokii. Při úpravě /etc/gnokiirc je potřeba definovat několik parametrů potřebných pro správnou komunikaci s GSM zařízením:
pico -w /etc/gnokiirc
Označení fyzického portu serveru, ke kterému je připojen datový kabel. Záleží na typu připojení.
port = /dev/ttyS0 COM1
port = /dev/ttyS1 COM2
port = /dev/ttyACM0 USB (DKU2)
port = /dev/ttyUSB0 USB
model = 5110 Modely NOKIA
model = AT SIEMENS a jiné AT zařízení
connection = serial Případně upravte na jiné pokud používáte jiné propojení.
serial_baudrate
serial_baudrate = 19200 Rychlost pro sériový port. U některých telefonů je nutné nastavit jiné rychlosti: 9600, 19200, 38400, 57600, 115200.
debug
debug=on Na obrazovku se vypisují ladící informace. Povolte jen v případě řešení potíží.
Uložte konfigurační soubor a po zadání následujícího příkazu se telefon při správné konfiguraci ozve:
gnokii --identify
Příklad správného výpisu pro SMS bránu Cinterion MC35i:
GNOKII Version 0.6.26 Couldn't read /root/.gnokiirc config file. Couldn't read /root/.gnokiirc config file. IMEI : 351551036108659 Manufacturer : SIEMENS Model : MC35i Product name : MC35i Revision : REVISION 02.00
Příklad správného výpisu pro telefon NOKIA 5110:
GNOKII Version 0.6.26 Couldn't read /root/.gnokiirc config file. Couldn't read /root/.gnokiirc config file. IMEI : 490543317034167 Manufacturer : Nokia Model : 5110 Product name : NSE-1 Revision : SW 05.27, HW 4210
Poznámka: Pokud se tak nestane, znamená to že server správně nekomunikuje s mobilním telefonem. Chyba může být v samotném zařízení, vadném či nepodporovaném datovém kabelu nebo v poškozeném COM či USB portu.
Otestování funkčnosti provedete zasláním SMS z příkazové řádky:
echo "text testovaci sms" | gnokii --sendsms "telefoni cislo"
2) smsd
Služba komunikující s databází systému ISPadmin. Pokud tedy SMS brána již odesílá zprávy z příkazové řádky, můžete přistoupit k aktivaci služby smsd. Nastavení není složíté. Nejprve si vypište heslo do databáze tímto příkazem:
cat /data/support/ispadmin/config/config.php | grep DBPASS
Poté si zobrazte soubor, který zajišťuje start této služby a vyhledejte následující řádek:
pico -w /etc/inittab
#sm:3:respawn:/usr/sbin/smsd -u ispadmin -p DBPASS -c localhost -d ispadmin -m mysql
Odkomentujte tento řádek a upravte číslo runlevelu z číslice 3 na 2. Poté místo DBPASS vyplňte heslo do systémové databáze.
Poznámka: Při použití sms bran SIEMENS s předchozím nastavením funguje pouze odesílání sms zpráv. Pro přijímaní zpráv je potřeba nakonec řádku přidat parametr -b MT. Jedná se o typ vnitřní paměti telefonů firmy Siemens. Odzkoušeno u modelů SIEMENS ES75, MC75i a TC35i. Pro model MC39i je potřeba zadat typ paměti -b ME. U modelu NOKIA 6310 je potřeba nakonec řádku přidat parametr -b IN. Jedná se o specifikaci typu vnitřní paměti, kde jsou uloženy SMS zprávy.
Po úpravě konfiguračního souboru je potřeba zapsané změny uvést do systému následujícím příkazem:
telinit q
Pro jistotu se můžete přesvědčit, jestli aplikace opravdu v systému běží:
ps ax | grep smsd
Pokud smsd běží a v konfigurační souboru je správně zapnuto locking, nelze již od této chvíle posílat sms přímo z příkazové řádky ale jen z webového rozhraní ISPadmin.
Ověření zasílání a přijímání SMS zpráv můžete provést z administračního rozhraní. Postupujte podle instrukcí v následujícím odstavci.
Nastavení SMS zpráv v systému
Nastavení v systému ISPadmin
Pokud výše uvedené funguje, můžete přejít k nastavení ISPadmina. Posledním krokem, který musíte před řádným provozem učinit, je zadání určitých informací a skupin potřených ke správnému fungování odesílání SMS zpráv. Přihlašte se do systému a nastavte proměnné pro zobrazování nabídek a tlačítek týkajících se zasílání SMS zpráv. Nastavení provedete v menu Nastavení / Systémová nastavení / Obecné změnou hodnoty klíče sms_notify z hodnoty 0 na hodnotu 1.
Hlášení výpadků
SMS upozornění správcům sítě v případě nedostupnosti routerů a síťových zařízení. V případě celkového výpadku sítě nemusí být emailová notifikace zcela funkční, z toho důvodu je vhodné mít k dipozici i jiný způsob ohlašování výpadků nezávislý na naší síti nebo Internetu.
Pokud dojde jen k lokálnímu výpadku, není vždy nutné upozorňovat hlavního správce sítě, ale můžeme rozdělit jednotlivé části sítě mezi podřízené techniky. Nejprve si nadefinujte sms šablony v menu Nastavení / Číselníky / Nagios / Šablony. Při vytváření šablony je možné použít proměnné, které jsou zobrazeny na této stránce. Jedná se o proměnné IP, Jméno hosta atd. V sekci SMS nebo email je vždy jedna šablona nastavena jako výchozí, která se použije jako defaultní šablona pro odesílání pokud není nastaveno jinak. V záložce Nastavení / Číselníky / Nagios / Kontakty tlačítkem 
Přidat novou skupinu přidejte další skupinu pro Nagios. Pojmenujte ji třeba podle lokality nebo technika, který za ní bude odpovědný. Typ notifikace zvolte SMS a přiřaďte skupině Šablonu.
Poté do vytvořené skupiny vložíme telefonní čísla. Klikněte na text Telefonní čísla a otevře se dialog pro zadání nových kontaktů skupiny. Zde tedy vyplňte telefonní čísla a jména osob, kterým budou chodit hlášení o výpadcích.
Nakonec editujte příslušné routery, na které chcete, aby se vztahovalo hlášení výpadků a přiřaďte tuto nově vytvořenou skupinu do nastavení Oznamovat výpadky. Všechna síťová zařízení připojená k tomuto routeru budou zahrnuta automaticky. Pokud je chcete vyčlenit, musíte tak učinit u každého zvlášť. Tímto způsobem můžete rozložit dohled nad celou sítí mezi jednotlivé techniky.
V menu Routery v nastavení routeru je možné u notifikace výpadku přes Nagios (v případě, že se jedna o notifikační skupinu typu "SMS") nastavit tzv. "extra kontakt". Jedná se o možnost nastavení speciálního telefonního čísla, kam se SMS v případě výpadku odešle. SMS se v tomto případě odešle na kontakty uvedené u této notifikační skupiny (definované v menu Nastavení / Číselníky / Nagios / Kontakty ) + na "extra kontakt". Tento "extra kontakt" je telefonní číslo, které je například reprezentováno HW resetátorem, takže v případě výpadku se odešle přesně definovaná SMS na tento "extra kontakt" a tím se například zabezpečí restart zařízení.
Funkci Hlášení výpadků je vhodné používat pouze u páteřních a jinak důležitých spojů routerů a zařízení. V případě kdy do této množiny zahrnete i klientské routery, může se stát, že budete informování velmi často i o nevýznamných výpadcích klientů(například pokud si klient svůj router vypíná a "šetří" elektřinu..). Pro klientské routery je proto vhodnější zvolit pouze upozornění na email.
Výpadky se odešlou pouze při prvním výpadku a při první dostupnosti. Nebudete tak bombardováni SMS zprávami po celou dobu nedostupnosti zařízení. Zařízení se považuje za nedostupné již při vyšší odezvě jak 500ms, což už značí možné problémy na trase.
Odchozí SMS
Zasílání SMS zákazníkům je možné uskutečnit přes kartu klienta modrým tlačítkem Odeslat SMS. Tato funkce bude fungovat správně jen za předpokladu, že máte u daného klienta v kontaktních údajích správně vyplněnou položku "Mob. telefon", jinak budete muset vyplňovat tel. číslo pokaždé ručně.
Při obesílání klientů můžete využít vlastní SMS šablony, které si nadefinujete v záložce Nastavení / Ostatní / Šablony SMS. Zde je možné vložit osobní informace vztahující se k danému klientovi a jeho službám pomocí různých systémových proměnných.
Všechny odchozí SMS zprávy lze zobrazit v kartě Statistiky / Logger, kde vyberete položku Historie odeslaných sms. Stejným způsobem si můžete zobrazit i Chybně odeslané sms. Dále je možné zobrazit odchozí sms zprávy i v kartě klienta v záložce Historie pro každého klienta zvlášť.
V menu Ostatní / Hromadné / SMS je funkce Hromadné SMS, kdy je možné informovat zákazníky o celkovém výpadku připojení k Internetu nebo třeba jen jejich části sítě.
Pamatujte na to, že pomocí SMS není vhodné sdělovat smluvní nebo jiné citlivé informace. Pro tyto účely raději používejte email. SMS zprávy jsou však vhodné pro informování uživatele o nedostupnosti nebo pozastavení služby, plánovaném výpadku, reklamních akcích a podobně.
Příchozí SMS
Systém při svém běhu zaznamenává různé události, které si můžete procházet v tzv. Loggeru. V záložce Statistiky / Logger jako typ události vyberte položku Přijaté SMS. V přehledu uvidíte všechny příchozí SMS zprávy. Většinou se bude jednat o doručenky odeslaných zpráv nebo různá oznámení od mobilního operátora. Přijaté zprávy jsou řazeny od nejnovější po nejstarší. Pokud je SMS přijata z čísla některého klienta, je telefonní číslo nahrazeno jeho jménem, na nějž je pak možno kliknout a zobrazit kartu klienta. Dále je možné zobrazit příchozí SMS zprávy i v kartě klienta v záložce Historie.
Pokud si budete přát nastavit zasílání upozornění na příchozí SMS zprávy přímo na Váš email, vyplňte jej do položky sms_notify_inbox_mail v záložce Nastavení / Systémová nastavení / Obecné. Je možné zde také zadat i více emailových adres oddělených čárkou nebo středníkem. Pokud budete později chtít přeposílání příchozích SMS zpráv na email zrušit, přepište vložený email hodnotou 0.
Doručenky
Doporučujeme doručenky vypnout, v případě kdy budete pravidelně odesílat hromadnou sms více zákazníkům, bude Vám chodit i obrovské množství doručenkových sms, což samozřejmě není žádoucí. Mnoho ISP po prvotním odzkoušení proto tuto funkci deaktivuje.
Je pochopitelné, že mít potvrzení o doručení smsky je lákavé. Ovšem v dnešní době jsou sms doručeny téměř ve sto procentech případů a zahazují se až po třech nebo více dnech, kdy je cílový mobil vypnutý nebo nedostupný. Navíc doručenka prakticky nijak nezaručuje převzetí smsky příjemcem, čímž její význam dle našeho názoru postrádá praktický smysl.
Ve výsledku lze tedy říci, že sms zprávu lze považovat za doručenou vždy a doručenka má pouze informativní význam. Přečtení konkrétního sdělení však v žádném případě nezaručit nemůže. </div>