[{"data":1,"prerenderedAt":258},["ShallowReactive",2],{"docs-troubleshooting-":3,"docs-navigation":116},{"id":4,"title":5,"body":6,"dateModified":106,"datePublished":106,"description":107,"extension":108,"meta":109,"navigation":110,"path":111,"proficiencyLevel":112,"seo":113,"stem":114,"__hash__":115},"docs\u002Fdocs\u002F7.troubleshooting\u002F1.index.md","Troubleshooting Open-AudIT",{"type":7,"value":8,"toc":100},"minimark",[9,14,18,23,42,46,49],[10,11,13],"h1",{"id":12},"troubleshooting","Troubleshooting",[15,16,17],"p",{},"Open-AudIT works out of the box, but every network is different. This section covers the problems you're most likely to hit and how to work through them.",[19,20,22],"h2",{"id":21},"in-this-section","In This Section",[24,25,26,35],"ul",{},[27,28,29,34],"li",{},[30,31,33],"a",{"href":32},"\u002Fdocs\u002Ftroubleshooting\u002Fdiscovery-problems\u002F","Discovery Problems"," — Can't find devices, limited data returning, duplicate records",[27,36,37,41],{},[30,38,40],{"href":39},"\u002Fdocs\u002Ftroubleshooting\u002Fcommon-errors\u002F","Common Errors"," — Specific error messages and what they mean",[19,43,45],{"id":44},"first-steps-for-any-problem","First Steps for Any Problem",[15,47,48],{},"Before diving into specific issues, these general steps resolve a surprising number of problems:",[50,51,52,68,81,87],"ol",{},[27,53,54,58,59,62,63,67],{},[55,56,57],"strong",{},"Check the Discovery Log."," Navigate to ",[55,60,61],{},"Menu → Admin → Database → List Tables",", find ",[64,65,66],"code",{},"discovery_log",", and export to CSV. Search for your device's IP address and review the entries.",[27,69,70,73,74,62,77,80],{},[55,71,72],{},"Increase the log level."," Go to ",[55,75,76],{},"Menu → Admin → Configuration → All",[64,78,79],{},"log_level"," (default 5), and set it to 7. Re-run the discovery. The additional detail often makes the problem obvious.",[27,82,83,86],{},[55,84,85],{},"Test with a single device."," If a subnet scan is failing, try scanning a single known IP first. This isolates the problem to one device and makes the logs much easier to read.",[27,88,89,92,93,99],{},[55,90,91],{},"Check target device configuration."," Make sure the target device has the necessary ports open and services enabled. See ",[30,94,98],{"href":95,"rel":96},"https:\u002F\u002Fdocs.community.firstwave.com\u002Fwiki\u002Fspaces\u002FOA\u002Fpages\u002F3163947185\u002FConfiguration",[97],"nofollow","Target Client Configuration"," on the wiki.",{"title":101,"searchDepth":102,"depth":102,"links":103},"",2,[104,105],{"id":21,"depth":102,"text":22},{"id":44,"depth":102,"text":45},"2026-04-10","General troubleshooting guidance for Open-AudIT covering discovery problems, common errors, and first steps for diagnosing issues.","md",{},{"title":13},"\u002Fdocs\u002Ftroubleshooting","Intermediate",{"title":5,"description":107},"docs\u002F7.troubleshooting\u002F1.index","8HbqTZmW0AXE7PxE3a99jVG27-fwr0lB3DMJHAosdQE",[117],{"title":118,"path":119,"stem":120,"children":121},"Docs","\u002Fdocs","docs",[122,126,138,160,191,213,220,242,253],{"title":123,"path":119,"stem":124,"description":125},"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":127,"path":128,"stem":129,"children":130,"description":132},"Getting Started","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started\u002F1.index",[131,133],{"title":127,"path":128,"stem":129,"description":132},"Get from a fresh install to discovering devices on your network in under 10 minutes. This guide walks through each step in order.",{"title":134,"path":135,"stem":136,"description":137},"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":139,"path":140,"stem":141,"children":142,"description":144},"Installation","\u002Fdocs\u002Finstallation","docs\u002F2.installation\u002F1.index",[143,145,150,155],{"title":139,"path":140,"stem":141,"description":144},"Install or upgrade Open-AudIT on Windows Server or Linux. Includes virtual appliance option for the fastest setup.",{"title":146,"path":147,"stem":148,"description":149},"Server Requirements","\u002Fdocs\u002Finstallation\u002Fserver-requirements","docs\u002F2.installation\u002F2.server-requirements","Hardware, operating system, browser, and dependency requirements for running Open-AudIT.",{"title":151,"path":152,"stem":153,"description":154},"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":156,"path":157,"stem":158,"description":159},"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":123,"path":161,"stem":162,"children":163,"description":165},"\u002Fdocs\u002Fdiscovery","docs\u002F3.discovery\u002F1.index",[164,166,171,176,181,186],{"title":123,"path":161,"stem":162,"description":165},"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":167,"path":168,"stem":169,"description":170},"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":172,"path":173,"stem":174,"description":175},"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":177,"path":178,"stem":179,"description":180},"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":182,"path":183,"stem":184,"description":185},"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":187,"path":188,"stem":189,"description":190},"Matching Devices","\u002Fdocs\u002Fdiscovery\u002Fmatching-devices","docs\u002F3.discovery\u002F6.matching-devices","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.",{"title":192,"path":193,"stem":194,"children":195,"description":197},"Reporting","\u002Fdocs\u002Freporting","docs\u002F4.reporting\u002F1.index",[196,198,203,208],{"title":192,"path":193,"stem":194,"description":197},"Open-AudIT gives you multiple ways to pull meaningful information out of collected data using Queries, Summaries, and Reports.",{"title":199,"path":200,"stem":201,"description":202},"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":204,"path":205,"stem":206,"description":207},"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":209,"path":210,"stem":211,"description":212},"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":214,"path":215,"stem":216,"children":217,"description":219},"Dashboards","\u002Fdocs\u002Fdashboards","docs\u002F5.dashboards\u002F1.index",[218],{"title":214,"path":215,"stem":216,"description":219},"Configure and customise Open-AudIT dashboards and widgets to create at-a-glance visual overviews of your network environment.",{"title":221,"path":222,"stem":223,"children":224,"description":226},"Administration","\u002Fdocs\u002Fadministration","docs\u002F6.administration\u002F1.index",[225,227,232,237],{"title":221,"path":222,"stem":223,"description":226},"Covers the ongoing administration of Open-AudIT including configuration, user management, permissions, and backup procedures.",{"title":228,"path":229,"stem":230,"description":231},"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":233,"path":234,"stem":235,"description":236},"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":238,"path":239,"stem":240,"description":241},"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":13,"path":111,"stem":114,"children":243,"description":107},[244,245,249],{"title":13,"path":111,"stem":114,"description":107},{"title":40,"path":246,"stem":247,"description":248},"\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":33,"path":250,"stem":251,"description":252},"\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":254,"path":255,"stem":256,"description":257},"Release Notes","\u002Fdocs\u002Frelease-notes","docs\u002Frelease-notes","What's new in each Open-AudIT release — features, fixes, and improvements.",1779233238088]