Configuring XML API credentials
You can discover the Cisco IMC and HP iLO for ProLiant management controllers by using an XML API. The XML API credentials are checked in sequence, and the first matching entry is used. After a working XML API credential is found, no further credentials are checked. To reorder XML API credentials, drag the credential to the required position in the list.
To view XML API credentials
- From the secondary navigation bar on the Discovery tab, click Credentials.
Click Devices, and then click XML API.
The XML API Credentials page displays the following information for each credential:
A heading link that describes the credential, which consists of the following parts:
If you click this heading link, the Edit XML API Credential page is displayed. For more information about this page, see To set up XML API credentials.
A free-text description of the XML API credential supplied by the user who created the credential.
A drop-down menu with the following options:
To set up XML API credentials
To add or edit an XML API credential:
- From the XML API credentials page, perform one of the following actions:
- To add a new credential, click Add.
- To amend an existing credential, click Actions > Edit.
- Enter the XML API credential details as follows, and then click Apply:
To match all endpoints, select Match All, or deselect it to enter values that will be used to determine if this credential is suitable for a particular endpoint. They can be one or more of the following, separated by commas:
As you enter text, the UI divides it into pills (discrete editable units) when you enter a space or a comma. According to the text entered, the pill is formatted to represent one of the previous types or is presented as invalid.
Click here for more information on using the pill UI.
Invalid pills are labeled with a question mark. You can also paste a list of IP addresses or ranges into this field. If any pills are invalid, a message stating the number of invalid pills is displayed above the range field. Clicking the link applies a filter that shows only invalid pills, which you can then edit or delete. You can remove the filter by clicking clear the Showing n of n label below the Range field. There is no paste option on the context-sensitive (right-click) menu.
Pills are not supported in Opera.
A check box enabling you to enable or disable the credential.
Username used to access the target.
The corresponding password.
|Timeout||The time (in seconds) after which a response is expected. The default is 180 seconds.|
A free-text description of this credential.
|Protocol||The protocol to use to communicate with the target. Select Cisco CIMC or HP iLO RIBCL. |
When selecting HP iLO RIBCL, be aware that after too many login failures, HP iLOs to impose a login delay. To avoid this issue, ensure that the credential is specific to the device so that it is checked first.
Custom HTTPS Port
To use a custom HTTPS port, select from the ports in the list. You must already have configured a custom HTTPS port in the Discovery Configuration window.
The XML API credential page is refreshed to show details of the new credentials.
Testing XML API credentials
After you add the credentials, test them using the following steps to ensure that they work
- Click Actions > Test for the XML API credential.
A dialog box is displayed, with valid IP address range, description, username, and options pre-populated.
- Enter the target IP address to test.
- Click Test.
The page is refreshed to show that the test is in progress. When the test is complete, the results are shown on the Device Credentials page (this might take a few minutes).
- Repeat for all credentials that you want to test.