Domain Scan

Discover all devices registered in your Active Directory domain and import them into ServiceOps as assets or CIs.

Domain Scan connects to your organization's domain controller using domain credentials and discovers all devices in the specified Organizational Unit (OU). It supports LDAP field mapping for location, department, and user assignment.

DNS Required

Configure DNS before running a Domain Scan. See DNS Configuration.

To access Domain Scan, navigate to Admin > Discovery and Agents > Discovery > Domain Scan.

Create a Domain Scan

1. Click Create Domain Scan in the top-right corner. The following popup appears.

2. Enter the following details:

   Field	Description
   Name	Enter a name for the domain scan.
   Domain Controller Name	Enter the name of the domain controller for your organization.
   Domain Name	Enter the domain name of your organization, for example: acme.com.
   OU	Enter the Organizational Unit to scan, for example: OU=motadata.
   Username	Enter the domain username for authentication.
   Password	Enter the password for the domain user.
   Map Location from LDAP	Enable to map the location from the LDAP server. When enabled, specify the LDAP Location Field. Enable Create Location to create the location automatically if it does not exist.
   Location	Select the location for discovered assets.
   Map Department from LDAP	Enable to map the department from the LDAP server. When enabled, specify the LDAP Department Field. Enable Create Department to create the department if it does not exist.
   Department	Select the department for discovered assets.
   Map Used By from LDAP	Enable to map the assigned user from the LDAP server. When enabled, specify the LDAP Used By Field. Enable Create Used By to create the user if they do not exist.
   Used By	Select the user from the dropdown.
   Description	Enter a brief description of the domain scan.
   Exclude IPs	Enter IP addresses to skip during the scan. Import excluded IPs in bulk using a CSV or Excel file via the Import Exclude IPs link.
   Poller	Select a Poller service to run the scan through that Poller.

3. Click Test Connection to verify the connection to the domain controller.

4. Click Save. The scan appears on the list page. Now, you can configure a scheduler, or initiate the scan immediately using the Discover New Asset option or poll the existing asset. Once clicked, the discovery process will get initiated and the progress will appear on the Discovery Service page.

Actions on the List Page

After saving a domain scan, the following actions are available from the scan row.

Scheduler

Select Scheduler on the scan row to configure automated discovery and polling runs for that scan. The scheduler popup displays two tabs:

• Discover Scan Schedule: Configure to automatically populate the inventory with newly discovered domain assets and CIs.
• Polling Scan Schedule: Configure to regularly poll existing domain assets and CIs to monitor their status and update their details.

Discover Scan Schedule

Click Create Discovery Schedule and configure the following:

1. Schedule Type: Select the type of schedule:
   • Once: Runs only once on the selected start date.
   • Daily: Runs daily from the selected start date and time.
   • Weekly: Runs once a week on the selected day and time. Provide a start date.
   • Monthly: Choose when the scheduler runs:
     • On Specific Date: Select the Date and Month for the schedule to run.
     • On Specific Day: Select the Occurrence (for example, first or second), Weekday (for example, Monday or Tuesday), and Month.
   • Interval: Set the interval in hours or days within which the schedule runs. Provide a start date.
2. Automatically add Assets in CMDB?: Select Yes to add discovered assets to CMDB automatically after each scan.
3. Email: Enter one or more email addresses to receive scan completion notifications.

Click Save to activate the schedule.

Polling Scan Schedule

Configure to regularly poll existing domain assets and CIs to refresh their details. Click Create Polling Schedule and configure the following:

1. Schedule Type: Select the polling frequency:
   • Once: Polls only once on the selected start date.
   • Daily: Polls daily from the selected start date and time.
   • Weekly: Polls once a week on the selected day and time. Provide a start date.
   • Monthly: Choose On Specific Date or On Specific Day and configure the date, occurrence, weekday, and month accordingly.
   • Interval: Set the interval in hours or days. Provide a start date.
2. Email: Enter one or more email addresses to receive polling completion notifications.

Click Save. Scheduled runs appear in the Discovery Service tab at the configured time.

Discover New Asset

Click Discover New Asset on the scan row to trigger an immediate scan for newly added devices in the domain. A confirmation dialog appears asking "Do you want newly scanned Entities in Asset/CI list?"

Select one of the following options:

• Yes: Adds the newly discovered entities directly to the Asset or CI list, based on the configured Discovery Preference Rule.
• No, Add in Stage: Runs the scan but places discovered entities in Stage instead of the Asset or CI list.
• Cancel: Closes the dialog without running the scan.

Poll Existing Asset

Click Poll Existing Asset to refresh the details of already-discovered domain assets without running a full domain scan.

Edit and Delete

Click Edit to update the scan configuration. Click Delete to remove the scan if it is no longer needed.

Add Asset in Stage / Add CI in Stage

Select Add Asset in Stage or Add CI in Stage from the row actions to review and promote staged items manually.

Add Asset in Stage

Select Add Asset in Stage to open the Asset in Stage dialog. It lists all assets currently in stage that were not directly added to the Asset list.

1. Asset Type filter: Use the dropdown (for example, All Hardware IT Assets) to filter the list by asset type.
2. Select assets: Use the checkboxes to select one or more assets. Use the search field to find specific assets by field or keyword.
3. Add to Asset: Click Add to Asset to move the selected assets to the Asset list. Click Delete to remove them from stage, or click Cancel to close without making changes.

Add CI in Stage

Select Add CI in Stage to open the CI in Stage dialog. It lists all CIs currently in stage that were not directly added to the CI list.

1. CI Type filter: Use the dropdown (for example, All CI) to filter the list by CI type.
2. Select CIs: Use the checkboxes to select one or more CIs. Use the search field to find specific CIs by field or keyword.
3. Add to CMDB: Click Add to CMDB to move the selected CIs to CMDB. Click Delete to remove them from stage, or click Cancel to close without making changes.

Related Topics

• Discovery Overview
• DNS Configuration
• Discovery Service
• Discovery Preference Rule