[{"data":1,"prerenderedAt":395},["ShallowReactive",2],{"docs-discovery-running-a-discovery-":3,"docs-navigation":252},{"id":4,"title":5,"body":6,"dateModified":242,"datePublished":242,"description":243,"extension":244,"meta":245,"navigation":246,"path":247,"proficiencyLevel":248,"seo":249,"stem":250,"__hash__":251},"docs\u002Fdocs\u002F3.discovery\u002F3.running-a-discovery.md","Running a Discovery",{"type":7,"value":8,"toc":232},"minimark",[9,13,23,28,85,89,96,103,107,110,142,149,153,160,191,195,202,206],[10,11,5],"h1",{"id":12},"running-a-discovery",[14,15,16,17,22],"p",{},"This guide walks through running your first network discovery in Open-AudIT. Make sure you've already set up at least one credential set before starting — see ",[18,19,21],"a",{"href":20},"\u002Fdocs\u002Fdiscovery\u002Fcredentials\u002F","Setting Up Credentials",".",[24,25,27],"h2",{"id":26},"creating-a-discovery","Creating a Discovery",[29,30,31,39,78],"ol",{},[32,33,34,35],"li",{},"Go to ",[36,37,38],"strong",{},"Menu → Discover → Discoveries → Create Discoveries",[32,40,41,42],{},"Fill in the discovery form:",[43,44,45,51],"ul",{},[32,46,47,50],{},[36,48,49],{},"Name"," — Give it a descriptive name, e.g., \"Office LAN - 192.168.1.0\u002F24\"",[32,52,53,56,57],{},[36,54,55],{},"Network Address"," — Enter an IP range, subnet, or single IP. Supported formats:\n",[43,58,59,66,72],{},[32,60,61,62],{},"Subnet: ",[63,64,65],"code",{},"192.168.1.0\u002F24",[32,67,68,69],{},"Range: ",[63,70,71],{},"192.168.1-10.1-254",[32,73,74,75],{},"Single IP: ",[63,76,77],{},"192.168.1.200",[32,79,80,81,84],{},"Click ",[36,82,83],{},"Submit",". You'll be taken to the Discovery Details page.",[24,86,88],{"id":87},"running-the-discovery","Running the Discovery",[14,90,91,92,95],{},"On the Discovery Details page, click the ",[36,93,94],{},"Execute"," button (the play icon) in the top-right toolbar. Open-AudIT will kick off the discovery process and the log panel at the bottom of the page will start showing activity.",[14,97,98,99,102],{},"The page refreshes automatically every 20 seconds while the discovery runs. If you want to stop the auto-refresh, click the ",[36,100,101],{},"X"," in the log panel header — the discovery will keep running in the background.",[24,104,106],{"id":105},"what-to-expect","What to Expect",[14,108,109],{},"Discovery happens in stages:",[29,111,112,118,124,130,136],{},[32,113,114,117],{},[36,115,116],{},"Nmap scan"," — Open-AudIT uses Nmap to ping sweep the range and identify live hosts.",[32,119,120,123],{},[36,121,122],{},"Port scanning"," — Each responding IP is scanned for ports 22 (SSH), 135 (WMI), and UDP 161 (SNMP), among others.",[32,125,126,129],{},[36,127,128],{},"Credential testing"," — Open-AudIT tests your credential sets against each device.",[32,131,132,135],{},[36,133,134],{},"Audit"," — For devices where credentials work, an audit script is copied to the device (or WMI\u002FSSH queries are run), executed, and the results are returned to Open-AudIT.",[32,137,138,141],{},[36,139,140],{},"Data storage"," — Device details are stored or updated in the database.",[143,144,146],"docs-callout",{"type":145},"warning",[14,147,148],{},"The first time a Windows or Linux device is discovered, you may initially see only limited Nmap data. The full audit details appear after the audit script has run and been processed. Give it a few minutes.",[24,150,152],{"id":151},"advanced-options","Advanced Options",[14,154,155,156,159],{},"Click the ",[36,157,158],{},"Advanced"," button on the Create Discoveries form to reveal additional settings, including:",[43,161,162,173,179,185],{},[32,163,164,167,168,172],{},[36,165,166],{},"Discovery type"," (Subnet, Active Directory, or Seed — see ",[18,169,171],{"href":170},"\u002Fdocs\u002Fdiscovery\u002Fdiscovery-types\u002F","Discovery Types",")",[32,174,175,178],{},[36,176,177],{},"Scan options"," (which Nmap options to use)",[32,180,181,184],{},[36,182,183],{},"Credential priority"," (for Enterprise users)",[32,186,187,190],{},[36,188,189],{},"Per-discovery match rules"," (Enterprise only)",[24,192,194],{"id":193},"scheduling-discoveries","Scheduling Discoveries",[14,196,197,198,201],{},"Rather than running discoveries manually, you can schedule them to run automatically. Go to ",[36,199,200],{},"Menu → Admin → Tasks"," to create a scheduled task. You can set a discovery to run daily, weekly, or on any custom schedule.",[24,203,205],{"id":204},"tips-for-better-discovery-results","Tips for Better Discovery Results",[43,207,208,214,220,226],{},[32,209,210,213],{},[36,211,212],{},"Limit your scan range to \u002F24 subnets."," Larger ranges work but take much longer. Scanning a \u002F16 (65,000+ IPs) can take hours.",[32,215,216,219],{},[36,217,218],{},"Use specific credentials."," The more accurate your credentials, the faster and more complete the audit.",[32,221,222,225],{},[36,223,224],{},"Check firewall rules."," Windows WMI requires ports 135 and additional dynamic ports to be open on the target. SSH needs port 22.",[32,227,228,231],{},[36,229,230],{},"Start with a single device."," If you're troubleshooting, scan a single known IP first before moving to full subnets.",{"title":233,"searchDepth":234,"depth":234,"links":235},"",2,[236,237,238,239,240,241],{"id":26,"depth":234,"text":27},{"id":87,"depth":234,"text":88},{"id":105,"depth":234,"text":106},{"id":151,"depth":234,"text":152},{"id":193,"depth":234,"text":194},{"id":204,"depth":234,"text":205},"2026-04-10","Step-by-step guide to creating and running your first network discovery in Open-AudIT, including advanced options and scheduling.","md",{},{"title":5},"\u002Fdocs\u002Fdiscovery\u002Frunning-a-discovery","Beginner",{"title":5,"description":243},"docs\u002F3.discovery\u002F3.running-a-discovery","ycsygP-T6BUP3vSRXeA6_PiLbglTpQJ-t5_8vrtzMxc",[253],{"title":254,"path":255,"stem":256,"children":257},"Docs","\u002Fdocs","docs",[258,262,274,296,322,344,351,373,390],{"title":259,"path":255,"stem":260,"description":261},"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":263,"path":264,"stem":265,"children":266,"description":268},"Getting Started","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started\u002F1.index",[267,269],{"title":263,"path":264,"stem":265,"description":268},"Get from a fresh install to discovering devices on your network in under 10 minutes. This guide walks through each step in order.",{"title":270,"path":271,"stem":272,"description":273},"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":275,"path":276,"stem":277,"children":278,"description":280},"Installation","\u002Fdocs\u002Finstallation","docs\u002F2.installation\u002F1.index",[279,281,286,291],{"title":275,"path":276,"stem":277,"description":280},"Install or upgrade Open-AudIT on Windows Server or Linux. Includes virtual appliance option for the fastest setup.",{"title":282,"path":283,"stem":284,"description":285},"Server Requirements","\u002Fdocs\u002Finstallation\u002Fserver-requirements","docs\u002F2.installation\u002F2.server-requirements","Hardware, operating system, browser, and dependency requirements for running Open-AudIT.",{"title":287,"path":288,"stem":289,"description":290},"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":292,"path":293,"stem":294,"description":295},"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":259,"path":297,"stem":298,"children":299,"description":301},"\u002Fdocs\u002Fdiscovery","docs\u002F3.discovery\u002F1.index",[300,302,307,308,312,317],{"title":259,"path":297,"stem":298,"description":301},"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":303,"path":304,"stem":305,"description":306},"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":5,"path":247,"stem":250,"description":243},{"title":171,"path":309,"stem":310,"description":311},"\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":313,"path":314,"stem":315,"description":316},"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":318,"path":319,"stem":320,"description":321},"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":323,"path":324,"stem":325,"children":326,"description":328},"Reporting","\u002Fdocs\u002Freporting","docs\u002F4.reporting\u002F1.index",[327,329,334,339],{"title":323,"path":324,"stem":325,"description":328},"Open-AudIT gives you multiple ways to pull meaningful information out of collected data using Queries, Summaries, and Reports.",{"title":330,"path":331,"stem":332,"description":333},"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":335,"path":336,"stem":337,"description":338},"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":340,"path":341,"stem":342,"description":343},"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":345,"path":346,"stem":347,"children":348,"description":350},"Dashboards","\u002Fdocs\u002Fdashboards","docs\u002F5.dashboards\u002F1.index",[349],{"title":345,"path":346,"stem":347,"description":350},"Configure and customise Open-AudIT dashboards and widgets to create at-a-glance visual overviews of your network environment.",{"title":352,"path":353,"stem":354,"children":355,"description":357},"Administration","\u002Fdocs\u002Fadministration","docs\u002F6.administration\u002F1.index",[356,358,363,368],{"title":352,"path":353,"stem":354,"description":357},"Covers the ongoing administration of Open-AudIT including configuration, user management, permissions, and backup procedures.",{"title":359,"path":360,"stem":361,"description":362},"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":364,"path":365,"stem":366,"description":367},"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":369,"path":370,"stem":371,"description":372},"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":374,"path":375,"stem":376,"children":377,"description":379},"Troubleshooting","\u002Fdocs\u002Ftroubleshooting","docs\u002F7.troubleshooting\u002F1.index",[378,380,385],{"title":374,"path":375,"stem":376,"description":379},"General troubleshooting guidance for Open-AudIT covering discovery problems, common errors, and first steps for diagnosing issues.",{"title":381,"path":382,"stem":383,"description":384},"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":386,"path":387,"stem":388,"description":389},"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":391,"path":392,"stem":393,"description":394},"Release Notes","\u002Fdocs\u002Frelease-notes","docs\u002Frelease-notes","What's new in each Open-AudIT release — features, fixes, and improvements.",1779864897686]