BMC Mainframe documentation is now on docs.bmc.com

We are pleased to announce that technical documentation for BMC Mainframe products is available on docs.bmc.com. Now you can save favorites, watch pages for changes, search, and comment on every page. Check out the announcement.

We've been recognized

Docs.bmc.com has been recognized for providing a great online experience for doc like BMC Cloud Lifecycle Management 4.6. Check out 5 Real-life Examples of Beautiful Technical Documentation.

 
 

This documentation refers to a previously released version of BMC Discovery.
See the information on this topic for 11.0 or see the documentation for the latest version (11.1).

Configuring WBEM credentials

WBEM (Web-Based Enterprise Management) is a set of systems management technologies for the management of distributed computer systems. BMC Atrium Discovery uses WBEM to discover storage systems using storage patterns. See discovery.wbemEnumInstances for information on the TPL function used for storage discovery.

To view WBEM credentials

  1. From the secondary navigation bar on the Discovery tab, click Credentials.
  2. Click Devices.
  3. Click WBEM.
    The WBEM Credentials page displays the following information for each credential:

Field Name

Details

Credential link

A heading link describing the credential. This consists of the following parts:

  • IP range — the IP address or addresses of the WBEM credential is intended to be used.
  • Username — the username used for this credential.

If you click this heading link, the Edit WBEM Credential page is displayed. For more information about this page, see to setup WBEM credentials below.

Description

A free text description of the WBEM credential supplied by the user who created the credential.

Actions

A drop-down menu with the following options:

  • Edit — Select this to edit the credential. The Edit WBEM Credential page is displayed. See to setup WBEM credentials for information on the fields and settings available from this page.
  • Disable — To disable a credential, select Disable. The credential is a marked as disabled in the credential list. When a credential is disabled, this option is replaced with an Enable option. To enable the credential, click Enable.
  • Delete — Select this to delete the credential.
  • Test — Select this to test the credential. For more information, see Testing WBEM credentials.
  • Move to top — moves the credential to the top of the list.
  • Move to bottom — moves the credential to the bottom of the list.

The WBEM credentials are checked in sequence, and the first matching entry is used. After a working WBEM credential is found, further credentials are not checked. To reorder WBEM credentials, drag the credential to the required position in the list.

To set up WBEM credentials

To add or edit a WBEM credential:

  1. From the WBEM credentials page, perform one of the following actions:
    1. To add a new credential, click Add.
    2. To amend an existing credential, click Actions => Edit.
  2. Enter the WBEM credential details as follows, and click Apply:

 

Field Name

Details

Matching Criteria

Select "Match All" to match all endpoints. 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:
• IPv4 address: for example 192.168.1.100.
• IPv4 range: for example 192.168.1.100-105, 192.168.1.100/24, or 192.168.1.*.
• IPv6 address: for example 2001:500:100:1187:203:baff:fe44:91a0.
• IPv6 network prefix: for example fda8:7554:2721:a8b3::/64.

 

The following address types cannot be specified
• IPv6 link local addresses (prefix fe80::/64)
• IPv6 multicast addresses (prefix ff00::/8)
• IPv4 multicast addresses (224.0.0.0 to 239.255.255.255)

 

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 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 which shows only invalid pills which you can then edit or delete. The filter can be removed by clicking clear in the Showing n of n label below the Range field. There is no paste option on the context sensitive (right click) menu.
Warning: You cannot paste a comma-separated list of IP address information into the Range field in Firefox. This can crash the browser. You can use a space separated list without any problems.
• To edit a pill, click the pill body and edit the text.
• To delete a pill, click the X icon to the right of the pill, or click to edit and delete all of the text.
• To view the unformatted source text, click the source toggle switch. The source view is useful for copying to a text editor or spreadsheet. Click the source toggle switch again to see the formatted pill view.
Underneath the entry field is a filter box. Enter text in the filter box to only show matching pills.

Pills are not currently supported in Opera.

Enabled

A check box enabling you to enable or disable the credential.

Username

Username used to access the WBEM server. This is not a credential for the target host, but the WBEM server. The permission level required is read.

Password

The corresponding password.
In the Edit WBEM Credential page, this field is displayed as Set Password. When editing a credential, the password is shown as a series of asterisks in this field and it cannot be edited. To enter a new password, select the check box. The password entry field is cleared. Enter the password into the password entry field; the password text is not echoed to the screen.

Description

A free-text description of this credential.

Timeout

The time (in seconds) in which a response is expected. The default is 180 seconds. WBEM queries may take some time so you may need to increase this timeout.

ProtocolThe protocol to use to communicate with the WBEM server. Select HTTP, HTTPS, or both.

Custom WBEM HTTP Port

To choose a custom HTTP port, choose from the ports in the list. You must already have configured a custom WBEM HTTP port in the Discovery Configuration window.

Custom WBEM HTTPS Port

To choose a custom HTTPS port, choose from the ports in the list. You must already have configured a custom WBEM HTTPS port in the Discovery Configuration window.

The WBEM credential page is refreshed to show details of the new credentials.

Testing WBEM credentials

When you have added the credentials, you should test them to ensure that they work by performing the following actions:

  1. Click Actions => Test for the WBEM credential.
    A dialog box is displayed with the valid IP range, description, username, and options pre-populated.
  2. Enter the target IP address to test. 
  3. Click Test.
    The page is refreshed to show that the test in progress and when complete, the results are shown on the Device Credentials page; this might take a few minutes.
  4. Repeat this for all the credentials you want to test.
  • No labels

© Copyright 2003-2017 BMC Software, Inc.
Legal notices