JHDL 0.2 Installation Instructions
Welcome to the installation for JHDL version 0.2, developed at Brigham
Young University. The installer is designed to support most platforms
and has been tested on all major machine types at BYU. However, this
software is unsupported - we currently don't have the ability
to respond directly to many user questions. To help, we have set up a
mailing list for users of JHDL to share ideas and discuss problems and
solutions. You can subscribe to the mailing list by sending the
following message to [email protected]:
subscribe jhdl
System Requirements
JHDL was written in Java and requires your machine have a Java
installation that is at least 1.1.8 or later. In addition, you will
need Swing version 1.1 or later.
We believe JHDL should run on any platform that supports Java. It was
developed on machines running Win95, WinNT, Linux, HP-UX, and Mac-OS.
Your mileage may vary due to the amount of memory you have and your
processor speed.
Installation Overview
You will need to install a Java environment and
the Swing package on your own before you install JHDL. Both the Java
environment and Swing are freely available. Only then can you
install and run JHDL. To help
you in this process, the remainder of these installation instructions
will try to point you to the resources you will need to prepare for the JHDL install.
The steps you will go through include the following:
- Install and configure a Java environment.
- Install and configure Swing (a GUI package for Java).
- Install JHDL.
- Configure your CLASSPATH variable to enable you to access
JHDL classes.
- Start up the JHDL browser to verify that all is in place.
Step 1 - Install Java
The Sun JDK site
can point you to JDK releases which will work with JHDL. JHDL was
developed under JDK 1.1.8 so download a version at least that late.
It has NOT been tested under version 1.2 so at this time we recommend
downloading the latest 1.1 version (1.1.8 at the time of the creation
of this distribution).
Download the JDK, unpack it, get yourself a Java book, and try
something deep like the ubiquitous Hello, World program to make
sure everything is operational.
Step 2 - Obtain Swing
Swing is a graphical package which JHDL requires for operation. It is
also available from Sun. Click
here to
download it.
The Swing distribution, when unpacked, will create a large directory hierarchy with examples, etc.
All that you need to do is to find the file "swing.jar" and keep it - everything else you got from the
Swing distribution can be erased.
Finally, be sure to put the "swing.jar" file on your CLASSPATH.
Note that this step and one above will likely require you to somehow
configure your machine to understand where class files are (possibly
through modification of a CLASSPATH) and may require you to reboot.
Step 3 - Install JHDL
This link to the installer will take you to
the actual JHDL install page. The page will detect the machine type
you are on and highlight in green the installation version it
suggests. Clicking on one of the download options shown will copy the
files from the web to your hard drive. Follow the instructions given
on the page for your machine type to complete the installation. In
general, this will entail executing the file you downloaded. Note
that the install is a multi-step process with possible delays between
the steps as things load. First, the installer will
load itself, then it will ask you questions about where to do the
install, then it will do the actual install.
Click here to do the JHDL install. Then
return to this page for information on configuring your installation.
Step 4 - Configure the JHDL Installation
The installer will place files into the location you chose. In that
directory you will find a file named "JHDL.jar". You must
put that jar file on your classpath in order for you to be able to run
JHDL. How you do that is machine dependent. However, to help you
verify that you have done it correctly do the following steps:
a
- Set your CLASSPATH by adding the full path to the actual jar
file to your CLASSPATH. You may need to reboot to get your
environment to know about the new CLASSPATH - this is machine
dependent. Here is an example for a UNIX C-Shell:
setenv CLASSPATH ${CLASSPATH}:/users/myname/mydirectory/JHDL.jar:/users/myname/mydirectory/swing.jar
- Run: java jab.
If the Jab console comes up, you are ready to go. If not, the most
likely cause is a bad CLASSPATH.
Step 5 - Get Started With JHDL
The installer also placed documentation into the installation
directory. Go into the docs directory there and open the page
jhdlDocs.html in a browser.
This should help you get started with
a simple example. It also contains a user's manual and an API
reference.
Congratulations, you are ready to begin using JHDL!
Last modified: Wed Nov 17 18:07:22 1999