Reference Data

GridNMS ships with platform-curated reference data — a MAC address vendor registry and a well-known-ports registry — delivered through Data Feeds. Reference Data is where you add your own entries on top of that, for the cases the standard registry gets wrong or doesn’t cover: a locally-assigned MAC prefix, a custom port your own software uses, or a name you’d rather see than the standard one.

Open it from Configure → System Configuration → Reference Data.

How overrides work

An override doesn’t replace the built-in registry — it shadows one entry in it. You give GridNMS a key (a MAC prefix, or a port and protocol) and the value you want GridNMS to show instead. Wherever that key would normally be looked up, your value wins; everything else in the registry is untouched. Remove the override and the built-in value applies again.

The page has one tab per dataset:

MAC Vendors

Overrides the vendor GridNMS shows for a device based on its MAC address.

• MAC Prefix — 6–12 hex digits (the OUI portion of a MAC address). Separators are optional. If you have overrides at different prefix lengths that could both match one address, the longest prefix wins.
• Vendor — the name to show instead.

Well-known Ports

Overrides the service name and category GridNMS shows for a port wherever it labels a discovered service — for example during Network Discovery.

• Port and Protocol (TCP or UDP) — matched exactly.
• Name — shown in place of the standard name.
• Category — one of web, database, management, mail, network, or file; drives the colour badge shown next to that service on the Applications page.

Adding, editing, and removing an override

• Click Add Override, fill in the fields, and save. As you fill in the key fields, the dialog shows you the canonical (built-in) value that key would otherwise resolve to — or tells you there isn’t one — so you can see exactly what you’re changing.
• Click any row to edit it.
• Click the trash icon on a row, then confirm, to remove an override. The canonical value (if any) applies again immediately.
• Use the search box to filter the current dataset’s overrides.

Each tab’s header shows which built-in dataset it’s shadowing, its current version and row count (from Data Feeds), and whether matching is by longest prefix or exact match. The Data Feeds link jumps to that page so you can check for or activate a newer version of the underlying registry.

Where to go next

• Data Feeds — status and versioning of the built-in registries these overrides shadow.
• Devices & Inventory — where the vendor GridNMS identifies from a device’s MAC address shows up.
• Network Discovery — where port-based service identification shows up while scanning your network.