Run Book Mappings

Administration > Operations Console > Run Book Mappings

Alternatively, click Run Book Mappings.

1. In the Run Book Mappings page, click New. The run book mapping configuration wizard opens.

2. Click Next in the Welcome page.

3. In the Select CI Type page, select a CI type to which to map OO run books. CI types that already have run books mapped to them appear in the tree, but are disabled.

   Tip You can search for CI types with names containing a specific string that you enter in this field. Click the Search button to run the search. Only matching results are displayed in the tree.

   The search is not case sensitive. You can use the asterisk (*) wildcard in your string to match one or more words of text.

   Click Next.

4. In the Select Run Books page, select the OO run books to map to the selected CI type, and click Select run book to mapping to add them to the list in the Selected Run Books area.

   Note

   • A run book that is included in an existing mapping, but that is not found in OO, is denoted by the Run Book Missing icon. Remove the run book from the mapping.

   • A run book included in an existing mapping that contains different parameters than those defined in the mapping (that is, additional or deleted parameters), is denoted by the Run Book Added icon.

   Click Next.

5. In the Configure Parameters page, configure the settings and default values of the parameters used by the selected OO run books:

   1. Optional. Click To choose an attribute that is not part of the selected CI click here to open the Select Topology dialog box, where you can select a CI from a related CI topology to use as the source for the required run book parameter:

      1. Select a topology from the drop-down list of topologies that are related to the CI type selected in the Run Book Mapping Configuration wizard. Related topologies are those topologies in the Run Book folder in Modeling Studio that include a node for the CI type selected in the wizard.

         Note  

         • Topology names in the Run Book folder in Modeling Studio cannot contain spaces.

         • You can create topologies using Query Manager:

           Administration > RTSM Administration > Modeling > Modeling Studio

           Alternatively, click Modeling Studio.

           For details on the user interface, see the RTSM Modeling section.

      2. Select a specific node from the selected topology to use as the source for a required run book parameter for the CI type selected in the Run Book Mapping Configuration wizard. Available nodes are those applicable for the CI type selected in the wizard, and their descendants.

      3. Click OK in the Select Topology dialog box.

   2. Optional. Select Enable to run automatically when you want to automatically run the run book.

      Note The run book runs automatically only when all the parameters listed in the Configure Parameters page have been assigned a value, and the run book runs without user intervention.

   3. Optional. Run Book/Parameter Name displays a hierarchical list of the selected run books and the parameters they require.

      Note:

      • Only parameters that are configured as flow input parameters for run books are included. For example, a parameter that is included in an operation configured in a run book is not displayed and cannot be mapped.

      • Mandatory parameters for which settings are required are denoted by a red asterisk.

      • A parameter included in an existing mapping, but that is not found in a run book, is denoted by the Run Book Missing icon.

      • A parameter found in a run book, but not included in an existing mapping, is denoted by the Run Book Added icon.

      • Additional and deleted parameters are automatically added to or removed from the mapping, when you click the OK button on the wizard page.

   4. Optional. CI Type displays the default CI from the selected CI type topology to use as the source for the required run book parameter. Click the arrow to open a drop-down list of all the CIs included in the CI type topology. Select a different CI if required.

      Note If there is no configured topology for the selected CI type, the CI corresponding to the selected CI type itself is the only available option.

   5. Optional. CI Attribute displays the default CI attribute, of the selected CI, to use as the source for the required run book parameter. Click the arrow to open a drop-down list of all the attributes for the selected CI. Select a different attribute if required.

   6. Optional. Event Attribute displays the default event attributes for events that correspond to the selected CI type. The field automatically lists all the default event attributes and custom attributes that were defined in OMi. You can select one of the listed default event attributes or add your own.

   7. Optional. Enter a Default Value to be used for the CI attribute.

6. Click Finish and review the configuration in the Summary page.

   The Summary page summarizes the configuration of the mapping of the parameters used by the selected OO run books to the CI attributes or to the event attributes, as well as the default values of the attributes.

7. Click OK to create the mapping and close the run book mapping configuration wizard.

For setting up and configuring the OO integration, as well as manual run book execution, review the following log file on the gateway server:

<OMi_HOME>/log/jboss/oo_integration.log

Log configuration can be performed here:

<OMi_HOME>/conf/core/Tools/log4j/jboss/OOIntegration.properties