SInce you have already uploaded everything to your server, if you go to the HAMweather
Administration screen, you should now see a HWemail section in the contents list onthe
left (You may need to refresh your browser). Click on the Email Settings link and you can
begin setting up the various settings.
Following are the descriptions of the various settings that can be set once at the
Email Forecasts administration page:
- Administrator Email - This is the email
that is used for the "from" address on all emails sent out by the HW package.
This should be set to an address that users can use if they are having problems.
- Email Mode - This determine how HW will
send emails. It should be set to either mailprog or SMTP.
- Unix servers will usually use mailprog mode with sendmail or such
- NT servers will normally use SMTP mode and an SMTP server to send emails
- Mailprog path or SMTP Server Name - If you
are using HW in mailprog mode set this to the full path (i.e.
"/usr/bin/sendmail" to sendmail or other such mailprog. If using HW in
SMTP mode then set this to the domain name of the SMTP server.
- Server Domain Name: This is only used when
using HWemail in SMTP mode. This setting needs to be set to the domain name HWemail
should announce to the SMTP server. Normally this is the same as the domain name of
your web site.
- Email Script Execution Method - The
determines whether the emailhw2.cgi script will be executed from the command line (cron
job) or from a web browser.
- Email Database Path -Set this to the full
path to the email database. The path will look similar to
"/usr/www/users/hamweather/email/email_list.txt". For NT servers you will
need to include the drive letter.
- Email Templates Path - Set this to the
full path to the directory containing the email templates, both html and email templates.
For example: The path will look similar to
"/usr/www/users/hamweather/email". For NT servers, you will need to
include the drive letter.
- Forecast Email Template - This is the name
of the template that is used when developing the email forecast to send to individuals.
- Subscribe Email Template - This is the
name of the template used to send the subscribe notification email.
- Unsubscribe Email Template - This is the
name of the template used to send the unsubscribe notification email.
- Subscribe HTML Template - This is the name
of the template used to display the successful subscribing of an email address.
- Unsubscribe HTML Template - This is the
name of the template used to display the successful unsubscribing of an email address.
- Email Error Template - This is the name of
the template used to display the unsuccessful subscribing or unsubscribing of an email
address.
Now click the Submit button atthe bottom of the page and the settings should be set.
You are now ready to test the system, then after testing is done you will want to
automate the emailhw2.cgi script to automatically send out emails daily.
To test HWemail, simply request a forecast via HAMweather, click on the "Recieve
this forecast daily" link that you added to the forecasts pages. Now sign up
for the forecast with your email address and any option you may one.
If all goes well you should see a screen letting you know that you have been subscribed
as well as an email stating the same thing.
Now to actually testing the sending of the forecast you will need to run the
emailhw2.cgi script. If you stated in the admin settings that you were going to use
telnet/cron access then you will need to telnet into your account, goto the hamweather cgi
directory and run the emailhw2.cgi script. This can be done by simply typing inthe
name "emailhw2.cgi" or you may need to include the path top perl first. i.e.:
/usr/bin/perl emailhw2.cgi
If in the web based admin you stated you were going to run the emailhw2.cgi script via
the web, simply browse to the emailhw2.cgi script in your web browser.
If all goes well, then you should recieve the forecast email in your in box. If
so then you can proceed to Step 8 : Automating HWemail, otherwise you should review yoru
installaiton.
Otherwise you can review the trouble shooting guide below:
A few things to check for when solving problems with your emailhw2.cgi installation:
- Make sure that the emailhw2.cgi script is installed in the same directory that
hamweather.cgi is installed and workign in.
- If in your email directory the file "email_list.txtback" exists. Make
sure its permissions are set to chmod 666