Skip to content

Sites & Zones

Sites, zones, and VLANs structure the CMDB and align with how OT/IT teams think about location and segmentation.

Tenant
└── Site (optional on zone)
└── Network zone (Purdue level)
└── VLAN (L2 segment)
└── Asset (one or many VLANs)
  • Zone → Site: optional site_id on the zone.
  • VLAN → Zone: optional zone_id on the VLAN (site is derived through the zone).
  • Asset → VLANs: many-to-many via VLAN multi-select on the asset form.

A site is a physical or logical location. Assets, edge appliances, and diagrams are scoped to a site.

  1. Go to Sites (/sites).
  2. Create or open a site; set name, location, and status.

Zones represent Purdue-style levels (e.g. field, control, operations, IT/DMZ).

  1. Go to Zones (/zones).
  2. Create a zone; optionally assign a Site.
  3. VLANs and diagram hierarchy use zones as the parent of L2 segments.

VLANs document L2 segments. Assign each VLAN to a zone (recommended so site scoping and diagrams stay consistent).

  1. Go to VLANs (/vlans).
  2. Create or edit a VLAN; pick Zone, VLAN number, and optional CIDR/gateway.

On the asset form, use VLANs (multi-select) instead of a direct zone field. An asset can use several VLANs, even in different zones, as long as each VLAN’s zone belongs to the asset’s site (when the zone has a site).

Import hierarchy from a diagram’s site: presets include full stack (site, zone, VLAN, asset) or CMDB-only (VLAN + assets). Edges flow site → zone → VLAN → asset (parent to child). Assets without VLAN link directly from the site.

In the diagram editor, site, name, and description save automatically from the properties panel. Diagrams link to a site and to assets on the canvas—not to change records. Connection labels are edited with a double-click; line style is in the Connection panel. See Network Diagrams.

Site, zone, and VLAN list pages show count columns (zones, VLANs, assets) linking to filtered lists. Detail pages include tabs for related inventory at each level.

  • assets.read — view sites, zones, VLANs, and assets
  • assets.create / assets.update — manage structure and assignments