User Tools


Differences

This shows you the differences between two versions of the page.

Link to this comparison view

en:adminmanual:monitorstatus [2017/04/28 11:48] (current)
joebordes created
Line 1: Line 1:
 +===== Monitor the health of your coreBOS =====
 +
 +If you would like to add your coreBOS install into your company'​s **IT Infrastructure Health Monitoring** system, the **ping** functionality is exactly what you are looking for.
 +
 +This feature is expressly designed to be called from a tool like [[https://​www.nagios.org/​|Nagios]] or [[https://​pandorafms.com|Pandora]] and will execute a set of 10 tests against your coreBOS install. Actually 11 if you consider accessing the script itself as a test.
 +
 +You must call the URL:
 +
 +http://​your_server/​your_corebos/​ping.php
 +
 +which must be accessible either using a user and password to overcome any apache authentication screen or by [[https://​github.com/​tsolucio/​corebos/​blob/​master/​htaccess.txt|explicitly excluding it]] from the authentication in the .htaccess file.
 +
 +The script will return the string
 +
 +<​code>​OK:​ basic testing has passed</​code>​
 +
 +if all tests pass or one of the next error messages depending on the failure detected:
 +
 +  * NOK: incorrect PHP version
 +  * NOK: no configuration file
 +  * NOK: no database configuration
 +  * NOK: no version file
 +  * NOK: no version configuration
 +  * NOK: missing program files: vtlib
 +  * NOK: version mismatch
 +  * NOK: could not access database
 +  * NOK: missing program file: users
 +  * NOK: missing admin user file
 +