Upgrading from v1.x?
- You can print this out an refer to it as
Unzip the files to a location of your choice.
After unzipping you should have the following
| ---- Inc (Directory)
| ---- MIME (Directory)
| |- Lite.pm
| ---- Net (Directory)
Set Perl Location if needed
If need to run CGI extensions
For UNIX servers. You may need to change the
location of your Perl in the admin_script, announcer.pl, and
By default, the location is set to:
This Perl location is the first line of the
Create Directories and Upload Files
If your server allows you to run Perl scripts
with the pl extension or you have other Perl scripts on your server
that use the extension pl, you can skip this step. Most server will
allow pl extensions.
If your server only allows CGI
extensions to be ran, at this point you must rename all the pl
files to cgi files.
Once you have renamed each of these files, you
must edit the announcer.cgi and admin_script.pl files such that it refers to the use
of the 'cgi' extensions.
To edit the file, open the file in a text
editor. Find the line towards the tp that says:
$cgiext = 'pl';
This line must be changed so that it reads:
$cgiext = 'cgi';
Set Permissions for NT servers
- Login to your ftp server. This can be done
using any FTP client such as CuteFTP.
- Create a directory such as announcer on
your server in which the script will run. This most likely will be
located as a subdirectory of your cgi-bin directory.
- Using your ftp client, change to the directory
which you created in step 2 above.
- Upload all files to the new directory. When
uploading, you must upload all files while maintaining the directory script
from the zip file.
When uploading the pl files, you should be sure to use ASCII mode
Set Permissions for UNIX servers
If NT server, you will want to give the
IUSR_XXX (Internet Guest Account) account CHANGE (RWXD) (RWXD)
permissions to the new directory you created as well as all files and
Note: You may need
to ask your system administrator to set the permissions for you.
For Unix servers, please refer to the chart
below for the permissions on the files.
|- admin_script.pl (755)
|- announcer.pl (755)
|- readme.txt (default)
|- subs_1.pl (default)
|- template.htm (default)
|- Tracker_Read.pl (755)
|- vars_main.pl (666)
| ---- Inc (Directory) (default)
| ---- MIME (Directory) (default)
| |- Lite.pm (default)
| ---- Net (Directory) (default)
|- Cmd.pm (default)
Note: Some servers may require 755
permissions on the announcer directory. If you receive an error when you
attempt to run the announcer.pl file, try using 755 permissions.
Default permissions are typically as follows:
Directories - 755
Files - 644
Edit your template file (template.htm)
This step is not a must at this moment. It can be
done at any point down the line.
Run admin to set your Script Settings
The template file is to make your script look as though it is part of your
For details on the use of template files, click
Note: When editing the template file, you must always include the $REPLACE
variable. This is to indicate where the script should insert the HTML
which is generates.
- Open the admin_script.pl in a browser of your
- Upon first run, the admin screen will appear.
- Choose the option to 'Edit Script Settings'.
Leave the password blank and click the submit button.
- Complete the script settings as they fit your
needs and submit them.
- Now you should define your new mailing lists using the Add/Edit Lists option.
- When doing this, please make sure you
read all notes provided.
- You will need to make sure you define
filenames for all of your lists. By default, Announcer will fill in
the directory path but it does not define a list filename.
- Your script is now setup.
Start Using Announcer
- At this point you can start using Announcer.
- We recommend you create a test list and test
the script to ensure everything is setup and working properly.
- For info on executing and calling the script, click