| Affiliation: | Ontopia AS |
|---|---|
| Date: | $Date: 2001/06/01 09:49:12 $ |
| Version: | 1.0 ($Revision: 1.4 $) |
| |
 | 1. Installation |
 | 2.1. Start the application server |
This is a guide to installing and getting started with using the Ontopia Navigator Trial. It describes how to install and start using the 1.0 release of the Navigator.
This release has been tested with the Java 2 Software Development Kit (SDK) 1.3 on Windows 98, Windows 2000, RedHat Linux 7.0, SuSE Linux 7.1 and Solaris SunOS 5.7. Version 1.2.2 is known not to work. There should be no platform dependencies in the code, so the software should also run on other systems, though this has not been verified.
Requirements:
|
Java 2 Software Development Kit (SDK) 1.3 |
The first step in the installation is to uncompress the distribution file, which you have presumably already done, since you are reading this document. The topmost directory created by uncompressing the distribution, called something beginning with oks-, will from now on be referred to as the basedir.
The Ontopia Navigator is a client-server application. On the client side it is a browser (the generic interface) and navigator for topic maps, designed for use through a Web browser. On the server-side there is a J2EE web application which is built using the navigator framework architecture.
To learn more about the navigator see the document Ontopia Navigator Generic Application - Users' Guide, which can be found in ${basedir}/doc/userguide.html.
Try out the navigator by following these steps:
Locate the ${basedir}/jakarta-tomcat/bin directory in Windows Explorer.
Double-click on the startup.bat file.
(Note that you may have to extend the memory environment settings for this batch-script. A predefined .pif file is included, so this should not normally be a problem.)
Change directory to ${basedir}/jakarta-tomcat.
Execute the bin/startup.sh script.
When 'Starting HttpConnectionHandler on 8080' is displayed on the screen the Ontopia Navigator server is ready.
Open a web browser window and point it to: http://localhost:8080/navigator/
The first time you're accessing a page it may take some time since the web application server needs to compile the JavaServer Pages.
If you are able to see the Ontopia Navigator front page then the installation is successful. Congratulations!
Internet Explorer Users: Please note that IE 5.0 may not be able to connect to the application server if you are working 'Offline'.
Change directory to ${basedir}/jakarta-tomcat.
Execute the bin/shutdown.sh script.
This section contains answers to frequently asked questions about the Navigator.
This is because the navigator by default sends web pages to the browser in the ISO 8859-1 encoding, which only supports a very limited set of characters.
You can change this setting by going into the ${basedir}/jakarta-tomcat/webapps/navigator/WEB-INF/config/topicmaps.xml file and changing the charset parameter of the default topic map to utf-8, or some other encoding of your choice.
Once this has been fixed the navigator should be able to display any Unicode characters in browsers that support them. We have successfully viewed both Japanese and Chinese characters in the navigator.