====== Příloha 1: Manuál ======
===== Překlad a instalace ústředny Asterisk =====
  - Nejdříve je nutné získat zdrojové kódy ústředny Asterisk. Ty naleznete buď na přiloženém CD, nebo můžete jejich aktuální verzi získat ze SVN repozitáře ''%%http://svn.digium.com/svn/asterisk/trunk%%''.
  - Pokud jste zdrojové kódy získali z CD, můžete tento krok přeskočit. V opačném případě nakopírujte soubor ''res_calendar_ews.c'' z CD do adresáře ''res/'' ze získaného repozitáře.
  - Spusťte konfiguraci instalace příkazem ''%%./configure --with-neon --prefix=/opt/asterisk/%%'' čímž vynutíte překlad s knihovnou neon. 
    * Pokud vám chybí některá s požadovaných knihoven, příkaz skončí s chybou a budete upozorněni kterou knihovnu je třeba doinstalovat.
    * Pokud chcete ústřednu Asterisk instalovat jinam než do ''/opt/asterisk'', změňte hodnotu parametru ''prefix''.
  - Po dokončení konfigurace spusťte samotný překlad príkazem ''make''.
    * Pokud máte více procesorů, urychlíte překlad přidáním parametru ''-j//n//'', kde //n// je počet procesorů.
  - Pokud překlad skončí úspěšně, nainstalujte ústřednu Asterisk pomocí příkazů ''make install'' a ''make samples'' které nakopírují všechny potřebné soubory a vzorové konfigurace.
    * Tyto příkazy mohou vyžadovat rootovská práva.

===== Konfigurace ústředny Asterisk =====
Uváděné cesty budou relativní k místu, kam jste ústřednu Asterisk nainstalovali. Pokud jste se drželi výše uvedené postupu, najdete tedy konfigurace v adresáři ''/opt/asterisk/etc/asterisk/''.

==== Minimalistické konfigurace ====
  - Smažte vše z adresáře ''etc/asterisk/''.
  - Zkopírujte soubory z adresáře ''etc/'' přiloženého CD do adresáře s konfiguracemi. Tím budou do ústředny načteny pouze moduly potřebné pro testování kalendářů, nastaven protokol SIP, přidáno několik testovacích linek které budou napojeny na testovací kalendář.
  - Je nutné dopsat nezbytné údaje pro použití testovacího kalendáře. Buď použijte konfigurační nástroj popsaný v následující kapitole, nebo ručně upravte soubor ''etc/calendar.conf''.

==== Konfigurace linek a kalendářů ====
Pro testování je také nutné vytvořit linky a kalendáře a vzájemně je propojit. K tomuto účelu jsem napsal webový konfigurační nástroj. Nástroj rozhodně nemá představovat nejlepší možnou implementaci konfigurace ústředny, má sloužit pouze k jejímu usnadnění.

Pro použití konfiguračního nástroje je vyžadován webový server s PHP alespoň ve verzi 5.2 a podporou SQLite verze 2. Dále pak moderní prohlížeč s podporou JavaScriptu.

Pokud by bylo potřeba použít jiný databázový systém, stačí upravit parametry funkce ''dibi::connect'' na začátku souboru ''ajax.php''. Názvy parametrů vám prozradí dokumentace k dibi knihovně na adrese ''%%http://dibiphp.com%%''. Počáteční dump databáze pak nejdete v souboru ''db/dump''.

  - Nakopírujte adresář ''configurator/'' z CD do adresáře tak, aby byl přístupný vašemu webovému serveru.
  - Upravte oprávnění adresáře ''db/'' a souboru ''db.sqlite'' v něm obsaženém tak, aby do nich mohl kdokoliv (především webový server) zapisovat.
  - Otevřete soubor ''index.htm'' ve vašem webovém prohlížeči.

Dále postupně procházejte konfiguračním nástrojem (můžete se kdykoliv vrátit), dokud vám nebudou vygenerovány patřičné konfigurace. Ty pak pouze ručně vložte do jednotlivých souborů.

===== Použití kalendářového modulu =====
Nyní byste měli mít nainstalovanou a nakonfigurovanou ústřednu Asterisk a mělo by být možné se k ní připojit SIPovým telefonem.

Spustitelný soubor ústředny najdete v adresáři ''sbin/asterisk''. Spusťte jej s paramtry ''-dc'' což vám zpřístupní konzoli a zobrazí ladící informace. Pro spuštění ústředny budete potřebovat rootovská práva.

V konzoli ústředny je k dispozici několik základních příkazů:
  * ''core stop now'' -- vypne ústřednu
  * ''calendar show calendars'' -- zobrazí přehled všech kalendářů včetně jejich zaneprázdněnosti
  * ''calendar show calendar //name//'' -- zobrazí detaily o konkrétním kalendáři