Brief

In this guide we will provide detailed process for installing FastNetMon manually. You may need it when your run FastNetMon in non standard environment or use cloud provisioning. In other cases, please use installer tool.

Requirements

We support this guide only for Ubuntu 18.04

Install process

First of all, we will need https support for APT because FastNetMon’s repository secured using this protocol:

sudo apt install -y apt-transport-https libssl1.0.0 iproute2

After that, please sync time. Our license server relies on accurate time and SSL certificate validation can fail in case of inaccurate time or date.

Add FastNetMon’s repository:

echo "deb [arch=amd64] https://repo.fastnetmon.com/fastnetmon_ubuntu_bionic bionic fastnetmon" | sudo tee /etc/apt/sources.list.d/fastnetmon.list

Put this content into file fastnetmon.key:

Add key trust storage:

sudo apt-key add fastnetmon.key

Install FastNetMon:

sudo apt-get update
sudo apt install -y fastnetmon

FastNetMon will fail because you do not have MongoDB.

MongoDB installation

If you use Docker you may use standard images with MongoDB. Otherwise, you can install it manually.

We use version 4.0 for Ubuntu 18.04. You can follow official guide or you can follow our own guide.

Add Mongo repository:

echo "deb [ arch=amd64 ] https://repo.mongodb.org/apt/ubuntu bionic/mongodb-org/4.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.0.list

Add Mongo gpg key:

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 9DA31620334BD75D9DCB49F368818C72E52529D4

Install MongoDB:

sudo apt-get update
sudo apt-get install -y mongodb-org

Load MongoDB:

sudo systemctl enable mongod
sudo systemctl start mongod

Create users in MongoDB.

NB! Please replace “<secret_password>” and “<fastnetmon_secure_pasword>” by secure passwords with at least 16 symbols.

Open MongoDB console:

mongo --host 127.0.0.1

Create administrator:

use admin
db.createUser( { user: "administrator", pwd: "secret_password", roles: [ { role: "userAdminAnyDatabase", db: "admin" }, { role: "readWriteAnyDatabase", db: "admin" }, { role: "dbAdminAnyDatabase", db: "admin"}, { role: "__system", db: "admin" }] })

Open MongoDB configuration:

sudo nano /etc/mongod.conf

And near commented line “security” add (it enabled authorization):

security:
  authorization: enabled

Apply changes:

sudo systemctl restart mongod

Create folder for FastNetMon’s passwords:

sudo mkdir -p /etc/fastnetmon/keychain
sudo chmod 700 /etc/fastnetmon/keychain

And after that put administrator’s password into this file:

echo -n "secret_password" | sudo tee /etc/fastnetmon/keychain/.mongo_admin

mongo admin --username administrator --password `sudo cat /etc/fastnetmon/keychain/.mongo_admin`

Create user for FastNetMon:

use admin
db.createUser( { user: "fastnetmon_user", pwd: "fastnetmon_secure_pasword", roles: [ { role: "dbOwner", db: "fastnetmon" } ] } )

Store password for user in file:

echo -n "fastnetmon_secure_pasword" | sudo tee /etc/fastnetmon/keychain/.mongo_fastnetmon_password

Apply changes:

sudo systemctl restart mongod

Confirm that you can login into MongoDB using user credentials:

mongo --host 127.0.0.1 -u fastnetmon_user -p `sudo cat /etc/fastnetmon/keychain/.mongo_fastnetmon_password` --authenticationDatabase admin

Specify MongoDB access credentials for FastNetMon (you do not need it for localhost case but you have to specify remote server when you use it):

sudo nano /etc/fastnetmon/fastnetmon.conf

Default configuration:

{
"mongodb_host": "127.0.0.1",
"mongodb_port": 27017,
"mongodb_database_name": "fastnetmon",
"mongodb_username": "fastnetmon_user",
"mongodb_auth_source": "admin"
}

Create default configuration:

sudo fcli create_configuration

Restart FastNetMon:

sudo systemctl restart fastnetmon

Confirm that FastNetMon is running properly:

sudo fcli show system_counters

FastNetMon Advanced manual install process on Ubuntu LTS

Brief

Requirements

Install process

MongoDB installation

24/7 Tech Support

Email Us