Browse Guides

BACK TO TOP
Asset Discovery
Reading mode
Copy Link
Link Copied!
Print
Feedback
This guide is part of a collection:
<style> .chartjs-size-monitor { display: none !important; height: 0 !important; overflow: hidden !important; }p { margin: 0; }span.fr-emoticon.fr-emoticon-img { background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle; } span.fr-emoticon { font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0; } blockquote { border-left: solid 2px #5e35b1; color: #5e35b1; margin-left:0; padding-left:5px;}blockquote blockquote{ border-color: #00bcd4; color: #00bcd4;}blockquote blockquote blockquote{ border-color: #43a047; color: #43a047;} table.grid{ border-collapse: collapse;} table.grid td, table.grid th { border: 1px solid #ddd;} .fr-fic.fr-dib{ display: block; margin: 5px auto;}.fr-fic.fr-dib.fr-fir{ text-align: right; margin: 5px 0 5px auto;}.fr-fic.fr-dib.fr-fil{ text-align: left; margin: 5px auto 5px 0;}.fr-fic.fr-dii{ float: none; margin: 5px auto;}.fr-fic.fr-dii.fr-fil{ float: left; margin: 5px auto;}.fr-fic.fr-dii.fr-fir{ float: right; margin: 5px auto;}img.fr-dib.fr-fir { margin-right: 0; text-align: right;}img.fr-dib.fr-fil { margin-left: 0; text-align: left;}img.fr-dib { margin: 5px auto; display: block; float: none;}img.fr-bordered { box-sizing: content-box; border: solid 5px #CCC;}img.fr-shadow { box-shadow: 10px 10px 5px 0px #cccccc;}img.fr-rounded { border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;}</style><p><br></p>
<style> .chartjs-size-monitor { display: none !important; height: 0 !important; overflow: hidden !important; }p { margin: 0; }span.fr-emoticon.fr-emoticon-img { background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle; } span.fr-emoticon { font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0; } blockquote { border-left: solid 2px #5e35b1; color: #5e35b1; margin-left:0; padding-left:5px;}blockquote blockquote{ border-color: #00bcd4; color: #00bcd4;}blockquote blockquote blockquote{ border-color: #43a047; color: #43a047;} table.grid{ border-collapse: collapse;} table.grid td, table.grid th { border: 1px solid #ddd;} .fr-fic.fr-dib{ display: block; margin: 5px auto;}.fr-fic.fr-dib.fr-fir{ text-align: right; margin: 5px 0 5px auto;}.fr-fic.fr-dib.fr-fil{ text-align: left; margin: 5px auto 5px 0;}.fr-fic.fr-dii{ float: none; margin: 5px auto;}.fr-fic.fr-dii.fr-fil{ float: left; margin: 5px auto;}.fr-fic.fr-dii.fr-fir{ float: right; margin: 5px auto;}img.fr-dib.fr-fir { margin-right: 0; text-align: right;}img.fr-dib.fr-fil { margin-left: 0; text-align: left;}img.fr-dib { margin: 5px auto; display: block; float: none;}img.fr-bordered { box-sizing: content-box; border: solid 5px #CCC;}img.fr-shadow { box-shadow: 10px 10px 5px 0px #cccccc;}img.fr-rounded { border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;}</style><style> .chartjs-size-monitor { display: none !important; height: 0 !important; overflow: hidden !important; } p { margin: 0; } span.fr-emoticon.fr-emoticon-img { background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle; } span.fr-emoticon { font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0; } blockquote { border-left: solid 2px #5e35b1; color: #5e35b1; margin-left: 0; padding-left: 5px; } blockquote blockquote { border-color: #00bcd4; color: #00bcd4; } blockquote blockquote blockquote { border-color: #43a047; color: #43a047; } table.grid { border-collapse: collapse; } table.grid td, table.grid th { border: 1px solid #ddd; } .fr-fic.fr-dib { display: block; margin: 5px auto; } .fr-fic.fr-dib.fr-fir { text-align: right; margin: 5px 0 5px auto; } .fr-fic.fr-dib.fr-fil { text-align: left; margin: 5px auto 5px 0; } .fr-fic.fr-dii { float: none; margin: 5px auto; } .fr-fic.fr-dii.fr-fil { float: left; margin: 5px auto; } .fr-fic.fr-dii.fr-fir { float: right; margin: 5px auto; } img.fr-dib.fr-fir { margin-right: 0; text-align: right; } img.fr-dib.fr-fil { margin-left: 0; text-align: left; } img.fr-dib { margin: 5px auto; display: block; float: none; } img.fr-bordered { box-sizing: content-box; border: solid 5px #CCC; } img.fr-shadow { box-shadow: 10px 10px 5px 0px #cccccc; } img.fr-rounded { border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box; } </style><style> .chartjs-size-monitor { display: none !important; height: 0 !important; overflow: hidden !important; } p { margin: 0; } span.fr-emoticon.fr-emoticon-img { background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle; } span.fr-emoticon { font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0; } blockquote { border-left: solid 2px #5e35b1; color: #5e35b1; margin-left: 0; padding-left: 5px; } blockquote blockquote { border-color: #00bcd4; color: #00bcd4; } blockquote blockquote blockquote { border-color: #43a047; color: #43a047; } table.grid { border-collapse: collapse; } table.grid td, table.grid th { border: 1px solid #ddd; } .fr-fic.fr-dib { display: block; margin: 5px auto; } .fr-fic.fr-dib.fr-fir { text-align: right; margin: 5px 0 5px auto; } .fr-fic.fr-dib.fr-fil { text-align: left; margin: 5px auto 5px 0; } .fr-fic.fr-dii { float: none; margin: 5px auto; } .fr-fic.fr-dii.fr-fil { float: left; margin: 5px auto; } .fr-fic.fr-dii.fr-fir { float: right; margin: 5px auto; } img.fr-dib.fr-fir { margin-right: 0; text-align: right; } img.fr-dib.fr-fil { margin-left: 0; text-align: left; } img.fr-dib { margin: 5px auto; display: block; float: none; } img.fr-bordered { box-sizing: content-box; border: solid 5px #CCC; } img.fr-shadow { box-shadow: 10px 10px 5px 0px #cccccc; } img.fr-rounded { border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box; } </style><style> .chartjs-size-monitor { display: none !important; height: 0 !important; overflow: hidden !important; } p { margin: 0; } span.fr-emoticon.fr-emoticon-img { background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle; } span.fr-emoticon { font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0; } blockquote { border-left: solid 2px #5e35b1; color: #5e35b1; margin-left: 0; padding-left: 5px; } blockquote blockquote { border-color: #00bcd4; color: #00bcd4; } blockquote blockquote blockquote { border-color: #43a047; color: #43a047; } table.grid { border-collapse: collapse; } table.grid td, table.grid th { border: 1px solid #ddd; } .fr-fic.fr-dib { display: block; margin: 5px auto; } .fr-fic.fr-dib.fr-fir { text-align: right; margin: 5px 0 5px auto; } .fr-fic.fr-dib.fr-fil { text-align: left; margin: 5px auto 5px 0; } .fr-fic.fr-dii { float: none; margin: 5px auto; } .fr-fic.fr-dii.fr-fil { float: left; margin: 5px auto; } .fr-fic.fr-dii.fr-fir { float: right; margin: 5px auto; } img.fr-dib.fr-fir { margin-right: 0; text-align: right; } img.fr-dib.fr-fil { margin-left: 0; text-align: left; } img.fr-dib { margin: 5px auto; display: block; float: none; } img.fr-bordered { box-sizing: content-box; border: solid 5px #CCC; } img.fr-shadow { box-shadow: 10px 10px 5px 0px #cccccc; } img.fr-rounded { border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box; } </style><style> .chartjs-size-monitor { display: none !important; height: 0 !important; overflow: hidden !important; } p { margin: 0; } span.fr-emoticon.fr-emoticon-img { background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle; } span.fr-emoticon { font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0; } blockquote { border-left: solid 2px #5e35b1; color: #5e35b1; margin-left: 0; padding-left: 5px; } blockquote blockquote { border-color: #00bcd4; color: #00bcd4; } blockquote blockquote blockquote { border-color: #43a047; color: #43a047; } table.grid { border-collapse: collapse; } table.grid td, table.grid th { border: 1px solid #ddd; } .fr-fic.fr-dib { display: block; margin: 5px auto; } .fr-fic.fr-dib.fr-fir { text-align: right; margin: 5px 0 5px auto; } .fr-fic.fr-dib.fr-fil { text-align: left; margin: 5px auto 5px 0; } .fr-fic.fr-dii { float: none; margin: 5px auto; } .fr-fic.fr-dii.fr-fil { float: left; margin: 5px auto; } .fr-fic.fr-dii.fr-fir { float: right; margin: 5px auto; } img.fr-dib.fr-fir { margin-right: 0; text-align: right; } img.fr-dib.fr-fil { margin-left: 0; text-align: left; } img.fr-dib { margin: 5px auto; display: block; float: none; } img.fr-bordered { box-sizing: content-box; border: solid 5px #CCC; } img.fr-shadow { box-shadow: 10px 10px 5px 0px #cccccc; } img.fr-rounded { border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box; } </style><style> .chartjs-size-monitor { display: none !important; height: 0 !important; overflow: hidden !important; } p { margin: 0; } span.fr-emoticon.fr-emoticon-img { background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle; } span.fr-emoticon { font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0; } blockquote { border-left: solid 2px #5e35b1; color: #5e35b1; margin-left: 0; padding-left: 5px; } blockquote blockquote { border-color: #00bcd4; color: #00bcd4; } blockquote blockquote blockquote { border-color: #43a047; color: #43a047; } table.grid { border-collapse: collapse; } table.grid td, table.grid th { border: 1px solid #ddd; } .fr-fic.fr-dib { display: block; margin: 5px auto; } .fr-fic.fr-dib.fr-fir { text-align: right; margin: 5px 0 5px auto; } .fr-fic.fr-dib.fr-fil { text-align: left; margin: 5px auto 5px 0; } .fr-fic.fr-dii { float: none; margin: 5px auto; } .fr-fic.fr-dii.fr-fil { float: left; margin: 5px auto; } .fr-fic.fr-dii.fr-fir { float: right; margin: 5px auto; } img.fr-dib.fr-fir { margin-right: 0; text-align: right; } img.fr-dib.fr-fil { margin-left: 0; text-align: left; } img.fr-dib { margin: 5px auto; display: block; float: none; } img.fr-bordered { box-sizing: content-box; border: solid 5px #CCC; } img.fr-shadow { box-shadow: 10px 10px 5px 0px #cccccc; } img.fr-rounded { border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box; } </style><style> .chartjs-size-monitor { display: none !important; height: 0 !important; overflow: hidden !important; } p { margin: 0; } span.fr-emoticon.fr-emoticon-img { background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle; } span.fr-emoticon { font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0; } blockquote { border-left: solid 2px #5e35b1; color: #5e35b1; margin-left: 0; padding-left: 5px; } blockquote blockquote { border-color: #00bcd4; color: #00bcd4; } blockquote blockquote blockquote { border-color: #43a047; color: #43a047; } table.grid { border-collapse: collapse; } table.grid td, table.grid th { border: 1px solid #ddd; } .fr-fic.fr-dib { display: block; margin: 5px auto; } .fr-fic.fr-dib.fr-fir { text-align: right; margin: 5px 0 5px auto; } .fr-fic.fr-dib.fr-fil { text-align: left; margin: 5px auto 5px 0; } .fr-fic.fr-dii { float: none; margin: 5px auto; } .fr-fic.fr-dii.fr-fil { float: left; margin: 5px auto; } .fr-fic.fr-dii.fr-fir { float: right; margin: 5px auto; } img.fr-dib.fr-fir { margin-right: 0; text-align: right; } img.fr-dib.fr-fil { margin-left: 0; text-align: left; } img.fr-dib { margin: 5px auto; display: block; float: none; } img.fr-bordered { box-sizing: content-box; border: solid 5px #CCC; } img.fr-shadow { box-shadow: 10px 10px 5px 0px #cccccc; } img.fr-rounded { border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box; } </style><style> .chartjs-size-monitor { display: none !important; height: 0 !important; overflow: hidden !important; } p { margin: 0; } span.fr-emoticon.fr-emoticon-img { background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle; } span.fr-emoticon { font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0; } blockquote { border-left: solid 2px #5e35b1; color: #5e35b1; margin-left: 0; padding-left: 5px; } blockquote blockquote { border-color: #00bcd4; color: #00bcd4; } blockquote blockquote blockquote { border-color: #43a047; color: #43a047; } table.grid { border-collapse: collapse; } table.grid td, table.grid th { border: 1px solid #ddd; } .fr-fic.fr-dib { display: block; margin: 5px auto; } .fr-fic.fr-dib.fr-fir { text-align: right; margin: 5px 0 5px auto; } .fr-fic.fr-dib.fr-fil { text-align: left; margin: 5px auto 5px 0; } .fr-fic.fr-dii { float: none; margin: 5px auto; } .fr-fic.fr-dii.fr-fil { float: left; margin: 5px auto; } .fr-fic.fr-dii.fr-fir { float: right; margin: 5px auto; } img.fr-dib.fr-fir { margin-right: 0; text-align: right; } img.fr-dib.fr-fil { margin-left: 0; text-align: left; } img.fr-dib { margin: 5px auto; display: block; float: none; } img.fr-bordered { box-sizing: content-box; border: solid 5px #CCC; } img.fr-shadow { box-shadow: 10px 10px 5px 0px #cccccc; } img.fr-rounded { border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box; } </style><style> .chartjs-size-monitor { display: none !important; height: 0 !important; overflow: hidden !important; } p { margin: 0; } span.fr-emoticon.fr-emoticon-img { background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle; } span.fr-emoticon { font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0; } blockquote { border-left: solid 2px #5e35b1; color: #5e35b1; margin-left: 0; padding-left: 5px; } blockquote blockquote { border-color: #00bcd4; color: #00bcd4; } blockquote blockquote blockquote { border-color: #43a047; color: #43a047; } table.grid { border-collapse: collapse; } table.grid td, table.grid th { border: 1px solid #ddd; } .fr-fic.fr-dib { display: block; margin: 5px auto; } .fr-fic.fr-dib.fr-fir { text-align: right; margin: 5px 0 5px auto; } .fr-fic.fr-dib.fr-fil { text-align: left; margin: 5px auto 5px 0; } .fr-fic.fr-dii { float: none; margin: 5px auto; } .fr-fic.fr-dii.fr-fil { float: left; margin: 5px auto; } .fr-fic.fr-dii.fr-fir { float: right; margin: 5px auto; } img.fr-dib.fr-fir { margin-right: 0; text-align: right; } img.fr-dib.fr-fil { margin-left: 0; text-align: left; } img.fr-dib { margin: 5px auto; display: block; float: none; } img.fr-bordered { box-sizing: content-box; border: solid 5px #CCC; } img.fr-shadow { box-shadow: 10px 10px 5px 0px #cccccc; } img.fr-rounded { border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box; } </style><p data-pasted="true"><strong>In this guide we will cover:</strong></p><p><a href="#What-is-Asset-Discovery-"><strong>- What is Asset Discovery?</strong></a></p><p><a href="#Pre-Requisites"><strong>- Pre-requisites</strong></a></p><p><a href="#Setup-Overview"><strong>- Setup Overview</strong></a></p><p><a href="#Enabling-Asset-Discovery"><strong>- Enabling Asset Discovery</strong></a></p><p><a href="#How-IT-Agents-Work---Types-of-Scan"><strong>- How IT Agents Work - Types of Scan</strong></a></p><p><a href="#Configure-How-Scans-Run"><strong>- Configure how Scans Run</strong></a></p><p><a href="#Installing-IT-Agents"><strong>- Installing IT Agents</strong></a></p><p><a href="#Configuring-IT-Agents"><strong>- Configuring IT Agents</strong></a></p><p><a href="#Discovery-Credentials"><strong>- Discovery Credentials</strong></a></p><p><a href="#CMDB-Mappings"><strong>- CMDB Mappings</strong></a></p><p><a href="#Running-Scans"><strong>- Running Scans</strong></a></p><p><a href="#Troubleshooting"><strong>- Troubleshooting</strong><br></a></p><p><br></p><p><br></p><p><span style="font-size: 11pt;" data-pasted="true"><em>This feature is available from v2.258+.&nbsp;</em></span></p><p><br></p><p><br></p><p><strong><span style="font-size: 14pt;">What is Asset Discovery? <a id="What-is-Asset-Discovery-" class="fr-anchor" title="What-is-Asset-Discovery-"></a></span></strong></p><p data-pasted="true">Asset Discovery is a built in feature that automatically finds devices on your network(s), such as computers, servers, printers, switches and phones, then syncs discovered and updated devices to your Halo CMDB. When a new device is found, Halo creates it as an asset (configuration item) straight away in your Halo CMDB. When an existing device changes, for example new software is installed or its operating system is updated, Halo updates the matching asset. Configuration and mappings are available so you can determine how discovered devices are added, including their asset type, which fields are filled in, and which site and user they belong to.&nbsp;</p><p><br></p><p>This gives you visibility of devices across your organisation without needing to connect and import data from other tools. If you already use tools that hold additional data you can leverage these alongside Asset Discovery to give your CMDB the richest data.</p><p><br></p><p>To utilise this functionality small IT Agent(s) will need to be installed on at least one of your devices, each IT Agent can then run scans to report on the device it&rsquo;s installed on as well as discover other devices across your network. Devices can be discovered either by scanning chosen IP ranges, or by listening for new devices as they appear on the network. Scans run automatically, keeping your inventory up to date without any manual intervention.</p><p><br></p><p data-pasted="true"><span style="font-size: 11pt;"><strong><em>Note: This guide covers Asset Discovery, which is built into Halo. If you already use a separate discovery tool, see the guide for that integration instead.</em></strong></span></p><p><br></p><p>In this guide we will run through how to set this functionality up in your instance. Our whitepaper for Asset Discovery can be found attached to this guide. If you are viewing this on our website, you will need to view this in our portal <a href="https://support.haloservicedesk.com/kb?id=3053" target="_blank" rel="noopener noreferrer">here</a>.&nbsp;</p><p><br></p><p><strong><span style="font-size: 14pt;">Pre-Requisites<a id="Pre-Requisites" class="fr-anchor" title="Pre-Requisites"></a></span></strong></p><ul><li>An Asset Discovery Licence.<ul><li>For clients on standard pricing an Asset Discovery licence is included in the cost of your licences with fair use of up to 20,000 endpoints. The licence can be shared between your Halo instances. Customers not on standard pricing, or those exceeding the fair usage limit, can purchase additional endpoints in bands of 100. Speak to your Halo contact or account manager to have Asset Discovery activated in your instance.</li></ul></li><li>You must be a Halo administrator to set this up.</li><li data-pasted="true">You must have at least one device available to run the IT Agent.<ul><li>Device(s) running an IT Agent must use one of the following operating systems: Windows, macOS or Linux, x64.</li><li>Device(s) running an IT Agent must have at least 2 GB RAM and 500 MB free disk space (8 GB RAM and 1 GB recommended).</li><li>You must have administrator (Windows) or root (macOS and Linux) rights on the device you are installing the IT Agent on.</li><li>Device(s) running an IT Agent need an outbound HTTPS connection (port 443, TLS 1.2 or higher) to the Asset Discovery service. No inbound ports or VPN are needed.</li><li>Devices being scanned by a sensor (devices in which are not hosting their own IT Agent) must accept inbound connections from the sensor.&nbsp;</li></ul></li><li style="color: rgb(0, 0, 0);">Your account manager or consultant can give you the current list of addresses to allow through your firewall or proxy.&nbsp;</li></ul><p><br></p><p><span style="color: rgb(0, 0, 0);">Be sure to reach out to your account manager if you have any queries about how your data is handled when using this integration.&nbsp;<br></span></p><p><br></p><p><strong><em>Note: The agent only makes outbound connections, so it works from home networks, public networks as well as the office.</em></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Setup Overview<a id="Setup-Overview" class="fr-anchor" title="Setup-Overview"></a></span></strong></p><ul><li>Enable the module and create an Asset Discovery site.</li><li>Configure scanning groups and tasks to control how and when scans run.</li><li>Install IT Agents to execute scans.</li><li>Give IT Agents credentials to allow more device data to be detected and imported.</li><li>Configure CMDB mappings to control how discovered devices are created/updated in the CMDB.</li><li>Run Scans.</li><li>Enable webhooks to have assets create/updated when a scan discovers devices.&nbsp;</li></ul><p><strong><span style="font-size: 14pt;">Enabling Asset Discovery<a id="Enabling-Asset-Discovery" class="fr-anchor" title="Enabling-Asset-Discovery"></a></span></strong></p><p>To enable the Asset Discovery module head to Configuration &gt; Integrations and use the &#39;+&#39; icon to enable the integration module.&nbsp;</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjQ3YmU3NWNkLTQxMjEtNGNiNi05YTYxLTJiZjY1MWUxMzdiNiJ9.8LTDJrpjaYFFXITt1OCkPuad_Gq0Hr6Z92eC8i_rpPU" class="fr-fic fr-fil fr-dib" width="418" style="width: 420px; height: 219.13px;" height="219"></p><p><strong><span style="font-size: 10pt;">Fig 1. Enable integration module</span></strong></p><p><br></p><p>When opening the integration module you will be prompted to select an Asset Discovery site. When setting this up for the first time you will need to create a new site.&nbsp;</p><p><br></p><p><strong>What is a site? -</strong> A (Asset Discovery) Site is the container for your discovery holding all your discovery configuration. IT Agents link to it, scans report into it, and Halo imports assets from it.</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjBlY2YyYWZiLTRkNTEtNDViMy04NGRiLTY0N2E1ZjMzN2RjNyJ9.wKPLLQOsK-e2BzijuqL12I_UBvCuBC4GsmlwmbQ6UHQ" class="fr-fic fr-fil fr-dib" width="602" style="width: 604px; height: 227.846px;" height="228"></p><p><strong><span style="font-size: 10pt;">Fig 2. Site Selection</span></strong></p><p><br></p><p>If you have multiple Halo instances (UAT/Dev), configuration <a href="https://www.usehalo.com/guides/1888" target="_blank" rel="noopener noreferrer">change tracking</a> must be used to allow the same Asset Discovery site to be linked/managed in multiple instances. This cannot be copied across manually.&nbsp;</p><p><br></p><p data-pasted="true"><strong><em>Note: &quot;Create a new Site&quot; only shows when your licence allows another Site. If it&#39;s missing, contact your account manager.</em></strong></p><p><br></p><p>The Asset Discovery module has four sub-modules, each used to configure part of the integration.&nbsp;</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImI1NDBlODdhLTRkMmMtNGNkNi04OTdhLTg3NDI0ZGMzYWUzMyJ9.EeabK8fvDYOZumA1Re16jre4Sb9iUHvh_WpFnYt1gr4" class="fr-fic fr-fil fr-dib" width="732" style="width: 734px; height: 269.224px;" height="269"></p><p><strong><span style="font-size: 10pt;">Fig 3. Asset Discovery integration modules</span></strong></p><p><br></p><p>If you have multiple Asset Discovery sites, you can toggle between sites using the button highlighted in Figure 4.&nbsp;</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImUwMWM2NDgwLTI1NGEtNDRmMi05MWJmLWIzZjc5NjVkOTlhZSJ9.1ibl7-wj8uA4f2Rfjz-GWQLX7DPI2fF9CbaUPbzsRpo" class="fr-fic fr-fil fr-dib" width="1319" style="width: 1321px; height: 443.408px;" height="443"></p><p><strong><span style="font-size: 10pt;">Fig 4. Switch between sites&nbsp;</span></strong></p><p><br></p><p><span style="color: rgb(0, 0, 0);">If you are unsure how many Asset Discovery sites you need, speak to your account manager. You may require multiple sites if your organisation is split into independent entities, or you are managing multiple external client data in which IP addresses may overlap.&nbsp;</span></p><p><br></p><p><span style="color: rgb(0, 0, 0);"><strong><span style="font-size: 14pt;">How IT Agents Work - Types of Scan<a id="How-IT-Agents-Work---Types-of-Scan" class="fr-anchor" title="How-IT-Agents-Work---Types-of-Scan"></a></span></strong></span></p><p>IT Agents support both local device discovery and network discovery. When discovering other devices on the network IT Agents are classed as &#39;Sensors&#39;. The type of discovery an IT Agent conducts will depend on its scanning group and scanning tasks.&nbsp;</p><p>&nbsp; &nbsp;</p><table style="width: 100%; border-collapse: collapse; height: 342px;"><colgroup><col style="width: 11.3731%;"></colgroup> <colgroup><col style="width: 22.26%;"></colgroup> <colgroup><col style="width: 28.364%;"></colgroup> <colgroup><col style="width: 38.0028%;"></colgroup><tbody><tr style="height: 30px;"><td style="border: 1px solid rgb(221, 221, 221); padding: 4px; vertical-align: top; font-size: 11pt;"><strong>Type of Scan</strong></td><td style="border: 1px solid rgb(221, 221, 221); padding: 4px; vertical-align: top; font-size: 11pt;"><strong>What is Discovered</strong></td><td style="border: 1px solid rgb(221, 221, 221); padding: 4px; vertical-align: top; font-size: 11pt;"><strong>Determined by</strong></td><td style="border: 1px solid rgb(221, 221, 221); padding: 4px; vertical-align: top; font-size: 11pt;"><strong>Details</strong></td></tr><tr style="height: 102px;"><td style="border: 1px solid rgb(221, 221, 221); padding: 4px; vertical-align: top; font-size: 11pt;">Local Scan</td><td style="border: 1px solid rgb(221, 221, 221); padding: 4px; vertical-align: top; font-size: 11pt;">Only the device the IT Agent is installed on</td><td style="border: 1px solid rgb(221, 221, 221); padding: 4px; vertical-align: top; font-size: 11pt;">This is always performed. Every IT Agent will scan the device hosting it with no additional settings.&nbsp;</td><td style="border: 1px solid rgb(221, 221, 221); padding: 4px; vertical-align: top; font-size: 11pt;">The IT Agent reads hardware, operating system, software and user details locally, so it needs no credentials and no open ports. It keeps working off the network, storing results and sending them when the device next connects. Use this type on laptops, desktops and servers you manage.</td></tr><tr style="height: 104px;"><td style="border: 1px solid rgb(221, 221, 221); padding: 4px; vertical-align: top; font-size: 11pt;">Sensor (passive)</td><td style="border: 1px solid rgb(221, 221, 221); padding: 4px; vertical-align: top; font-size: 11pt;">Devices heard on the local network</td><td style="border: 1px solid rgb(221, 221, 221); padding: 4px; vertical-align: top; font-size: 11pt;">Whether network visibility is enabled for the scanning group</td><td style="border: 1px solid rgb(221, 221, 221); padding: 4px; vertical-align: top; font-size: 11pt;">The IT Agent listens to broadcast traffic on its network adapters and records every MAC and IP address it sees. It finds devices as soon as they talk on the network, even ones that ignore scans. Passively found devices only carry a MAC and IP address (and a vendor) until something scans them.</td></tr><tr style="height: 32px;"><td style="border: 1px solid rgb(221, 221, 221); padding: 4px; vertical-align: top; font-size: 11pt;">Sensor (active)</td><td style="border: 1px solid rgb(221, 221, 221); padding: 4px; vertical-align: top; font-size: 11pt;">Devices at the targeted IP addresses</td><td style="border: 1px solid rgb(221, 221, 221); padding: 4px; vertical-align: top; font-size: 11pt;">The scanning task(s) the IT Agent is assigned to</td><td style="border: 1px solid rgb(221, 221, 221); padding: 4px; vertical-align: top; font-size: 11pt;">The IT Agent scans set IP ranges and collects information from detected devices using supported protocols (Windows over WMI, Linux and macOS over SSH, network devices over SNMP). With credentials it can log in for full detail; without them it only gets what the device shares openly.</td></tr></tbody></table><p><br></p><p><br></p><p><strong><span style="font-size: 14pt;">Configure How Scans Run <a id="Configure-How-Scans-Run" class="fr-anchor" title="Configure-How-Scans-Run"></a></span></strong></p><p>The way in which IT Agents conduct scans and what they discover is determined by scanning groups<span style="white-space:pre;" data-pasted="true">&nbsp;</span>and scanning tasks.</p><p><br></p><p><strong>Scanning Groups -&nbsp;</strong>Each IT Agent will need to be assigned to a scanning group. The group controls what the IT Agent scans and when maintenance is carried out.&nbsp;</p><p><strong>Scanning Tasks -&nbsp;</strong>Scanning groups can be assigned to a scanning task. The task controls what the IT Agent scans and when it carries out the scan.&nbsp;</p><p><br></p><p>Scanning groups and tasks are configured in the &quot;Scanning&quot; module.&nbsp;</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImM4M2Q3MmFiLTk5MTktNDFhNC04YzZmLWE2OGE4NWUxZDU1MiJ9.cvjsDKlZEvw_pmQ7LMFuVjWpjeFMnkQSHKrgB8BS9h4" class="fr-fic fr-fil fr-dib" width="696" style="width: 698px; height: 265.152px;" height="265"></p><p><strong><span style="font-size: 10pt;">Fig 5. Scanning Module&nbsp;</span></strong></p><p><br></p><p><strong><span style="font-size: 12pt;">Scanning Groups&nbsp;</span></strong></p><p>Each IT Agent will need to be assigned to a scanning group. The group controls how the IT Agent(s) behaves in terms of whether they scan for every device on the device&#39;s network and when maintenance is carried out.&nbsp;</p><p><br></p><p>Multiple groups may need to be configured based on how you would like different IT Agents to behave.&nbsp;</p><p><br></p><p>Create a new scanning group using the &quot;New&quot; button whilst under the &quot;Scanning Groups&quot; tab.&nbsp;</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjlhODBhNDVlLTQyM2MtNDBhMC1iNWMzLWUxMGJiNGRjZDkyZCJ9.0nJSXnxs-jjqDqew-0LNSaYnaTYU1KFQ6q5lVn6wjTE" class="fr-fic fr-fil fr-dib" width="1909" style="width: 1911px; height: 313.668px;" height="314"></p><p><strong><span style="font-size: 10pt;">Fig 6. Create New Scanning Group</span></strong></p><p><br></p><p>When creating you will need to set whether the group has network visibility and what the maintenance window is.</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjQ1NGZlYTBiLTZmOWItNDgwNC05OGZiLTM0NTEzNGFjNzRiNiJ9.WjH8ekIyQsDm_Yqi4nm20Af2-r-8dVpe7p3vgcX_Kws" class="fr-fic fr-fil fr-dib" width="1240" style="width: 1242px; height: 477.889px;" height="478"></p><p><strong><span style="font-size: 10pt;">Fig 7. New Scanning Group</span></strong></p><p><br></p><p><strong>Network Visibility&nbsp;</strong></p><p>When network visibility is enabled all IT Agents<span style="color: rgb(235, 107, 86);">&nbsp;</span><span style="color: rgb(0, 0, 0);">in this group are classed as &#39; Passive Sensors&#39;.&nbsp;</span>Sensors will listen to broadcast traffic on their network adapters and record every MAC and IP address seen. Devices are discovered as soon as they talk on the network, even ones that ignore scans. This is known as passive scanning. Passively found devices only carry a MAC and IP address (and a vendor) until they are scanned actively (using scanning tasks). &nbsp;Allowing you to detect all the devices on a single network. This is one way devices that cannot run an agent, such as printers, switches, phones, TVs and IoT devices, are discovered.&nbsp;</p><p><br></p><p><strong><em>Note: On Windows, Npcap is installed along with the IT Agent to do this.&nbsp;</em></strong></p><p><br></p><p>Network visibility should be enabled for groups containing IT Agents that you would like to be treated as sensors. Don&#39;t enable this if the IT Agent is on a device that is on a network containing devices you do not want to be discovered.</p><p><br></p><p data-pasted="true">We recommend enabling network visibility for a limited number of IT Agents, ideally on devices that remain connected to the corporate network. Create one Scanning Group for IT Agents that should be sensors and turn Network Visibility on for that group only. Then ensure the IT Agents assigned to this group are only used on your corporate network.&nbsp;</p><p><br></p><p data-pasted="true">A passive sensor only sees the network segment it&#39;s on, so sensors (IT Agents) will need to be installed on devices for each office, site or VLAN the others can&#39;t reach, plus a spare if you want cover when one is off.</p><p><br></p><p style="margin-left: 20px;"><span style="font-size: 11pt;">As a guide to how many sensors you need:</span></p><table style="width: 100%; border-collapse: collapse; margin-left: 20px;" class="grid"><tbody><tr><td style="width: 35%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;"><strong>Assets on the network</strong></td><td style="width: 40%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;"><strong>How often you want data refreshed</strong></td><td style="width: 25%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;"><strong>Sensors</strong></td></tr><tr><td style="width: 35%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Fewer than 5,000</td><td style="width: 40%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Weekly</td><td style="width: 25%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">1 or more</td></tr><tr><td style="width: 35%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Fewer than 5,000</td><td style="width: 40%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Daily</td><td style="width: 25%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">2 or more</td></tr><tr><td style="width: 35%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">5,000 or more</td><td style="width: 40%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Weekly</td><td style="width: 25%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">2 or more</td></tr><tr><td style="width: 35%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">5,000 or more</td><td style="width: 40%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Daily</td><td style="width: 25%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">4 or more</td></tr></tbody></table><p><br></p><p><br></p><p><strong>Maintenance Window</strong></p><p>The maintenance window for the group controls when all the IT agents in the group are allowed to<span style="white-space:pre;">&nbsp;</span>install updates to themselves. It doesn&#39;t control when scans run.&nbsp;</p><p><br></p><p>To set the maintenance window enter the hours you would like updates to be able to be carried out in, in the &quot;From&quot; and &quot;To&quot; fields. Enter this using the 24 hour clock.&nbsp;</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjBiZWE0MTA5LWEyMDAtNDgxNi1iMWJmLTYzZmQwZGMwYWY1YyJ9.9WlQldW1gn2itql7yVojfNj8yRWrLmw9S-XxWZ1lNe8" class="fr-fic fr-fil fr-dib" width="1922" style="width: 1924px; height: 422.304px;" height="422"></p><p><span style="color: rgb(0, 0, 0);"><strong><span style="font-size: 10pt;">Fig 8. Maintenance Window</span></strong></span></p><p><span style="color: rgb(226, 80, 65);"><br></span></p><p data-pasted="true"><span style="color: rgb(0, 0, 0);">To see when maintenance will be carried out, look at the scanning group entry in the list, shown in Figure 9. In the Figure 9 example maintenance will be carried out for this group from Monday to Friday every 15 minutes from 20:00, with the last check at 22:45, installing any new versions/updates they find. The &#39;To&#39; hour is included in the window. Outside this window IT Agents keep scanning as normal but won&#39;t update.</span></p><p><span style="color: rgb(226, 80, 65);"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjZiYzdiZDcyLTIyNGUtNDc3ZS1iYTM3LTQ5MmE4YjRmYTc0ZSJ9.sLvIiu6FTM0lYttl9Iv-inHKmbSW1x4Xs8TicPOxZF0" class="fr-fic fr-fil fr-dib" width="1781" style="width: 1783px; height: 293.603px;" height="294"></span></p><p><strong><span style="font-size: 10pt;">Fig 9. Maintenance Window schedule&nbsp;</span></strong></p><p><br></p><p>Configure the maintenance window outside normal operating hours, where possible.&nbsp;</p><p><br></p><p><strong>Default Scanning Group</strong></p><p>The first scanning group you make will be marked as the default, this cannot be changed.<span style="color: rgb(0, 0, 0);">&nbsp;All newly created IT Agents will be assigned to the default scanning group on creation, h</span>owever, you can change the scanning group an IT Agent belongs to against the IT Agent record. We will cover thi<span style="color: rgb(0, 0, 0);">s in the &quot;Configuring IT Agents&quot; s</span>ection of this guide.<span style="color: rgb(226, 80, 65);">&nbsp;</span></p><p><br></p><p><strong><span style="font-size: 12pt;">Scanning Tasks</span></strong></p><p>Each scanning group can be assigned to one or more scanning tasks, and each task can be assigned to multiple groups. Scanning tasks control when the scan takes place (scanning schedule) and what gets scanned, based on IP addresses. Scanning tasks actively scan configured IP ranges, collecting information from detected devices using supported protocols (Windows over WMI, Linux and macOS over SSH, network devices over SNMP). Active scanning will obtain more information about a device than passive scanning.&nbsp;</p><p><br></p><p>Multiple scanning tasks may need to be configured based on what devices can be captured by a scanning task and when the scan can take place.&nbsp;</p><p><br></p><p data-pasted="true">Create a new scanning task using the &quot;New&quot; button whilst under the &quot;Scanning tasks&quot; tab.&nbsp;</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjA0YzY4M2QyLWU4MDUtNDE1ZC1iZjFiLWUxMzFjMmE0Y2FkNCJ9.OoFXj2gcAxjS2b11FmOeejlVEwfugKYyaOczmNZZaFY" class="fr-fic fr-fil fr-dib" width="1847" style="width: 1849px; height: 326.144px;" height="326"></p><p><strong><span style="font-size: 10pt;">Fig 10. New scanning task&nbsp;</span></strong></p><p><br></p><p data-pasted="true">Give the task a name showing what the task covers, for example &#39;London office LAN&#39;.&nbsp;</p><p><br></p><p><strong>Target IP Addresses -</strong> Here set the addresses to scan when this task runs. Type each entry and press Enter. You can add a single address (192.168.1.20), a range (192.168.1.1-192.168.1.254) or a subnet in CIDR notation (192.168.1.0/24). Keep targets to networks the IT Agents can reach. A range and a subnet covering the same addresses scan them twice, so use one or the other.</p><p><br></p><p>Now set &quot;Trigger&quot;, this will set when the scanning task will run. The type of trigger chosen will impact how you configure the scan schedule. Trigger types include:&nbsp;</p><p data-pasted="true" style="margin-left: 20px;"><strong>Instant -&nbsp;</strong><span style="white-space:pre;">The scan will take place a</span>t set times on the days you choose. Add one or more rows, each with a time and the days of the week you would like the scan to run.&nbsp;</p><p style="margin-left: 20px;"><strong>Recurring</strong><span style="white-space:pre;"><strong>&nbsp;-</strong> The scan will take place r</span>epeatedly at a set interval, such as, every 4, 6, 8 or 12 hours, at a set minute past the hour (0 to 59). You only need to add one row for this trigger type.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjAzMjAxNTUxLTVhNmItNDdhNS1iYjFmLWFlMjhhNDAzNWE3ZiJ9.9yogWok-YVimAEzYFIkYWq-wEV-lxUxUKYdMQ7Wzc40" class="fr-fic fr-fil fr-dib" width="1942" style="width: 1944px; height: 577.015px;" height="577"></p><p><span style="color: rgb(0, 0, 0);"><strong><span style="font-size: 10pt;">Fig 11. Scanning task schedule example&nbsp;</span></strong></span></p><p><em><strong><br></strong></em></p><p><em><strong>Note: &#39;Instant&#39; doesn&#39;t</strong></em><strong><em>&nbsp;mean the task runs straight away. It means it runs at a fixed time. To scan an IT Agent&#39;s network straight away, a &quot;Scan Now&quot; button is available against each IT Agent, we will cover this in the &quot;Running Scans&quot; section.&nbsp;</em></strong></p><p><br></p><p>Then assign scanning groups to the task, this controls which IT Agents will carry out this task. All the IT Agents assigned to a scanning group that is assigned to this task will run this scanning task.&nbsp;</p><p><br></p><p>Avoid scheduling scanning tasks within the groups&#39; maintenance windows, in case an update is available for the Agent.&nbsp;</p><p><br></p><p>If the device hosting the IT Agent is offline at the time of scan the IT Agent will still collect data for the device it is installed on and sync this to Halo once it is back online.&nbsp;</p><p><br></p><p><span style="font-size: 12pt;"><strong><span style="color: rgb(0, 0, 0);">A typical setup of Scanning Groups and Tasks</span></strong></span></p><p><span style="font-size: 11pt;"><span style="color: rgb(0, 0, 0);">The table below outlines an example setup for scanning groups and tasks.</span> <br></span></p><table style="width: 100%; border-collapse: collapse;"><tbody><tr><td style="width: 30%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;"><strong>Scanning Group</strong></td><td style="width: 20%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;"><strong>Network Visibility</strong></td><td style="width: 25%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;"><strong>Maintenance Window</strong></td><td style="width: 25%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;"><strong>Scanning Tasks</strong></td></tr><tr><td style="width: 30%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Laptops and desktops</td><td style="width: 20%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Off</td><td style="width: 25%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Evenings, e.g. 18 to 20</td><td style="width: 25%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">None (agent role only)</td></tr><tr><td style="width: 30%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Office sensor (one per office)</td><td style="width: 20%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">On</td><td style="width: 25%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Overnight, e.g. 1 to 4</td><td style="width: 25%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">The office IP ranges</td></tr><tr><td style="width: 30%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Servers</td><td style="width: 20%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Off</td><td style="width: 25%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Your change window</td><td style="width: 25%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">None, or a server-range task</td></tr></tbody></table><p><br></p><p><strong><span style="font-size: 14pt;">Installing IT Agents<a id="Installing-IT-Agents" class="fr-anchor" title="Installing-IT-Agents"></a></span></strong></p><p data-pasted="true">The IT Agent is a small service you install on a device. It links itself to your Asset Discovery site using a linking code that Halo puts in a configuration file for you.</p><p><br></p><p>IT Agents are installed under the &quot;Agent Discovery module&quot;.&nbsp;</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjZlMjYzMmM0LTdjZDItNDAyMy04MzFkLWI4MDc3NzZkM2U5NSJ9.kde_bAvTzU0zOPDyujnqu70b7ix6eSdmByJZW4nhLN4" class="fr-fic fr-fil fr-dib" width="659" style="width: 661px; height: 254.42px;" height="254"></p><p><strong><span style="font-size: 10pt;">Fig 12. Agent Discovery Module&nbsp;</span></strong></p><p><br></p><p>In here, there is a section to download an IT Agent for each operating platform you may be using. You only need to download the agent respective to the operating system of your device. Each section has a download button and command to run.&nbsp;</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImQyZWFjYmM0LTdkYzgtNGRmZS05NzZjLTI4NjBiMWZmMGE2ZCJ9.gJ6iBHXCnZ_PusNzc4suV31BFYZj7uAl_WcEeOZjrk4" class="fr-fic fr-fil fr-dib" width="1015" style="width: 1017px; height: 886.084px;" height="886"></p><p><strong><span style="font-size: 10pt;">Fig 13. IT Agents Download Options</span></strong></p><p><br></p><p style="margin-left: 20px;"><strong>How many Agents do I need to Install?</strong></p><p data-pasted="true" style="margin-left: 20px;">You need enough agents to detect all the devices you want in your CMDB. The number of IT Agents you need depends on how many separate networks you have, since one agent can discover everything on its own network and scan any other network it can<span style="white-space:pre;">&nbsp;</span>reach. Devices that aren&rsquo;t on a reachable network, such as home workers&rsquo; laptops, may need their own agent.</p><p style="margin-left: 20px;"><br></p><p data-pasted="true">Download the IT Agent relevant to your operating system. Every download gives you two files, a configuration file and an installer script. Keep them together in the same folder.</p><p><br></p><p data-pasted="true"><strong><em>Note: The configuration file holds the linking code for your Asset Discovery Site. Anyone with it can link a device to your Site, so treat it like a password. The linking code expires, so download fresh files each time you deploy</em></strong></p><p><br></p><p data-pasted="true"><strong><span style="font-size: 12pt;">Proxy Settings (Windows and macOS only)</span></strong></p><p>When you click &#39;Download Windows Installer&#39; or &#39;Download Mac Installer&#39;, Halo asks whether the device needs a proxy. If it does, tick the proxy option and enter the proxy server (for example myproxyserver.domain.local) and port (for example 8080). Leave it unticked for a direct connection.</p><p><br></p><p data-pasted="true"><strong><span style="font-size: 12pt;">Install an IT Agent for Windows</span></strong></p><ol><li>Click &#39;Download Windows Installer&#39; and save both files to the device, in the same folder.</li><li>Open Windows PowerShell as Administrator.</li><li>Go to the folder with the files, for example cd $HOME\Downloads.</li><li>Run .\Install-AssetDiscoveryItAgent.ps1.</li><li>The script downloads the IT Agent installer, writes the configuration and installs it silently. You should see:</li></ol><pre style='box-sizing: inherit; font-family: Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace; font-size: 10pt; margin-top: 0px; margin-bottom: 1rem; overflow: auto; display: block; color: rgb(33, 37, 41); font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial; background-color: rgb(247, 247, 247); padding: 10px; border: 1px solid rgb(221, 221, 221); white-space: pre-wrap; margin-left: 40px;'>Using bundled site config -&gt; linking the agent to site &#39;&lt;your Site&gt;&#39;. [6/6] Downloading + installing the Windows IT Agent... Downloaded installer -&gt; ...\ls-it-agent\&lt;installer&gt;.exe Wrote config -&gt; ...\ls-it-agent\installation.cfg Done. IT Agent installation invoked.</pre><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImFjNDM3MzQ3LWEyM2ItNGJiYi05ODhiLThiN2U2OTM5MjQ3OCJ9.Da2voJUf01Dt20Fy0JTiwT43vfFDYPyCi6cl2vtfAGs" style="box-sizing: inherit; border-style: none; cursor: pointer; padding: 0px 1px; user-select: none; max-width: calc(100% - 10px); min-width: 10px; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 13px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: left; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial; width: 740px; height: 66.6px;" data-pasted="true" class="fr-fic fr-dii" width="738" height="67"></p><p><strong><span style="font-size: 10pt;">Fig 14. Running the windows installer script&nbsp;</span></strong></p><p><br></p><p>If Windows blocks the script because it isn&#39;t digitally signed, unblock it and run it again:</p><pre style='box-sizing: inherit; font-family: Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace; font-size: 10pt; margin-top: 0px; margin-bottom: 1rem; overflow: auto; display: block; color: rgb(33, 37, 41); font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial; background-color: rgb(247, 247, 247); padding: 10px; border: 1px solid rgb(221, 221, 221); white-space: pre-wrap; margin-left: 40px;' data-pasted="true">Unblock-File .\Install-AssetDiscoveryItAgent.ps1 powershell -ExecutionPolicy Bypass -File .\Install-AssetDiscoveryItAgent.ps1</pre><p>If PowerShell says the script &#39;is not recognized&#39;, you&#39;re in the wrong folder. Use <code style='box-sizing: inherit; font-family: Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace; font-size: 13.2px; padding: 0.2rem 0.4rem; color: rgb(189, 65, 71); background-color: rgb(248, 249, 250); border-radius: 0.25rem; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;' data-pasted="true">cd&nbsp;</code>to go to the folder that holds both files.</p><p><br></p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em; color: rgb(0, 0, 0); font-family: Poppins, sans-serif, Roboto; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;" data-pasted="true">To check the install, run the following:</p><pre style='box-sizing: inherit; font-family: Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace; font-size: 10pt; margin-top: 0px; margin-bottom: 1rem; overflow: auto; display: block; color: rgb(33, 37, 41); font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial; background-color: rgb(247, 247, 247); padding: 10px; border: 1px solid rgb(221, 221, 221); white-space: pre-wrap;'>Get-Service | Where-Object { $_.DisplayName -like &quot;*IT Agent Discovery*&quot; }</pre><p data-pasted="true">The IT Agent Discovery Service should show as Running. The IT Agent installs to its own IT Agent Discovery folder under C:\Program Files, and writes its log to the itagent\logs folder inside it.</p><p><br></p><p><span style="font-size: 12pt;"><strong>Install an IT Agent for macOS</strong></span></p><ol style="margin-bottom: 1rem; margin-top: 0px;"><li style="font-size: 11pt;">Click &#39;Download Mac Installer&#39; and save both files to the Mac, in the same folder.</li><li style="font-size: 11pt;">Install <code>jq</code> if it isn&#39;t already there: <code>brew install jq</code>.</li><li style="font-size: 11pt;">Open Terminal and go to the folder with the files.</li><li style="font-size: 11pt;">Run <code>sudo sh ./install-assetdiscovery-itagent-macos.sh</code> and enter your password.</li><li style="font-size: 11pt;">The script downloads the macOS installer package, adds the linking code (and proxy, if set) and installs it silently. It finishes with <code>Done. IT Agent installation invoked.</code></li></ol><p><span style="font-size: 12pt;"><strong>Install an IT Agent for Linux</strong></span></p><p><span style="font-size: 11pt;">The Linux agent runs on x86_64 (amd64) only. The script detects your distribution and installs a <code>.deb</code> or <code>.rpm</code> package.</span></p><ol style="margin-bottom: 1rem; margin-top: 0px;"><li style="font-size: 11pt;">Click &#39;Download Linux Installer&#39; and save both files to the device, in the same folder.</li><li style="font-size: 11pt;">Make sure <code>jq</code> and either <code>curl</code> or <code>wget</code> are installed, for example <code>sudo apt install jq</code> or <code>sudo dnf install jq</code>.</li><li style="font-size: 11pt;">Go to the folder with the files.</li><li style="font-size: 11pt;">Run <code>sudo sh ./install-assetdiscovery-itagent-linux.sh</code>.</li><li style="font-size: 11pt;">The script finishes with <code>Done. IT Agent installation invoked.</code></li></ol><p data-pasted="true"><span style="font-size: 12pt;"><strong>Deploying IT Agents across many Devices</strong></span></p><p><span style="font-size: 11pt;">You can push the scripts with your usual deployment tools, such as Group Policy, Intune or an RMM. Send both files to each device and run the script with admin or root rights. Use &#39;Download Configuration File&#39; to get a fresh <code>assetdiscovery.config.json</code> on its own when you already have the scripts.</span></p><p><br></p><p><strong><span style="font-size: 12pt;">Viewing Installed IT Agent Records</span></strong></p><p><span style="font-size: 11pt;"><span style="color: rgb(0, 0, 0);">Once an IT Agent is installed on a device, it will appear under the &quot;IT Agent&quot; tab.</span></span></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImM0NzI1NmEyLTZlNzEtNDI4Yi1hYzc2LWY3ZGEwNmM3ZjA3MSJ9.H5A9NBI_hBdip5Gg4BTfsK7RllhwRs8_6MtSpID342o" class="fr-fic fr-fil fr-dib" width="986" style="width: 988px; height: 293.809px;" height="294"></p><p><span style="font-size: 10pt;"><strong>Fig 15. IT Agent List</strong></span></p><p><br></p><p><span style="font-size: 11pt;">Clicking into an IT Agent will show more information about that Agent, including the name of the device it is installed on, if it is linked and syncing with the Asset Discovery Site (state) and its discovery components.&nbsp;</span></p><p><br></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijc2YjczMDdmLWVmNGMtNDlkZi1iNDk2LWExMDc3YjQ2ZjY0ZCJ9.WAWrdtrxDqWBJcP5Z0EQ6GuS0luSZ4LZoaF9nj5Gnxw" class="fr-fic fr-fil fr-dib" width="1056" style="width: 1058px; height: 396.087px;" height="396"></span></p><p><strong><span style="font-size: 10pt;">Fig 16. IT Agent details&nbsp;</span></strong></p><p><br></p><p><strong>Discovery Components -</strong> Here you can see the components that will influence how this IT Agent conducts its scans. Including the scanning group it belongs to, if it has network visibility, its maintenance window and its scanning tasks.</p><p><br></p><p><strong><span style="font-size: 14pt;">Configuring IT Agents<a id="Configuring-IT-Agents" class="fr-anchor" title="Configuring-IT-Agents"></a></span></strong></p><p data-pasted="true"><strong>Assigning IT Agents to Scanning Groups</strong></p><p>New IT Agents will be assigned to <span style="color: rgb(0, 0, 0);">the default scanning group by default bu</span>t you can change this using the button on the agent shown in Figure 17.</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImVjYWIyZjViLTRhYmYtNDI5NC1iNTJkLTFmYWRhZGE4NjQ3YiJ9.qeVCdXbifloCCu3O7_zHl1BoFhSxvqMkue6gHtyIjko" class="fr-fic fr-fil fr-dib" width="1170" style="width: 1172px; height: 462.603px;" height="463"></p><p><strong><span style="font-size: 10pt;">Fig 17. Change Scanning Group</span></strong></p><p><br></p><p><strong><span style="font-size: 12pt;">Unlink an IT Agent from an Asset Discovery Site</span></strong></p><p>If the device an IT Agent is installed on is being retired, or should report to a different Asset Discovery Site you will need to unlink the associated IT Agent from its current site. This is done using the button shown in Figure 18.&nbsp;</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjU2YWRkMTFjLTA4ZDItNGNjMy04MTliLTA5ZWFmZDk0NGE3YyJ9.CYt0l47tTa6wenonhm70im95I0YMitM3T1E9maceJVQ" class="fr-fic fr-fil fr-dib" width="1168" style="width: 1170px; height: 461.814px;" height="462"></p><p><strong><span style="font-size: 10pt;">Fig 18. Unlink IT Agent from Asset Discovery Site</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Discovery Credentials <a id="Discovery-Credentials" class="fr-anchor" title="Discovery-Credentials"></a></span></strong></p><p><span style="white-space:pre;">O</span>nce your IT Agents are installed they can discover devices but it is beneficial to provide the<span style="white-space:pre;">&nbsp;</span>agent with some credentials first.</p><p><br></p><p data-pasted="true">Credentials let the IT Agents log in to the devices they scan, which gives you full details about the device (model, serial number, operating system, software) instead of just a MAC and IP address. Without them, scans only collect what a device shares without logging in.</p><p><br></p><p>Credentials are configured under the &quot;Discovery Credentials&quot; module.&nbsp;<br><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjA4Yzk3NmEwLWJiOGEtNGJlZC05YjZhLWE3MDNhYzRmM2Y5ZCJ9.h0RT0je6IG62CJprd2auWqU60zNnhCXJOgFBltjpZGE" class="fr-fic fr-fil fr-dib" width="695" style="width: 697px; height: 255.105px;" height="255"></p><p><strong><span style="font-size: 10pt;">Fig 19. Discovery Credentials Module&nbsp;</span></strong></p><p><br></p><p>When adding a new set of credentials you will need to choose the type of credentials you are adding, enter in the actual credentials, then choose the IT Agents that can use these.&nbsp;</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImFmYWVjNzA0LTMwMWMtNGNjYi04ZTZjLTBjNDZiYTlhYzk3NCJ9.6ESYBbrrJ-Gqc17NHSiPrqWvv_5V0LvLvEPqfQOCy-w" class="fr-fic fr-fil fr-dib" width="1582" style="width: 1584px; height: 489.573px;" height="490"></p><p><strong><span style="font-size: 10pt;">Fig 20. Adding Discovery Credentials</span></strong></p><p><br></p><p>Various types of credentials are available to add:</p><table style="width: 100%; border-collapse: collapse; margin-left: 20px;" class="grid"><tbody><tr><td style="width: 20%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;"><strong>Type</strong></td><td style="width: 50%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;"><strong>What you enter</strong></td><td style="width: 30%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;"><strong>Use it for</strong></td></tr><tr><td style="width: 20%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Windows</td><td style="width: 50%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Username and password</td><td style="width: 30%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Windows devices</td></tr><tr><td style="width: 20%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">SSH</td><td style="width: 50%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Username and password</td><td style="width: 30%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Linux, Unix and macOS devices</td></tr><tr><td style="width: 20%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">SSH Certificate</td><td style="width: 50%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Username, password, SSH key and passphrase</td><td style="width: 30%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Linux, Unix and macOS devices that use key login</td></tr><tr><td style="width: 20%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">SNMP V1 or SNMP V2</td><td style="width: 50%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">The community string</td><td style="width: 30%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Printers, switches, routers, firewalls and NAS devices</td></tr><tr><td style="width: 20%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">SNMP V3</td><td style="width: 50%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Username, password, authentication type (MD5 or SHA), privacy protocol (DES, AES or TripleDES), privacy password and context</td><td style="width: 30%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">The same devices, where SNMP v3 is used</td></tr></tbody></table><p><br></p><p><br></p><p data-pasted="true">Credentials are stored encrypted in the IT Agent and are applied to all assets in its local network. Passwords aren&#39;t shown again in the UI after saving. Use dedicated, least-privilege scanning accounts.</p><p><br></p><p>A scan runs automatically when a new credential is created.</p><p><br></p><p>Multiple IT Agents can be assigned to one set of credentials, allowing them each to use these credentials to access device information. Similarly, one IT Agent can be assigned to various credentials, when this is the case each set of credentials an IT Agent has access to will be tried until the IT Agent is successfully able to login to the device. Credentials will be tried in the order they were added to Halo, once one set of credentials is successful no further credentials will be tried by that IT Agent for the same device.&nbsp;</p><p><br></p><p data-pasted="true">After trying the credentials specifically assigned to the IT Agent, credentials marked as default will be tried on all entities that they are applicable to (e .g., Windows credentials on Windows targets).</p><p><br></p><p><strong><span style="font-size: 14pt;">CMDB Mappings<a id="CMDB-Mappings" class="fr-anchor" title="CMDB-Mappings"></a></span></strong></p><p>CMDB mappings control how devices discovered by IT Agents create or update assets in your Halo CMDB. This includes the asset type they are created as, the fields that are populated, the users assigned to the assets, as well as many more properties.&nbsp;</p><p><br></p><p>CMDB Mappings are configured in the &quot;CMDB Mapping&quot; module.&nbsp;</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImJlMDVlMmVhLWNmZTgtNDVmNi05YjVlLTFiMjhiMDI0YjhmMSJ9.dgjCEhEhS94MFC8P7aEQeKqmJ2zVFnMrXOhu5bk-YdY" class="fr-fic fr-fil fr-dib" width="670" style="width: 672px; height: 239.4px;" height="239"></p><p><strong><span style="font-size: 10pt;">Fig 21. CMDB Mapping module</span></strong></p><p><br></p><p><strong><span style="font-size: 12pt;">Determine Asset Types</span></strong></p><p>All assets in Halo must have an asset type, therefore you will need to determine the asset type discovered devices are created as based on their device properties.&nbsp;</p><p><br></p><p>Start by choosing a &quot;Default Group for new Asset Types&quot;, the group chosen here will be the group any newly created asset types are created under.&nbsp;</p><p><br></p><p data-pasted="true">Choose how imported assets&#39; types are determined, using the &#39;Determining an Asset&#39;s type&#39; field.&nbsp;</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjJjYTI5NGE0LTFlM2YtNGE2My04NDVjLWVhMGVhYTU5YTNlYiJ9.tGcgV0X_Ml0ySVfvDhhtjOuLVzyUKZFZ7tSOqpIG1Y0" class="fr-fic fr-fil fr-dib" width="1533" style="width: 1535px; height: 396.22px;" height="396"></p><p><strong><span style="font-size: 10pt;">Fig 22. Configuration Options for determining an Asset&#39;s type&nbsp;</span></strong></p><p><br></p><p data-pasted="true" style="margin-left: 20px;"><strong>Use the Same Type for all Assets</strong></p><p style="margin-left: 20px;">If you would like all discovered assets to have the same asset type when created/updated set the &#39;Determining an Asset&#39;s type&#39; field to be &#39;use the same type for all Assets&#39; then set the &#39;Default Asset Type&#39; field to be the asset type you would like assets to have.</p><p style="margin-left: 20px;"><br></p><p style="margin-left: 20px;"><strong>Use a Field to Determine each Asset&#39;s Type</strong></p><p style="margin-left: 20px;">If you would like all imported assets&#39; types to be determined by a particular field, set the &#39;Determining an Asset&#39;s type&#39; field to be &#39;Use a field to determine each Asset&#39;s type&#39;. Then in &#39;Field for determining an Asset&#39;s type&#39; choose the field you would like the type to depend on. The field you choose must contain the name of the desired asset type, if this name can be matched to an existing asset type in Halo, it will be assigned this asset type. If the name is not the same as an asset type in Halo, a new asset type will be created. Note that the names must be identical in order to match. This setting is used if devices have a property that already determines their asset&#39;s type.&nbsp;</p><p style="margin-left: 20px;"><br></p><p data-pasted="true" style="margin-left: 20px;"><strong>Determine Asset Type using Rules</strong></p><p style="margin-left: 20px;">If you would like asset types to be determined by asset rules set the set the &quot;Determining an Asset&#39;s type&quot; field to be &quot;Determine asset type using rules&quot;. Now you will be able to set asset&#39;s types based on what criteria devices meet. These rules are based on field values, and if matched will assign an asset to the chosen asset type. When creating a rule first add criteria for the rule, select the Halo field that you would like to base the criteria on, then set the rule type and the outcome needed in the field to match the rule. If an asset matches this rule, it will be imported as this asset type. If an asset is imported that does not match any of these rules, it will be created under the set default asset type.</p><p style="margin-left: 20px;"><br></p><p style="margin-left: 20px;">In the Figure 23 example, any devices that have a name starting with &quot;LAP&quot; will be created as the &quot;Laptop&quot; asset type. Otherwise it will be created as the &quot;Other Devices&quot; (default) asset type.&nbsp;</p><p style="margin-left: 20px;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjFhMDFlNGFlLWIzOGUtNGQyNC04OWY2LTM2MTRjNzBiY2EzZiJ9.OXLFM2WPfcxNJJRddi1swjifCBioLjA0EWiIHHicPrE" class="fr-fic fr-fil fr-dib" width="557" style="width: 559px; height: 390.363px;" height="390"></p><p style="margin-left: 20px;"><strong><span style="font-size: 10pt;">Fig 23. Asset type rule mapping</span></strong></p><p style="margin-left: 20px;"><br></p><p style="margin-left: 20px;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjRjMDc5Y2ZlLTk5ZjAtNDUxYy05MjJkLTVjYjEzN2NkYjNlNCJ9.RHgHlOKqt2fHNbU2x0c9qcg_nq79XBEc9Ls_vtDhuxQ" class="fr-fic fr-fil fr-dib" width="1574" style="width: 1576px; height: 495.211px;" height="495"></p><p style="margin-left: 20px;"><strong><span style="font-size: 10pt;">Fig 24. Example Asset Type configuration set to be based on rules</span></strong></p><p><br></p><p>Don&#39;t update the Asset Type for Existing or Matched Assets - When checked, asset types will not be changed/updated after the initial creation. Asset types will be set when assets are created, any following imports will update assets but will not update their asset type. Useful if you would like to be able to change the criteria for determining an asset&#39;s type without this impacting existing assets.&nbsp;</p><p><br></p><p><strong><span style="font-size: 12pt;">Field Mappings</span></strong></p><p data-pasted="true">You can then set the &quot;Field Mappings&quot; for fields on your assets within the &quot;Field Mappings&quot; tab. This controls which fields in Halo device data is stored in.</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjM5NmI3OGU1LWNiMWItNDIwYi1hOWU1LWQxNTI3OWViYjRmNiJ9.A0chCcvaxr4K7DzrGQBQ3sFO7GAYGj7McjA0V-7cXC4" class="fr-fic fr-fil fr-dib" width="1591" style="width: 1593px; height: 695.154px;" height="695"></p><p><strong><span style="font-size: 10pt;">Fig 25. Field Mappings tab</span></strong></p><p><br></p><p>You will need to populate the table of mappings based on what data you would like to import and where you would like this stored.&nbsp;</p><p><br></p><p><span style="font-size: 11pt;">Recommended initial field mappings:</span></p><p><br></p><table style="width: 100%; border-collapse: collapse; margin-left: 20px;" class="grid"><tbody><tr><td style="width: 50%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;"><strong>Asset Discovery Field</strong></td><td style="width: 50%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;"><strong>Halo Field</strong></td></tr><tr><td style="width: 50%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Basic Info name</td><td style="width: 50%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Asset Tag</td></tr><tr><td style="width: 50%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Basic Info mac</td><td style="width: 50%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Mac Address</td></tr><tr><td style="width: 50%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Basic Info ipAddress</td><td style="width: 50%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">IP Address</td></tr><tr><td style="width: 50%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Basic Info lastUpdated</td><td style="width: 50%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Last Updated</td></tr><tr><td style="width: 50%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Custom Info serialNumber</td><td style="width: 50%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Serial Number</td></tr><tr><td style="width: 50%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Custom Info model</td><td style="width: 50%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Model</td></tr></tbody></table><p><br></p><p><br></p><p>Create a mapping by adding to the &#39;Field mappings&#39; table.&nbsp;</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImU5YWY4OTMxLWM0MjEtNDcxMS05NjlhLWE0ZmUwMDdmMzUyMSJ9.fFh28exNRysx6VkBHB9KMXG5qaHCaWeZuV99LNyh-J0" class="fr-fic fr-fil fr-dib" width="590" style="width: 592px; height: 473.434px;" height="473"></p><p><strong><span style="font-size: 10pt;">Fig 26. New Field Mapping</span></strong></p><p><br></p><p><strong>Field Type -&nbsp;</strong>Choose the type of device field you are mapping, this will influence the options that appear in the &quot;Asset Discovery Field Mapping&quot;.&nbsp;</p><p><strong>Asset Discovery Field Mapping -</strong> Choose the device field you would like to import data from. For some field types &quot;System Table&quot; is an option here, this allows you to map all the data in this field into a table against the asset in Halo. The following data (field types) can be mapped to a table:</p><ul><li data-pasted="true">Antiviruses</li><li>Network Adapters</li><li>AI Detections</li><li>Mapped Drives</li><li>Hard Disks</li><li>Certificates</li></ul><p><strong>Halo Field -&nbsp;</strong>Choose the type of Halo field this data should be imported into.&nbsp;</p><p><strong>Halo Field Mapping -&nbsp;</strong>Choose the Halo field the data should be imported into. If you do not have a relevant field to store this data yet choose &quot;*Create a new Field...&quot; and a field will be created for you automatically on import.&nbsp;</p><p><br></p><p data-pasted="true">New for this import is the ability to map lists data to tables in Halo. The following data can be mapped to a table:</p><p><br></p><p><br></p><p><strong>Import Asset relationships -</strong> Enable this if you would like device relationships to be imported into your CMDB. Keep in mind if this is enabled any existing relationships, added manually or imported via another tool, will be removed. Do not enable this if asset relationships are being tracked/imported by another tool.&nbsp;</p><p>Match imported software to Client licences based on name - Device software will automatically be imported for each device with a record held against the asset in Halo. With this enabled, the software will attempt to match to existing software licences in Halo you have for that client, matching based on name. Used when you have already imported asset software licences.&nbsp;</p><p><br></p><p><strong><span style="font-size: 12pt;">Determine which Site an Asset Belongs to</span></strong></p><p>Every asset in Halo needs to belong to a site, therefore you will need to configure site rules to determine what site a device belongs to based on its properties. This is done under the &quot;Sites and Users&quot; tab.</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjIzNjdhMjdiLTU4YzUtNGMwNy05YTliLTAwMDc0ZDFhZTE3ZCJ9.M_TYvSDh_Q4QbXtz0lUZzDRj8uinovzZrlvVVOW7oH0" class="fr-fic fr-fil fr-dib" width="1690" style="width: 1692px; height: 452.34px;" height="452"></p><p><strong><span style="font-size: 10pt;">Fig 27. Site Configuration</span></strong></p><p><br></p><p><strong>Default Site -&nbsp;</strong>Choose the site assets will belong to if they do not meet any site rules (fallback site).&nbsp;</p><p><strong>Don&#39;t update the asset site for existing or matched assets -&nbsp;</strong>When checked, existing assets will not have their site updated/changed. Assets will be assigned to a site upon initial import, but the site will not change on following syncs.&nbsp;</p><p><br></p><p>Site rules are configured by adding entries to the &quot;Site Rules&quot; table. Simply choose the site you would like assets to be created under, then add the criteria devices need to meet to be assigned to this site.&nbsp;</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjZiOTg0MjA4LTQ5MDUtNGRlYi1hZjUwLWM4Y2FkNDhiMGYzOSJ9.2McC_dGrC6weNOys_2upVjZVjlcY2uOIPiMOlezcVRU" class="fr-fic fr-fil fr-dib" width="592" style="width: 594px; height: 447.169px;" height="447"></p><p><strong><span style="font-size: 10pt;">Fig 28. Example Site Rule&nbsp;</span></strong></p><p><br></p><p>Settings are also available to have assets assigned to a site in line with their matched user. See the next section &quot;Match Users to Assets&quot; for more information on this.&nbsp;</p><p><br></p><p><strong><span style="font-size: 12pt;">Match Users to Assets</span></strong></p><p>Assets created via asset discovery can be assigned/matched to users in Halo automatically. To use this functionality enable &quot;Allow User matching&quot; under the &quot;Sites and Users&quot; tab.&nbsp;</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImZjODZhZmYxLTQ5MWQtNDNjZS1hZjQ2LWIyZmJkNDRlMzQzZSJ9.MJvwiIiPb8eSsOqMdOIFekjiY_2h6BtOyz2bdKd1Ij4" class="fr-fic fr-fil fr-dib" width="1480" style="width: 1482px; height: 760.581px;" height="761"></p><p><strong><span style="font-size: 10pt;">Fig 29. Enable User matching to Assets</span></strong></p><p><br></p><p><strong><em>Note: If you would only like user matching to occur for selected assets, disable this setting and configure user matching per asset type.&nbsp;</em></strong></p><p><br></p><p><strong>User Matching Field -&nbsp;</strong>User matching will always be attempted using username, email and the network login of the user, but an additional field can be chosen here to base matching on if matching is unsuccessful with the other fields. &nbsp;</p><p><strong>Allow partial matching on the email address, network login and User matching fields -&nbsp;</strong>When enabled, partial matches are made if an exact match cannot be found: first based on the network login, followed by the email address, and then matching field (provided one is set in the &quot;User Matching Field&quot; dropdown).</p><p><strong>User Assignment Behaviour -&nbsp;</strong>This controls how users are assigned to assets when a matching user is found.&nbsp;</p><ul><li>Add User to Asset&#39;s existing Users - When chosen, any matched users will be added to the asset&#39;s users in Halo, in addition to any users already assigned to the asset in Halo. Use this when assets are allowed to have multiple users assigned.&nbsp;</li><li>Remove existing Users and replace - When chosen, any matched users will be assigned to the asset in Halo, replacing any users currently assigned to the asset. Use this when discovery is the source of truth for the users assigned to assets.&nbsp;</li><li>Ignore if Asset already exists - When chosen, if the asset being discovered is matched to an existing asset in Halo, the asset in Halo will not be assigned a user. Use this if Halo is the source of truth for users assigned to assets and you are managing assigned users directly in Halo.&nbsp;</li></ul><p><strong>Do not remove existing Users from an Asset if a valid User is not found -</strong> Enable this if you would like existing users to remain assigned to the asset in Halo even if no users can be found for the discovered device.&nbsp;</p><p><strong>Assign Assets to their User&#39;s Site if a User is successfully matched -</strong> Enable this if the asset should always belong to the same site as its assigned u<span style="color: rgb(0, 0, 0);">ser. This will override site rules unless &quot;Site rules overrides the Users Site if a User is successfully matched&quot; is checked.&nbsp;</span></p><p><span style="color: rgb(0, 0, 0);"><strong>Site rules overrides the Users Site if a User is successfully matched -&nbsp;</strong>Enable this if the asset should belong to the same site as its assigned user if the asset does not match any site rules. If the asset matches a site rule the site rule takes precedence.&nbsp;</span></p><p><br></p><p><strong><span style="font-size: 12pt;">Set an Asset Matching Field</span></strong></p><p>When assets are discovered Halo will attempt to match the asset onto an existing Halo asset, if matched they will update the asset, otherwise a new one will be created. When an asset is created via discovery the asset will be assigned an &quot;Asset Discovery ID&quot; and this will always be used to match discovered devices to this one in future.&nbsp;</p><p><br></p><p>An asset matching field should also be set, to control what property devices match assets on when an &quot;Asset Discovery ID&quot; is not available. This is set under the &quot;Imports&quot; tab. &nbsp;</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjM1M2ZhYTU2LTUxODEtNDcxZi04MDE5LWYzZmY0NDBkNDAyYSJ9.VEPSEy6WjzVggx8jx0Tz2Vy0uiOX6MACZAmqXcjweRQ" class="fr-fic fr-fil fr-dib" width="1511" style="width: 1513px; height: 551.454px;" height="551"></p><p><strong><span style="font-size: 10pt;">Fig 30. Set asset matching field</span></strong></p><p><br></p><p>This should be the unique identifier of your assets/devices, such as the serial number.&nbsp;</p><p><br></p><p><strong>Don&#39;t create new Assets -&nbsp;</strong>Enable this if you would not like new assets to be created from discovery, only existing (matched) ones to be updated.&nbsp;</p><p><br></p><p><strong><span style="font-size: 12pt;">Determine Asset Statuses</span></strong></p><p>Statuses of assets in Halo can be set by asset discovery following scans. Useful for tracking the state of your devices in real time. Asset status configuration can be found under the &quot;Imports&quot; tab.&nbsp;</p><p><strong><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjAyNjlmZTMzLWY4ZDEtNDQ5NC05ZGU2LWYwZWM0OTljYmYzYSJ9.xLnRnImW3s0pOVlf_XZBDb46MSN2wGJgK01vHmJzauI" class="fr-fic fr-fil fr-dib" width="1601" style="width: 1603px; height: 607.804px;" height="608"></strong></p><p><strong><span style="font-size: 10pt;">Fig 31. Asset Status configuration</span></strong></p><p><strong><br></strong></p><p><strong>Status of New Assets -</strong> Choose the status assets should have when they are first created via discovery.&nbsp;</p><p data-pasted="true"><strong>Status for Assets matched for the first time -</strong> Choose the status assets should have when they are first updated via asset discovery (indicating they have successfully matched to a scanned device).&nbsp;</p><p><strong>Statuses that cannot be overridden by the sync -</strong> If selected asset statuses should never be changed by the discovery sync, enter them here. If an asset has a one of these statuses asset discovery will not change the asset&#39;s status.&nbsp;</p><p data-pasted="true"><strong>Status for Halo Assets when the Device has been deleted from Asset Discovery -&nbsp;</strong><span style="color: rgb(0, 0, 0);">Choose the status assets in Halo should have when their associated devices are classed as deleted. Devices will be &#39;deleted&#39; when the IT Agent discovering them has been unlinked from your Asset Discovery Site, or has an IP that is no longer scanned.&nbsp;</span></p><p><span style="color: rgb(0, 0, 0);"><strong>Status for Halo Assets when the Device has been previously deleted from Asset Discovery and is now recovered -</strong> Choose the status assets in Halo should have when their associated devices were previously classed as deleted but have now been re-discovered by an IT Agent. &nbsp;</span></p><p><br></p><p><span style="color: rgb(0, 0, 0);"><strong><span style="font-size: 12pt;">Manual Asset Imports</span></strong></span></p><p><span style="color: rgb(0, 0, 0);">Assets can be imported manually by initiating an export and re-import of the most recent scan data. Manually importing assets does not trigger scans, it just re-imports the data obtained by the last scan. Useful if you have recently changed your CMDB mappings for the integration.&nbsp;</span></p><p><br></p><p>To begin an import use the &quot;Export Data&quot; button, this will begin exporting the recent scan data, once the export is complete you will have an option to import this data (progress of the export will show on the page).&nbsp;</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImNmZGViYjU5LTUxYTItNDE3OC04ZDhkLTFjN2QzNTY4MTBkMSJ9.FUeRfEmFWcHzBMy-2G5ylie_-3OJAcTMwWMq1LuUbAo" class="fr-fic fr-fil fr-dib" width="1615" style="width: 1617px; height: 699.974px;" height="700"></p><p><strong><span style="font-size: 10pt;">Fig 32. Button to Export Data and re-import it</span></strong></p><p><br></p><p><strong><em>Note: Exports expire after 24 hours, after this time you will need to complete another.</em></strong></p><p><strong><br></strong></p><p><strong><span style="font-size: 12pt;">Automatically Import Assets</span></strong></p><p>To have assets created/updated automatically following scans, enable the integration webhooks using the setting shown in Figure 33.</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjMzMjkxMTQwLTYzYWQtNGU2Zi05ZDJjLTY1ZTU4MGJlMTRlYSJ9.YfHDLgSjz5u5tTGP8tXWKmOiTau-wqmXbFOp99iE404" class="fr-fic fr-fil fr-dib" width="1504" style="width: 1506px; height: 801.75px;" height="802"></p><p><strong><span style="font-size: 10pt;">Fig 33. Enable Integration Webhooks</span></strong></p><p><strong><br></strong></p><p data-pasted="true"><span style="font-size: 12pt;"><strong>Viewing Inbound Requests</strong></span></p><p><span style="font-size: 11pt;">Every webhook Asset Discovery sends to Halo is logged here, newest first. The types of logs seen are: Asset Created, Asset Updated, Asset Deleted or Export Completed.</span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjEzZjA5YTc0LWE3MTUtNDBkZC1iNWM1LWNhMTEwMDkwZjdjNCJ9.dvTw_UP_Pbam1wfSft8_siOsHrQivMFug4cTk3VsO48" class="fr-fic fr-fil fr-dib" width="1721" style="width: 1723px; height: 582.814px;" height="583"></span></p><p><strong><span style="font-size: 10pt;">Fig 34. Inbound Requests</span></strong></p><p><br></p><p><span style="font-size: 11pt;">Click into a request to see its details:</span></p><ul style="margin-bottom: 1rem; margin-top: 0px;"><li style="font-size: 11pt;">Details: the type, date and status.</li><li style="font-size: 11pt;">Request: the URL, headers and payload that were sent. Each event&#39;s <code>key</code> is the asset&#39;s Asset Discovery ID.</li><li style="font-size: 11pt;">Result: what Halo returned.</li><li style="font-size: 11pt;">Log: each step Halo took, for example <code>Asset 111 created/updated from ID ...</code>.</li><li style="font-size: 11pt;">Attempts: retries.</li></ul><p><img src="https://bagiali.itsm.haloqa.co.uk/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjNjZjdmODhhLTcwNWEtNDdkMi1hNjRkLTVlMmFkOTdiN2Y3ZiJ9.LhZnoumyt3iEza2U8kNjZ_FnoXh3zvEincWY0Xr4hgI" class="fr-fic fr-dii"></p><p><strong><span style="font-size: 10pt;">Fig 35. Inbound Request, Request tab</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Running Scans<a id="Running-Scans" class="fr-anchor" title="Running-Scans"></a></span></strong></p><p><span style="font-size: 11pt;">Once all your setup is complete scans are ready to be run.&nbsp;</span></p><p><br></p><p><strong><span style="font-size: 12pt;">Running Manually</span></strong></p><p><span style="font-size: 11pt;">Scans for individual IT Agents can be triggered manually against the IT Agent record. Head to Configuration &gt; Integrations &gt; Asset Discovery &gt; Agent Discovery &gt; IT Agent tab &gt; select an Agent &gt; Scan Now.&nbsp;</span></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImJjODVjMmFjLWZiMjQtNDY3My1iMmM3LWQ4YjllZmYyYWY3ZiJ9.VzsleWrGNIVvGyfUUOgKj9D98RngVEr_ofNkz45knaA" class="fr-fic fr-fil fr-dib" width="1856" style="width: 1858px; height: 466.178px;" height="466"></p><p><strong><span style="font-size: 10pt;">Fig 36. Run scan manually</span></strong></p><p><br></p><p><strong><em>Note: Scans can only be triggered manually per IT Agent, not for a scanning group.&nbsp;</em></strong></p><p><br></p><p><strong><span style="font-size: 12pt;">Running on a Schedule&nbsp;</span></strong></p><p>Scans will run automatically on a schedule, this schedule is determined by the scanning tasks assigned to an IT Agent&#39;s scanning group. The scanning tasks an IT Agent has can be seen against their IT Agent record.</p><p><br></p><p>The schedule can be viewed/edited within the scanning task.&nbsp;</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjMzYTFjZGE3LWFkYzYtNDRjNC04NTMzLTM4Njg0OWQ4ZTU2MyJ9.0keeo4unRl5mO6jSf2ZV6mZJaH1ViLkmcBKcWInvBXA" class="fr-fic fr-fil fr-dib" width="1824" style="width: 1826px; height: 631.001px;" height="631"></p><p><strong><span style="font-size: 10pt;">Fig 37. Scanning schedule&nbsp;</span></strong></p><p><br></p><p><span style="font-size: 14pt;"><strong>Troubleshooting<a id="Troubleshooting" class="fr-anchor" title="Troubleshooting"></a></strong></span></p><table style="width: 100%; border-collapse: collapse;" class="grid"><tbody><tr><td style="width: 30%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;"><strong>Problem</strong></td><td style="width: 30%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;"><strong>Cause</strong></td><td style="width: 40%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;"><strong>Fix</strong></td></tr><tr><td style="width: 30%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">PowerShell says the script &#39;is not recognized&#39;</td><td style="width: 30%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">PowerShell isn&#39;t in the folder holding the script</td><td style="width: 40%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;"><code>cd</code> to the folder with both files and run it again</td></tr><tr><td style="width: 30%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">PowerShell says the script &#39;is not digitally signed&#39;</td><td style="width: 30%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Windows blocks scripts downloaded from the internet</td><td style="width: 40%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Run <code>Unblock-File .\Install-AssetDiscoveryItAgent.ps1</code>, or run it with <code>powershell -ExecutionPolicy Bypass -File .\Install-AssetDiscoveryItAgent.ps1</code></td></tr><tr><td style="width: 30%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">The agent only discovers its own device</td><td style="width: 30%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Its scanning group has no Scanning Task, and Network Visibility is off</td><td style="width: 40%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Check the Scanning Tasks column on the agent record. Assign a task to the group, or turn on Network Visibility</td></tr><tr><td style="width: 30%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Devices only show a MAC and IP address</td><td style="width: 30%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">They were found by Network Visibility and haven&#39;t been scanned</td><td style="width: 40%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Add a Scanning Task covering their range, with Credentials</td></tr><tr><td style="width: 30%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Mapped data doesn&#39;t show on the asset</td><td style="width: 30%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">The field isn&#39;t on that asset type</td><td style="width: 40%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Add the field under Configuration &gt; Asset Management &gt; Asset Types</td></tr><tr><td style="width: 30%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Every asset comes in as the same type</td><td style="width: 30%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">&#39;Use the same type for all Assets&#39; is selected</td><td style="width: 40%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Switch to rules on the Asset Types tab</td></tr><tr><td style="width: 30%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Asset types you corrected change back</td><td style="width: 30%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Each sync re-applies the type</td><td style="width: 40%; border: 1px solid #ddd; padding: 4px; vertical-align: top; font-size: 11pt;">Tick &#39;Don&#39;t update the Asset type for existing or matched Assets&#39;</td></tr></tbody></table><p><br></p><p><span style="font-size: 12pt;"><strong><span style="color: rgb(0, 0, 0);">The agent log&nbsp;</span></strong></span></p><p><span style="font-size: 11pt;">On Windows the log is in the <code>itagent\logs</code> folder of the IT Agent&#39;s install folder under <code>C:\Program Files</code>. These PowerShell commands find it and pick out the useful lines:</span></p><pre style="font-size: 10pt; background-color: #f7f7f7; padding: 10px; border: 1px solid #ddd; white-space: pre-wrap;">$log = (Get-ChildItem &quot;C:\Program Files\*IT Agent Discovery\itagent\logs\*.IT.Agent.log&quot; | Select-Object -First 1).FullName # Did Asset Discovery accept what the agent sent? Select-String $log -Pattern &quot;Feedback check complete&quot; # Warnings and errors Select-String $log -Pattern &quot;\[WRN\]|\[ERR\]&quot; | Select-Object -Last 40</pre><p><span style="font-size: 11pt;">&#39;Feedback check complete&#39; lines show how many scanned devices Asset Discovery processed, and how many failed or weren&#39;t found.</span></p>
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.