Page History

...

• WiFiMon Agent package (version 1.23.10)
• PostgreSQL (tested on version 10.16)
• Java 11
• Elasticsearch (tested on version 7.9.3)
• Kibana (tested on version 7.9.3)
• Logstash (required in case of correlation with RADIUS and DHCP Logs, tested on version 7.9.03)

The following ports must be available on the WAS. However, the ports may be changed manually depending on your needs:

...

Installing WiFiMonrequires the following commands:

wget httpshttp://bitbucket83.software97.geant95.org/projects/WFMON/repos/agent/raw/packages/167/deb/wifimon-agent-1.2.1.deb?at=refs%2Fheads%2Fmaster --output-document=wifimon-agent-1.2.1.3.0.deb
sudo apt-get update
sudo apt-get install -y gdebi
sudo gdebi wifimon-agent-1.23.10.deb

Afterwards, the following files will show up in /usr/lib/wifimon/ directory:

• elasticsearch.sh: Script to create Elasticsearch indices

• kibana-import.ndjson: JSON file to be imported in Kibana to create the necessary visualizations and dashboards

• start.sh: Script for starting WiFiMon GUI and Agent

• secure-processor-1.23.1war0war: This incorporates both the WiFiMon Secure and Non-Secure Agent
  

• ui-1.23.10.war: This incorporates the WiFiMon GUI

• config: Directory with configuration files. Their parameters must be filled in.

• keystore: Directory where the Java Keystore should be stored in order to run WiFiMon Agent and GUI on HTTPS

...

In ui.properties, the WiFiMon Administrator is expected to provide the values for the PostgreSQL properties (the same as in the secure-processor.properties file) as well as the Kibana properties. Specifically, the WiFiMon Administrator should insert the FQDN Kibana listens on ("server.host.name" property), the protocol used by Kibana ("kibana.protocol" property), which is "http" for the WiFiMon Non-Secure Agent (this step) or "https" for the WiFiMon Secure Agent (step 7 of this documentation) as well as the port Kibana listens to ("kibana.port" property), which is usually 5601" for the WiFiMon Non-Secure Agent (this step) or "https" for the WiFiMon Secure Agent (step 7 of this documentation) as well as the port Kibana listens to ("kibana.port" property), which is usually 5601. Finally, WiFiMon provides methods for checking if a new software version is available. To that end, the running version of the WiFiMon software is compared with the most recent version that is stored within a VM provided by GEANT. Moreover, this VM keeps some statistics of WiFiMon end users involving their IP address and running version. The purpose of this is to track how many users are currently utilizing WiFiMon and what versions. If the WiFiMon end user wants to be excluded from this process, "user.tracking" should be changed to "no".

Starting the WiFiMon Secure Agent and WiFiMon GUI requires the following command:

...

cp agent/wifimon-assembly/target/wifimon-agent-bin/secure-processor-1.23.10.war /usr/lib/wifimon/secure-processor-1.23.10.war
cp agent/wifimon-assembly/target/wifimon-agent-bin/ui-1.23.10.war /usr/lib/wifimon/ui-1.23.10.war

Anchor
letsencrypt letsencrypt

7. Configuration of the WiFiMon Secure Agent

...

• Maps:

  • Clients Maps, map withthe measurement count from clients location in current day, automatically updated every 30 seconds

  • APs Maps, map withthe measurement count from APs location in current day, automatically updated every 30 seconds

• Configuration:

  • Subnets: Add/remove Subnets that are allowed to perform measurements

  • Access Points: Add remove information (MAC, latitude, longitude, etc.) about Access Points (necessary to depict measurements in APs Maps page)

  • Users: Add/remove users to login to the WiFiMon GUI (role "USER" does not have access "Configuration" and "Guide" tabs)

  • Privacy / Correlation: Hide/show user-related data, select the method to allow the correlation between measurements, client IP and AP MAC

• Guide: Instruction on how to embed scripts (to perform measurements) to websites and locally install the available performance tests (NetTest, boomerang, speedtest/HTML5)
  

• Help: Instruction on how to get help

• Check for updates: Check for newer versions of WiFiMon software.

As a first step you should add the Subnet of your WiFi network to allow measurements.

...