Splash Image

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:
  1. Install and configure a Java environment.
  2. Install and configure Swing (a GUI package for Java).
  3. Install JHDL.
  4. Configure your CLASSPATH variable to enable you to access JHDL classes.
  5. 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
  1. 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
           
  2. 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