HowToUse

Setup

1. Download the source code
2. Run: 'mvn install' in the root directory
3. Run: cd ipheatmap-assembly
4. Run: mvn assembly:single
5. Extract target/ipheatmap-assembly-0.0.1-SNAPSHOT-bundle.zip to an empty directory
6. Change to the directory where the bundle was extracted.

Running the IPHeatmap IPSplitter

1. You will need an input file containing a list of IP addresses. The file should be formatted with one IP per line in plain dotted decimal format. For example: 1.1.1.12.2.2.23.3.3.3
2. Save the file as iplist.txt.
3. Run: java -jar ipheatmap-splitter-0.0.1-SNAPSHOT.jar iplist.txt iplist

A directory called iplist will be created with the iplist.txt split into smaller binary files. This is done for performance reasons later when generating the maps.

Running the IPHeatmap Server

1. Change to the ipheatmap-server directory.
2. Edit src/main/webapp/WEB-INF/web.xml.
3. Modify the ipDir parameter to point to the directory created by the IPSplitter.
4. Modify the cacheDir parameter to point to any empty directory where cached tiles will be saved.
5. Modify the labelFile parameter to point to the network-labels.txt file. There is an example network-labels.txt file provided in the top level project directory.
6. Save the file.
7. Run: mvn jetty:run.
8. Open http://localhost:8080/ in a web browser.
9. You are now viewing your IP address list in a map.

Running the IPHeatmap Tiler

TODO