Service Status Script

[Paul]

A PHP/MySQL based script to show advisories on the current status of servers or service and allow the advisories to be created and managed via a simple web based admin interface.

The admin interface also allows the ability to view various server information such as load providing a small script has been located on each server to be monitored.

You can see a live example at http://status.tolranet.com/

Requirements:

PHP 5.1.2 or later
MySQL 5.0.x or later
MySQLi enabled
Sockets enabled
OpenSSL
ionCube loaders or dynamic loading enabled.

Install:

1. Download the ZIP file from one of the following locations:

• USA Mirror
• UK Mirror

2. Unpack the ZIP file and upload the contents of the upload folder to your web space.

3. Rename dist.system.cfg.php to system.cfg.php then edit it to include the database information.

4. Change the permission on the folder system/cache to be writable by everything. Note: If you are hosting with TOLRA this step should be skipped.

5. If you have ionCube loaders installed in php.ini or are hosting with TOLRA then this step can be skipped. Otherwise download the loaders from http://www.ioncube.com/loaders.php, unpack the zip file and upload the ioncube folder to the same location as you just uploaded the script.

6. Using your web browser access http://yourdomain.com/install.php, where you will be asked to agree to the terms and conditions, if accepted click the I agree link at the bottom of the page.

7. Assuming no errors, delete the install.php file.

8. Login to the admin interface, http://yourdomain.com/admin/ with the user name admin and password admin, then select Edit User and update the details for the user including the password.

9. The script is now usable and you can add servers and advisories as required.

Skinning:

To skin the public or admin interface of the script make a copy of the folder system/themes/default e.g. copy it to system/themes/mytheme, then edit system.cfg.php and change $config['theme'] = 'default'; to be $config['theme'] = 'mytheme';. The theme files can now be edited to give the script the same look as the rest of your site.

home.html - The template for the home page.
advisory.html - The template for displaying an individual advisory.
admin.html - The template for admin pages.
login.html - The template for the admin interface login page.

Other admin templates are located in system/modules/hostingstatus/templates, if you wish to modify these simply copy the file to be modified to your theme folder and it will be used instead of the default.

Status of Remote Servers:

To be able to view the status of a server within the admin interface you will need to upload the serveinfo.php file to the server to be viewed. This files needs to be accessible via a URL.

Once uploaded click Edit Servers in the admin interface and enter the URL of the remote serverinfo.php file into the appropriate "Monitoring URL" box then click Update Monitoring URLs. All being well when you click "View Servers" the status of the server will be displayed.

Support:

Any support issues or questions related to this script must be posted in this forum rather than using support tickets.

Need Hosting?

A status page hosted on the same server/network as the service being reported on has little value therefore you will need to host it offsite. Our STARTER-1 plan at £30 + VAT per year is generally adequate for this task and can be located in either the UK or USA.

We can also host the status site as status.yourdomain.com providing you have a) access to add DNS records and b) have one or more nameservers located away from your services being reported on.

[appedot09]

Thanks.

Just a little more info, pretty much everything is automatic, but if for some reason it doesnt on your server most info bits at the bottom can be overriden with the config file.