Troubleshooting

In the event of an error Marmoset outputs errors using the PHP syslog() function. No errors are displayed on the resulting page in order to ensure search robots get the original PHP page (without semantic data) in such cases.

The location of these errors depends on your Web server's configuration. First, ensure that:

• Logging errors is enabled in your Web server's configuration
• Determine the location of the errors in your php.ini file
  • Normally this would either be a log file or the system log
  • In Windows based systems, system log messages can be viewed using the Event Viewer (Control Panel -- Administrative Tools)
  • Under Linux based systems system log messages can be viewed at /var/log/messages
• In case the location is the system log, ensure that the user running your Web server process has sufficient permissions to write to the system log

Common Problems

Calling my page with ?overrideUserAgent=true returns the original page

This usually means that an error occurred. Use the information above to find the location of error messages, and obtain additional information about the error.

An error occurs, but there are no errors in the log

In this case, make sure that:

1. You know the location where PHP's syslog() outputs error messages (this depends on your specific Web server and PHP configuration)
2. The operating system user running the Web server has sufficient permissions to write to the system log (under Windows, a user belonging to group 'Guests' may not be allowed to write to the system log, causing error messages to disappear)

ERROR: Non-empty content is required

This usually means that the original PHP page you activated produces an empty page.

Enlighten ERROR: <optional text>

This means the invocation of the Calais Web service failed, normally due to temporary connectivity problems. Ensure your Web server is allowed to establish outbound connections to the Calais Web service (your hosting server provider may have disabled this for security reasons, and may enable it if you ask)