Installation : STEP 4 : 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, You can use WsFTP or CuteFTP or similar.  You will need to upload the entire contents (even subdirectories) of the "hamweather/cgi-bin/" 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/hamweather/cgi-bin as the example in step 2.)  When uploading you should upload all files in ASCII mode except for the graphic images, which are denoted withthe '.gif' filename extension.

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.

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: If you are installing HAMweather Lite 2.0 you will not have all the files listed below, for they are not needed for the Lite version.

HAMweather CGI Directory (i.e /yourpath/cgi-bin/hamweather)
  |    
  |__hamlib (dir)             (rwxr-xr-x)
  |    |
  |    |__hwadmin (dir) (rwxrwxrw-)
  |    |    |__hwalib_ftype.pl (rwxr-xr-x)
  |    |    |__hwalib_hwi.pl (rwxr-xr-x)
  |    |    |__hwalib_hwpro.pl (rwxr-xr-x)
  |    |    |__hwalib_hwv.pl (rwxr-xr-x)
  |    |    |__hwalib_of.pl (rwxr-xr-x)
  |    |    |__hwalib_referer.pl (rwxr-xr-x)
  |    |    |__hwalib_spectemp.pl (rwxr-xr-x)
  |    |    |__hwalib_system.pl (rwxr-xr-x)
  |    |    |__hwalib_wxinfo.pl (rwxr-xr-x)
  |    |    |__hwanav.txt (rwxr-xr-x)
  |    |    |__hwanav_hwpro.txt (rwxr-xr-x)
  |    |
  |    |__hamweatherlib.pl  (rwxr-xr-x)
  |    |__hamlib.pl         (rwxr-xr-x)
  |    |__(other files included for PRO add on)(rwxr-xr-x)
  |
  |__hwpro_info (dir)(rwxrwxrwx)(chmod 777)
  |    |__us_nf_info.txt (rw-rw-rw-) (chmod 666)
  |    |__us_nf_info.temp (rw-rw-rw-) (chmod 666)
  |    |__us_ns_info.txt (rw-rw-rw-) (chmod 666)
  |    |__us_ns_info.temp (rw-rw-rw-) (chmod 666)
  |
  |__hwadmin5340 (dir) (rwxrwxr-x)
  |    |__hwadmin.cgi  (rwxr-xr-x) (chmod 755)
  |
  |__logs (dir)        (rwxrwxrwx)
  |    |__error.txt    (rw-rw-rw-) (chmod 666)
  |    |__log.txt      (rw-rw-rw-) (chmod 666)
  |
  |__output (dir)  (rwxr-xr-x)
  |
  |__radar (dir)  (pro addon only)               (rwxr-xr-x)
  |    |__us (dir) (PRO addon only)              (rwxr-xr-x)
  |         |__color.gif (PRO addon only)       (rwxr-xr-x)
  |         |__smallradar.gif (PRO addon only) (rwxr-xr-x)
  |
  |__templates (dir)) (rwxr-xr-x)
  |    |__include (dir) (rwxr-xr-x)
  |    |    |__header.html (rwxr-xr-x)
  |    |    |__footer.html (rwxr-xr-x)
  |    |    |__nav1.html (rwxr-xr-x)
  |    |    |__nav2.html (rwxr-xr-x)
  |    |    |__nav3.html (rwxr-xr-x)
  |    |    |__form1.html (rwxr-xr-x)
  |    |    |__current.html (rwxr-xr-x)
  |    |
  |    |__(various template files) (rwxr-xr-x)
  |
  |__themes (dir)      (rwxrwxrwx)
  |    |__default.txt  (rw-rw-rw-) (chmod 666)
  |
  |__us (dir)
  |    |__metar
  |    |    |__forecasts (dir)  (rwxrwxrwx) (chmod 777)
  |    |    |__info (dir)       (rwxr-xr-x)
  |    |         |__us (dir)    (rwxr-xr-x)
  |    |         |    |__(various info files)  (rwxr-xr-x)
  |    |         |
  |    |         |__world (dir) (rwxr-xr-x)
  |    |              |__(various info files)  (rwxr-xr-x)
  |    |
  |    |__states (dir)          (rwxr-xr-x)
  |         |__forecasts (dir)  (rwxrwxrwx) (chmod 777)
  |         |__info (dir)       (rwxr-xr-x)
  |              |_(various info files)        (rwxr-xr-x)
  |
  |__users (dir)       (rwxrwxrwx) (chmod 777)
  |    |__default.txt  (rw-rw-rw-) (chmod 666)
  |
  |__hamweather.cgi    (rwxr-xr-x) (chmod 755)
  |__hwconfig.txt    (rwxr-xr-x) (chmod 755)
  |__hwgetstate.cgi    (rwxr-xr-x) (chmod 755)
  |__metarlister.cgi   (rwxr-xr-x) (chmod 755)

Then upload any html files and the images directory of the "hamweather/" directory to the web server in the path you specified (in step 2) to hold the html and image files. (we used /usr/www/users/hamnet/hamweather as the example in step 2.)

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

NOTE: If you are installing HAMweather Lite 2.0 you will not have all the files listed below, for they are not needed for the Lite version.

HAMweather HTML Directory (this directory structure not in CGI-BIN)
  |__index.html  (for testign only)     (rwxr-xr-x)
  |__images (dir)         (rwxr-xr-x)
       |__fcicons (dir)    (rwxr-xr-x)
       |    |__(various image files)   (rwxr-xr-x)
       |    
       |__fcmapicons (dir) (rwxrwxrwx)
       |    |__(various image files)    (rwxrwxrwx)
       |
       |__fcmaps (dir)    (rwxrwxrwx)
       |    |__(various image files)     (rw-rw-rw-)
       |
       |__radar (dir) (PRO addon only)   (rwxrwxrwx)
       |    |__us (dir) (PRO addon only)  (rwxrwxrwx)
       |    |    |__(various image files) (PRO addon only)  (rw-rw-rw-)
       |    |
       |    |__radar.gif (PRO addon only)  (rw-rw-rw-)
       | 
       |__us (dir)       (rwxr-xr-x)
            |__states (dir) (rwxr-xr-x)
                 |__(various image files) (rwxr-xr-x)

 

Installation : STEP 5 : Give it a Try

Now the installation is done it is the time for the big test!  From your web browser access your new HAMweather site and try it out.  To do this you can browse directly to the hamweather.cgi  Actually, if using HAMweather Pro,  during implementation of HAMweather on your server it is better to point directly to the hamweather.cgi, adding any parameters needed, to ensure that maps are updated.

NOTE: To add US zipcode searching capability you will need to also download the HWzipdb add-on and install it per its instructions. It is also recommended to install the HWaltplaces add-on. This add on will allow for more US "place, state" combinations than normally available in HAMweather. Both of these add-ons  can be downloaded from http://www.hamweather.com/downloads

If everything is working you should check out the Easy Customization page to perform a quick customization.

If you are experiencing problems Review the Install Trouble Shooting Page.

HAMweather Debug Mode

HAMweather contains a debug mode that will give you information about your server, parameters passed to HAMweather and other pertinent HAMweather information.  To use this mode simply browse to the hamweather.cgi filr and pass the debug=1 parameter.   The URL would look similiar to the following URLs:

http://www.yourdomain.com/cgi-bin/hamweather/hamweather.cgi?debug=1
http://www.yourdomain.com/cgi-bin/hamweather/hamweather.cgi?forecast=zandh&place=blacksburg&state=va&debug=1

When you access the debug mode of HAMweather youwill see the perl environmental variables, the passed parameters, versions of HAMweather and all loaded hamweather library files and other pertinent information.  If for some reason you do not see this information then the Debug ability may have been turned off.  in the hwconfig.txt file there is a variable named $allow_debug.  This variable should be set to 0 to turn on debug ability or 1 to turn off.  Changing that line the hwconfig.txt file to the following would turn debug ability on:

$allow_debug = 0;

You can also force the debug mode to stay on with out the need for the debug parameter in the url.  this can be useful when debugging forms.  To do this set the 'allow_debug' property to '2'.  Changing line in the hwconfig.txt file to the value of two as follows would put debug into an always on mode:

$allow_debug = 2;

This debug information maybe useful in solving your HAMweather problems.  When you are done debugging if youwant to turn the debug ability off simply change the $allow_debug value to '1' in the hwconfig.txt file.



Hmmm.. I need some trouble shooting help.

HAMweather copyright 2000 by HAMweather, LLC, all rights reserved