BMC Helix CMDB

Connection Requirements

1 - IP

The IP address or hostname of the BMC Helix CMDB server. For on-premises deployments enter the AR System / mid-tier host (e.g. cmdb.example.com). For Helix SaaS deployments enter your tenant FQDN (e.g. tenant.onbmc.com).

2 - Port

The port number of the BMC Helix CMDB server. (default: 8443) Common values: 8443 for HTTPS on-prem, 443 for Helix SaaS, 8008 for legacy plain-HTTP installs.

3 - Username

The username of an AR System service account that has REST API access and read permission on the CMDB class configured below (default BMC_ComputerSystem) under the configured dataset.

4 - Password

The password for the AR System service account.

5 - Dataset Id

The CMDB dataset to query. (default: BMC.ASSET) BMC ships BMC.ASSET as the production dataset; override only if your organization uses a custom dataset (for example BMC.SANDBOX for staging data).

6 - Namespace

The CDM (Common Data Model) namespace that contains the CI class. (default: BMC.CORE) Override only if your organization has placed extended CI classes in a custom namespace such as BMC.CUSTOM.

7 - Device Class Name

The CMDB CI class to enumerate as devices. (default: BMC_ComputerSystem) Override if you want to discover a different or extended class (for example BMC_Laptop or a custom subclass). The combination of Dataset Id, Namespace and Device Class Name defines the endpoint Octo calls: /api/cmdb/v1.0/instances/{Dataset Id}/{Namespace}/{Class}.

8 - Is Secure?

Choose this if your connection is going to be over HTTPS. (default: True) Turn it off only for legacy plain-HTTP installs.

9 - Timeout

The amount of time (in seconds) to wait for API responses. (default: 30)

Field Mapping

• Hostname ← Name

• IpAddresses ← IPAddress

• MacAddresses ← MACAddress

Default Values

• Port: 8443

• Dataset Id: BMC.ASSET

• Namespace: BMC.CORE

• Device Class Name: BMC_ComputerSystem

• Is Secure: true

• Timeout: 30

Permissions Required

The configured service account must have REST API access enabled on the AR System server and read permission on the CMDB CI class (BMC_ComputerSystem by default) under the configured dataset (BMC.ASSET by default). Octo authenticates against /api/jwt/login and uses the returned JWT for all subsequent requests.

Attention

Please perform a connection test to ensure there is a valid connection to the BMC Helix CMDB host. When the discovery operation is finalized you will be able to see the details on the Assets page.