Endymion MailMan Installation
Troubleshooting
When Mailman installation fails, it's
usually a common error. Check these things first.
Permissions
Make sure that you have your permissions
set on the file "mailman.cgi"
so that it is executable. The exact mechanism of doing this is
different on every operating system. Under Unix, make sure that
the permissions on the file reads "-rwxr-xr-x"
when you do an "ls -alt".
You can set the permissions explicitly with the command "chmod
755 mailman.cgi". If you're using any other OS, ask
an expert on your OS.
Make your web server run it as a
script
Make sure that your web server understands that it is supposed
to be running the script file as a CGI script. In most cases the
clue to the server is the extension on the file. You tell your
web server via its configuration that a file ending in ".cgi"
(or ".pl" or whatever your
copy is called) is a CGI script and that it should run your Mailman
CGI file when you invoke it. If your web server isn't happy with
the ".cgi" extension, feel
free to rename it to ".pl"
or ".runthis" or whatever
makes your web server happy. If you change the extension or the
name, of the MailMan script file then you don't have to change
anything else. MailMan dynamically identifies its own location
each time it runs. You may have to alter the configuration of
your web server in order to run a CGI script on a new Apache installation,
as outlined in our Unix installation
guide.
If you are trying to install
MailMan at a hosted web site, then your web hosting provider most
likely already has some sort of a policy on how CGI scripts are
supposed to work for your server. They should be able to tell
you where the file needs to be placed, what it needs to be called,
what the permissions need to be, etc. If they give you information
along those lines and you just don't understand, then please contact
us and we might be able to help. We're certainly happy to
try.
Make sure that MailMan can read its
own templates
Make sure that MailMan's templates are readable to your web server.
Keep in mind that just because they are marked readable to you,
they are not necessarily marked readable to your web server, since
the server generally runs as a different Unix user. You probably
want your permissions for your "t_*.htm"
files to read "-rw-r--r--",
which you can achieve with "chmod 644
t_*.htm". That configuration gives you the ability
to alter the files, but it gives anybody in your system, including
the web server user, permission to read the files.
Also make sure that MailMan's
templates are located in the directory that your web server will
set to the 'current' directory when MailMan runs. This will usually
be the same directory that the script is located in, but not necessarily.
Some web servers set the current directory to places other than
where the script itself is located. If you have one of these servers
and MailMan runs but your templates are missing, then the solution
is most likely to explicitly set a configuration option at the
top of the MailMan script that tells it where its templates are
located.
If you are having problems and none
of the above ideas help, or if you just don't even know how to
handle some of the above suggestions, then just contact
us for help. We're friendly, we promise. We'll even do
it for you for a small fee if you need to just save some time.
|