BQN Documentation
BQN Documentation

Overview

How to Update the Software

The update of a bqn package (e.g.,bqn-R4.0.24.bpkg) consists of two steps: first it is installed and then it is activated. The activation involves a traffic interruption of some seconds, so it is advisable to carry it out at times of low throughput.

The installation is performed in Administration->Software, clicking on the ⁝ menu icon and selecting Install… A file selector pops up to choose the package, that it is transferred to the BQN server and installed.

The activation is done in Administration->Software clicking on the ↶ arrow icon of the package to activate (highlighted in red in the picture below).

This operation forces you to log back into the BQN after a few seconds, during which time, the traffic flow is interrupted.

How to Generate a Diagnostic

When requested by Bequant support, a diagnostic file can be generated in Administration->Diagnostic.

The file will be placed in the download folder of the browser being used.

How to Back up the Configuration

You can save the server configuration to a local file in Administration->Backup->Save.

To restore it, pick a previous backup file in option Administration->Backup->Load.

It is strongly recommended that you load the configuration always without overwriting management address and wire configuration, so the interface configuration is not lost when transferring configuration from one BQN server to another.

Monitoring with SNMP

The BQN supports the following SNMP v2c alarms (traps):

  • Cpu: excessive server CPU load.
  • Memory-dpdk: excessive memory usage in DPDK packet processing.
  • Memory-pool: excessive memory usage in BQN general memory pool.
  • Disk: file system full or almost full.
  • Process: some mandatory processes down.
  • Traffic-uplink: no traffic in the uplink direction.
  • Traffic-downlink: no traffic in the downlink direction.
  • Traffic-low: low traffic (uplink and downlink directions combined).
  • Traffic-inverted: uplink throughput higher than downlink throughput (possibly because some wires are inverted, with access port connected to the Internet and vice versa).
  • Wire: no wires configured or some wires down.
  • License-available: no license defined or license invalid.
  • License-expiration: license has expired.
  • License-usage: server throughput is above the license capacity.
  • Time: no NTP server configured or not reachable.
  • Bqnmgr: BQN remote management system not reachable.

These alarms are related to the dashboard shown in BQN homepage. See the Troubleshooting section for more information.

To configure the SNMP agent, go to Administration->SNMP:

The BQN SNMP also exports some system statistics. To get the BQN MIB files, contact Bequant support.

Traffic Captures

To capture traffic passing through a network interface, connect to the system shell using ssh and invoke the system interface capture command.

Packet capture functionality can impact the performance of the system. Use it in a targeted fashion, knowing the traffic you are looking for and when generating captures to disk, make sure you define a small size limit that does not compromise the system.

The following example captures three packets from interface en0p0s8:

 
$ ssh bqnadm@192.168.0.121
bqnadm@bqn0# system interface en0p0s8 capture 3
17:48:06.147 OUT FrameLen:84 IPv4 116.48.111.46:443 172.10.1.23:62837 IpLen:70 Frags:0x4000 . . . 
17:48:06.149 IN FrameLen:71 IPv4 172.10.1.23:62837 116.48.111.46:443 IpLen:57 Frags:0x4000 . . . 
17:48:06.450 IN FrameLen:60 IPv4 172.10.1.23:57435 153.154.50.95:443 IpLen:41 Frags:0x4000 . . 

If no number of packets is specified, the capture continues until you stop it pressing C. This command accepts a filter to capture only part of the traffic. The capture filter uses the PCAP filter expression syntax, which is commonly used by the tcpdump program. For example, to capture traffic involving IP address 10.10.1.2:


bqnadm@bqn0# system interface en0p0s8 capture filter "host 10.10.1.2"

If there are VLAN or PPPoE, you need to specify it in the filter to apply layer-3 parameters such as host. For example ,in traffic with both VLAN and PPPoE:


bqnadm@bqn0# system interface en0p0s8 capture filter "pppoes and vlan and host 10.10.1.2" 

This command can store the captures in a file with PCAP format. For example, to store 10 MB of traffic involving IP10.10.10.10:


bqnadm@bqn0# system interface en0p0s8 capture filter "host 10.10.10.10" file myfile.pcap 10 

The file will be generated in the user homedirectory and can be retrieved from another server using scp:


PS C:\Users\myname> scp bqnadm@192.168.0.121:myfile.pcap . 

previous
NEXT