Table A-1 identifies the mappings between the IBM Tivoli Netcool/OMNIbus alert field names (from the alerts.status table) and the XML format that the web service uses. To set the IBM Tivoli Netcool/OMNIbus alert fields, the XML document presented to the web service must have the corresponding fields set. This must be handled in the appropriate translation file identified in Table 5-1.

/update/event/identifier

The alerts.journal table is populated from data passed in the <logs> element. An entry is added to the journal table for each <log> element that is a child of the <logs> element. The text for the journal entry is passed in <string-field/> elements that are children of <extended-fields> elements within the <log> element.

The name attribute in the <string-field/> element must be set to an integer from 1 to 16. A journal entry has 16 columns that can contain text, and the name attribute determines what column in the journal table to populate. The column is 255 characters in length; so, strings longer than 255 characters will be truncated.

An extended field is defined as a <string-field/> or <date-field/> element that is a child of the <extended-fields> node. Fields that contain date information are passed as a date-field element and all other fields are passed as a string-field element. The name of the extended field is specified in the name attribute, and the value of this field is specified as the element value. The name must be the name of a database column in the alerts.status table or a special reserved name used to populate the alert.details table.

The web service allows up to 20 entries to be populated in the alerts.details table. To populate an entry, you must specify 2 elements. The Detail_n_Name element populates the Name field of the alerts.details table and the Detail_n_Value element populates the Detail field. For both elements, the n would be replaced by an integer between 1 and 20. The number identifies the position where the information would appear on the Alert Details tab of the Event Information window.

Listed below is an example that shows how to populate fields in the alerts.status, alerts.details, and alerts.journal database tables. In the example, the Manager and LastOccurrence fields would be populated in the alerts.status table for the row with an identifier of TESTYA3F17890220E040020A78012524. The lines that start with Detail would cause the first two rows of the alerts.details table to be populated for the alert with an identifier of TESTYA3F17890220E040020A78012524. The log entry will cause a journal entry to be added to the alerts.journal table for the alert with an ID of TESTYA3F17890220E040020A78012524.

<event>
    <identifier>TESTYA3F17890220E040020A78012524</identifier>
    <logs>
        <log>
            <extended-fields>
                <string-field name="1">This creates an entry in the journal</xsl:text></string-field>
            </extended-fields>
        </log>
    </logs>
    <extended-fields>
       <string-field name="Manager">Oracle Enterprise Manager</string-field>
       <date-field name="LastOccurrence">2012-01-13T16:08:45.000-06:00</date-field>
       <string-field name="Detail_1_Name">Reported Date:</string-field>
       <date-field name="Detail_1_Value">2012-05-03T00:00:00.0-00:00</date-field>
       <string-field name="Detail_2_Name"> Event Class:</string-field>
       <string-field name="Detail_2_Value">metric_alert</string-field>
    </extended-fields>
</event>

The web service for Netcool/OMNIbus uses port 8080 as the default port for communication when the web service is configured at installation to use HTTP (no SSL). To change the port number to a different value:

1. Identify a new port number to use for the web service. You must verify that the new port number is not in use on the system where the web service is installed.

2. Change the web service to use the new port number:

   1. At the system where the web service is installed, navigate to the adapters/conf directory and open the framework.properties file in a text editor.

   2. Change the port number from 8080 to the new port number for the following properties:

      services.url

      client.url

      notification.url

      acquisitionevent.url

   3. Save and close the framework.properties file.

   4. Stop and then start the web service as instructed in Running the Web Service on Unix and Running the Web Service on Windows.

3. Change the configuration of the IBM Tivoli Netcool/OMNIbus Connector to use the new port number:

   1. From the Setup menu of Oracle Enterprise Manager Cloud Control, select Extensibility, then Management Connectors.

   2. Click on the name of the Netcool/OMNIbus Connector.

      The General tab of the Configure Management Connector page appears.

   3. Change the URLs listed in the Web Service End Points section to use the new port number.

   4. Click OK to save your changes.

4. Change the agent scripts to send alert information to the new port number:

   1. Navigate to the directory where the Oracle Agent for Netcool/OMNIbus is installed.

   2. Open the oracle_error.cmd (Windows) or oracle_error.sh (Unix) script file in a text editor.

   3. Change the port number in the OMNIBUS_ADAPTER_URL variable from 8080 to the new port number and save.

   4. Open the oracle_send.cmd (Windows) or oracle_send.sh (Unix) script file in a text editor.

   5. Change the port number in the OMNIBUS_ADAPTER_URL variable from 8080 to the new port number and save.

Contact Oracle Support for assistance in switching the default SSL port 8443 to a different port.