Page History

...

Anchor
wifimon wifimon

5. WiFiMon Installation

To install WiFiMon, use Installing WiFiMon requires the following commands:

wget https://fl-5-205.unil.cloud.switch.ch/wifimon-agent-0.1.1-SNAPSHOT.deb --no-check-certificate

sudo apt-get update
sudo apt-get install -y gdebi
sudo gdebi wifimon-agent-0.1.1-SNAPSHOT.deb

Afterwards, you will be able to see the following files will show up in /usr/lib/wifimon/ directory of the installation computer:

• 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-0.1.1.war: This incorporates both the WiFiMon Secure and Non-Secure Agent.
  

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

• config: Directory with configuration files that need to . 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

• probes: Contains files related to the configuration of WiFiMon Hardware Probes.
  
• subnets: Contains files related to the configuration of the different subnets visualization.

chmod +x elasticsearch.sh
chmod +x start.sh

Before executing the execution of script elasticsearch.sh, you must install “curl” must be installed. This can be done is possible using the following commands:

sudo apt-get update
sudo apt-get install -y curl

You should edit the Script elasticsearch.sh script based on what interface your must be edited to match the interface the Elasticsearch cluster listen on. You should provide the to. The FQDN of the WAS or should be provided or localhost if the WAS listens is configured to listen on localhost. Add Script elasticsearch.sh will add the required indices and some initial data in the Elasticsearch cluster by executing the elasticsearch.sh script.:

./elasticsearch.sh

Go to Kibana page, select Management and press Index Patterns to configure them. Insert the following to create wifimon indexIn the sequel, Kibana index patterns should be configured from the Kibana User Interface. In Kibana, the "wifimon" index pattern can be created from Management/Index Patterns. The following details should be provided:

• Index pattern: wifimon

• Time Filter field name: timestamp

• Index pattern ID: wifimon_v0.1 (press advanced options should be selected to see this field)

and the following following details are required to create "radiuslogs" index (for the correlation of RADIUS Logs with End User measurements):

• Index pattern: radiuslogs

• Time Filter field name: Timestamp

• Index pattern ID: radiuslogs_v0.1 (press advanced options should be selected to see this field)

and the following details are required to create "probes" index (for the metrics collected from the WiFiMon Hardware Probes):

• Index pattern: probes

• Time Filter field name: timestamp
  

• Index pattern ID: probes_v0.1 (press advanced options should be selected to see this field)

and the following to create "dhcplogs" index (for the correlation with DHCP logsof DHCP Logs with End User measurements):

• Index pattern: dhcplogs

• Time Filter field name: timestamp
  

• Index pattern ID: dhcplogs_v0.1 (press advanced options should be selected to see this field)

After you create the index pattern go to Saved Objects tab, press Import and import the creation of index patterns, the necessary visualizations and dashboards should be imported. To that end, the kibana-import.ndjson to create the necessary visualizations and dashboards.file should be imported in the Management/Saved Objects tab.

Finally, WiFiMon properties should be configured in the files Go to config directory and fill in the configuration files (secure-processor.properties, ui.properties) . You may ignore the processor.properties file. Note that of the WiFiMon config directory. Notably, WiFiMon uses HMAC SHA-512 encryption to encrypt sensitive data (End User User IP addresses, End User MAC addresses) that are stored in the Elasticsearch cluster and visualized by Kibana. In secure-processor.properties, you have to define the key of this algorithm (type String).must be defined. This key is of type String and the reader could select any well-formatted string, preferably of big length. This string is defined only in the secure-processor.properties configuration file.

Starting Start the WiFiMon Secure Agent and WiFiMon GUI requires the following command: ./start.sh

Anchor
compile compile

6. Compile WiFiMon Code

...