Hostify Status Checker v1.0 README /* * Hostify Status Checker v1.0 * http://hostify.net * Copyright (c) 2010 Hostify Networks * * This file is part of Hostify Status Checker. * * Hostify Status Checker is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * Hostify Status Checker is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with Hostify Status Checker. If not, see . * * Modified: 10/2/2010 11:07pm American/Chicago * Revision: 1 */ Requirements- General Requirements: - PHP >= 5.2.14 - HTTP server Host Node Requirements: - fsockopen - file_get_contents - Cron (or something else that can call a file at regular intervals) - MySQLi Monitored Server Requirements: - Linux 1)PHP functions a) exec b) shell_exec c) fsockopen - Windows 1) PHP functions a) passthru b) fsockopen 2) Windows functions a) typeperf Installation Instructions- 1) Extract the Hostify Status Package. 2) Create the MySQL database. a. Create a new appropriately named database. b. Create a new user with a strong password for the database. c. Import database.sql using phpMyAdmin or if you prefer, run the SQL manually. This will create the two tables needed for Hostify Status Checker to run. 3) Navigate to /app and set the appropriate settings in config.php: a. Contact information: This is very important. If a server goes down, you will receive and email at the address you enter. b. Database config: Enter the details for the database you created in step 2. c. Servers to check: View the example configuration and modify it to your needs. If there is more than one server that you wish to check, simply duplicate the example. Ensure that the domain and id are unique. 4) Setup the mail server in /app/mail.inc.php. The default is to use SMTP. If this is not setup, mail sending will fail and YOU WILL _NOT_ BE NOTIFIED IF A SERVER GOES DOWN. 5) Upload the files and folders in /app to the appropriate directory on your monitoring server (typically /home/YOUR_USERNAME/public_html/ on a cPanel server). 6) Setup a cron job to execute every one minute (or at another interval if you prefer) using this command: /usr/bin/curl -s http://yourdomain.com/cron.php >/dev/null 2>&1 7) Upload the files from /remote to the server(s) you wish to monitor ensuring that they are placed in the appropriate directory as specified in config.php on the monitoring server. If you wish to display information about PHP on a particular server, comment out line 39 in status.php. 8) Download the appropriate extra packages: a. If you wish to support speed testing for your monitored servers, download Speedtest Mini from http://www.speedtest.net/mini.php Place the package in a subdirectory on the server(s) you wish to monitor. For example, on a cPanel server you would place the Speedtest in /home/YOUR_USERNAME/public_html/speed For reference, the path to speedtest.swf would be /home/YOUR_USERNAME/public_html/speed/speedtest.swf b. If you wish to support advanced server details, comment out line 28 in info.php. Retrieve phpSysInfo from http://phpsysinfo.sourceforge.net. Remove index.php from the phpSysInfo package. Place the phpsysinfo package onto the server you wish to enable this feature in /home/YOUR_USERNAME/public_html/ For reference, the path to phpSysInfo's config.php would be /home/YOUR_USERNAME/public_html/config.php If configuration is successful, you will receive an email upon the first check at the address specified in config.php. If you do not receive an email, check that the appropriate values are set in both config.php and mail.inc.php. Statistic averages are updated once per day, trailing behind by one day. If you find any bugs or think of any useful features that should be implemented please use our bug tracker: http://hostify.net/bugs/