# BMC Discovery

## Connection Requirements

{% stepper %}
{% step %}

### Domain

Enter the domain of your BMC Discovery.
{% endstep %}

{% step %}

### Port

Port number (optional, default: 443).
{% endstep %}

{% step %}

### API Token

To generate a BMC Discovery API token:

* Go to the Users page.
* From the Action list for the user, select Generate API Token.
* A dialog will appear showing the generated token.
* Copy the token and save it securely for external clients.

{% hint style="info" %}
🔵 Note:\
API tokens cannot be revoked individually. To remove a token, you must delete the user.
{% endhint %}
{% endstep %}

{% step %}

### Version

Version of the BMC Discovery. (default: 1.15)

To learn API version of BMC Discovery API:

* Click Help (?) button on Homepage of BMC Discovery.
* In the modal that opens, there is a link labeled 'REST API' that you can click.
* After clicking the link, new page will display the version of the BMC Discovery API.
  {% endstep %}

{% step %}

### Fetch Installed Software

Choose if you'd like to fetch installed software information (default: False).
{% endstep %}

{% step %}

### Timeout

Amount of time that will be waited for server responses.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
⚠️ Attention\
Please perform a **connection test** to ensure there is a valid connection to the host.\
When the discovery operation is finalized, you will be able to see the details on the **Assets** page.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.octoxlabs.com/adapters/adapters/bmc-discovery.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.