Troubleshooting guide
# ls -la
-rwsr-sr-x 1 root root 569012 Jan 15 1997 visualmail
If visualmail is not SUID/SGID, run the commands:
chown root visualmail
chgrp root visualmail
chmod 6755 visualmail
Common Problems and its solutions
Problem: Performing actions that take too much time (like downloading a very big mailbox), the user always receives after the same amout of time a "the server returned an invalid or unrecognized" error message.
Cause: Web server configuration issue.
Solution: Check the ScriptTimeout parameter in your web server's config file, by default most web server software kills the cgi application if no reponse is received for more than x time.
Problem: VisualMail returns a "Incomplete config file" error message.
Cause: Missing parameter in visualmail.conf
Solution: Check if the VisualMail configuration file visualmail.conf is located in the /etc directory and contains all the required parameters.
Problem: VisualMail returns a "Error reading language file" message.
Cause: VisualMail can’t access the language file.
Solution: Check if the language file specified in the visualmail.conf file is present and can be readed from VisualMail.
Problem: VisualMail returns a "Error processing <file>.htx file" message.
Cause: <file>.htx can’t be readed by VisualMail.
Solution: Check if the HTX directory specified in the visualmail.conf file is present and can be readed from VisualMail. Also check is the <file>.htx file is present and can be readed from VisualMail.
Problem: VisualMail returns a "Error parsing HTX file" message.
Cause: The HTX file selected can’t be accessed from VisualMail or contains incorrect HTX commands.
Soultion: Check if the HTX path specified in the visualmail.conf file is present and can be accessed from VisualMail. Also check if the HTX file accessed contains any incorrect HTX command.
Problem: The images appear as broken links.
Cause: The /images directory can’t be accessed from the web browser.
Solution: Check if the /images directory is copied correctly in your web server html root directory.
Problem: The messages deleted are not cleaned at nights (enterprise version)
Cause: The dbutil program is not installed correctly in the cron file.
Solution: Read the installation procedure described in chapter 2.