[{"data":1,"prerenderedAt":418},["ShallowReactive",2],{"docs-discovery-matching-devices-":3,"docs-navigation":274},{"id":4,"title":5,"body":6,"dateModified":264,"datePublished":264,"description":265,"extension":266,"meta":267,"navigation":268,"path":269,"proficiencyLevel":270,"seo":271,"stem":272,"__hash__":273},"docs\u002Fdocs\u002F3.discovery\u002F6.matching-devices.md","Matching Devices",{"type":7,"value":8,"toc":254},"minimark",[9,13,17,22,25,28,31,35,38,93,97,114,117,214,218,224,230,233,237,240,244],[10,11,5],"h1",{"id":12},"matching-devices",[14,15,16],"p",{},"Every time Open-AudIT discovers or imports a device, it needs to decide: is this something I've already seen, or is it new? This process is called device matching, and understanding how it works helps you avoid duplicate records and missing devices.",[18,19,21],"h2",{"id":20},"how-matching-works","How Matching Works",[14,23,24],{},"Open-AudIT checks a series of properties against existing records in the database. The rules operate as OR conditions — if any single rule finds a match, Open-AudIT treats the incoming data as belonging to that existing device.",[14,26,27],{},"If all rules fail, the device is treated as new and a new record is created.",[14,29,30],{},"Devices with a status of \"deleted\" are excluded from matching.",[18,32,34],{"id":33},"match-order","Match Order",[14,36,37],{},"Matching is checked in this order:",[39,40,41,45,48,51,54,57,60,63,66,69,72,75,78,81,84,87,90],"ol",{},[42,43,44],"li",{},"Opmantek UUID (internal identifier, not configurable)",[42,46,47],{},"Google Cloud ID (not configurable)",[42,49,50],{},"Hostname + UUID combination",[42,52,53],{},"Hostname + D-Bus ID (Linux only)",[42,55,56],{},"Hostname + Serial",[42,58,59],{},"D-Bus ID alone",[42,61,62],{},"DNS FQDN",[42,64,65],{},"DNS Hostname",[42,67,68],{},"FQDN",[42,70,71],{},"Serial + Type",[42,73,74],{},"Serial alone",[42,76,77],{},"SNMP sysName + Serial",[42,79,80],{},"SNMP sysName",[42,82,83],{},"MAC address (from multiple tables)",[42,85,86],{},"IP address",[42,88,89],{},"Hostname",[42,91,92],{},"IP address (for devices with no other data)",[18,94,96],{"id":95},"configuring-match-rules","Configuring Match Rules",[14,98,99,100,104,105,109,110,113],{},"Most match rules can be turned on or off. Find them under ",[101,102,103],"strong",{},"Menu → Admin → Configuration"," (search for ",[106,107,108],"code",{},"match_",") or via ",[101,111,112],{},"Menu → Discover → Discoveries → Discovery Match Options",".",[14,115,116],{},"Key defaults to be aware of:",[118,119,120,136],"table",{},[121,122,123],"thead",{},[124,125,126,130,133],"tr",{},[127,128,129],"th",{},"Rule",[127,131,132],{},"Default",[127,134,135],{},"Notes",[137,138,139,153,165,177,190,202],"tbody",{},[124,140,141,147,150],{},[142,143,144],"td",{},[106,145,146],{},"match_hostname",[142,148,149],{},"Yes",[142,151,152],{},"Good in most cases; may cause issues on networks with duplicate hostnames",[124,154,155,160,162],{},[142,156,157],{},[106,158,159],{},"match_mac",[142,161,149],{},[142,163,164],{},"MAC addresses are generally unique, but VMware workstations can share MACs",[124,166,167,172,174],{},[142,168,169],{},[106,170,171],{},"match_serial",[142,173,149],{},[142,175,176],{},"Very reliable — serials are hardware-assigned",[124,178,179,184,187],{},[142,180,181],{},[106,182,183],{},"match_ip",[142,185,186],{},"No",[142,188,189],{},"DHCP makes IP-only matching unreliable",[124,191,192,197,199],{},[142,193,194],{},[106,195,196],{},"match_dbus",[142,198,186],{},[142,200,201],{},"ESXi clones don't regenerate the D-Bus ID, causing false matches",[124,203,204,209,211],{},[142,205,206],{},[106,207,208],{},"match_ip_no_data",[142,210,149],{},[142,212,213],{},"If a device has almost no data and its IP matches, assume it's the same device",[18,215,217],{"id":216},"duplicate-and-missing-devices","Duplicate and Missing Devices",[14,219,220,223],{},[101,221,222],{},"Duplicate devices"," happen when none of the match rules fire for a real existing device — Open-AudIT creates a new record instead of updating the old one. This is common after VM cloning (where identifiers may be duplicated) or when scanning the same device from different subnets.",[14,225,226,229],{},[101,227,228],{},"Missing devices"," (or overwritten devices) happen when a match rule fires incorrectly — Open-AudIT updates the wrong existing record. VM cloning is again the culprit here; a cloned ESXi guest may share a D-Bus ID with its source, causing the source device's record to be overwritten.",[14,231,232],{},"If you're seeing duplicates or missing devices, check the Discovery Log for the affected device to see which field triggered the match. Then review your match rule configuration.",[18,234,236],{"id":235},"enterprise-per-discovery-match-rules","Enterprise: Per-Discovery Match Rules",[14,238,239],{},"If you're running Open-AudIT Enterprise, you can set match rules on a per-discovery basis, overriding the global defaults for specific subnets or environments.",[18,241,243],{"id":242},"using-orgid-in-matching","Using OrgID in Matching",[14,245,246,247,113],{},"From v4.3.4 onwards, you can include a device's Organization ID as part of the match criteria. This is useful when you're auditing multiple customer networks that might share the same hostnames or IP ranges. See the wiki for details on ",[248,249,253],"a",{"href":250,"rel":251},"https:\u002F\u002Fdocs.community.firstwave.com\u002Fwiki\u002Fspaces\u002FOA\u002Fpages\u002F3163952015\u002FMatching+Devices+-+Including+OrgID",[252],"nofollow","Matching Devices - Including OrgID",{"title":255,"searchDepth":256,"depth":256,"links":257},"",2,[258,259,260,261,262,263],{"id":20,"depth":256,"text":21},{"id":33,"depth":256,"text":34},{"id":95,"depth":256,"text":96},{"id":216,"depth":256,"text":217},{"id":235,"depth":256,"text":236},{"id":242,"depth":256,"text":243},"2026-04-10","How Open-AudIT decides whether a discovered device is new or already exists in the database, and how to configure match rules to avoid duplicates.","md",{},{"title":5},"\u002Fdocs\u002Fdiscovery\u002Fmatching-devices","Intermediate",{"title":5,"description":265},"docs\u002F3.discovery\u002F6.matching-devices","0EUDIGAUyoPvdZcDaydy6wcLrMXsh8SRqMEFy6jSfdE",[275],{"title":276,"path":277,"stem":278,"children":279},"Docs","\u002Fdocs","docs",[280,284,296,318,345,367,374,396,413],{"title":281,"path":277,"stem":282,"description":283},"Overview","docs\u002Findex","Guides to help you install, configure, and get the most out of Open-AudIT — a powerful network discovery, audit, and asset tracking system.",{"title":285,"path":286,"stem":287,"children":288,"description":290},"Getting Started","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started\u002F1.index",[289,291],{"title":285,"path":286,"stem":287,"description":290},"Get from a fresh install to discovering devices on your network in under 10 minutes. This guide walks through each step in order.",{"title":292,"path":293,"stem":294,"description":295},"Activating Your License","\u002Fdocs\u002Fgetting-started\u002Factivating-your-license","docs\u002F1.getting-started\u002F2.activating-your-license","How to activate your free 100-device Open-AudIT Enterprise license after installation.",{"title":297,"path":298,"stem":299,"children":300,"description":302},"Installation","\u002Fdocs\u002Finstallation","docs\u002F2.installation\u002F1.index",[301,303,308,313],{"title":297,"path":298,"stem":299,"description":302},"Install or upgrade Open-AudIT on Windows Server or Linux. Includes virtual appliance option for the fastest setup.",{"title":304,"path":305,"stem":306,"description":307},"Server Requirements","\u002Fdocs\u002Finstallation\u002Fserver-requirements","docs\u002F2.installation\u002F2.server-requirements","Hardware, operating system, browser, and dependency requirements for running Open-AudIT.",{"title":309,"path":310,"stem":311,"description":312},"Install on Linux","\u002Fdocs\u002Finstallation\u002Finstall-linux","docs\u002F2.installation\u002F3.install-linux","Step-by-step guide to installing Open-AudIT on supported Linux distributions including Red Hat, Rocky Linux, Debian, and Ubuntu.",{"title":314,"path":315,"stem":316,"description":317},"Install on Windows","\u002Fdocs\u002Finstallation\u002Finstall-windows","docs\u002F2.installation\u002F4.install-windows","Step-by-step guide to installing Open-AudIT on Windows Server, including Nmap and Visual C++ prerequisites.",{"title":281,"path":319,"stem":320,"children":321,"description":323},"\u002Fdocs\u002Fdiscovery","docs\u002F3.discovery\u002F1.index",[322,324,329,334,339,344],{"title":281,"path":319,"stem":320,"description":323},"Discovery is how Open-AudIT finds and audits devices on your network. Learn about credentials, running scans, discovery types, and how it all works under the hood.",{"title":325,"path":326,"stem":327,"description":328},"Credentials","\u002Fdocs\u002Fdiscovery\u002Fcredentials","docs\u002F3.discovery\u002F2.credentials","Learn how to create and manage the credential sets Open-AudIT uses to authenticate with devices during network discovery.",{"title":330,"path":331,"stem":332,"description":333},"Running a Discovery","\u002Fdocs\u002Fdiscovery\u002Frunning-a-discovery","docs\u002F3.discovery\u002F3.running-a-discovery","Step-by-step guide to creating and running your first network discovery in Open-AudIT, including advanced options and scheduling.",{"title":335,"path":336,"stem":337,"description":338},"Discovery Types","\u002Fdocs\u002Fdiscovery\u002Fdiscovery-types","docs\u002F3.discovery\u002F4.discovery-types","Open-AudIT supports Subnet, Active Directory, and Seed discovery types. Learn when to use each and how they work.",{"title":340,"path":341,"stem":342,"description":343},"How It Works","\u002Fdocs\u002Fdiscovery\u002Fhow-discovery-works","docs\u002F3.discovery\u002F5.how-discovery-works","A detailed look at what Open-AudIT does during a discovery — from Nmap scanning through credential testing, audit script execution, and data processing.",{"title":5,"path":269,"stem":272,"description":265},{"title":346,"path":347,"stem":348,"children":349,"description":351},"Reporting","\u002Fdocs\u002Freporting","docs\u002F4.reporting\u002F1.index",[350,352,357,362],{"title":346,"path":347,"stem":348,"description":351},"Open-AudIT gives you multiple ways to pull meaningful information out of collected data using Queries, Summaries, and Reports.",{"title":353,"path":354,"stem":355,"description":356},"Queries, Summaries & Reports","\u002Fdocs\u002Freporting\u002Fqueries-summaries-reports","docs\u002F4.reporting\u002F2.queries-summaries-reports","Understand the three types of reporting in Open-AudIT — Queries, Summaries, and Reports — how they differ, and how to use filters and permissions.",{"title":358,"path":359,"stem":360,"description":361},"Creating a Query","\u002Fdocs\u002Freporting\u002Fcreating-a-query","docs\u002F4.reporting\u002F3.creating-a-query","Learn how to write custom SQL queries in Open-AudIT to extract device information, with examples for common use cases like warranty tracking and open ports.",{"title":363,"path":364,"stem":365,"description":366},"Groups","\u002Fdocs\u002Freporting\u002Fgroups","docs\u002F4.reporting\u002F4.groups","Learn how to use Groups in Open-AudIT to create dynamic collections of devices for filtering reports, building dashboards, and baselining configurations.",{"title":368,"path":369,"stem":370,"children":371,"description":373},"Dashboards","\u002Fdocs\u002Fdashboards","docs\u002F5.dashboards\u002F1.index",[372],{"title":368,"path":369,"stem":370,"description":373},"Configure and customise Open-AudIT dashboards and widgets to create at-a-glance visual overviews of your network environment.",{"title":375,"path":376,"stem":377,"children":378,"description":380},"Administration","\u002Fdocs\u002Fadministration","docs\u002F6.administration\u002F1.index",[379,381,386,391],{"title":375,"path":376,"stem":377,"description":380},"Covers the ongoing administration of Open-AudIT including configuration, user management, permissions, and backup procedures.",{"title":382,"path":383,"stem":384,"description":385},"Configuration","\u002Fdocs\u002Fadministration\u002Fconfiguration","docs\u002F6.administration\u002F2.configuration","Key configuration settings in Open-AudIT covering discovery behaviour, change logging, data retention, and how to edit them.",{"title":387,"path":388,"stem":389,"description":390},"Users, Roles & Orgs","\u002Fdocs\u002Fadministration\u002Fusers-roles-orgs","docs\u002F6.administration\u002F3.users-roles-orgs","Understand Open-AudIT's role-based access control system including users, roles, organisations, LDAP integration, and permission inheritance.",{"title":392,"path":393,"stem":394,"description":395},"Backup & Restore","\u002Fdocs\u002Fadministration\u002Fbackup-restore","docs\u002F6.administration\u002F4.backup-restore","How to back up and restore your Open-AudIT database on Linux and Windows, including database reset procedures.",{"title":397,"path":398,"stem":399,"children":400,"description":402},"Troubleshooting","\u002Fdocs\u002Ftroubleshooting","docs\u002F7.troubleshooting\u002F1.index",[401,403,408],{"title":397,"path":398,"stem":399,"description":402},"General troubleshooting guidance for Open-AudIT covering discovery problems, common errors, and first steps for diagnosing issues.",{"title":404,"path":405,"stem":406,"description":407},"Common Errors","\u002Fdocs\u002Ftroubleshooting\u002Fcommon-errors","docs\u002F7.troubleshooting\u002F2.common-errors","Explanations and solutions for common Open-AudIT error messages including MySQL lock errors, LDAP issues, Apache problems, and license screens.",{"title":409,"path":410,"stem":411,"description":412},"Discovery Problems","\u002Fdocs\u002Ftroubleshooting\u002Fdiscovery-problems","docs\u002F7.troubleshooting\u002F3.discovery-problems","Troubleshoot Open-AudIT discovery issues including devices not found, duplicate records, Nmap problems, stuck queues, and cross-platform auditing.",{"title":414,"path":415,"stem":416,"description":417},"Release Notes","\u002Fdocs\u002Frelease-notes","docs\u002Frelease-notes","What's new in each Open-AudIT release — features, fixes, and improvements.",1779233238468]