Mapping for the BMC Discovery formats
The topics in this section describe the mapping for the BMC Discovery (formerly BMC Atrium Discovery and Dependency Mapping or BMC Atrium Discovery) formats.
BMC Discovery version 8.2 and later format
BMC Discovery 8.2 and later uses the URL-based web API to perform the import task, unlike earlier device imports.
Note
For BMC Discovery version 11, ensure that your Discovery user is added to the api-access group in BMC Discovery. For more information, see XML API in the BMC Discovery documentation.
Format the URL as shown in the following example (all on a single line). Enter this URL on the import page into the Source field in the File Access section.
https://DISCOVERY_SERVER/ui/api/XmlApi?query=search NetworkDevice show name,#InferredElement:Inference:Associate:DiscoveryAccess.endpoint, sysobjectid&username=ADDM_USERNAME&password=ADDM_PASSWORD
Substitute the following values in the query URL:
Variable | Value to subsitute |
|---|---|
DISCOVERY_SERVER | Host name or IP address of the BMC Discovery server |
DISCOVERY_USERNAME | User name that is registered on the BMC Discovery server |
DISCOVERY_PASSWORD | Password associated with the user name |
Note
The BMC Network Automation application server automatically performs URL encoding on any blank spaces or other special characters.
The query returns the following values:
Device field | BMC Discovery 8.2+ field | Comments |
|---|---|---|
Name | name | Unique name of the device. |
Hostname/IP Address | #InferredElement:Inference:Associate: DiscoveryAccess.endpoint | Endpoint host name or IP address of the device. |
Device Type | Sysobjectid | Maps the SNMP OID to the device type. |
Category | Sysobjectid | Maps the SNMP OID to the device category. |
BMC Atrium Discovery version 7.5 format
The import task maps the BMC Atrium Discovery version 7.5 database fields to the device record as follows:
Device field | BMC Atrium Discovery 7.5 field | Comments |
|---|---|---|
Name | bmc_computersystem_r.aname | Must be a unique name. Up to 100 characters in length. |
Hostname/IP Address | dim_ipaccesspoint.aname | Required for new devices. If snmpaddr is blank, uses ip_hostname field. |
Device Type | dim_snmpdatasource_r.asysobjectid | Maps the OID to the device type by using the DeviceType.snmpOids file. |
Category | dim_snmpdatasource_r.asysobjectid | Used to determine the category of the device. |
Comments
I'd like to understand how to import:
- All network devices known in Discovery
- A set selection of devices
- A range or network span of devices
Log in or register to comment.