DocsUse Devexana

Network views: campus map and switch faceplate

Devexana builds the campus map and the switch faceplate from maintained files and source records. This page explains what each view shows, which records it uses and its limits.

Available
Campus map from the site file your team maintains
Available
Links between switches from LLDP and CDP neighbour data
In production use
Access points and phones inferred from LLDP data
Available
Switch faceplate and port trace
Off by default
Live map background in the campus view
On this page

The views combine files that your team maintains with records from source reads. The table below identifies the inputs.

Diagram: your site file, LLDP and CDP neighbours, interface reads and your port map feed the campus map and the switch faceplate
Selected inputs and the views they supply. The table below lists additional inputs. Lines between switches represent logical links. Open full size

Where each element comes from

Each displayed element comes from a maintained file, a source read or an inference.

Drawn elementSourceKind
Buildings and closets on the campus mapYour site file (sites.json) and campus file (campus.json). Your team enters plan positions, rooms and jacksEntered by your team
Building placement that Devexana derives from a switch nameA draft. It stays a draft until a person confirms itInferred, needs confirmation
Map image or schematic behind the campus mapYou prepare it on another computer before you load itSupplied by your team
Lines between switches on the campus mapLLDP and CDP neighbour tables that the switches report. Devexana sorts each line as inter-building, riser, intra-building or unplacedRead from switches, logical
Access points and phonesDevexana infers them from the LLDP data that switches report. A person approves each inferred deviceInferred, needs approval
Ports on the switch faceplateInterface reads (port state, PoE class, VLANs), your port map, the devices seen on each port (MAC address and host), and stored configuration versionsRead from switches and entered by your team
Port traceDevexana follows neighbour links from port to portRead from switches

Campus map

The campus map places buildings and closets from the site file your team maintains. It draws the switch-to-switch links between buildings that the switches report, and labels them as observed links, not cable routes.

The Campus view in the dark theme, under the heading Devices / Campus, with the line buildings: 4 · between buildings: 4. A schematic shows four public landmarks: White House, Union Station, U.S. Capitol, and Smithsonian Castle marked draft placement. Link lines join the buildings. The U.S. Capitol to White House line has a warning marker, and the line to Smithsonian Castle is dashed. A Connections panel, headed Observed adjacencies, not surveyed cable routes, lists four links between buildings. U.S. Capitol to White House shows 2 strands, 10 Gbit/s and optic alarm. The other three links show observed, and Smithsonian Castle to White House shows 1 strand draft. The footer reads Public landmarks · fictional network.
The campus map. Each line and each Connections row is a logical link that the switches report. The dashed line goes to a building with a draft placement. Public landmarks, fictional network. Open full size

The header counts the buildings and the links between buildings.

  • Placement drafts. When Devexana places a building from a switch name, the placement is a draft. Confirm or move each draft in the sites editor before you rely on it.
  • What "fiber" means. The word "fiber" in the campus view means inter-building links, plus optics facts where a read returns them. It is not a record of fiber strands.
  • Connections list. The list beside the map names each pair of joined buildings, with its strand count and speed. Each switch-to-switch link that the switches report counts as one "strand". This is a count of logical links, not a count of fiber strands. Links inside one building have their own row.
  • Link details. A link card shows the speed, the VLANs and the optics facts that the reads returned. If a source read reports an optical alarm, the map marks the link and the Connections list shows optic alarm.
  • Freshness. If a neighbour table is older than 24 hours, the view marks the link as stale.

Only an administrator can edit sites. Each edit writes a record to the audit log. To confirm a draft placement, do these steps:

  1. Open Networking › Devices › Campus.
  2. Find the building that shows as a draft.
  3. Compare its position with your own site records.
  4. If the position matches your site records, confirm the placement.
  5. If the position is incorrect, move the building to the correct position.

Switch faceplate

The switch faceplate combines the port state that the switch reports, your port map, the devices seen on each port, and VLANs.

A switch faceplate for a 24-port switch with four SFP ports: Link, Speed, PoE and VLAN tabs, each port drawn by state, VLAN bands above and below the ports, and a state legend
A switch faceplate on the Link tab. The bands show the VLAN of each group of ports. Fictional sample data. Open full size
  • Reachability. The view states whether the switch is reachable, stale or unreachable now. This is the current state, not a history.
  • No read method. If no read method reaches a switch, the faceplate still opens. It marks the switch as not reachable and shows the ports from your port map. See A switch is listed but not read.
  • Backup-only switches. A switch known only from a configuration backup shows no port status.
  • Port trace. The port trace follows neighbour links from a port to the next switch.

To trace a port, do these steps:

  1. Select a port.
  2. Start the port trace to follow neighbour links to the next switch.

What depends on the read method

What a view can show depends on how Devexana reads each switch. Switches over SSH and SNMP explains each read method.

Read methodWhat it adds to the views
SNMPPort state, PoE class, VLANs, and LLDP and CDP neighbours
SSH, default command setThe running configuration, read once a day
SSH, wider command setNeighbours, PoE power, MAC and ARP tables and optics. This command set is a setting on the appliance and is off by default
NAPALMError counters and CPU load
Your port map (CSV)Port labels and the person or room on each port. See Import files, port maps and DHCP leases

Limits

Applies to Devexana release 0.3.182. Page updated 2026-10-20. Questions or corrections: support@devexana.com.