Troubleshooting guide

 

  1. Check if visualmail has SUID/SGID permissions:
  2. # 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

  3. Check all the paths to files and directories specified in the /etc/visualmail.conf.
  4. Check if there is enough disk space on the temporary directory and on the visualmail home directory.
  5. Check if the language file is complete.
  6. Check if all the HTX files are present in the HTX directory.
  7. Check if the URL of the visualmail executable file is correctly specified in the /etc/visualmail.conf.
  8. Check if the /images directory is installed in your html root directory and can be accessed from the web browser.
  9. Check the SMTP server address and port number.
  10. Check the Main Mail server address, port number and type.

 

 

 

 

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.