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: \ontopia- 503\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í.