Fortinet Document Library

Version:


Table of Contents

User Guide

21.4.0
Copy Link

ElastiFlow

ElastiFlow is a NetFlow aggregation tool for collecting and visualizing network flow data from multiple sources, networks, and devices. The following sections describe how to deploy ElastiFlow to FortiMonitor using a VMware OVF image.

Resource requirements

The following list provides the minimum Linux VM requirements for an ElastiFlow integration deployment:

  • 4 CPUs

  • At least 8GB of memory

  • 50 GB of available SSD space

  • Port 5601 open

  • DNS connectivity

Note: The Elasticsearch Curator automatically purges data when the available disk space is less than 10GB. Data older than 14 days is also cleared out.

Download and import the OVA file

  1. Download https://packages.panopta.com/elastiflow/FortiMonitor-Elastiflow-5.ova
    Note: The zip file is approximately 2.7 GB in size.

  2. In VMWare vSphere or ESXi, provision a new VM. Use the method Deploy a virtual machine from an OVF or OVA file.
    Note: A Disk Not Found error may be displayed. You can ignore this warning and proceed with the installation.

  3. Boot the new VM and then log in using the following credentials:
    Username: fortimonitor
    Password: fortimonitor

  4. Set a new password.
    Important note: Do not lose this password. The password can not be recovered. Without it, there is no way to access the VM.

  5. Enter the following command to enable the FortiMonitor Agent to report on ElastiFlow performance and resource usage:
    sudo efconfig enable-agent CUSTOMER_KEY
    Note: To obtain your customer key, select your avatar then select My Account.

  6. The network configuration defaults to DHCP. DHCP is helpful to ease getting the VM online, but because DHCP address leases are not stable in the long term, it is advisable to change to static addressing. The netplan is in /etc/netplan/00-installer-config.yaml and may be edited in root mode using an editor such as nano (See example file below). The command sudo netplan apply will enable the new settings.

  7. Once installed, point your Netflow data from your network devices to the appliance and it will start populating.

  8. Visit http://<IP>:5601 to access the Appliance Main Page.
    Where IP is the IP address of the machine where you installed the ElastiFlow integration.

  9. Go to the dashboard and look at Overview Dashboard to verify that the dashboard exists.
    Note: An Error in visualization error will occur if there is no data to populate the dashboard.

The following are the IPv4 protocols and their corresponding ports the appliance will be listening on:

  • Netflow UDP 2055

Note: After installing ElastiFlow, contact support to enable linking from your network devices in the FortiMonitor Control Panel to the ElastiFlow interface.

Example netplan file

Sample /etc/netplan/00-installer-config.yaml file configured for static addressing. Use IPv4 addresses and masks appropriate for your environment. This file is sensitive to indentation:

network:
version: 2
renderer: networkd
ethernets:
ens160:
dhcp4: no
addresses: [10.0.0.143/24]
gateway4: 10.0.0.254
nameservers:
addresses: [10.0.0.254, 8.8.4.4, 8.8.8.8]

Enable Geo-location data

If you want to get provider and location data, enable geo-location data using the MaxMind GeoIP database:

efconfig enable-geoip LICENSE-KEY

Note: Generate a license by going to https://dev.maxmind.com/geoip/geolite2-free-geolocation-data?lang=en.

While enabling GeoIP automatically downloads the database, you have the option to force a refresh at any time. Enter the following command to download the latest MaxMind GeoIP databases:

efconfig download-geoip-database

ElastiFlow

ElastiFlow is a NetFlow aggregation tool for collecting and visualizing network flow data from multiple sources, networks, and devices. The following sections describe how to deploy ElastiFlow to FortiMonitor using a VMware OVF image.

Resource requirements

The following list provides the minimum Linux VM requirements for an ElastiFlow integration deployment:

  • 4 CPUs

  • At least 8GB of memory

  • 50 GB of available SSD space

  • Port 5601 open

  • DNS connectivity

Note: The Elasticsearch Curator automatically purges data when the available disk space is less than 10GB. Data older than 14 days is also cleared out.

Download and import the OVA file

  1. Download https://packages.panopta.com/elastiflow/FortiMonitor-Elastiflow-5.ova
    Note: The zip file is approximately 2.7 GB in size.

  2. In VMWare vSphere or ESXi, provision a new VM. Use the method Deploy a virtual machine from an OVF or OVA file.
    Note: A Disk Not Found error may be displayed. You can ignore this warning and proceed with the installation.

  3. Boot the new VM and then log in using the following credentials:
    Username: fortimonitor
    Password: fortimonitor

  4. Set a new password.
    Important note: Do not lose this password. The password can not be recovered. Without it, there is no way to access the VM.

  5. Enter the following command to enable the FortiMonitor Agent to report on ElastiFlow performance and resource usage:
    sudo efconfig enable-agent CUSTOMER_KEY
    Note: To obtain your customer key, select your avatar then select My Account.

  6. The network configuration defaults to DHCP. DHCP is helpful to ease getting the VM online, but because DHCP address leases are not stable in the long term, it is advisable to change to static addressing. The netplan is in /etc/netplan/00-installer-config.yaml and may be edited in root mode using an editor such as nano (See example file below). The command sudo netplan apply will enable the new settings.

  7. Once installed, point your Netflow data from your network devices to the appliance and it will start populating.

  8. Visit http://<IP>:5601 to access the Appliance Main Page.
    Where IP is the IP address of the machine where you installed the ElastiFlow integration.

  9. Go to the dashboard and look at Overview Dashboard to verify that the dashboard exists.
    Note: An Error in visualization error will occur if there is no data to populate the dashboard.

The following are the IPv4 protocols and their corresponding ports the appliance will be listening on:

  • Netflow UDP 2055

Note: After installing ElastiFlow, contact support to enable linking from your network devices in the FortiMonitor Control Panel to the ElastiFlow interface.

Example netplan file

Sample /etc/netplan/00-installer-config.yaml file configured for static addressing. Use IPv4 addresses and masks appropriate for your environment. This file is sensitive to indentation:

network:
version: 2
renderer: networkd
ethernets:
ens160:
dhcp4: no
addresses: [10.0.0.143/24]
gateway4: 10.0.0.254
nameservers:
addresses: [10.0.0.254, 8.8.4.4, 8.8.8.8]

Enable Geo-location data

If you want to get provider and location data, enable geo-location data using the MaxMind GeoIP database:

efconfig enable-geoip LICENSE-KEY

Note: Generate a license by going to https://dev.maxmind.com/geoip/geolite2-free-geolocation-data?lang=en.

While enabling GeoIP automatically downloads the database, you have the option to force a refresh at any time. Enter the following command to download the latest MaxMind GeoIP databases:

efconfig download-geoip-database