Page History

...

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

...

A summary of the mandatory steps for the installation (detailed in the linked sections below):

• Installation of PostgreSQL

• Creation of database, users and tables in PostgreSQL

• Installation of Java

• Installation of Elasticsearch

• Installation of Kibana

• Configuration of Elasticsearch

• Configuration of Kibana

• Installation of WiFiMon Agent and WiFiMon GUI

• Run the services

• Links to the WiFiMon GUI

There are also some optional steps:

• Compilation of the WiFiMon code

• Configuration of the WiFiMon Secure Agent certificate

• Configuration of X-Pack

Anchor
PostgreSQL PostgreSQL

2. PostgreSQL

...

This account can be later deleted from the WiFiMon GUI (after step 5). However, an ADMIN account should always be present in order to access the WiFiMon GUI and manage the WiFiMon Users, Access Points and Subnets. We strongly suggest that the password is changed from the WiFiMon GUI when the installation is complete (step 5).

Anchor
java java

3. Java Installation

...

Installing Elasticsearch 7.9.0 3 and Kibana 7.9.03, requires executing the following commands:

...

wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.9.03-amd64.deb
sudo dpkg -i elasticsearch-7.9.03-amd64.deb

• Kibana 7.9.0
  

  Anchor
  kibana kibana

wget https://artifacts.elastic.co/downloads/kibana/kibana-7.9.03-amd64.deb
sudo dpkg -i kibana-7.9.03-amd64.deb

Anchor
elasticsearch_configure elasticsearch_configure

Elasticsearch Configuration

...

wget https://bitbucket.software.geant.org/projects/WFMON/repos/agent/raw/packages/wifimon-agent-1.2.0-SNAPSHOT1.deb?at=refs%2Fheads%2Fmaster --output-document=wifimon-agent-1.2.0-SNAPSHOT1.deb
sudo apt-get update
sudo apt-get install -y gdebi
sudo gdebi wifimon-agent-1.2.0-SNAPSHOT1.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.2.0-SNAPSHOT.war1war: This incorporates both the WiFiMon Secure and Non-Secure Agent
  

• ui-1.2.0-SNAPSHOT1.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

...

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

Anchor
letsencrypt letsencrypt

7. Configuration of the WiFiMon Secure Agent

...