| Current File : //var/wcp4/cmcmacau/public_html/scripts/scripts/scripts/bandwidthmeter/docs/INSTALL |
NOTE, if you are upgrading see UPGRADE before beginning
Installation:
1. Unzip the installation package bandwidthmeter-***.zip. It will create a
bandwidthmeter directory.
2. Move the bandwidthmeter directory into a location on your web server
that is setup to execute PHP files (.php).
3. Modify the config.inc.php file to fit your configuration. Set $mysql
to "True" if you want to use MySQL to log readings I would suggest
downloading phpMyAdmin (http://phpmyadmin.sourceforge.net/).
4. If you want to use the javascript pop-up version (highly recommended
because it prevents users from generating incorrect results), you must
include the file "popup.js" on the page which you are calling the meter
from. This may be done within the <head> tag with the following line:
<script language=javascript src="popup.js">
When you call the meter, link to it as follows:
<a href="javascript:OpenMeter('meter.php')">Speed Test</a>
5. (MySQL users only)
The following directions are assuming that you are using the phpMyAdmin
interface. I am assuming that most who know the command line are
able to figure out how to create a database and load the SQL code.
Create a new database (default name is bandwidthmeter). This can be
done from the main screen. Where it says "Location of the textfile,"
browse to the sql/setup.sql file. Click on OK.
You have now created the database and loaded the table structure.
Next go to the Home page for phpMyAdmin. Click on Users. Make sure that
the proper database is selected that you created above. Then click on the
"host" textbox and enter localhost. For the username the default is
"bandwidthmeter" and choose a password. The username and password should
correspond to the settings you have in your config.inc.php file. For
privileges choose Select and Insert.
Reload MySQL for the user changes to go through.
6. To test the MySQL install, load install.php in a web browser. This will
determine whether Bandwidthmeter can properly connect to the MySQL server.
7. Point your browser to the location you placed the php files in followed
by meter.php . For example, http://yourdomain.com/bandwidthmeter/meter.php
This will perform a speed test. You can send your clients to visit
this page to perform the bandwidth test.
8. If you have setup MySQL to record IP's, hostnames, timestamps, and speeds,
you can access this data by going to admin.php
(i.e. http://yourdomain.com/bandwidthmeter/admin.php).