Installation : STEP 1 : Uncompressing the package.

The first step is to uncompress the software package.  HAMnet recommends Winzip or something similar. Once unzipped you should see the following files:

CGI Releated files
hwscroll.cgi
hwjavanf.txt
zonejava.txt
Java Applet releated files
HWDataLoader.class
HWDirectiveManager.class
HWLineWrapManager.class
HWTextScroll.class
Demo Page File
index.html
Installation : STEP 2 : Setup Configuration

With the software package uncompressed it is now time for the hardest step of the installation process.  Here you will need to set up the configurationof HWscroll.    In particular the HWscroll.cgi file.  You will need to edit the first 3 lines in CGI script file, then you will need to add the alt templates used by HWscroll.

Now you will need to gather two pieces of information and add this to the first couple lines of the following cgi scripts. Since you ashould already have HAMweather installed and the HWscroll.cgi will be inthe same directory, then you actulaay just copy the top three lines from your hamweather.cgi.

You will now need to make a few modifcations to the demo html page that is supplied to make it point to your server.  in the index.htlm files you will need to change the urls that point to the hwscroll.cgi on the HAMnet  server to point to the script on your server.  Also you will need to url that points to the java applet code base on HAMnet to point to the applet codebase on your server.   You can find more information on these urls in the HWscroll Usage section of this documentation.

Installation : STEP 3 : Upload Files to the Server

In step three you will upload all the HAMweather files to your web server.  To do this you will need an FTP program, HAMnet suggests WsFTP or CuteFTP.  When uploading you should upload all files in ASCII mode except for the java class files, which are denoted withthe '.class' filename extension.  The java class files should be uploaded in binary mode.

You can follow the table below on where to upload the various files:

CGI Releated files
hwscroll.cgi Upload hwscroo.cgi to the exact same directory as the hamweather.cgi file
hwjavanf.txt Upload to the hwjavanf.txt and zonejava.txt files to the template directory of your HAMweather installation.
zonejava.txt
Java Applet releated files
HWDataLoader.class The java applet class filws should be uploaded in binary mode to the part of your server that you put your normal html pages on.  HAMnet suggest that you make a subdirectory called hwscroll within the hamweather directory, but can actually be any directory of your choice.
HWDirectiveManager.class
HWLineWrapManager.class
HWTextScroll.class
Demo Page File
index.html This file should be uploaded to the portion of your server where you normally put your html pages.  HAMnet suggests for clarity to put upload this page into the same directory as you uploaded the java applet class file.

After you finish uploading,  you will also need to set the correct permissions for the hwscroll.cgi file. You will need to set the permisison to 755, this is the permission that allows the cgi script to be executable by the web server . NOTE:   Most newer FTP programs allow you to set permissions of the files.  Refer to your individual programs documentation for instructions on how to do this.  The need to set file permissions does not usually exist for Windows NT, 95/98 web servers.

Installation : STEP 4 : Register 'alt' files

Well down to the last step.  You will need to register the two alt template files, so HAMweather knows we are going to use them.  You can do this from HAMweather web based administration.  Simply browse to the HAMweather administration, and choose the 'Other Templates option'.  After you do this, the Other template screen should display.  You will notice two main sections one for 'ALT templates' and a second for 'Pass Templates', you will need to only make a change to the 'Alt templates' section.

hajavanf.txt Find a blank line in the entry section and check the check box (so that it is checked) to the left.  Next, to the right of 'Alt Name' enter 'nfjava' and to the right of 'Alt Template' enter in 'hwjavanf.txt'.

zonejava.txt Now move to the next blank line and click the check box (so that it is checked) to the left.  Next, to the right of 'Alt Name' eneter 'zonejava' and to the right of 'Alt Template' enter 'zonjava.txt'.

When registering the alt templates, if you notice that a template have already been listed, then you will not have to list it again.

When you are done entering in the template info the 'Alt Template' sections should look similar to the image below:

alttemp.gif (17311 bytes)

Now click the SUBMIT button near the bottom of the page.

Well thats it, It wasn't so bad. :) you should now have HWscroll installed. Now browse to the the demo page  (index.html) that was included and see if it works.