Diddle Widget

	System configuration and performance analysis for share Web hosting environments.
	Copyright (C) 2010, KrazyWorks, LLC
	igor@krazyworks.com
	
	This program 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.
	
	This program 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 this program.  If not, see http://www.gnu.org/licenses/


Description

The "Diddle" widget is based on the diddle.ksh script by KrazyWorks. This is a simple performance analysis tool designed for Linux-based shared hosting Web servers. The script has been designed to run under unprivileged user accounts.

How it works

The diddle.ksh is a Korn shell script that resides in your WordPress "plugins" folder. Whenever somebody visits your site, the script runs and updates system performance data, which is then displayed on your site via the widget. The script is designed to cache the results of its previous run for 600 seconds. You can change this cache timeout by editing the "cache=600" line in the "diddle.ksh" file.

System requirements

Your Web server must be running Linux. You must have SSH access to your Web server. Your WordPress version must be 2.8 or newer.

The "Diddle" script and widget are designed to work in the most common Linux-based shared hosting configurations. However, not all such servers are configured identically. Therefore, it is possible that the script may fail to collect the required data. Below we explain how you can test th script before enabling it on your site.

Installation

	1. Download the plugin and unzip it into the wp-content/plugins folder of your WordPress installation.
	2. SSH to your Web server and "cd" to the wp-content/plugins/diddle-widget directory.
	3. Type "ls" and make sure you can see the "diddle.ksh" file.
	4. Make the script executable by typing "chmod 755 diddle.ksh"
	5. Determine the path by typing "pwd" in the directory where "diddle.ksh" is located.

Testing

While you are still in the wp-content/plugins/diddle-widget directory, you can test the script by typing "./diddle.ksh" The output should look something like this:

	krazyworks.com [~/public_html/wp-content/plugins/diddle-widget]# ./diddle.ksh

	Server: meru.site5.com
	OS:             Red Hat 3.4.6-11
	Kernel: Linux 2.6.27-grsec4
	Arch:   32-bit OS running on 64-bit hardware
	CPU(s): 8 x 4-core Intel Xeon CPU E5420@ 2.50GHz
	RAM:    8Gb (92% used), 16 x 512Kb DIMMs
	Swap:   6Gb (13% used), paging in/out: 28/47
	Uptime: 1 day
	Load:   .11, .13, .14
	CPU %:  32 CPU cores at 14% combined utilization
	Apps:   MySQL 5.0.89, Perl 5.8.8
	Issues: occasional RAM shortages

If you are getting any errors, then this plugin is not a match for your Web hosting environment.


Configuration

1. Go to the "Widgets" section of your WordPress administration interface.
2. Drag the "Diddle Widget" into the sidebar location of your choice.
3. Enter the desired title and path to the "diddle.ksh" script and click "Save Changes"

IMPORTANT! The path should look something like this:

	/home/your_username/public_html/wp-content/plugins/diddle/diddle.ksh

Support

What support?


