Skip to main content Link Search Menu Expand Document (external link)

Virtual (VM) Collector Installation Guide

Table of contents
  1. Virtual (VM) Collector Installation Guide
    1. Install CentOS Linux
      1. Booting from disk / ISO image
      2. Configuration
        1. Partitioning
        2. Network Settings
    2. Running the Fluency installation package
      1. Downloading install package
      2. Executing installation package
      3. Kernel update / reboot
      4. Configuration / Install package
    3. Installing Automatic Updates
      1. Allow automatic updates when connected to a Fluency server
    4. Fluency Portal Configurations
      1. Login to the Fluency Cloud Portal
      2. Adding a new Collector
    5. Connecting the collector to a Fluency server
      1. Configure server address and token 
  2. VMWare OVA Images
    1. Image Download
      1. Default VM Login

This guide addresses the procedures required to install the Fluency Virtual Collector.

The Fluency virtual collector is installed on top of the CentOS Linux operating system. For more detailed information regarding CentOS, refer to the official vendor documentation.

Official CentOS documentation: https://docs.centos.org/en-US/centos/install-guide/

Install CentOS Linux

The following guide assumes the installation is takes place on a machine with a new empty disk, and that the system has been booted from the CentOS installation ISO. For instructions on other types of CentOS installations, please refer to the official documentation: https://docs.centos.org/en-US/centos/install-guide/

The CentOS Minimal install ISO can be found at the following link (other Mirrors/Repositories may be used for the same ISO): https://mirrors.mit.edu/centos/7.9.2009/isos/x86_64/CentOS-7-x86_64-Minimal-2009.iso

The recommended size for the virtual collector is 2 vCPU, 8GB RAM and 80GB to 1TB of disk space. If your virtual machine already has CentOS installed, such as the case when launching an instance from an AWS or Microsoft Azure image, this section may be skipped.

Note: for Microsoft Azure, the supported/tested image is the OpenLogic.CentOS-7_9 image. (In the marketplace, search “centos based”. The image is from Rouge Wave Software). The minimum instance size on Azure was Standard B2s, with 4GB RAM.

Booting from disk / ISO image

Start the machine from the installation disk/image. Select Install CentOS 7 from the launch menu.

Configuration

On the following screen(s), select the language, and “continue” to the “Installation Summary” page.

Select the “Installation Destination” option under “System”, to partition and configure the disk. Note, you may also choose to disable “KDump” here, as it is not used.

Partitioning

In the Installation Destination configuration page, choose “I will configure partitioning” and select “Done” to advance to the next page to customize the partitioning.

Select “Standard Partition” and create a mount point for the root directory “/”. For the desired capacity, choose the entire available space.

Click “Done” when finished configuring. Accept/confirm the changes and acknowledge the warnings to continue.

Network Settings

Return to the “Installation Summary” page and select “Network and Hostname” to configure the network settings.

For the Host name, choose a valid name for the machine, avoiding spaces. You may also toggle the On/Off button for the Network interface to enable the port on boot.

Click “Done” when finished.

Return to the “Installation Summary” page and select “Begin Installation” to start. On the following page, configure a password for the root user.

Wait for the progress bar to indicate that the installation is complete.

Select “Reboot” to complete the installation. You will be prompted to log into the system terminal when the machine completes the reboot.

Running the Fluency installation package

Login to the system with the root user credentials created in the above step. (if not using a root account, add the prefix “sudo” for each of the commands shown below.)

Downloading install package

Download the Fluency installation package (and make it executable) via the following commands:

yum -y install wget
wget https://s3.amazonaws.com/SecurityDo/images/Fluency-installer-v700b.package
chmod 755 Fluency-installer-v700b.package

Executing installation package

Run the installation package with the following command:

./Fluency-installer-v700b.package

Kernel update / reboot

You will be asked to update kernel and restart.

Configuration / Install package

Once the VM restarts, log in and run the package again.

The installer will prompt you for a “hardware platform”. Type “vm” in the prompt. The installer will prompt you for an “fsl-name”. Type a name in the prompt, avoid using spaces and special characters. Allow the package to run and complete the installation.

The prompt should display “DONE” when completed.

The collector installation is now complete. Proceed to the next step to attach it to your Server.  

Installing Automatic Updates

Fluency collectors can automatically update when connected to a server. However, this is a recently added feature, and must be patched into the collector.

Allow automatic updates when connected to a Fluency server

Download and install the patch via the following commands:

wget https://s3.amazonaws.com/SecurityDo/public/collector_upgrade_20220707.tar.gz
tar xvfz collector_upgrade_20220707.tar.gz 
cd collector_upgrade_20220707
./install.sh

This will install a new service on the collector and allow Fluency collector to download and install updates (via the server). No further action is needed after the patch. 

Fluency Portal Configurations

Login to the Fluency Cloud Portal

https://.cloud.fluencysecurity.com (A different custom URL may also be assigned here.)

Adding a new Collector

In the Main Menu, choose the “Collectors” option in the Configurations section.   Select the “+” button in the upper right corner to add a new collector.

Give the collector a name and a description. Avoid special characters/spaces. You may use the fsl-name from the installer.

Note: The XDP/EBPF option can be ignored.

The collector list will now show a new collector with “Red / Grey” status, and a Token. Copy this token for the following step.  

Connecting the collector to a Fluency server

Obtain a collector token from your Fluency server.

Configure server address and token 

On the command prompt in the collector, run the following command to attach the collector to the server:

mgmt add_server https://<companyname>.cloud.fluencysecurity.com <your-token>

This completes the procedures to install and configure a Fluency Virtual collector. Refresh the Collector page on the Fluency portal. The status indicator for the new collector should now be “Green”.

VMWare OVA Images

Alternatively, if you have VMWare, you can use our OVA image. (Note that the procedure for attaching the collector to the cloud/server is the same as that outlined at the end of the last section.)

Image Download

Link to the OVA image for VMWare: https://s3.amazonaws.com/SecurityDo/images/FluencyESXiCollector-v692-202106.ova

The collector image is built on top of a minimal CentOS 7 install. Standard CentOS 7 procedures for network setup will work here.

Default VM Login

The default credentials are:

user: root
pass: security

MD5 Checksum of the ova file is:

hliu@server$ md5sum FluencyESXiCollector-v692-202106.ova
3ef699ac55007a8a381fd96365f3d00b  FluencyESXiCollector-v692-202106.ova

Page last updated: 2022 Oct 26