Contents - Index

Control Panel - Available Logs

Jomres has a number of different log types available but only the error logging is enabled by default.

Other logs are gateway logs, request logs and logging information captured by the booking engine. Unless you've got a specific need it's not recommended that you enable these logs as they'll slow your system down and possibly expose sensitive information, to enable them you have to manually edit jomres.php and set the appropriate line to true.

All logs are saved by default in xml format in the /media folder. If you need to use the logging you can edit site_config.php and change the $jrConfig['jomres_systemLog_path'] setting to something above your html root (after making sure that it's writable by the web server). Note that as of v3.1.7 site configuration is saved in the table XXX_jomres_site_config, so you will probably need to edit this table manually. Look for a column element marked as "akey" = "jomres_systemLog_path" and change it's corresponding value to the full path of where you want to save logs (ensuring that that path is writable by the web server).

Error logs are available by default and useful for tracking down behaviour within the system. If you get an error message in the frontend of Jomres look at the error log to see if it advises what went wrong. A typical example is where a property manager hasn't been assigned to a property, if they try to log in and view a Jomres page they'll get an error, and this will be reflected in the error log.

When you click on the control panel icon to view the log files you'll be taken to a list of available log files. If there are none available then there will be a message to that effect. To view a log file click on the relevant link, e.g. Request. This will take you to an output page for that log file. The logs are recorded in xml format then read in by a function that builds a more human readable output. The log file is viewed in reverse chronological order; therefore the most recent entries are first. The view will provide each log file in a table showing an information icon, the date and time of the log, the task that was being performed and the message. If you click on the information icon another (green) line is revealed to show the session id and the query string of the call.

The log files are:

Request 
This logs all of the requests sent to Jomres (so gets very big very quickly). It will record contents of the $_REQUEST variable. This script is useful particularly if you wish to confirm that a remote server is indeed communicating with the Jomres server.
Booking 
This logs activity performed when somebody is using the booking form. Because the booking process is all Ajax based it can be very difficult to track how the system is calculating its prices. To make this a little easier to follow the booking system maintains the ability to log its actions. Whilst it's still complex, the log does help to break the booking engine steps down into manageable bites.
Gateway
This is a separate log for tracking gateway communications. It will record what was sent to and from the gateway system. It is absolutely vital that you keep this log file secure at all times.
System
This log file tracks miscellaneous system activity. As of 2.6 its main task is to perform logging of the booking insertion process, but its use is likely to expand in later version.
Error
Logs php errors thrown up. Note, it cannot manage php compilation errors, so if you've introduced an error in the code (e.g. forgotten to include a ";" at the end of a line) then the script will still fail, but otherwise it will attempt to write an error report to the error log file and send the user to an error page.

When a log file gets to appx 1Mb in size it will be automatically renamed by the system as large log files will slow your system down.