INSTALACE PRODUKTU ONTOPIA KNOWLEDGE SUITE profesionální verze 1
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
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 Framework 1, 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-professional- 3.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.lic 2. 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 Engine 4 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. 2 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. 3
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-professional- 3.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-professional- 3.4.4\lib\oks-professional-test.jar 4
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-professional- 3.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
Poté otevřete 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
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