Installing the Jigsaw Web Server

If you find that you cannot activate the visualisation options on the DDC CD-ROM, there are three possible reasons.

1. You have not installed the Jigsaw web server.

The visualisation components of the DDC CD software use a collection of Java servlets and applets that allow you to plot maps and graphs of the various DDC data files. To operate these components of the CD, you need to install a Java server on your PC. The supplied Java server is called Jigsaw. If you do not wish to operate the visualisation components, there is no need to install or activate the Jigsaw server on your PC. To install Jigsaw make sure you have performed the following steps:

Step 1: Make sure that you have at least 50 Megabytes (ideally 100MB) free space on your hard-disk (usually C:). If there is already a directory named Jigsaw under C:\, move it elsewhere or delete it otherwise it will be overwritten. Otherwise, the INSTALL.EXE will create a directory called Jigsaw and install the Jigsaw server under it.

Step 2a: Installing Jigsaw if you wish to run the DDC software from the CD. Insert the DDC CD into your CD drive. From within Windows Explorer run INSTALL.EXE in the \visual directory on the CD. The installation process does not involve any setting of Registry items or any other share libraries, therefore an uninstall program is not supplied. To uninstall the Jigsaw server simply delete the whole Jigsaw directory that will have been created on your C: disk. Once the installation is complete you will find you have a directory called Jigsaw on your hard-disk. Installation of Jigsaw may take between 10 and 20 seconds.

Step 2b: Installing Jigsaw if you have previously copied the entire contents of the CD onto your hard-disk (see above) and you wish to run the DDC software from your hard-disk. From within Windows Explorer run INSTALL.EXE in the \visual directory in your hard-disk DDC directory that you created when you copied the CD-ROM onto your hard-disk. The installation process does not involve any setting of Registry items or any other share libraries, therefore an uninstall program is not supplied. To uninstall the Jigsaw server simply delete the whole Jigsaw directory that will have been created on your C: disk. Once the installation is complete you will find you have a directory called Jigsaw on your hard-disk. Installation of Jigsaw may take between 10 and 20 seconds.

Once installed on your hard-disk (usually disk C:), the Jigsaw Java server will remain installed. Each time you wish to run a visualisation session using the DDC software, however, you will need to open the Jigsaw server. See below under point 2.

2. You have not opened a Jigsaw server session

You may have successfully installed the Jigsaw server, but each time you wish to run the visualisation components of the DDC CD you need to open a Jigsaw session. You can do this be following the instructions below:

Activating the Jigsaw server: Make sure that you have previously installed Jigsaw from the location (either CD or hard-disk) where you are running the CD. Using Windows Explorer, find your Jigsaw directory and click on the file HTTPD.EXE. This will open a session under DOS labelled JRE. In this DOS session, Jigsaw will display five lines of text, the last line being:

JigAdmin[2.0beta3]:serving at http://setit:8009/

You should now minimise this session (do not close it). With this Jigsaw server running you will be able to use the visualisation options on the DDC software. You must keep this Jigsaw server session running for the duration you wish to use the DDC visualisation software.

Ending a Jigsaw session: To close a Jigsaw session, switch back to your DOS session in which HTTPD is running and type Ctrl+C. This will close down the Jigsaw server and end your DOS session. It is important that you close your Jigsaw session properly using Ctrl+C; otherwise your machine may crash.

3. You do not have an active network connection on your PC or laptop.

Even with Jigsaw installed and running, the visualisation component of the DDC CD-ROM will normally only work if you have a network connection (i.e., a TCP/IP protocol with an initialised stack) installed on your PC or laptop. If your PC is connected to a LAN (Local Area Network) or has a dial-up connection, then you probably already have a TCP/IP protocol configured correctly. If, however, your machine has no network device then the visualisation options will fail. If you are not sure about this, then contact your local systems advisor or if you are a confident PC user then examine the fix provided below. The other (non-visualisation) components of the CD-ROM will work whether or not you have a network device.

A fix to re-create an active network connection (this is only recommended for confident PC users).
If you don't have a dialup adapter present on your machine then install one from your Win95 disk. In the networking properties configure the dail-up adapter's TCP/IP properties for a specific IP address. As the machine isn't connected to a network, you can use any reasonable number - e.g. 222.222.222.222 works fine, with a subnet mask of 255.255.255.0. You also need to configure the DNS settings and gateway and disable the WINS resolution. A net gateway of 222.222.222.222 works fine. As for the DNS, the host name is the name of the local computer and the domain can be of your choosing (e.g. urc.aeu.ca.uk or similar). Once you have entered this info and rebooted, the machine has a specific IP number and the Jigsaw Java server will start just fine.
Warning: The only problem with this fix occurs if you already have a dial-up connection and you are using the dial-up adapter. You can only have one dial-up adapter installed on Win95 and as a result once you specify a specific IP address you can be pretty much certain that the connection to your local ISP through a phone line is broken until you put it back to an automatic allocation of IP addresses via a DHCP server. You could install the drivers and TCP/IP protocols for a phantom NIC and specify a specific IP address for this card thus fooling the local machine into thinking that it is networked. The implications of doing this, however, can be wide ranging - at the least you get a disabled device in the device manager and a slight impact on machine boot-up performance; at the worst you cause an IRQ storm on the motherboard and the machine operates at a crawl.