Nangu TV

Služba Nangu.TV je určená pro poskytovatele internetových služeb (ISP) a přináší Vašim zákazníkům vysílání přímo do televizoru, počítače nebo tabletu. Při jejím využívání získají do domácnosti další příjem televizních programů a na televizoru mohou využít všech možností IPTV.

Pokud poskystovatel NANGU není OG Soft: Funguje to tak, že se jak v IPTV Nangu musí provést nastavení služeb (provádí si CP sám přes webové rozhraní poskytujícího od dodavatele NANGU) a v Mango také a pak  MANGO  dokáže informovat NANGU o zákaznících, službách a IPTV STB. Čili spravovat si bude virtuálního operátora middleware CP a Mango bude automaticky řídit zákazníky/služby/IPTV STB.

Pro poskytovatele NANGU je potřeba předat informace, odkud se bude přistupovat na middleware NANGU (webový systém NANGU pro provisioning).

Na www rozhraní by se měli samozřejmě hlásit administrátoři od CP (aby mohli administrovat služby) i od OG Soft s.r.o. (abychom Vám mohli pomáhat, kdyby něco nešlo) a na API se bude připojovat  MANGO . Tedy dodejte poskytovateli NANGU (pro SELF servis, spol. s r.o. není již potřeba, přístupy povoleny) Vaší IP adresu, ze které se budete přihlašovat na www rozhraní a předejte jim i tyto naše adresy:

• IP admin OG Soft: 91.227.7.106, 91.227.7.108
• IP app Mango: 91.227.7.27

My zároveň od poskytovatele NANGU potřebujeme znát IP adresu API (Pro Nangu.tv od SELF servis, spol. s r.o. není potřeba).

Jelikož je smlouva o NANGu mezi Vámi a poskytovatelem NANGu, budou po Vás nejspíše chtít nějaké prohlášení, že je možné aby OG Soft s. r.o. mohl s poskytovatelem komunikovat a předávat jim do NANGu data z Mango. Příklad oznámení pro poskytovatele Nangu: "Tímto souhlasíme ,aby společnosti OG Soft s. r.o., jakožto poskytovateli platformy  MANGO  pro naši společnost, bylo umožněno komunikovat a předávat do NANGu data z Mango a obráceně případná data z Nangu přijímat a zpracovávat v Mango."

Založení IPTV_PROXy

Pod  MANGO  RM se zakládá zařízení provozovatele třídy IPTV Proxy, interface virtual0. Nastavení parametrů tohoto zařízení je řešeno v rámci implementace.

Nastavení Vyžaduje PUK a Vyžaduje STB MAC+SN nastavte dle Vaších potřeb.

Co se týká zadávání zařízení, stačí zadat zařízení IPTV SetTopBox v Mango a synchronizační skript toto zařízení založí i v NANGU (musíme znát jejich host name, na kterou se systém  MANGO  bude napojovat).

Blokování služby vs zobrazování hlášek

Při zablokování služby přiřazené na zařízení IPTV_STB, která je podřízená IPTV_PROXY, dochází k odeslání informací na nangu.tv server (služba bude zablokována). Můžete však chtít, aby se místo blokování zobrazovala na IPTV_STB hláška. Na zařízení IPTV_PROXY pro potlačení blokování a zobrazování hlášek slouží tyto parametry (první dva parametry zapínají funkcionalitu hlášek, ostatní slouží pro definici chování hlášek):

• Blokovaná služba - titulek: Titulek hlášky, zobrazené na obrazovce při zablokované službě
• Blokovaná služba - text: Text hlášky, zobrazené na obrazovce při zablokované službě
• Blokovaná služba - doba zobrazení (sec): Jak dlouho (v sekundách) bude na obrazovce při zablokované službě zobrazena hláška
• Blokovaná služba - perioda zobraz. (min): Jak často (v minutách) bude na obrazovce při zablokované službě zobrazena hláška
• Blokovaná služba - neskrývatelná hláška: Je-li nastaveno na true, hlášku při zablokované službě nemůže uživatel zavřít
• Blokovaná služba - zobrazení hlášky: CHANNEL_SWITCH - při každém přepnutí kanálu, STB_ON - při zapnutí settopboxu, ONCE - pouze jednou

Při smazání obsahu prvních dvou parametrů dojde při následném zablokování služby i ke smazání definice hlášky na nangu.tv serveru a k obnově blokování služeb na IPTV_STB.

Nastavení v NANGU

Nejprve je potřeba na webovém rozhraní NANGu nadefinovat kanály, balíčky a tarify. Níže příklad postupu ve webovém rozhraní Nangu.tv:

• Založte balíčky přes tlačítko Add
  • příklad seznamu nadefinovaných balíčků, lze si nastavit libovolně, např. dle žánru (dokumenty, pro děti,...)
    Náhled souboru...Skrýt
    
  • příklad obsahu balíčku, dialog editace
    Náhled souboru...Skrýt
    
• Tyto balíčky přidejte do Offers (sekce Offers), kde při zakládání offers zaškrtnete, jaké balíčky jsou v dané službě. Je důležité si poznamenat offer_code (sloupec Code), který se pak přidělí u definice služby v  MANGO  (modul Produkty a služby, tabulka "Parametry služby nebo produktu").
  • příklad seznamu nadefinovaných nabídek, lze si nastavit tolikrát, kolikrát se bude nabídka u služeb lišit
    Náhled souboru...Skrýt
    
  • příklad obsahu nabídky, dialog editace
    Náhled souboru...Skrýt
    
• Založte tarify a k nim přidejte offer (nabídky) a zaškrtněte volbu "Mandatory". Je důležité si poznamenat tariff_code (sloupec Code), který se pak přidělí u definice služby v  MANGO  (modul Produkty a služby, tabulka "Parametry služby nebo produktu").
  • příklad seznamu nadefinovaných tarifů, lze si nastavit tolikrát, kolikrát se bude tarif u služeb lišit
    Náhled souboru...Skrýt
    
  • příklad obsahu tarifu, dialog editace
    Náhled souboru...Skrýt
    

Pro případné řešení komplikací během nasazování i v rámci ostrého provozu bychom měli znát přístupové údaje do administrační části Nangu.

Definice služby

V modulu Produkty a služby založte službu třídy ITPV. Zjistěte si u poskytovatele NANGU, jaké parametry služby vyžadují. Parametry mohou být:

Příklad obsahu parametrů:

V tabulce "Parametry služby nebo produktu" je potřeba nastavit tyto údaje:

• Bázová služba zákazníka, která reprezentuje "Subscription" v terminologii NANGU, musí mít nastaven parametr "tariff_code" (Kód tarifu) - odpovídá ID tarifu v NANGU. Synchronizační skript na základě toho vytvoří pro uživatele nangu subscription s tímto tarifem, jejíž identifikátor je roven ID této bázové služby v Mango.

Definice balíčků

Pak se najdou a nastaví případné volitelné balíčky (pokud je CP nabízí) - v terminologii NANGU je to "Offer". V Mango jsou reprezentovány jako závislé služby třídy IPTV k aktivované bázové službě (třídy IPTV); každá z nich musí mít nastaven v tabulce "Parametry služby nebo produktu" 'offer_code' (Kód offer - OfferCode v nangu.tv serveru) - musí odpovídat kódu offer, jak je nastaven na iptv proxy (NANGU).

Nastavení kanálů IPTV

Založte v modulu Televize kanály třídy IPTV a v případě více definic IPTV služeb s rozdílnou skladbou kanálů, můžete v modulu Televize, záložka "Skupiny kanálů" vytvořit skupiny třídy IPTV pro jednotlivé definice služeb. Na první záložce "Seznam kanálů" pak vybrané kanály přiřadíte do skupin, uvedených v tabulce "Seznam skupin kanálů". Tyto skupiny pak můžete v modulu "Produkty a služby", záložce "Náhled na kanály TV služeb" a tabulce "Seznam kanálů / skupin kanálů" přiřadit.

Stahování CDR záznamů (billing informací) od Nangu.tv

Systém umožňuje  MANGO  partnerům využívající IPTV řešení stahovat kompletní billing informace (včetně VOD a jaké filmy byly kdy objednány) pro následné provádění vyúčtování IPTV služeb Vašich zákazníků.

• Obecne stahujeme Billing CRDs (to je komplet billing včetně VOD apod. ), tak ContentProvider CDRs (jaké filmy byly kdy objednány) s tímto nastavením.
• Format XML
• Billing CRDs:
  • Všechny typy tvod, offer, tariff i timeshift
  • Generování po hodině
• ContentProvider CDRs:
  • Oba typy tvod i offer
  • Generování po hodině

Cena se určuje dle tarifu definovaného v Mango (modul Produkty a služby , záložka Náhled na tarify ).

Aktivace služby u zákazníka

Zákazníkům aktivujte IPTV služby, kde vyplňte povinné údaje. Po vytvoření služby připojte tuto službu pod IPTV settopbox.

Synchronizační skript vytváří na NANGU serveru NANGU uživatele s identifikátorem rovným ID uživatele v Mango a updatuje na NANGU serveru informace o něm.

• Jestliže je poskytovatelem NANGU požadováno nastavení parametru PUK (volba "vyžaduje; PUK generuje proxy"), bude přiděleno na zařízení až ze strany NANGU (na zařízení tedy PUK ručně nevyplňujte)
• Jestliže je poskytovatelem NANGU požadováno nastavení parametru PUK (volba "vyžaduje; PUK = MAC"), bude automaticky poslána v parametru PUK hodnota MAC adresa zařízení (na zařízení tedy PUK ručně nevyplňujte)
• Jestliže jsou pro bázovou službu nastaveny parametry master_pin (PIN) a parental_pin (Rodičovský zámek), nastaví je synchronizační skript pro subscription.
• Jestliže je pro bázovou službu nastaven parametr nangu_locality (Název lokality), nastaví je synchronizační skript pro subscription (LocalityCode v nangu.tv serveru).

Aktualizace zařízení zákazníka

Vyvolání aktualizace zařízení je možné z Mango standardním mechanismem (akcí "Aktualizace parametrů tohoto zařízení" v modulu Koncová zařízení).

Pokud je nadefinován filtr alertu, zobrazuje se stav aktualizace kromě modulu Události & Alerting také v modulu Koncová zařízení, záložce "Koncová zařízení" a záložce "Koncová zařízení pro televizní služby", v tabulce "Události zařízení".

Současné významy chybových kódů při provádění aktualizace:

• 3: chyba v Mango databázi - nekonzistence dat, eventuelně chyba v SQL dotazu, někde se nenašlo něco, co by tam určitě mělo být (třeba IPTV proxy pro STB, uživatel od aktivního STB, povinné parametry...), nebo se nepodařilo uložit do tabulky něco, co by určitě mělo jít uložit apod. Podrobnosti v syslogu na app serveru (i na dx serveru).
• 98: interní chyba Action Executoru - akce se začala provádět, ale spadla takovým způsobem, že nezapsala výsledek.
• 255: výjimka v Nangu - Podrobnosti jsou uvedeny kromě modulu Události & Alerting také v modulu Koncová zařízení, záložce "Koncová zařízení" a záložce "Koncová zařízení pro televizní služby", v tabulce "Události zařízení".
• Ostatní chybové kódy - odpovídají C errno. U aktualizace settopboxu je myslitelným příkladem síťová nedostupnost IPTV proxy nebo databáze - pak by se skončilo s nějakým kódem, který C knihovna nastavuje v této chybové situaci.

V případě, že by IPTV proxy odmítla komunikovat přes HTTP nebo neběží webová služba, může v kódu být buď 255 (třeba když proxy odpovídá, ale vrací "403 Forbidden" kvůli špatnému certifikátu), nebo něco jiného, viz předchozí odstavec (třeba když na portu, kde má webová služba poslouchat, nic neposlouchá). U těchto chyb vzniká event DeviceUpdateError .

Protože při aktualizaci jednoho STB uživatele, který jich má více, musíme aktualizovat všechna zařízení uživatele, pak v případě, kdy mám hlášenu chybu "Nehraje STB" je správný postup zkontrolovat stav aktualizace u všech modemů uživatele, příčina chyby nemusí nutně být vidět u toho postiženého.

Objednání služeb zákazníkem - samoobsluha

Zákazník si může na svém settopboxu objednat balíček (offer) ke svému tarifu (tariff). Jeho požadavek se musí dostat do  MANGO , kde se zákazníkovi aktivuje k jeho bázové IPTV službě (tariff) IPTV služba závislá (offer). K napojení Nangu nabízí  MANGO  SOAP server a WSDL procedury pro aktivaci a ukončení služby.

Více info v článku Nangu - samoobsluha (SOAP).

Dokumentace k Nangu

Dokumentaci k NANGu naleznete zde (english version): http://upload.cibs.cz/nangu/adminguide-2.4.pdf (verze 2.4. nasazena 26.7.2012)
Dokumentaci k NANGu naleznete zde (english version): http://upload.cibs.cz/nangu/adminguide_release-2.2.0.pdf (platná do 26.7.2012)

FAQ

Otázka: Jak je zajištěn přenos dat z IPTV_STB do NANGu, tedy pod jaké IPTV_PROXY se má nově vytvořené zařízení připojit?
Odpověď: Při vytvoření IPTV_STB vznikne automaticky parametr IPTV_PROXY_ID s vazbou na zařízení IPTV_PROXY a toto ID se zjistí dle vybraného nadřazeného zařízení.

Otázka: Provedl jsem smazání zařízení v Mango, kdy dojde ke smazání zařízení v Nangu.TV?
Odpověď: Systém každých 10 minut posílá do Nangu.TV požadavky na smazání neexistujících zařízení.

Otázka: Mám na zařízení třídy IPTV SetTopBox vyplnit parametr PUK?
Odpověď:

• Jestliže je poskytovatelem NANGU požadováno nastavení parametru PUK (volba "vyžaduje; PUK generuje proxy"), bude přiděleno na zařízení až ze strany NANGU (na zařízení tedy PUK ručně nevyplňujte)
• Jestliže je poskytovatelem NANGU požadováno nastavení parametru PUK (volba "vyžaduje; PUK = MAC"), bude automaticky poslána v parametru PUK hodnota MAC adresa zařízení (na zařízení tedy PUK ručně nevyplňujte)

Otázka: Lze v Mango nastavovat lokality pro Nangu.TV, tj. parametr LocalityCode?
Odpověď: V Mango u tříd služeb IPTV, Dual Play a Triple Play máte pro tyto účely parametr Název lokality. Je k dispozici při aktivaci/editaci/přechodu služby a odesílá se do Nangu.tv ihned, bez ohledu na počátek aktivace/změny služby. Seznam hodnot se definuje číselníkem. Pokud máte zájem o předávání lokalit z Mango na nangu.tv, informujte zákaznickou podporu.

Máte nějaké otázky? Zeptejte se na support@mango.cloud.