Configuring the HP Operations Manager monitor adapter

You can specify the adapter configuration elements for the monitor adapter for HP Operations Manager by using the form view, the XML view, or both. You cannot use the form view to configure elements and attributes that do not have an entry in the UI label column.

To configure the monitor adapter

  1. Log on to BMC Atrium Orchestrator Grid Manager.
  2. To access the adapters page, click the Manage tab, and then click the Adapters tab.
  3. In the Adapters in Repository list, select the bmc-adapter-hp-operations-manager-monitor check box.
  4. To include the adapter in the Adapters on Grid list, click Add to Grid.
  5. Click Configure corresponding to the newly added adapter.
  6. On the Add an Adapter Configuration page, perform the following steps to configure the adapter by using the form view, or skip to step 7 to configure the adapter by using the XML view:
    1. Enter a name for the adapter.
    2. Enter a description for the adapter.
    3. Under Properties, enter or select values for the configuration elements.

      Include all required elements, which are indicated with an asterisk (*).
    4. Click OK.

      The newly configured adapter is now listed in the Adapters on Grid list.
  7. (O ptional ) Configure the adapter in the XML view by performing the following steps:

    Note

    Switching to the XML view means that you cannot thereafter use the form view for modifying that configuration.

    1. Enter a name and a description for the adapter.
    2. Click Switch to XML View.
    3. On the Warning message that appears, click Switch View.
    4. In the Properties text box, use XML format to enter the configuration elements and attributes, and then click OK.

      Note

      If the default value for an optional element is acceptable, omit the element. Do not include empty elements.

    5. On the Warning message that appears, click Save.

      The adapter configuration with settings is saved in the XML view permanently. The newly configured adapter is now listed in the Adapters on Grid list.

The following table describes the configuration elements for the monitor adapter. You cannot use the form view to configure elements and attributes that do not have an entry in the UI label column.


Node elements required for configuring the monitor adapter

Element

Description

Required

<config>

Contains all the other elements

Yes

<username>

Specifies the user name for the HP Operations Manager server authentication

Yes

<password>

Specifies the password that corresponds to the user name

Yes

<wsdl-url>

Specifies the WSDL URL of the application

Example: https://<serverName>:<port>/opr-webservice/Incident.svc?wsdl

Conditional; required if the <host>, <port>, and <protocol> elements are not specified

<host>

Specifies the IP address or the host name of the server where the HP Operations Manager web service is available

Conditional; required if the <wsdl-url> element is not specified

<port>

Specifies the communication port for the HP Operations Manager application Default value: 443

Conditional; required if the <wsdl-url> element is not specified

<protocol>

Specifies the communication protocol for the HP Operations Manager application

Valid values:

  • https (default)
  • http

Conditional; required if the <wsdl-url> element is not specified

<polling-interval>

Specifies the interval, in seconds, after which the monitor polls for new messages

Yes

<arguments>

Specifies a list of elements that define the search criteria for messages

Yes

<severity>

Specifies the severity of the event

Valid values:

  • Normal
  • Warning
  • Minor
  • Major
  • Critical
  • Unknown

No

<dns-name>

Specifies the name of the node generating the message

No

<category>

Specifies a string used for categorizing the message

Messages that have some logical connection fall under the same category or message group.

No

<application>

Specifies the name of the application to which the message relates

No

<object>

Specifies the name of the object to which the message relates

No

<configuration-item>

Specifies the configuration item of the message

No

<correlation-key>

Specifies a string that enables other processes to identify messages that relate to each other

No

<escalation-status>

Defines the escalation status of the message

Valid values: notEscalated, Escalated

No

<condition-matched>

Indicates whether the message was sent to the server because of a matched condition in a policy or template Valid values: true, false

No

<received-time>

Specifies the time at which the message is received; contains the comparator attribute

Valid values for comparator:

  • at
  • from
  • to
  • since

    Valid values: DateTime in the format YYYY-MM-DDTHH:MM:SS

    Example: 2009-01-10T16:10:05

    Example: <received-time comparator="from">2009-01-10T10:00:00</received-time>

No

<state-change-time>

Specifies the time at which the state of the message is changed; contains the comparator attribute

Valid values for comparator:

  • at
  • from
  • to
  • since

    Valid values: DateTime in the format YYYY-MM-DDTHH:MM:SS Example: 2009-01-10T16:10:05

    Example: <state-change-time comparator="from">2009-01-10T10:00:00</state-change-time>

No

<title>

Specifies the message text; contains the comparator attribute

Valid values for comparator:

  • exactly, for exact match
  • contains, for contains

    Example: <title comparator="contains">backup failed</title>

No

<custom-attributes>

Specifies the parent element of the <custom-attribute> element

No

<owner>

Specifies the name of the HP Operations Manager user who is responsible for the message

Valid values:

  • any, for messages owned by any anyone.
  • none, for messages not owned by anyone.
  • self, for messages owned by the current user. The current user is the user specified at request level or the user specified in the adapter configuration.
  • others, for messages not owned by the current user.

No

<life-cycle-state>

Specifies the life cycle state of the message

No

<comparator>

Specifies the comparison logic for the given parameters If you specify more than one element in the search criteria, a logical AND is performed between the given elements.

Valid values:

  • AND: Use logical AND between the given parameters (default)
  • OR: Use logical OR between the given parameters

No

<use-ssl-certificate>

Specifies whether SSL certificates are used for authentication Valid values: false (default), true

Conditional; if the value of <protocol> element is set to https, set the value of <use-ssl-certificate> to true

<allow-unsigned-certificates>

Specifies whether to allow unsigned certificates from trusted zones

If you are using self-signed SSL certificates (a common practice), set the value of this element to true.

On ecommerce sites or military installations, if you need to use signed certificates such as VeriSign or Thawte (a rare practice), set the value of this element to false. Valid values: false (default), true

Conditional; ignored unless the <use-ssl-certificate> element is set to true

<install-certificate>

Specifies whether to install security certificates automatically

Set the value of this element to true if you prefer to have security certificates installed automatically (a common practice).

Set the value of this element to false if you prefer to manually export the security certificate from the BMC Network Automation server and manually import it into the BMC Atrium Orchestrator local peer's cacerts file (a rare practice).

Valid values: false (default), true

No

<passphrase>

Specifies the password to the keystore file (cacerts ) local to the BMC Atrium Orchestrator peer

Default value: changeit

Note

The value of the <passphrase> element must match the password in the keystore. The password can be changed by using keytool. If a change is made, this value must be updated to reflect the new password.

Conditional; ignored unless the <use-ssl-certificate> element is set to true

The following figure shows an XML template for configuring the monitor adapter:

XML template for configuring the monitor adapter

<config>
  <username></username>
  <password></password>
  <host></host>
  <port></port>
  <wsdl-url></wsdl-url>
  <protocol></protocol>
  <polling-interval></polling-interval>
  <arguments>
     <severity></severity>
  </arguments>
  <use-ssl-certificate></use-ssl-certificate>
  <allow-unsigned-certificate></allow-unsigned-certificate>
  <install-certificate></install-certificate>
  <passphrase></passphrase>
</config>
Was this page helpful? Yes No Submitting... Thank you

Comments