Installation : STEP 1 : Uncompressing the package.

The first step is to uncompress the software package.  You can use Winzip or something similar. Once unzipped you should have a directory structure similar to the directory tree shown in Step 3.

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 configuration of HWimage.    In particular the emailhw2.cgi and emailstorer.cgi files.  You will need to edit the first 3 lines in CGI script file, then you will need to add the alt templates used by HWimage.

You will need to gather two pieces of information and add this to the first couple lines of the following cgi scripts. NOTE: Since you should already have HAMweather installed and the emailhw2.cgi and emailstorer.cgi will be in the same directory, then you can actually just copy the top three lines from your hamweather.cgi.

Installation : STEP 3 : Upload Files to the Server

In step three you will upload all the HWimage files to your web server.  To do this you will need an FTP program, you can use WsFTP or CuteFTP or somethign similar.  You will need to upload the entire contents (even subdirectories) of the "cgi-bin/hamweather" directory to the web server in the path that you specified (in step 2) to hold all the cgi scripts. (we used /usr/www/users/hamnet/cgi-bin/hamweather as the example in step 2.)   When uploading you should upload all files in ASCII mode.

While you are uploading you will also need to set the correct permissions for the various files and directories.  In the directory structure below you will notice a bunch of letter after each directory or filename.  These indicate the permission setting for that file.  Use this chart to convert them letter pattern to the appropriate chmod value. 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.

The zone.html and zandh.html files are optional.  They can replace yoru current ones so that the "click here to receive this forecast daily" link is added.

PERMISSION COMMAND
rwxrwxrwx chmod 777 filename
rwxrwxr-x chmod 775 filename
rwxr-xr-x chmod 755 filename
rw-rw-rw- chmod 666 filename
rw-rw-r-- chmod 664 filename
rw-r--r-- chmod 644 filename

The directory structure for the cgi files and subdirectories should stay the same and look similar to this:

NOTE: The HWimage files in the cgi-bin portions should be in the same directory structure as your HAMweather  files.    Thus the hwimage.cgi should be in the same directory as you hamweather.cgi.   You will need to create the email subdirectory in the main hamweather cgi-bin path. The zone.html and zandh.html files are optional.  They can replace yoru current ones so that the "click here to receive this forecast daily" link is added.

The directory structure for the cgi files and subdirectories
should stay the same and look similar to this:

HAMweather cgi-bin Directory (i.e /yourpath/cgi-bin/hamweather)
  |
  |__email (dir) (rwxrwxrwx) (chmod 777)
  |    |__email_error.html (rw-rw-r--) (chmod 664)
  |    |__email_list.txt (rw-rw-rw-) (chmod 666)
  |    |__email_template (rw-rw-r--) (chmod 664)
  |    |__subscribe.html (rw-rw-r--) chmod (664)
  |    |__subscribe.txt (rw-rw-r--) chmod (664)
  |    |__unsubscribe.html (rw-rw-r--) chmod (664)
  |    |__unsubscribe.html (rw-rw-r--) chmod (664)
  |
  |__hamlib (dir) (permission set when installing HW)
  |    |__hwadmin (dir)(permission set when installing HW)
  |         |__hwalib_email.pl   (rwxr-xr-x) (chmod 755)
  |         |__hwanav_email.txt   (rw-rw-r--) chmod (664)
  |
  |__templates   (dir) (permission set when installing HW)
  |    |__emailstorer.html(rw-rw-r--) (chmod 664)
  |    |__zone.html(rw-rw-r--) (chmod 664)
  |    |_zandh.html(rw-rw-r--) (chmod 664)
  |
  |__emailhw2.cgi (rwxr-xr-x) (chmod 755)
  |__emailstorer.cgi (rwx-xr-r) (chmod 755)

Installation : STEP 4 : Add Subscribe and unsubscribe links

As stated earlier the zone.html and zandh.html template were optional to install. They are exact copies of the original zonel.html and zandh.html templates that come with the HW standard and Pro distributions except they also include the  "Click here to recieve ths forecast daily" link.  You can add the link yourself to your current zone.html and zandh.html files but adding the following html to the templates:

<a href="%%scripturl%%?&user=%%user%%&theme=%%theme%%&place=%%lplace%%&state=%%lstate%%&zipcode=%%zipcode%%&forecast=pass&pass=es">
Have this forecast emailed to you daily!</a>

Then you will need to add the following link to the intzone.html template for canadian forecast users:

<a href="%%scripturl%%?&user=%%user%%&theme=%%theme%%&place=%%lplace%%&state=%%lstate%%&country=ca&forecast=pass&pass=esca">
Have this forecast emailed to you daily!</a>

Installation : STEP 5 : Add the emailstorer.html template to your PASS templates

You will now need to add the emailstorer.html template to HAMweathers list of PASS template.  To do this goto the web based admin and click the "Special Templates" link.  Once there click the "PASS Templates" link.  If you do not already see a template listed with the nickname of "es" and filename of "emailstorer.html" then click the "Add New" Link and inter "es" in the nickname field and "emailstorer.html" in the file name field.

Now to Step 6: Email Settings Via the Web based Admin