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.

 

Copyright © 1999 - 2002 Endymion Corporation
All rights reserved.
Carpe Noctem