This product can be run directly from the CDROM. Provided you have a JAVA 1.1 runtime installed, you can just go ahead and run it (either directly or as an Applet). HyperLens is developed using JDK 1.1.6: if you are using an earlier version and experience problems, you may wish to upgrade.
This document describes manual installation. If you prefer automatic installation, please see here.
If you don't have a working JavaTM 1.1 runtime, such as the jre or jdk, you will need to install it. Further information is available here. See the jre folder on this CDROM for distributions included with this product.
We recommend that you install a script to launch the software on your desktop or in your Path, as appropriate to your operating system. Run scripts are included on the CDROM: they may work directly, or you may need to tweak one for your system.
If none of these work, you can run HyperLens "by hand", as described under Running the HyperDAAC.
A JAVA runtime for a range of operating systems is provided on the CDROM. These are freely redistributable and available via the Internet, and are included for the convenience of users. Installation instructions from the authors of these packages are included. Please read the License for your operating system before installing.
If you already have JAVA 1.1, we recommend you continue to use it and do not try to install a new one.
If you need to install JAVA, please see the Java Runtime page on this CDROM.
The only benefit to installation is faster performance - particularly if you are using a slow CDROM.
If you copy the software and/or data to your hard disc, you will need to ensure they are in your CLASSPATH, as explained under Using the HyperDAAC. You can install parts of the data (e.g. the 32Km and/or the 64Km Browse Archives) by copying these directories, whilst continuing to access other data from CDROM. To do this, add the location on your harddisc to your CLASSPATH, keep the CDROM there alongside it, and ensure that the hard disc is before the CDROM.
You do not need the tools - they are extras.
If you are running a webserver, or if you wish to import data from external sources, you may wish to install the Tools. Most importantly:
The tools are not not necessary to use the HyperDAAC, and are provided as-is and without support. scene.cgi may run significantly faster than HyperLens alone, due to the slow JAVA I/O for large data files (on a Linux development machine, running it as CGI is typically 30 times faster than running JAVA).
The tools are a set of small programs, in ANSI C and Perl. Details of how to install will depend on your platform and policies, but in general you will need to compile the C programs and install them somewhere in your PATH (e.g. /usr/local/bin on a typical UNIX system) Running any of the programs without any commandline arguments will give you brief help on the program.
If you run a webserver, you may wish to install scene.cgi as a CGI script. Your webserver will also need "send as-is" capability for .asis files for this to work correctly: we recommend Apache.
If you run HyperLens® as an applet from your own webserver, you will need to use "localhost" URLs (http://localhost/...).
Please do not try this unless you are familiar with configuring and running a webserver. It is not required, and will cause frustration!
HyperLens is a registered trademark of WebThing Ltd. JAVA and HotJava are registered trademarks of Sun Microsystems, Inc.