Instalace produktu Ontopia

Instalace produktu Ontopia
ver. 5.0.2 (open-source verze)
Martina Husáková
1.2.2010
PÁR SLOV ÚVODEM
Produkt společnosti Bouvet Ontopia (dříve Ontopia Knowledge Suite – OKS) je jedním
z nejpoužívanějších nástrojů pro tvorbu námětových map a na nich založených webových
aplikací. Od verze 5.0.0 už není třeba platit za tento software, ale je distribuován jako opensource.
Pro provoz této aplikace je třeba mít k dispozici Java 2 Software Development Kit (SDK) ver
verzi 1.5 nebo novější.
CO JE TŘEBA UDĚLAT PRO ZPROVOZNĚNÍ ONTOPIE?
Nejprve je nutné definovat proměnné prostředí, které ukáží Ontopii cestu k Javě a třídám
nezbytným pro provoz Ontopie. Pro nastavení proměnných prostředí jděte do nabídky
Start/Nastavení/Ovládací panely/Systém/Upřesnit/Proměnné prostředí. Níže máte uvedené
názvy a hodnoty proměnných prostředí, přičemž je uvedena cesta, která platí pro můj osobní
počítač, název disku a adresáře, ve kterém máte Ontopii rozbalenou, si uveďte samozřejmě
svoji vlastní.
Nastavení proměnné prostředí s názvem JAVA_HOME
♣ c:\Program Files\Java\jdk1.6.0_07\
Nastavení proměnné prostředí CLASSPATH
♣ c:\Prog\Ontologie\ontopia-502\lib\ontopia.jar
Nyní můžete otestovat, jestli Váš systém Ontopii našel a to zadáním příkazu
♣ java net.ontopia.Ontopia
do příkazového řádku (menu Start/Programy/Příslušenství/Příkazový řádek).
Obrázek 1.: Testování dostupnosti Ontopie
TESTOVÁNÍ PŘÍSTUPNOSTI A FUNKČNOSTI KOMPONENT PRODUKTU ONTOPIA (volitelný
krok)
Je doporučované, nikoliv povinné, otestovat si dostupnost jednotlivých komponent produktu
Ontopia pomocí sady testů. Zjistíte tak, jestli Ontopia funguje dobře právě na Vašem
systému. Testování zahrnuje testy enginu námětových map spolu s jeho metodami, testování
importu a exportu námětových map atd. Tento krok doporučuji na základě vlastních
zkušeností provést, ať víte, na čem jste ☺.
Pro otestování je nezbytné přidat si další soubory do proměnné prostředí CLASSPATH a to:
♣ c:\Prog\Ontologie\ontopia-502\lib\ontopia-tests.jar (pro spuštění testů)
Následující soubory jsou vyžadovány Navigator Frameworkem (určený pro tvorbu webových
aplikací s námětovými mapami) a Web Editoru Frameworku (určený pro tvorbu editorů
námětových map).
♣
♣
♣
♣
c:\Prog\Ontologie\ontopia-502\apache-tomcat\common\lib\servlet-api.jar
c:\Prog\Ontologie\ontopia-502\apache-tomcat\common\lib\jsp-api.jar
c:\Prog\Ontologie\ontopia-502\apache-tomcat\common\lib\jst1.jar
c:\Prog\Ontologie\ontopia-502\apache-tomcat\common\lib\standard.jar
Pro otestování je dále vhodné nastavit proměnnou prostředí ONTOPIA_HOME na místo, kde
máte produkt Ontopia umístěný na disku, např. c:\Prog\Ontologie\ontopia-502. Pro spuštění
testů jděte do příkazového řádku a spusťte soubor runtests-ontopia.bat, který je umístěn
v adresáři Ontopie/tests.
Měli byste vidět něco jako toto:
Ontopia Topic Maps Engine [version]
License: [license info]
Success: All required classes found.
Running tests
.........................................
.........................................
.........................................
.........................................
.........................................
.........................................
.........................................
..
Time: 10.367
OK (1109 tests)
Asserts: 12905
Ve starších verzích produktu Ontopia jste museli testovat každou komponentu Ontopie
zvlášť. Nyní tomu tak není a vše je provedenou spuštěním souboru runtests-ontopia.bat.
SPUŠTĚNÍ SERVERU TOMCAT
Pokud vše proběhlo v pořádku, můžete spustit Tomcat server a to spuštěním souboru
startup.bat, který naleznete v adresáři s produktem Ontopia, viz. např. v cestě:
c:\Prog\Ontologie\ontopia-502\apache-tomcat\bin\startup.bat. Doporučuji si umístit
zástupce pro spuštění serveru někam na plochu, abyste soubor startup.bat nemuseli
pokaždé hledat. Pokud se Vám server nenastartuje, zkontrolujte, jestli jste uvedli správně
cestu k Javě, resp. ověřte správnost proměnné prostředí JAVA_HOME.
Po spuštění Tomcat serveru si otevřete webový prohlížeč a zadejte do pole pro zadávání
web. adres adresu http://localhost:8080. Aplikace Ontopia, viz. níže, by se Vám měla ukázat
ve webovém prohlížeci.
Obrázek 2.: Aplikace Ontopia
Zadáním adresy http://localhost:8080/i18n/index.jsp se dostanete k webové
aplikaci, která využívá jako ontologii námětovou mapu.
Obrázek 3.: Webová aplikace Scripts and languages
Další webová aplikace je umístěna na adrese: http://localhost:8080/xmltools/.
Obrázek 4.: Webová aplikace Free XML Tools
SPUŠTĚNÍ SERVERU TOMCAT
Po ukončení práce s Ontopií vypněte webový server Tomcat spuštěním souboru
shutdown.bat, který je v adresáři s Ontopií/apache-tomcat/bin.
Nejčastější problémy při pokusu o spuštění aplikačního serveru
Může se stát, že port 8080, který je defaultním HTTP portem pro server Apache Tomcat,
používá jiný proces nebo aplikace. Pokud budete chtít změnit číslo portu pro aplikaci OKS,
upravte
soubor
server.xml,
který
najdete
v
adresáři:
…\ontopia503\apachetomcat\conf\server.xml.
Najděte číslo 8080 a změňte ho na port, který nevyužívá žádný proces nebo aplikace a
přitom je větší než číslo 1024. Poté restartujte server Apache Tomcat a zkuste ho spustit
znovu. Přitom mějte na paměti, jaké číslo teď server Apache Tomcat využívá, protože ho
budete muset zadat i do URL adresy. Tedy jestliže změníte číslo portu na 1999, pak adresa
pro spuštění OKS bude http://localhost:1999/.
Další informace o serveru Apache Tomcat lze najít v adresáři apache-tomcat/RUNNING.txt.
Pokud by Vás zajímalo srovnání Apache s jinými servery, mrkněte na tento odkaz:
http://nb.vse.cz/~zelenyj/it380/eseje/xmerd04/Tomcat.htm.
Přeji hodně zdaru při tvorbě námětových map s Ontopií ☺.