Instalace a konfigurace serveru

CoUnSiL Server:

• je komplementární část systému CoUnSil, která zpravidla běží na dedikovaném či virtuálním serveru, který má dostatečné výkonové kapacity a stabilní rychlé síťové připojení. Je tvořen dvěma částmi:
  • webový klient - na zdieľanie informácií o servery, jeho nastaveniach a nastaveniach jednotlivých miestností.
  • zrcadlo paketů - jedná se o komponentu systému CoUniverse, která zajišťuje přeposílání datových proudů obrazových a zvukových stop. Zrcadlo paketů je nastaveno tak, aby přeposílal příchozí proudy dat od jednotlivých klientů všem ostatním v dané virtuální místnosti.
• slouží k distribuci obrazových a zvukových stop, které přijímá od jednotlivých klientů a recipročně je přeposílá.
• využívá principu tzv. virtuálních místností, do nichž se klienti připojují při startu. Vzájemná komunikace mezi klienty (přeposílání obrazových a zvukových dat) je možná pouze v případě, že jsou všichni ve stejné virtuální místnosti.
• je linuxová aplikace implementovaná v jazyku Java.
• využívá nástrojů CoUniverse a UltraGrid

Postup instalace

Základní požadavky na server

• Minimální HW konfigurace serveru je uvedena na stránce Požadavky_na_systém
• Veřejná IP adresa síťového rozhraní
• Linuxový operační systém, doporučená distribuce Ubuntu OS

Potřebné knihovny aplikace a závislosti

Další knihovny a aplikace, které je nutné mít nainstalovány předem (napsat vč. příkazů pro Ubuntu)

Instalace

1. Stáhněte a nainstalujte aktuální verzi Javy. Pro více informací o instalaci postupujte dle návodu na oficiálních stránkách.
2. Nastavte proměnnou JAVA_HOME na cestu do adresáře, kde je nainstalovaná Java (export JAVA_HOME=path-to-java). Alternativně konzultujte instalaci Javy s dokumentací k Vámi zvolené linuxové distribuci.
3. Stáhněte a nainstalujte UltraGrid.
4. Stáhněte ZIP archiv obsahující CoUnSiL server.
5. Rozbalte CoUnSiL server do Vámi zvoleného adresáře.
6. Úprava konfiguračního souboru roomConfiguration.json (podrobnosti viz níže)

• Nastavení IP adresy serveru
• Nastavení jména serveru, doporučujeme nastavit jméno shodné s DNS záznamem serveru.
• Kontrola a případná úprava cesty k zrcadlu paketů (parametr "distributor path")
• Konfigurace virtuálních místností

1. Spusťte server příkazem /cesta-ke-counsil-serveru/start_server.sh.

Pozn.: Má-li server běžet jako služba, doporučujeme startovací skript start_server.sh přidat mezi služby spouštěné při startu systému.

Konfigurační soubor roomConfiguration.json

Konfigurační soubor je plain text dokument. Lze jej tedy editovat v libovolném textovém editoru. Konfigurace je zapsána ve formátu JSON. Výchozí konfigurační súbor má následující strukturu:

 {
   "server name":"jmeno_serveru", 
   "web server port": 80,  
   "distributor path": "/home/sitola/counsil/ultragrid/bin/hd-rum-transcode", 
   "agc":"simple", 
   "comunication port":9701, 
   "server ip":"147.251.36.2", 
   "dummy compress":"libavcodec:codec=H.264:bitrate=1M",
   "dummy distributor compress": "",
   "rooms":[
       {
           "name":"example_room1"
       },       
       {
           "name":"example_room2"
       }
   ]
 }

Popis parametrů:

• server name: reprezentuje doménové jméno počítače, na kterém je nainstalován CoUnSiL server. Slouží tedy jako identifikátor a mělo by být jedinečné.
• comunication port: TCP port, na kterém spolu vzájemně komunikují klienti se serverem. Jedná se o řídící komunikaci, datová komunikace bude posílána po UDP portech (viz definice portů pro komunikaci)
• web server port: TCP port, na kterém server poskytuje informace pro klienty o virtuálních místnostech, příp. dalším nastavení nutném pro úspěšné připojení klienta na server. Pokud běží na TCP portu 80, je potřeba spustit server s administrátorským oprávněním (uživatel root).
• distributor path: absolutní cesta k zrcadlu paketů, který je součástí UltraGridu (hd-rum-transcode)
• server ip: IP adresa dedikovaného či virtuálního serveru, na němž běží CoUnSiL server. IP adresa musí být veřejná.
• rooms: seznam virtuálních videokonferenčních místností, které budou dostupné CoUnSil klientům na serveru. Pro každou místnost je nutné vyplnit parametr name, který slouží jako jednoznačný identifikátor virtuální místnosti. Parametr name musí být unikátní v rámci jedné instalace serveru. Doporučujeme místnosti pojmenovat např. kódem předmětu či označením fyzické místnosti v níž probíhá výuka.
• agc: nastavení jedné z komponent CoUniverse, nechte hodnotu "simple"
• dummy compress: nastavení kodeku a jeho parametrů pro přenos obrazu z klient; ve výchozím
• dummy distributor compress: nastavení kodeku a jeho parametrů pro případné překódování příchozích proudů dat na serveru. Ve výchozím nastavení může zůstat hodnota prázdná.

Pozn.: Nástroj CoUniverse, který je využit v systému CoUnSiL umožňuje správu vícebodových audio a video spojení mezi klienty. Mezilehlé prvky (v našem případě tomu odpovídá CoUnSiL server) jsou schopny překódovat video do jiného formátu, příp. upravit parametry komprese. Parametry komprese jsou klíčové pro správný běh nástroje CoUniverse. Pro detailní informace konzultujte dokumentaci ke CoUniverse.

POZOR: Je nezbytné zachovat strukturu zápisu. Při chybách v zápisu (chybějící čárky či uvozovky) nebude konfigurační soubor načten a server se nespustí.