#     #              ######                       
 ##    # ###### ##### #     # ###### ###### ###### 
 # #   # #        #   #     # #      #          #  
 #  #  # #####    #   ######  #####  #####     #   
 #   # # #        #   #     # #      #        #    
 #    ## #        #   #     # #      #       #     
 #     # ######   #   ######  ###### ###### ######
  
About NetBeez
NetBeez is a network performance dashboard that reports the status and performance of a wireless or wired network. The dashboard collects information from network sensors that can be installed on a linux host with network connectivity. including a Raspberry Pi.

Type of information collected
One agent can run user-defined tests like: ping, to verify network connectivity and reachability; dig, to verify if a DNS server responds and if a DNS record is available; curl, to check if an HTTP server responds and if a specific page is available; traceroute, to trace what route is traversed to reach a destination. The resulting information of these commands, like response time, packet loss, or percentage of number of failed tests is sent back to the server for processing, alarming, and visualization.

How to install NetBeez
1. Create a dashboard by requesting an instance at https://netbeez.net/free-instance-signup/
2. Install the software agent, virtual agent, or Raspberry Pi image

Software Agent
1. Add the NetBeez software repository, update the database, and install the netbeez-agent package
    echo "deb http://repo.netbeez.net wheezy main" | sudo tee -a /etc/apt/sources.list
    sudo wget -O - http://repo.netbeez.net/netbeez_pub.key | sudo apt-key add -
    sudo apt-get update
    sudo apt-get install netbeez-agent
2. As root, save the private key that you received with the welcome email at step 1 as file /etc/netbeez/netbeez-agent.pem
3. As root, edit the configuration file /etc/netbeez/netbeez-agent.conf and replace "hostname" with your dashboard instance name
    {"host":"hostname.netbeezcloud.net", "secure_port":"20018", "interfaces":"eth0", "model":"software-debian"}
4. Restart the agent process
    sudo service netbeez-agent stop; sudo service netbeez-agent start
If you are having problems, please read the FAQ at the bottom of this page or ask the community at http://community.netbeez.net

Virtual Agent
1. Download the OVA file
   OVA: netbeez-virtual-agent-0.11.2.ova
   MD5: netbeez-virtual-agent-0.11.2.md5
2. Load the OVA on VirtualBox (available here) or vSphere with the following settings:
   vCPU: 1
   Sockets: 1 or 2
   RAM: 1 or 2 GB
   HDD: Thin provisioning
3. Once the OVA is booted, login with netbeez/netbeez (username/password) and follow this procedure to configure the virtual agent (use root or sudo):
   i) Save the private key that you received with the welcome email at step 1 as file /etc/ssl/certs/netbeez.pem
   ii) Edit the configuration file /etc/netbeez/netbeez-agent.conf and replace "hostname" with your dashboard instance name
    {"host":"hostname.netbeezcloud.net", "secure_port":"20018", "interfaces":"eth0", "model":"virtual-model-ova"}
4. Restart the agent process
    sudo service nbagent_prod stop; sudo service nbagent_prod start
Raspberry Pi image
You can download and install a preconfigured NetBeez Raspbian image on a Raspberry Pi. The image has been tested on the Raspberry Pi Model B, Model B+, and Model 2.
1. Download the NetBeez Raspian image
   IMG: generic_free_rpi-model-b_0.11.2_20160302.img.zip
   MD5: generic_free_rpi-model-b_0.11.2_20160302.img.zip.md5
2. Install the NetBeez Raspbian on your Raspberry Pi on an 8 GB SD card. Instructions can be found here.
3. Once booted, login into the Raspberry Pi with username pi and password netbeez--free (two dashes).
4. Edit the configuration file /etc/netbeez/netbeez-agent.conf and replace "hostname" with your dashboard instance name
    {"host":"hostname.netbeezcloud.net", "secure_port":"20018", "interfaces":"eth0", "model":"rpi-model-b"}
5. Save the certificate that you received with the welcome email as file /etc/netbeez/netbeez-agent.pem
6. Reboot the netbeez agent process
    sudo service nbagent_prod stop
sudo service nbagent_prod start
If you are having problems, please read the FAQ at the bottom of this page or ask the community at http://community.netbeez.net

Setup NetBeez
1- Login to your dashboard by pointing your browsers to the address provided during the dashboard creation
2- Click on the Agents tab, and verify that the agents you have configured are reporting back to the dashboard
3- Click on the Targets tab, and click on the + sign to create a new target

NetBeez | Community | Documentation