

Webmail FAQ for Installation, Troubleshooting, Upgrading
We appreciate you reviewing our documentation before contacting Technical Support.
General Questions
- Can I check AOL, MSN, or AT&T; email?
- Is there a Macintosh version of EMU Webmail/Alacer?
- How can I read my Molly Mail messages my mail client?
- Where does EMUmail store mail? On the webserver or on the mail server?
- How do I send mail to multiple people?
Upgrading
- How do I upgrade EMU 2.x to EMU Webmail 4.x?
- Can I switch professional versions of EMU Alacer or Webmail to NT from Unix, or vice versa?
- How do I upgrade from EMU 3.x to EMU Webmail 4.0?
Installation & Setup
- What sort of system do I need to run EMU Webmail?
- What version of Perl do I need for EMU Webmail 4?
- Do I need Perl to run EMU Webmail on Windows NT?
- Which user should own Webmail files?
- Where can I get the latest build of Webmail?
- What should I do if my Perl installation is missing modules?
- Can I make the entries in my previous address book available in Webmail?
- How do I set up CGI in apache?
- How do upgrade my version of DB_File?
- How can I set Webmailto use another SMTP port?
- What format does EMU Webmail keep its address books in?
- What is Filter::decrypt?
- How do I configure FastCGI for EMU 3/Webmail 4 on Unix?
- How do I set up a frames-based interface for EMU Webmail?
- How do I configure EMU Webmail to use IMAP only?
- "This text is part of the internal format of your mail folder, and is
not a real message. It is created automatically by the mail system software. If deleted, important folder
data will be lost, and it will be re-created with the data reset to initial values." -- What does that
mean?
- Which Perl packages does EMU Webmail require?
- How do I get emails to show the correct address in the From
- How can I get DB_File to work with Solaris?
- How do I make EMU Webmail use a different location for Perl?
- Why can't I install EMU Webmail/Alacer in my web directory?
- How do I upgrade Perl on my Cobalt RaQ2?
- Can I use EMU Webmail with Perl 5.6?
- How do I restrict what servers users can get mail from in EMU Webmail?
- What does "Invert Selected Messages" mean?
- Where is my econfig.pl?
- I need the FCGI module to run Alacer?
- How do I get EMU Alacer to run under mod_perl?
- How do I stop EMU Webmail 4 from showing my name and mailhost everytime
I log in? I do not want this feature to show my information.
- I need to reset the Perl CPAN site. I inputed incorrect CPAN URL when
I first ran emuinstall.
- How can I send special MIME-types (like HTML) in my messages?
- How do I uninstall Webmail/Alacer?
- How do I reinstall EMU Webmail or Alacer?
Troubleshooting Webmail
- I get an error message that says: "... emumail.cgi: Can't locate auto/EMU/IMAP/expunge.al ..."
- Where does EMU Webmail 4 log error messages?
- I continuously get the error: "The e-mail address someuser@domain.com is invalid."
- I get an "HTTP/1.0 501 Not Supported" error.
- Everything looks to be setup, but the browser returns "document contains no data" and web server error logs say: "CGI error: QUIET / Compilation aborted"
- When I hit the URL in a browser I get: "#!/usr/bin/perl ..."
- Why is the File Upload field missing from the compose page?
- Why does the web browser giving me a download screen when I visit my EMU_URL?
- Webmail complains that it can't find FCGI.pm. What do I do?
- EMU Alacer dies with a 'Bareword "x" not allowed...' error when I run it.
- "405 Method not allowed" error
- I can't login with IE5 and AutoComplete.
- Sometimes the first paragraph of a message is missing from Webmail.
- When I install the RedHat 6.2 RPM, I see "file XXX from install of YYY conflicts with file from ZZZ"
- Why won't Webmail work with Perl 5.6.0?
- I get a warning about conflicting modules.
- Why can't I use Molly Mail on my WebTV?
- I'm having trouble with EMU Webmail on Windows 2000.
- I got a CGI error saying that "The specified CGI application misbehaved by not returning a complete set of HTTP headers."
- What do I do to fix a "Quote Exceeded" error?
- I got an "Improper login sequence" error.
- I get an access violation right after installation
- On the first click after I log in, the server returns a "Session Expired" error.
- If you see a CGI error regarding PERL2EXE on Windows NT
- For generic problems with EMU Alacer on UNIX
- I am having trouble with GDBM_File.pm
- I'm having trouble with Webmail and UnixWare 7.x.x.
- Webmail dies with a 'Bareword "x" not allowed ...' error.
- I'm having userdb problems after Red Hat Linux upgrade from 5.2 to 6.x.
- I'm having a problem using MIME attachments with EMU Alacer.
- How do I turn on debugging in EMU Alacer?
- Why do I receive an error "email address invalid" when I send mail?
Back to Top
-
Can I check AOL, MSN, or AT&T; email?
Unfortunately, AOL, AT&T;, and MSN do not participate in the open communication standards of the Internet.
It is impossible to check mail with these services without using their proprietary software. All other
ISPs known to us are EMUmail/Mollymail/Hobomail compatible.
Back to index
-
Is there a Macintosh version of EMU Webmail/Alacer?
Tenon, at http://www.tenon.com, maintains all of our Mac ports.
Back to index
- How can I read my Molly Mail messages my mail client?
Mollymail can't be interfaced with Outlook, Eudora, or other POP3 or IMAP mail clients -- it only works
within a web browser.
Back to index
- Where does Webmail store mail? On the webserver or on the mail server?
Please see our document explaining Mail Storage
Options at http://emumail.com/help/folders.txt
for a detailed explanation.
Back to index
- How do I send mail to multiple people?
You can send mail to a group of people by placing a comma ',' between the addresses in either the To:,
CC:, or BCC: fields. You can setup a group of people in your addressbook using this same method.
Back to index
- How do I upgrade EMU 2.x to EMU Webmail 4.x?
1) Back up your important user data directories.
2) In 'site.emu', you need to set the
convert2x_file_type=
line with the database file type you had in 2.0. To find this out in Unix, run the file command on an
old userdb or messagedb file. In NT, it's probably just SDBM.
Back to index
- Can I switch professional versions of EMU Alacer or Webmail to NT from
Unix, or vice versa?
If you have a professional version of Emumail or Alacer and are migrating from NT to Unix, or vice-versa,
there is no charge for transferring the license. Just contact sales@emumail.com
Back to index
- How do I upgrade from EMU 3.x to EMU Webmail 4.0?
Just install EMU Webmail 4.0, and upgrading should be automatic. Back up your home and HTML data directories
and replace the old files with the new ones. You will need to use the new templates, but you can of
course modify them to meet your needs if you have a license.
Back to index
- What sort of system do I need to run EMU Webmail?
System requirements:
- Web Server with CGI and Perl 5.005_03 support
- POP or IMAP server
- SMTP server Minimum
- 64MB memory (256 RAM recommended)
- 3MB disk space for install plus sufficient space for users' mail
- Minimum Intel Pentium 233MHz or equivalent (e.g. 233MHz PowerPC,
300MHz Alpha)
- Fast CGI is recommended for better performance
For servers with many users:
- FastCGI
- Pentium III 450 with 512Mb ram should handle 50,000 - 75,000 users
- Dual Pentium III 600 with 1Gb ram should handle 175,000 users
Important areas of concern are: space allocation and clustering. Data files should be housed within
a well-performing NFS server, processing should be handled in a cluster of web/cgi servers. File server
should utilize an OS that supports a journalling filesystem (e.g. Solaris v7), and web/cgi servers
run very well with FastCGI on linux platforms.
Back to index
- What version of Perl do I need for EMU Webmail 4?
If you are running Windows NT, you don't need Perl at all.
The minimum requirement to use EMU Webmail 4 on UNIX is Perl 5.004, and we strongly recommend Perl
5.005_03. EMUmail does *NOT* recommend version 5.005_02 of Perl; also, it won't work with Perl 5.6.0
at all. The latest version of Perl may be obtained from http://www.perl.com.
Back to index
- Do I need Perl to run EMU Webmail on Windows NT?
Perl is not needed for the Windows NT version to work.
Some versions of ActivePerl actually interfere with EMUmail. If you suspect that your version of ActivePerl
is interfering, move your C:\PERL directory to another location, like C:\ACTIVEPERL. Back to index
- Which user should own Webmail files?
The user the Web server is running as must own ALL EMU Webmail 4 files (the EMU data and html/ directories).
Problems loading the login page, detaching files, or downloading messages can all be caused by ownership
and permissions problems.
Back to index
- Where can I get the latest build of Webmail?
http://www.emumail.com/download3.html
Back to index Back to index
- What should I do if my Perl installation is missing modules?
Make a list of the missing packages noted during install or at runtime. A package name looks like "Package"
or "Package::Name"
Run CPAN as root:
# perl -MCPAN -e shell
Here, it might ask you some configuration questions. The defaults are usually fine. Then, install each
package you need:
cpan> install Package::Name1
cpan> install Package::Name2
cpan> exit
For help installing modules when you are NOT root, see:
http://www.singlesheaven.com/stas/TULARC/webmaster/myfaq.html#7 Back to index
- Can I make the entries in my previous address book available in
Webmail?
Unfortunately, you cannot transfer addresses from other electronic address books, since there is no
standard Internet address book format. However, if you click on the From: address in any message (in
the message, not the
index), you will be taken to the add-to-address-book page. Back to index
- How do I set up CGI in apache?
Add, in access.conf or httpd.conf (which are probably in /etc/httpd/conf/):
Options Indexes FollowSymLinks ExecCGI
AllowOverride None
Of course, change
/PATH/TO/EMUMAIL.CGI
to the appropriate directory path.
In srm.conf or httpd.conf, add or uncomment:
AddHandler cgi-script .cgi Back to index
- How do upgrade my version of DB_File?
We recommend that if you are not using DB_File already, you shouldn't.
Upgrade your current version of Perl if the current DB_File implementation is 1.x. First, install the
latest emumail, so a conversion from Berkeley DB to GDBM will take place, then it will be safe to upgrade
either your Perl or Linux version.
Back to index
- How can I set Webmail to use another SMTP port?
By default, Emumail will use 25 for SMTP; if you need to change the port number, remove the # at the
beginning of the
#smtp_port=1025
line in your site.emu file and set it to the appropriate port. Back to index
- What format does EMU Webmail keep its address books in?
The addressbook files are in GDBM database format, in a simple hash table. The addressbook addresses
are stored along side other data in the userdb file. The hash table entry (which can
be viewed by running the 'showgdbm' tool from our Webmail
Utility Download area) looks like this:
the key is "addresses.NICKNAME" and
the value is "EMAIL:FULLNAME"
where NICKNAME, EMAIL, and FULLNAME are replaced by appropriate data. Back to index
- What is Filter::decrypt?
t's in 3 parts:
/usr/local/lib/perl5/site_perl/5.005/sun4-solaris/auto/Filter/decrypt contains:
decrypt.bs
decrypt.so
/usr/local/lib/perl5/site_perl/5.005/sun4-solaris/Filter contains: decrypt.pm Check that these three
files can be opened and read by the 'nobody' user (or whichever usename your webserer runs as). If they
can't, you need to get Filter::decrypt from CPAN. Back to index
- How do I configure FastCGI for EMU 3/Webmail 4 on Unix?
1) Change the filename "emumail.cgi" to "emumail.fcgi".
2) In the file "site.emu", make these changes:
a) Change "emumail.cgi" to "emumail.fcgi" in the line contaning
"emu_url=".
b) Set "use_fastcgi = true" in the appropriate line.
3) Check that you have mod_fastcgi.so in your /home/emumail/modules
directory. If not, ask us for a copy.
4) Add these lines to your httpd.conf:
a) In the list of LoadModule directives:
LoadModule fastcgi_module /home/emumail/modules/mod_fastcgi.so
b) In the list of AddModule directives:
AddModule mod_fastcgi.c
c) With the other AddHandler directives:
AddHandler fastcgi-script fcgi
d) Near the end:
FastCgiServer /path/to/emumail.fcgi -listen-queue-depth 50 -processes 4
5) Edit the /home/emumail/html/index.html file and change "emumail.cgi" to "emumail.fcgi"/
6) If you are missing any of the following perl modules, you must
install FCGI.pm and CGI::Fast from CPAN. To run CPAN as root:
# perl -MCPAN -e shell
(Here it might ask you for some setup information if it's your first
time running CPAN. The defaults are usually fine.)
cpan> install FCGI
cpan> install CGI::Fast
cpan> exit
7) Now run emuinstall again. Back to index
- How do I set up a frames-based interface for EMU Webmail?
In order to implement a frames-based interface after logging, you'll have to set a field in your conf.emu
file (which is in the directory where your interface is located, e.g., data/iface/normal/conf.emu).
It should look like this (note that we use "frames.html" as a generic filename--feel free
to choose your own):
post_login_page=frames.html
In this manner, your file, "frames.html", can set up a frames-based interface.
If you want to use alternate filenames, you can use the "parse" mode of EMU Webmail 4 to access
the templates directly instead of going through the default modes of EMU 3. For example, in the default
msgindex.html file, you can access the compose.html page by placing the following link in the page:
<a href="$url?folder=$folder&passed;=compose">
Alternately, you can use the Parse mode to access the page directly:
<a href="$url folder=$folder&passed;=parse&variable;=compose.html">
Either method accomplishes the same thing. Note that you declare the name of the file that you wish
to access through the "variable=" name/value pair.
To configure EMU Webmail 4 for multiple interfaces, in site.emu, set
multi_interfaces=false
ifaces = { iface1 iface2 iface3 }
Place the relevant HTML files you create in iface/iface1, iface/iface2, etc. Back to index
- How do I configure EMU Webmail to use IMAP only?
In site.emu set:
pure_imap=true
login_protocol=imap
outbox_protocol=imap Back to index
- "This text is part of the internal format of your mail folder, and is
not a real message. It is created automatically by the mail system software. If deleted, important folder
data will be lost, and it will be re-created with the data reset to initial values." -- What does that
mean?
This isn't anything to be concerned about. Pine and some other mailers, put a message at the beginning
of mail folders which stores configuration data specific to that folder. An older mailer, or one that
doesn't recognize that feature, will just see it as another message and display it as such. Don't delete
it or change it; just ignore it.
Back to index
- Which Perl packages does EMU Webmail require?
All required Perl modules are included in the Webmail module pack. Head to the Downloads
and grab the module pack for your OS. Back to index
- How do I get emails to show the correct address in the From
In your site.emu file, find the line that says "default_email = something". In that string,
the codes are:
%u = username (before @).
%h = full host (e.g. server.treverton.co.za)
%1 ... %N = reverse order domain, so if you had mail.emumail.com, %1 would be
'com', %2 would be 'emumail', and %3 would be 'mail'
If EMU is running on mail.yourdomain.com, and you want messages to appear to be coming from yourdomain.com,
you might want to try something like:
default_email = %u@%2.%1
or
default_email = %u@yourdomain.com Back to index
- How can I get DB_File to work with Solaris?
By default, the Berkeley dbs are installed in a place that's effectively invisible. You have to move
some files around to get it to work. Move the contents of this directories:
/usr/local/Berkeley/bin -> /usr/bin
/usr/local/Berkeley/lib -> /usr/lib
/usr/local/Berkeley/include -> /usr/include Back to index
- How do I make EMU Webmail use a different location for Perl?
To change the location of the perl emumail uses, first:
mv emumail.cgi EMU.pm
Then create a new file called emumail.cgi that says this:
#!/usr/local/bin perl # or whatever your correct path is!
use EMU;
Make sure your new emumail.cgi is owned by the webserver user, and the permissions are 755.
Back to index
- Why can't I install EMU Webmail/Alacer in my web directory?
The EMUmail install requires Administrator access. Please write to your ISP/administrator for help with
the install, and direct them to us if they have questions.
Back to index
- How do I upgrade Perl on my Cobalt RaQ2?
(1) Install perl5.005_03
a) Visit http://www.cpan.org/
b) Download the sourcefile perl5.005_03.tar.gz to /usr/local/src
c) Run the following commands:
tar -zxvf /usr/local/src/perl5.005_03.tar.gz
cd /usr/loca/src/perl5.5005_03
rm -f config.sh
sh Configure
make
make test
make install
(2) Move:
mv /usr/bin/perl /usr/bin/perl5.00503
(3) Move:
mv /usr/bin/perl5.00404 /usr/bin/perl
(4) Copy:
cp /usr/bin/perl /usr/bin/perl5.00404
(Please follow 2-4 exactly, or you might accidentally erase your new Perl)
(5) Install emumail by running
./emuinstall
(6) Move
mv emumail.cgi EMU.pm
(7) Create a file called emumail.cgi containing two lines:
#!/usr/bin/perl5.00503
use EMU;
(8) Follow the rest of the install instructions (permission, move
files, etc) Back to index
- Can I use EMU Webmail with Perl 5.6?
Perl 5.6.0 appears to be not entirely backward compatible. Perl 5.005_03 has been out for a while, is
reliable and good, and is known to work with our software. We recommend that customers who are having
trouble and are using Perl 5.6.0 try using Perl 5.005_03.
If you need both versions installed on our system, we can help you set up EMUmail to use the correct
version.
Back to index
- How do I restrict what servers users can get mail from in EMU
Webmail?
For EMUmail 3.x or Webmail 4, edit your site.emu, and set:
default_pop=popservername.com
allowed_domains=popservername.com
hostname_input_box=false
If you're using Alacer, in econfig.pl, add or change:
$default_pop="popservername.com";
$allowed_domains="popservername.com";
and edit the html template to remove the box. Back to index
- What does "Invert Selected Messages" mean?
Each message in the index has a selection checkbox next to it, on the left.
"Invert Selected Messages" flips the selections:
All selected (checked) messages are unselected (unchecked)
All unselected (unchecked) messages are selected (checked) Back to index
- Where is my econfig.pl?
If EMUmail is complaining about not being able to find an econfig.pl on your system, the reason is most
likely because one has not yet been generated. To create this file you must run the emusetup.pl (emusetup.exe
if using NT) program. It will walk you through the process of configuring EMUmail on your server.
Back to index
- Do I need the FCGI module to run Alacer?
No, EMU Alacer will run without the FCGI module. You should only use this module if you either have
or are planning to have a FastCGI compliant webserver. EMUmail should have a significant speed increase
when run under FastCGI. Back to index
- How do I get EMU Alacer to run under mod_perl?
In order to get the distributed version of EMUmail to run under mod_perl you need to rename the emumail.cgi
to EMU.pm and then rename the emuwrapper.cgi to emumail.cgi. After those two steps you can edit your
httpd.conf to contain a directive like this:
PerlSendHeader on
SetHandler perl-script
PerlHandler Apache::Registry
Options ExecCGI
Where /emumail.cgi is the location of your emumail.cgi wrapper. You'll then need to enable mod_perl
in your econfig.pl file by changing:
$mod_perl = 1;
That's it! So the steps again are:
1. Rename emumail.cgi to EMU.pm
2. Rename emuwrapper.cgi to emumail.cgi
3. Edit your httpd.conf and add the appropriate mod_perl tag (as shown above)
4. Edit your econfig.pl file to enable mod_perl support.
5. Restart your httpd.
For more information on mod_perl check the site http://perl.apache.org. Back to index
- How do I stop EMU Webmail 4 from showing my name and mailhost everytime I log
in? I do not want this feature to show my information.
This can be prevented by modifying the login.html template file so as not to retrieve this information
from the cookie. Delete the references to $username and $hostname from the login.html file. Back to index
- I need to reset the Perl CPAN site. I inputed incorrect CPAN URL when
I first ran emuinstall.
Delete ~/.cpan directory (you need to be root). Then run emuinstall again and input the correct CPAN
url. Back to index
- How can I send special MIME-types (like HTML) in my messages?
You can allow users to set the MIME-type of their message by adding an INPUT element to the compose
page template. You can make all messages HTML messages HTML messages by adding this tag:
<input type=hidden name="message_ct" value="text/html">
Or you could put a drop down select box with multiple ones:
<select name="message_ct"> <option>text/html<option>text/plain</select>
or you can create a open text field:
<input type=text name="message_ct" value="text/plain">
We recommended *not* making text/html the default, as this might confuse users who use the caret (arrow)
symbols in their messages. Back to index
- How do I uninstall EMU Webmail/Alacer?
If you installed the Webmail RPM, execute: rpm -e emumail emumail-modules
This will remove Webmail, but retain any customizations and user data on your system. If you wish to remove the remaining
data, execute: rm -rf /home/emumail If you did not install Webmail from an RPM package, execute:
rm -rf /home/emumail
This will remove permanently all user data and customizations in addition to EMU Webmail. Be sure to back up anything you do
not want to delete. Back to index
- How do I reinstall EMU Webmail or Alacer?
For NT or Unix, remove the directories (emu*) and then install again.
For Alacer on Unix, re-run emusetup.pl
In general, you can edit econfig.pl (for Alacer) or site.emu (for EMU Webmail 4) at any time.
Back to index
- I get an error message that says: "... emumail.cgi: Can't locate
auto/EMU/IMAP/expunge.al
..."
This message apears in emu-error when using IMAP:
Mon Jun 7 13:31:05 1999] emumail.cgi: Can't locate
auto/EMU/IMAP/expunge.al in @INC (@INC contains:
/usr/lib/perl5/5.00503/i686-linux /usr/lib/perl5/5.00503
/usr/lib/perl5/site_perl/5.005/i686-linux
/usr/lib/perl5/site_perl/5.005 . ../data/lib) at /home/httpd/html/emumail.cgi line 2951
You need to get a new version of imap.pm. See the information on running CPAN. Back to index
- Where does EMU Webmail 4 log error messages?
Check /tmp/emuerror and your web server error logs. If you have debug enabled, it will log everything
EMU Webmail does in data/emudebug.(It's turned on by setting "emu_debug=true" in the site.emu
file.) Back to index
- I continuously get the error: "The e-mail address someuser@domain.com
is invalid."
Edit the line in the site.emu file and change the line that says: default_pop=localhost to point to
your SMTP mailhost address. Back to index
- I get an "HTTP/1.0 501 Not Supported" error.
- Check to see if web server has execute permission on the cgi program.
- Check site.emu and make sure the entry for emu_url is the full URL
for the cgi program. For example:
emu_url=http://mydomain.com/emumail.cgi
not:
emu_url=emumail.cgi Back to index
- Everything looks to be setup, but the browser returns "document
contains no data" and web server error logs say: "CGI error: QUIET / Compilation aborted"
Try deleting the /tmp/emu-error file, because it may have permissions which disallow write access by
the webserver user. For example, if this file is generated by root, then web browser tries to append
it, it cannot since this file is owned by root. Note that this bug has been fixed in EMU Webmail 4.
Back to index
- When I hit the URL in a browser I get: "#!/usr/bin/perl ..."
You need to setup CGI as a file type on your server before EMU Webmail 4 will run as a CGI.
Depending on the version of web server that you're using you need to configure it to accept CGIs. In
Apache you'll have to edit either the httpd.conf file, or the srm.conf file. There's a server directive
called ExecCGI that you'll have to add to the directory entry that gives Apache access to your EMU installation.
Back to index
- Why is the File Upload field missing from the compose page?
If you are using IE version 3.0, you will need to download a patch in order to use file uploads (check
http://www.microsoft.com/ie). However, if you aren't using IE but are having this problem, you should
check that your window is open wide enough for the form field to be displayed in it. Try resizing your
browser window. Back to index
- Why does the web browser giving me a download screen when I visit my EMU_URL?
The problem lies with the webserver: It isn't recognizing your emumail.cgi (or .exe) as a CGI program
to run. On NT, try renaming your emumail.exe to emumail.cgi and then running emusetup.exe to change
the URL. If this doesn't fix the problem then you should verify that EXECUTE permissions are turned
on in your installation directory. Back to index
- Webmail complains that it can't find FCGI.pm. What do I do?
If you aren't using FastCGI (don't have a FastCGI server) but are getting this error, it's most likely
because the FCGI.pm that is distributed with EMUmail has been removed. This file (which is located in
the same directory as your emumail.cgi) needs to be there even if you aren't using FastCGI.
If you are using FastCGI, it's possible that the FCGI module installation on your system is invalid.
Try reinstall the FCGI module. If you aren't able to get that working, consider an alternative such
as mod_perl.
You may also want to get the latest FCGI module. Run CPAN as root and isntall it:
# perl -MCPAN -e shell
cpan> install FCGI Back to index
- EMU Alacer dies with a 'Bareword "x" not allowed...' error when I run it.
People will usually encounter this error when their emumail.cgi has become corrupted. This usually happens
because you are trying to change the location of Perl on your system. To correctly change the location
of Perl on your system without corrupting your emumail.cgi you will need to follow steps similar to
the installation of mod_perl: (Note: If you are already getting the Bareword error, reinstall a fresh
copy of emumail.)
1.) Move emumail.cgi to EMU.pm
2.) Move emuwrapper.cgi to emumail.cgi
3.) Edit the new emumail.cgi to point to the right Perl. Back to index
- "405 Method not allowed" error
You try to access the emumail.exe/cgi file and get a "405 Method not allowed" error from the
web server.
This is most often caused by an incorrect $url variable in the econfig.pl file. The $url needs to point
to the emumail.exe (or emumail.cgi file under Unix).
Correct:
$url = "http://www.emumail.net/emumail.exe";
Incorrect:
$url = "http://www.emumail.net/";
Back to index
- I can't login with IE5 and AutoComplete.
IE's AutoComplete is considered a security violation, since the password is not typed in by the user
at login time.
Turning off AutoComplete will allow you login to webmail.
Administrators: to overrride this protection, set disable_sessionID=true in your site.emu file.
Back to index
- Sometimes the first paragraph of a message is missing from
Webmail.
Some versions of the Net::Cmd perl module, used by EMUmail, have trouble with certain messages. To fix
this, update your copy of Net::Cmd.
Run CPAN as root:
#perl -MCPAN -e shell
(If this is your first time running CPAN, it might ask you for some configuation options. When you get
the cpan> prompt:)
cpan> install Net::Cmd
(Follow the instructions. When it's done, type:
cpan> exit
Back to index
- When I install the RedHat 6.2 RPM, I see "file XXX from install
of YYY conflicts with file from ZZZ"
There are two things you can try:
1) Use rpm -Uvh --force emumail4.0-1-RH6.i386.rpm -- it might overwrite some modules, but the version
you are installing is newer, so it will work.
2) Install using the UNIX tarball from http://emumail.com/download3.html instead.
Back to index
- Why won't Webmailwork with Perl 5.6.0?
Perl 5.6 appears to be not entirely backward compatible. Perl 5.005_03 has been out for a while, is
reliable and good, and is known to work with our software. We recommend that customers who are having
trouble and are using Perl 5.6 try using Perl 5.005_03. If you need both versions installed on our system,
we can help you set up EMUmail to use the correct version.
Back to index
- I get a warning about conflicting modules.
There are two things you can try:
1) Use rpm -Uvh --force EMU_PACKAGE_NAME -- it might overwrite some modules, but the version you are
installing is newer, so it will work.
2) Install using the UNIX tarball from http://emumail.com/download3.html instead.
Back to index
- Why can't I use Molly Mail on my WebTV?
WebTV is incompatible with Molly Mail, in part because it does not yet have any Javascript capability.
Sites running Emumail can be configured to allow WebTV access. This is up to the administrator of the
site.
Back to index
- I'm having trouble with EMU Webmail on Windows 2000.
Some administrators have had trouble with IIS and CGI in Windows 2000; the Xitami webserver ( available
at http://xitami.com ) may be an effective substitute for your system.
We haven't tried it, so we don't have any information on setting it up with EMU Webmail yet.
Back to index
- I got a CGI error saying that "The specified CGI application
misbehaved by not returning a complete set of HTTP headers."
If you receive the following message when you try to run EMU 3 after following the installation instructions:
CGI Error
The specified CGI application misbehaved by not returning a complete set of HTTP headers. The headers
it did return are:
[Fri Aug 13 08:16:36 1999] emumail.cgi: [Fri Aug 13 08:16:36 1999]
emumail.cgi: Undefined subroutine &EMU;::FatalError called at
emumail.cgi line 89.
[Fri Aug 13 08:16:36 1999] emumail.cgi: BEGIN failed--compilation
aborted at emumail.cgi line 134.
Check the location of your init.emu file. For NT, it should be in the web server root. Try also moving
it to the same directory as the emumail.exe file. For unix, it should be in the same directory as emumail.cgi.
Also check the contents of init.emu with a text editor. It should have a line that says 'page_root='
where is an absolute path to the emu3 data directory. Whitespace is NOT allowed in the page_root,
so please don't put the data directory in "C:\Program Files" for example. Be sure that the
capitalization is correct as well.
Back to index
- What do I do to fix a "Quote Exceeded" error?
The webserver running EMU Webmail has set a quota for the amount of space allocatable for your mail.
Molly Mail users have a 2 Megabyte quota for mail stored on our server. After you have downloaded 2
MB worth of mail, you must delete some messages before reading any more new mail. This total includes
messages in the INBOX, all saved-mail folders, sent-mail folders, and file attachments.
Sometimes files you delete persist on the server. To correct this, next time you log in, enter
username#flush_msgs
in place of your regular username and Molly Mail will clean out the mailbox. (Mail in your folders will
NOT be erased.)
If you believe you are under the quota and seeing this message in error, email the site administrator.
You may download mailfolders to your local machine with the "Export Folders" command from
the Folders page to save your data before deleting it from the server.
Back to index
- I got an "Improper login sequence" error.
It's likely that your web browser does not have Javascript enabled.
For Netscape:
Edit -> Preferences -> Advanced: Enable Java & Enable Javascript
For Internet Explorer:
Tools -> Internet Options ->
Security -> Custom Level -> Scripting -> Enable Back to index
- I get an access violation right after installation
If you have Activeperl installed, it may be causing a conflict -- try moving that directory to "c:\perl2"
or something similar.
Back to index
- On the first click after I log in, the server returns a "Session Expired"
error.
It's likely that your web browser is not accepting cookies. To fix this:
In Netscape, go to the Edit menu:
Edit -> Preferences -> Advanced: Cookies: "Accept all cookies"
In Internet Explorer, go to the Tools menu:
Tools -> Internet Properties -> Security -> Custom Level
-> Cookies -> Allow Per-session cookies -> "Enable"
Back to index
- If you see a CGI error regarding PERL2EXE on Windows NT
There are a few things that could be causing this:
First, EMUmail cannot be split among multiple hard drives. The data directory and the executable MUST
be on the same hard drive.
If you have perl installed in C:\PERL or perhaps elsewhere, it may be interfering with EMUmail. Try
moving that directory elsewhere, or uninstalling Perl, testing EMUmail, and then reinstalling Perl in
a different directory.
Also, EMU doesn't like seeing the environment variable PERL5DB defined.
For example, you may have:
PERL5DB=BEGIN { require 'e:\activestate\PerlDB.pl' }
Pulling that from the environment makes things better.
Also, there are 2 directories that EMUmail installs. One is 'emu3' in your web server root. The other
is 'emu3data' (used for storing users' mail). You need to set the permissions on both these directories
to allow 'Network' access. The 'emu3data' directory and the 'emu3' directory both need 'Change (RWXD)'
access.
The documentation you have might INCORRECTLY tell you that 'Read (RX)' is the correct setting.
Finally, make sure your webserver is set up to execute CGI. For Microsoft
IIS 4.x do the following:
Open the Internet Service Manager.
Right click on the 'emu3' folder and select 'Properties'
In the 'Directory' tab set the following:
Access Permission -> check 'Read', check 'Write'
Permissions -> select 'Execute (including script)'
Content Control -> uncheck 'Directory browsing allowed'
Back to index
- For generic problems with EMU Alacer on UNIX
1) Run emusetup.pl once again and watch for error messages.
2) Test the program as 'root' and also as 'nobody'.
3) Capture the entire error output (from emusetup or emumail.cgi) to a file and send it to support@emumail.com.
4) run "ls -lR *" on each of the directories containing our software, capture the output to
a file, and send it to support@emumail.com.
Back to index
- I am having trouble with GDBM_File.pm
The quickest fix is to use db_file instead. In your site.emu file, set:
dbm_isa=DB_File
If that doesn't work, email support@emumail.com
Back to index
- I'm having trouble with Webmail and UnixWare 7.x.x.
UnixWare 7.0.0, 7.0.1, or 7.1.0 may be used to prevent your machine from being used as an SMTP relay.
This prevents spammers from making their mail appear as if it comes from your site. By default, this
feature is disabled on UnixWare 7.0.0 and 7.0.1, but is enabled on 7.1.0
A problem in this feature prevents a local SMTP connection from sending outgoing mail. That is, if you
make a connection to the SMTP server from the same network on which the server resides, you will not
be able to send a message to another machine. The SMTP dialog will be dropped with the error message:
Relay mail from localhost to recipient.host.name denied where "recipient.host.name" is the
name of the remote host to which the mail is addressed. An example of this is if you have the Netscape
Communicator or Navigator Messenger Mailbox configured with the local host as the "Outgoing mail
(SMTP) server." In this case, the Netscape mail user agent makes a direct SMTP connection to the
local host to send outgoing mail, which will fail with the above error message.
Back to index
- Webmail dies with a 'Bareword "x" not allowed ...' error.
People will usually encounter this error when their emumail.cgi has become corrupted. This usually happens
because you are trying to change the location of Perl on your system. To correctly change the location
of Perl on your system without corrupting your emumail.cgi you will need to follow steps similar to
the installation of mod_perl (Note: If you are already getting the Bareword error, reinstall a fresh
copy of emumail):
1) Move emumail.cgi to EMU.pm
2) Move emuwrapper.cgi to emumail.cgi
3) Edit the new emumail.cgi so it points to the correct Perl
Back to index
- I'm having userdb problems after Red Hat Linux upgrade from 5.2 to
6.x.
Red Hat's database format changed between 5.2 and 6.x. Please send an original userdb file and a new
one to techprod@emumail.com
for analysis.
Back to index
- I'm having a problem using MIME attachments with EMU
Alacer.
Please try reinstalling the MIME modules from the originals, and send a debug log to eval
`dircolors` if problems persist.
Back to index
- How do I turn on debugging in EMU Alacer?
You can turn on debugging in your EMU Alacer in order to track the program's behavior and provide clues
to misbehavior:
In your econfig.pl file, add the line
$EMU_DEBUG =1;
to the end of the file, This will create a file emudebug in your emu data drectory next time you run
the program. If you see errors in your program, sending a copy of emudebug to support@emumail.com will
help us solve your problem.
Be sure to turn debugging off after your problem is resolved.
Back to index
- Why do I receive an error "email address invalid" when I send
mail?
Your mailserver is probably not accepting mail relay from the webserver (even though they may be the
same machine!) In order to open the relay to allow mail to be sent offsite, you need to consult your
mailserver documentation for instructions. Be sure to open relay to only the webserver's IP address,
and not to the whole Internet.
|