Znalostní technologie II 2007/2008
Martina Husáková
INSTALACE PRODUKTU ONTOPIA KNOWLEDGE SUITE profesionální verze
1
Znalostní technologie II 2007/2008
Martina Husáková
Obsah Požadavky.................................................................................................................. 3 Instalace .................................................................................................................... 3 Proměnná CLASSPATH ....................................................................................... 3 Zpřístupnění licenčního klíče ................................................................................ 3 Ověřování komponent OKS................................................................................... 3 Spouštíme aplikaci OKS ........................................................................................... 5 Nejčastější problémy při pokusu o spuštění aplikačního serveru........................... 7
2
Znalostní technologie II 2007/2008
Martina Husáková
Požadavky Nejdůležitějším požadavkem je mít nainstalovanou Javu (Java 2 Software Development Kit (SDK)) ve verzi 1.3. nebo novější. OKS by mělo jít spustit na všech operačních systémech, kde je JDK 1.3. (nebo vyšší verze) dostupné.
Instalace Nejprve je nutné rozbalit zip soubor s aplikací OKS a to na libovolné místo na disku.
Proměnná CLASSPATH Abychom mohli používat různé knihovny aplikace OKS, resp. psát např. webové aplikace na bázi Topic Maps nebo OKS otestovat, je nutné nastavit proměnnou prostředí CLASSPATH. V případě, že chceme jen spustit a pracovat s komponentou Navigator Framework1, nastavení proměnné prostředí CLASSPATH není nutné. Proměnou CLASSPATH nastavíme tak, že přejdeme do menu Start/Nastavení/Ovládací panely/Systém/Upřesnit/Proměnné prostředí. Do proměnné CLASSPATH umístíme cestu k jar souboru tj. oks-professional.jar. Do této proměnné umístíme ještě jeden důležitý jar soubor: oks-professional-test.jar, který nám umožní otestovat celé prostředí OKS. Obsah proměnné CLASSPATH by měl vypadat např. následovně: c:\Program Files\Skola_SW\oks-professional-3.4.4\lib\oks professional.jar;c:\Program Files\Skola_SW\oks-professional3.4.4\lib\oks-professional-test.jar
Zpřístupnění licenčního klíče Existují různé způsoby, jak zpřístupnit licenční klíč, viz. dokumentace v systému WebCT. Samozřejmě nemusíme používat všechny způsoby, stačí jen jeden. OKS testuje jednotlivé možnosti zadání licenčního klíče v určitém pořadí. Doporučuje se umístit licenční klíč do domovského adresáře, resp. adresáře c:\Documents and Settings\Vaše jméno\ontopia.lic2. Pro otestování přítomnosti a nalezení licenčního klíče zadáme do příkazové řádky (menu Start/Programy/Příslušenství/Příkazový řádek) následující: java net.ontopia.products.license.LicenseInfo
Měla by se nám zobrazit např. podoba licenčního klíče a datum vypršení licence. Ověřování komponent OKS Po nastavení proměnné CLASSPATH a umístění licenčního klíče je vhodné3 ověřit, jestli jsou určité komponenty OKS připraveny k použití. Ověřme tedy součást zvanou Topic Map Engine4 pomocí: java net.ontopia.products.TopicMapEngine.
1
Tato součást plné verze OKS je určena k psaní webových aplikací využívajících námětových map. Nezapomeňte soubor s licenčním klíčem přejmenovat z ontopia.lic.txt na ontopia.lic. 3 Řekla bych, že spíše nutné. 4 Zajišťuje management námětových map, tj. zakládání, uložení, editaci, dotazování apod. 2
3
Znalostní technologie II 2007/2008
Martina Husáková
Po spuštení příkazu by se Vám měly objevit informace: Ontopia Topic Map Engine [version] License: [licence info] Success: All required classes found.
Je velmi vhodné otestovat i všechny další komponenty. Proč všechny? Ze své vlastní zkušenosti mohu říci, že pokud se otestování dalších komponent neprovede, Murphyho zákony funguji i v případě prostředí OKS, tj. některá důležitá komponenta zkrátka nemusí správně fungovat a pak je stejně musíme otestovat, abychom zjistili, která není v provozu. Takže tedy otestujeme další komponenty: Full-text Integration java net.ontopia.products.FulltextIntegration
Query Engine java net.ontopia.products.QueryEngine
Schema Tools java net.ontopia.products.SchemaTools
Navigator Framework java net.ontopia.products.GenericNavigator
Web Editor Framework java net.ontopia.products.WebEditor
Pro otestování dvou posledních komponent prostředí OKS (Navigator Framework a Web Editor Framework) je zapotřebí umístit do proměnné CLASSPATH soubory z hlavního adresáře prostředí OKS/apache-tomcat/common/lib/servlet-api.jar a jsp-api.jar. Tedy konečná podoba proměnná CLASSPATH je následující: c:\Program Files\Skola_SW\oks-professional-3.4.4\lib\oksprofessional.jar;c:\Program Files\Skola_SW\oks-professional3.4.4\lib\oks-professional-test.jar;c:\Program Files\Skola_SW\oksprofessional-3.4.4\apache-tomcat\common\lib\servletapi.jar;c:\Program Files\Skola_SW\oks-professional-3.4.4\apachetomcat\common\lib\jsp-api.jar
Může se nám stát, že začneme testovat např. dvě poslední zmíněné komponenty a výsledkem je nenalezení všech požadovaných tříd pro provoz testované komponenty OKS. Zkuste proto zavřít Příkazový řádek, znovu ho otevřít a zadat příkaz k otestování znovu. Možná nejkritičtější chvíle celého testování spočívá v testu Topic Map Enginu. Zkontrolujeme, zda máme v proměnné CLASSPATH umístěn jar soubor: oks-professional-test.jar, tj. c:\Program Files\Skola_SW\oks-professional-3.4.4\lib\oks professional.jar;c:\Program Files\Skola_SW\oks-professional3.4.4\lib\oks-professional-test.jar
4
Znalostní technologie II 2007/2008
Martina Husáková
Aby toho nebylo málo, založíme si další proměnnou prostředí OKS_HOME, která bude obsahovat cestu k OKS aplikaci, tj. c:\Program Files\Skola_SW\oks-professional-3.4.4
Poté přejdeme do Příkazové řádky a zadáme cestu k testovacímu spustitelnému souboru runtests-engine.bat, tj. c:\Program Files\Škola_SW\oks-professional3.4.4\tests\runtests-engine.bat, viz. obrázek č. 1. Během testování by nám na monitoru měla běhat sada teček. V případě, že uvidíme nějaký prapodivný znak místo tečky, jedná se o chybu v testování a pravděpodobně komponenta nebude na počítači běhat správně.
......................................... ......................................... ......................................... ......................................... ......................................... ......................................... ......................................... ......................................... .. Time: 10.367 OK (1109 tests) Asserts: 12905 Obrázek č. 1: Testování Topic Map Enginu
Můžeme spustit i další dva testy pomocí souborů: runtests-navigator.bat a runtestswebed.bat, které se nacházejí v tom samém adresáři jako test pro Ontopia Topic Map Engine.
Spouštíme aplikaci OKS Nejprve je nutné spustit aplikační server Apache Tomcat pomocí souboru startup.bat (…\oksprofessional-3.4.4\apache-tomcat\bin\startup.bat). Trvá určitou chvíli než se server zinicializuje a je připraven k práci. Pokud se server nenastartuje, zkontrolujte správnost nastavení proměnné prostředí JAVA_HOME, která obsahuje cestu k Javě, tj. c:\Program Files\Java\jdk1.6.0_02\
5
Znalostní technologie II 2007/2008
Poté
otevřete
Martina Husáková
webový
prohlížeč
a
jako
webovou
adresu
zadejte:
http://localhost:8080/. Na monitoru by se měla objevit aplikace OKS, viz. obrázek
č. 2.
Obrázek č. 2: OKS
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: Sripts and languages
6
Znalostní technologie II 2007/2008
Martina Husáková
Další webová aplikace je umístěna na adrese: http://localhost:8080/xmltools/, viz. obrázek č. 4.
Obrázek č. 4.: Free XML Tools
Jestliže už nebudete chtít pracovat s OKS, ukončete aplikační server Apache Tomcat spuštěním souboru: shutdown.bat (…\oks-professional-3.4.4\apache-tomcat\bin\shutdown.bat).
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: …\oks-professional-3.4.4\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.
7