WebMO Troubleshooting Guide

	Recent news WebMO 10.0 is now available for free download! WebMO 10.0 Pro and Enterprise have a variety of additional features and is available for purchase. WebMO can now be installed on Windows, Mac, and Unix servers!
February 9, 2010

WebMO Troubleshooting Guide

These instructions detail the WebMO troubleshooting process. This instructions use the WebMO diagnostic script, distributed with WebMO 3.3 and higher.

Following the WebMO installation instructions through at least the command-line portion of the setup

Run the WebMO diagnostic setup script
% cd WebMO.install
% perl diagnose.pl

Follow the directions that are given in the diagnostic script

When the script execution is complete view diagnose.html
% netscape diagnose.html

Any errors will be marked in red; brief instructions on how to fix the error are also given.

It is STRONGLY recommended that you install WebMO as a normal system user (i.e. not 'root') into the /home/username/public_html directory structure, using the directory names recommended by the installation script. Note that this will require a few small tweaks to the typically Apache configuration file, as outlined here.

The vast majority of configuration problems are Apache cgi-execution configuration problems, but are difficult to detect. The diagnostic script summarizes the relevant Apache configuration details, but may not detect all problems. More information regarding Apache configuration with regard to cgi-execution can be found in the WebMO Support section.

If you are unable to fix your configuration problem, please visit the WebMO Support Forum or send email to support@webmo.net. In order to help us better diagnose your configuration problem, please include the diagnose.html file as an email attachment.