Inštalácia

Aplikácia pozostáva z nasledovných častí, ktoré je potrebné samostatne nainštalovať, inštalácia každej časti je popísaná v samostatnej kapitole:

• DB repozitár
• DWFC server
• Aplikačný server
• Android aplikácia

DB repozitár

Aplikáciu je možné prevádzkovať s repozitárom na nasledovných DB platformách:

• PostgreSQL 9.1 a vyššie
• MS SQL Server 2012 a vyššie

Špecifiká pre jednotlivé typy databáz sú popísané v samostatných podkapitolách. Vo všeobecnosti platí nasledovný postup inštalácie:

1. Vytvorenie novej databázy (prípadne schémy) - iniciálna veľkosť cca 200 MB, resp. podľa veľkosti projektu
2. Vytvorenie DB užívateľa s právom zápisu do objektov vo vytvorenej databáze (schéme)
3. Vygenerovanie DB objektov pomocou skriptu dwfc3.sql
4. V prípade, že je vykonávaný upgrade aplikácie z DWFC2, je potrebné zoznam úloh exportovať do súboru pomocou skriptu export_json.sql. Export je možné vykonať napr. prostredníctvom SQL Server Management Studia, je však potrebné nastaviť veľkosť výstupných reťazcov. Predtým, ako je uvedený súbor otvorený, je potrebné nastaviť v Query results -> SQL Server -> Results to text -> Maximum number of chars ... na hodnotu 8000.
5. Následne je možné pomocou skriptu vykonať export tak, že je výstup nastavený ako čisto textový (Result to text - Ctrl+T). Po spustení sa zobrazí výstup vrátane informácie o nemigrovaných taskoch. Časť pod čiarou až do konca uložíme do súboru s príponou .json.
6. Tento výstupný súbor použijeme po inštalácii klientskej časti do novej verzie.

Konfigurácia PostgreSQL

TBD

Konfigurácia MS SQL Server

Server musí byť nakonfigurovaný v tzv. mixed móde, tzn. musí umožňovať popri Kerberos autentifikácii aj autentifikáciu užívateľov spravovaných priamo SQL serverom. Vytvorený používateľ musí mať nastavené serverové privilégium VIEW SERVER STATE aby mal dostupný zoznam všetkých procesov.

DWFC server

Technické požiadavky na spustenie DWFC servera:

• Java JRE 1.7
• CPU s taktom minimálne 800 Mhz
• minimálne RAM 512 MB
• diskový priestor 2 GB

Inštalácia servera sa vykonáva rozbalením archívu DWFC3_server.zip do adresára na serveri, na ktorom má aplikácia fyzicky bežať. Užívateľ, po ktorým bude server bežať musí mať prístupové prava do adresára, kam budú zapisované logy (podadresár logs adresára, v ktorom je spustený server). Pred spustením servera je potrebné nainštalovať databázu repozitára. V závislosti na type použitého DB engine sa použije príslušný skript:

• pre PostgreSQL sa použije DWFC3_pg.sql
• pre MS SQL sa použije skript DWFC3_ms.sql

Repozitár sa vytvorí nasledovnými krokmi:

• vytvorenie užívateľa s heslom (v prípade MS SQL je potrebné mať server v mixed móde)
• vytvorenie novej databázy, veľkosť je možné obmedziť na 2 GB a viac, podľa počtu úloh
• asociácia vytvoreného užívateľa s vytvorenou databázou
• spustenie príslušného skriptu DWFC3_XX.sql

Nastavenú databázu nastavíme v konfiguračnom súbore dwfc.properties v rozbalenom adresári nasledovne:

• provider = P pre PostgreSQL, S pre MS SQL
• host = hostname alebo IP adresa databázového servera
• database = názov databázy
• username = login, prihlasovacie meno
• password = heslo

Následne je možné server spustiť pomocou priloženého skriptu: server.sh pre unix, server.cmd pre windows.

Prípadné problémy pri spustení alebo behu sú zapisované do žurnálu v podadresári logs. V základnej konfigurácii sa vykonáva rotácia žurnálového súboru po dosiahnutí veľkosti 20 MB, zachovávaných je 20 súborov.

Aplikačný server

Aplikačný server je inštalovaný z adresy [1]. Po stiahnutí je archív rozbalený do cieľového adresára. Konfiguráciu jetty upravíme tak, aby boli povolené nasledovné moduly (možno skontrolovať v start.ini):

• ext
• server
• jsp
• resources
• deploy
• jstl
• websocket
• http
• slf4j-log4j

Moduly je možné pridávať príkazom java -jar start.jar --add-to-start=<modul>.

V konfigurácii vytvoríme JNDI datasource s názvom jdbc/ds, ktorý môže používať ovládače com.microsoft.sqlserver.jdbc.SQLServerDataSource a PGSimpleDataSource. V prípade ovládača MS je potrebné konfiguráciu uviesť priamo ako URL, tzn. nie jednotlivé properties, nakoľko v takomto prípade nie je nastavené heslo.

Android aplikácia

Aplikácia je štandardne inštalovaná prostredníctvom Google play marketu. Je verejne dostupná pod názvom DWFC. Po inštalácii je potrebné si v nastaveniach zmeniť predvolené hodnoty:

• Server URL - nastavenie URL adresy DWFC aplikačného servera, prípadne transparentného proxy (dodá Váš správca siete). Pokiaľ potrebujete spravovať server mimo organizácie, je potrebné zadať adresu, ktorá je viditeľná z vonkajšieho Internetu, tzn. aj mimo Vašej siete.
• Username - login do aplikácie, viď User management
• Password - heslo užívateľa