IBM Tivoli Monitoring > Version 6.3 Fix Pack 2 > Installation Guides > Installation Guide > Set up event forwarding to Netcool/OMNIbus > Understanding and Customizing the Event Contents > Add event classes for new and updated agents to the MCS Attribute service used by the EIF Slot Customization function

IBM Tivoli Monitoring, Version 6.3 Fix Pack 2

Installation

This section outlines the steps for adding event classes for new and updated agents to the MCS Attribute service used by the EIF Slot Customization function.

  1. Install the TEDGEN tool from the IBM Tivoli Monitoring Tools DVD on either the Hub monitoring server or portal server. The tool is located in the tec/tedgen directory on the Tools DVD and the installation and configuration instructions are in the README.txt file in the same directory.

  2. If you installed the TEDGEN tool on a portal server on Linux or UNIX, you must also perform the following configuration steps:

    1. Create the Install_dir/tables/cicatrsq/TECLIB directory if it does not already exist, where Install_dir is the directory where IBM Tivoli Monitoring is installed.

    2. Copy the om_tec.baroc and kib.baroc files from the Install_dir/arch/cq/TECLIB directory to the Install_dir/tables/cicatrsq/TECLIB directory where arch is the architecture directory for the portal server.

These steps assume that you have installed the TEDGEN utility on the computer where the Hub Tivoli Enterprise Monitoring Server or the Tivoli Enterprise Portal Server are installed and you have installed the latest application support for the agents whose event slots will be customized.

  1. If you are generating the MCS XML file on the portal server on Linux or UNIX, the BAROC files are not present by default and install them by running the install.sh script on the portal server computer and selecting the Install TEMS support for remote seeding option. See Install application support files on a computer with no monitoring server for more details. This action places the BAROC files on the portal server under the Install_dir/tables/cicatrsq/TECLIB directory.

  2. If you installed the TEDGEN utility with a portal server on Windows, verify that the portal server's TECLIB directory contains the .baroc files for the agents whose events you want to customize. Not all agents include their .baroc files in their Tivoli Enterprise Portal Server application support. If an agent's .baroc file is not present, you can copy it from the Hub monitoring server's TECLIB directory.

Perform these steps to run the TEDGEN utility:

  1. If you are running the TEDGEN utility on Windows, issue the following command: 

       set CANDLE_HOME=Install_dir

    where Install_dir is the directory where IBM Tivoli Monitoring is installed.

  2. If you are running the TEDGEN utility on UNIX, issue the following command: 

      export CANDLEHOME=Install_dir

    where Install_dir is the directory where IBM Tivoli Monitoring is installed.

  3. Run the TEDGEN tool to create a new MCS XML file:

      cd TEDGEN_Install_dir/scripts
      tedgen -itmDir Install_dir\{CMS|CNPS} \TECLIB -id server_id -xmlPath output_xml_file_path
      tedgen -itmDir Install_dir/tables/{tems_name|cicatrsq}/TECLIB -id server_id -xmlPath output_xml_file_path

    Where:

    Install_dir

    Is the directory where the monitoring server or portal server is installed.

    server_id

    Is any string. The EIF slot customization function does not use the value of this string.

    output_xml_file_path

    Is the name of the MCS XML file that should be created by the tool. Absolute and relative paths are supported.
    Example: In the following example, the hub monitoring server named mytems has the BAROC files in the TECLIB directory. The output file goes to the same directory and is named tems.xml. 

      tedgen -itmDir C:\IBM\ITM\CMS\TECLIB -id mytems -xmlPath tems.xml

  4. If the TEDGEN tool was run on the Hub monitoring server, copy the newly generated MCS XML file to the computer where the Tivoli Enterprise Portal Server is installed.

  5. Edit the portal server environment file to specify the path to the XML file:

    1. On Windows systems: In the Manage Tivoli Monitoring Services window, right-click Tivoli Enterprise Portal Server and click Advanced → Edit ENV File to open the kfwenv file in the text editor.

    2. On Linux/UNIX systems: Open Install_dir/config/cq.ini in a text editor.

    3. Locate the KFW_MCS_XML_FILES environment variable and type = (equal sign) followed by the path to the MCS XML file.

    4. Save and close the environment file.

    5. On Windows systems, restart the portal server. On Linux/UNIX systems, reconfigure the portal server and then start it.


Parent topic:

Add event classes for new and updated agents to the MCS Attribute service used by the EIF Slot Customization function

+

Search Tips   |   Advanced Search