Install on Proxmox VE
Beta
The support of Proxmox VE is in beta.
Before you start
You need:
- the DC Netscope OVA, downloaded from easyvirt.com,
- Proxmox VE 8.2 or later for the import wizard (older versions can import the OVA from the command line),
- a shell access (SSH or console) to each Proxmox VE node whose traffic you want to see,
- an IP address for DC Netscope, or a DHCP network,
- these network openings:
| Flow | From | To | Port |
|---|---|---|---|
| Web interface | Your users | DC Netscope | 443/tcp |
| Inventory | DC Netscope | A Proxmox VE node | 8006/tcp |
| NetFlow (Open vSwitch bridges) | Proxmox VE nodes | DC Netscope | 9000/udp |
| sFlow (Linux bridges) | Proxmox VE nodes | DC Netscope | 10000/udp |
Which bridges do your nodes use?
How the flows are exported depends on the type of the bridges the virtual machines are connected to. In the Proxmox
VE interface, open a node, then System > Network: the Type column reads Linux Bridge or OVS Bridge.
| Bridge type | Flows | Software to install on the nodes |
|---|---|---|
OVS Bridge |
NetFlow, exported by Open vSwitch | None |
Linux Bridge (the default of Proxmox VE) |
sFlow, exported by hsflowd | hsflowd |
The SDN zones of Proxmox VE (Simple, VLAN, VXLAN, EVPN) are built on Linux bridges: use hsflowd.
Import the OVA
With the import wizard (Proxmox VE 8.2 and later)
-
Let a storage hold the files to import: open
Datacenter>Storage, edit a file-based storage (local, for instance), and addImportto itsContent. -
In the tree, select this storage under the node that will run DC Netscope, open its
Importtab, clickUploadand choose the OVA file. -
Select the uploaded OVA and click
Import. In the wizard:- pick a
VM ID, a name and the storage of the disks, - in the
Advancedtab, set the network interface on the bridge of your choice, with the modelVirtIO, - leave
Start after importunchecked.
- pick a
From the command line
Copy the OVA to the node, extract it, and import its OVF descriptor, with 150 as the identifier of the new
virtual machine and local-lvm as its storage here:
mkdir /tmp/dcnetscope && tar -xf dcnetscope.ova -C /tmp/dcnetscope
qm importovf 150 /tmp/dcnetscope/*.ovf local-lvm
qm set 150 --net0 virtio,bridge=vmbr0
Remove /tmp/dcnetscope once the import is done.
To confirm
The controller and the network card models the appliance boots with on Proxmox VE (VirtIO SCSI and VirtIO network are expected to work), and whether the import wizard keeps the disk controller of the OVA.
Do not start it yet: its settings come first.
Set the network and the administrator account
DC Netscope reads its settings from cloud-init. Proxmox VE gives them to the virtual machine through a cloud-init
drive and a snippet: a YAML file stored on a storage whose Content includes Snippets.
-
On the node, write the settings in
/var/lib/vz/snippets/dcnetscope.yml(the snippets folder of thelocalstorage):#cloud-config email: admin@example.com os_password: a-strong-password ip_mode: static static_ip: 192.168.1.50 static_netmask: 255.255.255.0 static_gateway: 192.168.1.1 dns_ip: 192.168.1.1emailandos_passwordcreate the first administrator of DC Netscope. The password is also the one of therootaccount of the virtual machine.ip_modeisdhcp,static, orcloud-initto let cloud-init configure the network itself. Thestatic_*fields are ignored indhcpmode.
-
Add a cloud-init drive to the virtual machine, and give it the snippet:
qm set 150 --ide2 local-lvm:cloudinit qm set 150 --cicustom "user=local:snippets/dcnetscope.yml"
See Appliance settings for all the settings.
To confirm
That the appliance reads a snippet given with cicustom (NoCloud datasource). Without cloud-init, write the same
settings in /etc/dcnetscope.yml from the console of the virtual machine, and reboot it: see
the manual configuration.
Start the virtual machine. After a few minutes, its console shows the address of DC Netscope: open
https://<DC Netscope address> in your browser and log in with the account you defined.
Create an account for DC Netscope
DC Netscope reads the inventory (nodes, virtual machines, containers, networks, tags and pools) with the API of Proxmox VE. An API token of a read-only user is recommended. On one node of the cluster:
-
Create a role with the rights DC Netscope needs, and a user holding this role on the whole cluster:
pveum role add DCNetscope --privs "Sys.Audit,VM.Audit,VM.Monitor,SDN.Audit,Pool.Audit,Datastore.Audit" pveum user add dcnetscope@pve pveum acl modify / --users dcnetscope@pve --roles DCNetscope -
Create an API token for this user.
--privsep 0gives the token the rights of the user:pveum user token add dcnetscope@pve netscope --privsep 0Write down the
valueit prints: it is the secret of the token, and is shown only once.
To confirm
VM.Monitor lets DC Netscope ask the QEMU guest agent for the IP addresses of the virtual machines on
Proxmox VE 8. Proxmox VE 9 replaces it with finer rights (VM.GuestAgent.*): the list of rights depends on the
version.
The IP addresses of the virtual machines
DC Netscope names a flow after the virtual machine owning its IP address. Proxmox VE knows the addresses of the
containers, but the ones of a virtual machine only when the QEMU guest agent is installed in it and enabled
in its Options (or when its address is static, set by cloud-init). The flows of the other virtual machines
show IP addresses, which you can name in the External IPs view.
Connect Proxmox VE
-
Open the administration interface, and go to the
Servicestab.
-
In
Connected infrastructures, chooseProxmox VE (beta), and type the address of a node (pve1.example.com, orpve1.example.com:8006). Then:- with an API token, type
dcnetscope@pve!netscopeas the user (the user,!, and the name of the token), and the secret of the token as the password, - with a user and a password, type the user with its realm (
root@pam,dcnetscope@pve): without a realm, DC Netscope uses@pam.
Click
Add a new connector. - with an API token, type
-
Check that the status of Proxmox VE is green.
One connector covers a whole cluster: any of its nodes answers for the others.
Send the flows of the nodes
Proxmox VE has no central setting for the export of flows: it is set on each node, from its shell. Follow the tab of the type of your bridges.
OVS bridges: NetFlow from Open vSwitch
Open vSwitch exports NetFlow natively, as on XCP-ng.
-
List the bridges of the node, and spot the ones carrying the traffic of your virtual machines (
vmbr0here):ovs-vsctl showThe
tapports are the network interfaces of the virtual machines (tap101i0: the first interface of the virtual machine101), thevethports the ones of the containers. -
Send the flows of the bridge to DC Netscope,
192.168.1.50here:ovs-vsctl -- --id=@nf create NetFlow \ targets=\"192.168.1.50:9000\" \ active_timeout=60 \ add_id_to_interface=true \ -- set Bridge vmbr0 netflow=@nftargets: the address of DC Netscope and the port of its NetFlow collector,active_timeout: how often, in seconds, the flows still open are exported,add_id_to_interface: adds the identifier of the interface to the exported flows.
-
Check the export:
ovs-vsctl list netflowThe
targetsline should read["192.168.1.50:9000"].
Repeat for every bridge and every node.
Keep the export after a reboot
Open vSwitch forgets this setting when the node reboots, and when the network configuration is applied
again from the Proxmox VE interface. Run the command from a systemd service started after the network,
for instance /etc/systemd/system/dcnetscope-netflow.service:
[Unit]
Description=NetFlow export of Open vSwitch towards DC Netscope
After=network-online.target openvswitch-switch.service
Wants=network-online.target
[Service]
Type=oneshot
RemainAfterExit=yes
ExecStart=/usr/bin/ovs-vsctl -- --id=@nf create NetFlow targets=\"192.168.1.50:9000\" active_timeout=60 add_id_to_interface=true -- set Bridge vmbr0 netflow=@nf
[Install]
WantedBy=multi-user.target
and enable it with systemctl enable --now dcnetscope-netflow.service.
To confirm
Whether an ovs_extra line on the bridge in /etc/network/interfaces keeps the export across a network
reload, which would avoid the service.
Linux bridges: sFlow from hsflowd
The Linux bridge exports no flows by itself. hsflowd (Host sFlow) is a small agent that samples the packets of the network interfaces of the node and sends them to DC Netscope in sFlow.
Activate the sFlow collector first
The sFlow collector of DC Netscope does not run by default: in the
appliance settings, set Sflow Collector workers count to 1 or more. It listens
on 10000/udp.
-
Install hsflowd on the node. Download the Debian package matching the version of Proxmox VE (Debian 12 for Proxmox VE 8, Debian 13 for Proxmox VE 9) from the releases of host-sflow, then:
apt install ./hsflowd-debian12_<version>_amd64.deb -
Write its settings in
/etc/hsflowd.conf, with DC Netscope at192.168.1.50here:sflow { sampling = 256 sampling.10G = 256 polling = 30 collector { ip = 192.168.1.50 udpport = 10000 } psample { group = 1 egress = off } dent { sw = on switchport = ^(tap|veth)[0-9]+i[0-9]+$ } }sampling: one packet out of 256 is sampled. Lower it on a quiet node to see more of the small flows, raise it on a busy one to spare its CPU.samplingonly applies to the interfaces of unknown speed: thetapinterfaces report 10 Gb/s, and hsflowd gives them its own default of one packet out of 10000 unlesssampling.10Gis set,collector: the address of DC Netscope and the port of its sFlow collector,dent: samples the interfaces whose name matchesswitchport: thetapinterfaces of the virtual machines and thevethinterfaces of the containers. The interfaces of the virtual machines started later are sampled too.sw = onsamples in software: withsw = off, hsflowd asks for a sampling in hardware, which thetapinterfaces do not support, and no flow is exported.
-
Start hsflowd, and have it started with the node:
systemctl enable --now hsflowd
Repeat on every node.
Why the interfaces of the virtual machines, and not the bridge
Sampling vmbr0 itself shows mostly the traffic of the node: the traffic between two virtual machines of
the same node goes from one tap interface to the other without crossing it. Sampling the packets each
virtual machine sends (egress = off) sees every flow once, including the ones that never leave the node.
To confirm
This setup was validated with the virtual machines of a Proxmox VE 9.2 node and hsflowd 2.1.17, including a
virtual machine with the firewall of Proxmox VE enabled: its tap interface is sampled, the fwbr, fwpr
and fwln interfaces are left out by switchport. The veth interfaces of the containers remain to be
validated.
Note
The firewall of DC Netscope, the firewall of the nodes, and the ones between the nodes and DC Netscope must let
9000/udp (NetFlow) or 10000/udp (sFlow) through.
Your physical switches can also send their flows, as a complement or as a start before installing anything on the nodes: see Network devices. They see only the traffic between the nodes, and with the VXLAN or EVPN zones of the SDN, this traffic is encapsulated.
Check that the flows arrive
Open the Dashboard. Within a few minutes, the collect summary shows the traffic received from the nodes, and the flows of your virtual machines appear with their names.

Nothing shows up? Check that:
9000/udpor10000/udpis open from the nodes to DC Netscope,- with Open vSwitch,
ovs-vsctl list netflowshows the export on the nodes (a rebooted node may have lost it), - with hsflowd,
systemctl status hsflowdshows it running, andSflow Collector workers countis1or more, - with hsflowd,
tc -s filter show dev tap<vmid>i0 ingresson a node shows asampleaction with the expected rate (1/256, not1/10000), andjournalctl -u hsflowdshows nosetRate(...) exitStatus=2. Without them, hsflowd sends only counters, and no flow appears,
and have a look at the troubleshooting page.
Flows appear with IP addresses instead of names? Their virtual machines probably have no QEMU guest agent: see the IP addresses of the virtual machines.
Next steps
- Activate your license: a 15 days trial license is active from the installation.
- Manage the users, or connect your Active Directory.
- Group your applications to read the flows between them: the tags and the pools of Proxmox VE are already imported as categories.