WNMap Documentation Start Page
You will need a basic knowledge of a web application based on a backend database to understand the following. Good luck :)
REQUIREMENTS to install WNMap
Mandatory
- Web server (Apache recommended): http://httpd.apache.org/
- PHP 4 or greater: http://www.php.net/
- MySQL 3.23 or greater: http://www.mysql.com/
- Google Maps API key: http://www.google.com/apis/maps/
Google Maps requires users of its web services API to provide a key given to those who have registered for use of their service. Register for your API key at Google Maps API URL above.
Optional
- Yahoo! Maps Application ID: http://api.search.yahoo.com/webservices/register_application
You need this if you want to enable geocoding for address searches Yahoo! Maps requires users of its web services API to provide an application ID which uniquely identifies your instance of WNMap. Register for your application ID at the Yahoo! Maps Application ID URL above.
- Python http://www.python.org/
You need this if you want to install python scripts for active data drawing features
INSTALLATION
- Create a WNMap MySQL database using source:sql/create-tables.sql
- Copy the entire contents of 'htdocs/' to a directory served by HTTP. Note the URL that you will be accessing the application from.
- Register for a Google API key and Yahoo! app ID (optional) with your URL.
- Edit 'config.php.dist' in your web directory and rename it to 'config.php'.
- Edit update_topology.py (few variables on top of the file) and save it somewhere on your machine. Then use cron to run it and update the data in the map server. It's up to you to choose how often data on the map server should be updated.
Notes on the Python scripts
The Python scripts in the misc folder do query network status, and insert data to be drawed in the mysql database.
How To Update node status
Use source:misc/updateStatusWithPing.py
This script is still untested
Draw wireless links
You can do this if your network used olsr routing
Use source:misc/update_topology.py
The script uses the txtinfo plugin shipped with olsrd
You can add several IP addresses separated by spaces to a single node. You need this when you have several Wireless Routers on the name roof, and you want them to appear as a single marker.
