Configuring an IBM Tivoli Monitoring data provider

You can configure the Universal Agent initialization file to define a new data provider.

If you are using Tivoli® Monitoring version 6.2.2 or earlier, make sure there are no tab or space characters in the KUMPOST configuration file.

To configure an IBM® Tivoli Monitoring data provider, complete the following steps:

If you are running the Universal Agent on a Windows system, complete the following steps:
  1. On the Windows system where the Universal Agent is installed, click Start > IBM Tivoli Monitoring > Manage Tivoli Monitoring Services.
  2. Right-click the Universal Agent and click Reconfigure.
  3. In each of the two Agent Advanced Configuration windows, click OK.
  4. To update the Universal Agent initialization file, click Yes.
    The KUMENV file is opened in the system text editor.
  5. Set the KUMA_STARTUP_DP value to POST: 
    KUMA_STARTUP_DP=POST
    Note: If the Universal Agent is already configured to use another data provider, specify both values separated with a comma, as in the following example:
    KUMA_STARTUP_DP=ASFS,POST
  6. Add the required POST parameter information to the KUMENV file: 
    *----------------------------------------*
* TADDM POST DP Parameters *
*----------------------------------------*
KUMP_POST_DP_PORT=7575
KUMP_POST_GROUP_NAME=TADDM
KUMP_POST_APPL_TTL=14400
  7. Save the KUMENV file, and close it.
  8. To configure the agent, click Yes.
  9. In the Manage Tivoli Enterprise Monitoring Services window, click Universal Agent > Start.
  10. In the system text editor, create a text file. Enter the following information in the file: 
    //APPl CONFIGCHANGE
//NAME dpPost E 3600 
//ATTRIBUTES ';' 
Post_Time T 16 Caption{Time} 
Post_Origin D 32 Caption{Origination} 
Post_Ack_Stamp D 28 Caption{Event time stamp} 
Comp_Type D 512 Caption{Component type} 
Comp_Name D 512 Caption{Component name}
Comp_Guid D 512 Caption{Component GUID} 
Change_Type D 512 Caption{Change type} 
Chg_Det_Time D 512 Caption{Change detection time} 
Chg_Attr D 512 Caption{Changed attribute} 
Srv_Addr D 512 Caption{TADDM server} 
Srv_Port D 16 Caption{TADDM port}
  11. Save the file as %ITM_HOME%\TMAITM6\metafiles\KUMPOST.
    Note: Ensure that you spell the file name, KUMPOST, with uppercase letters, as shown here.
  12. Open a Windows command prompt and navigate to the %ITM_HOME%\TMAITM6 folder.
  13. Run the KUMPCON.exe program to validate and import the KUMPOST metafile.
  14. In the Manage Tivoli Monitoring Services window, right-click the Universal Agent, and select Recycle.
If you are running the Universal Agent on a Linux® or UNIX system, complete the following steps:
  1. Reconfigure the universal agent using the following command: 
    itmcmd config –A um
    When you are prompted for the data provider, enter POST.
    Note: If the Universal Agent is already configured to use another data provider, specify both values separated with a comma (for example, ASFS,POST).
  2. In the $ITM_HOME/config directory, make a backup copy of the um.ini file, and then add the following entries to the original copy of the file: 
    # TADDM POST DP Parameters
KUMP_POST_DP_PORT=7575
KUMP_POST_GROUP_NAME=TADDM
KUMP_POST_APPL_TTL=14400
  3. In the $ITM_HOME/interp/um/metafiles directory, create a text file. Enter the following information in the file: 
    //APPl CONFIGCHANGE
//NAME dpPost E 3600
//ATTRIBUTES ';'
Post_Time T 16 Caption{Time} 
Post_Origin D 32 Caption{Origination} 
Post_Ack_Stamp D 28 Caption{Event time stamp} 
Comp_Type D 512 Caption{Component type} 
Comp_Name D 512 Caption{Component name} 
Comp_Guid D 512 Caption{Component GUID} 
Change_Type D 512 Caption{Change type} 
Chg_Det_Time D 512 Caption{Change detection time} 
Chg_Attr D 512 Caption{Changed attribute} 
Srv_Addr D 512 Caption{TADDM server} 
Srv_Port D 16 Caption{TADDM port}
  4. Save the file as KUMPOST.
    Note: Ensure that you spell the file name, KUMPOST, with uppercase letters, as shown here.
  5. Restart the Universal Agent using the following commands: 
    itmcmd agent stop um
    itmcmd agent start um
  6. To validate and refresh the KUMPOST metafile, complete the following steps:
    1. Run the $ITM_HOME/bin/um_console command with the following parameters: 
      um_console -h <ITM directory>
    2. At the command line, type the following text:
      validate KUMPOST
      Messages similar to the following are displayed:
      KUMPS001I Console input accepted.
KUMPV025I Processing input metafile /opt/IBM/ITM//lx8266/um/metafiles/KUMPOST
KUMPV026I Processing record 0001 -> //APPl CONFIGCHANGE
KUMPV148I Note: APPL names starting with letters A-M are designated for 
Best Practices and Business Partner UA solutions.
KUMPV026I Processing record 0002 ->     //NAME dpPost E 3600
KUMPV026I Processing record 0003 ->     //ATTRIBUTES ';'
KUMPV026I Processing record 0004 -> Post_Time T 16 Caption{Time}
KUMPV026I Processing record 0005 -> Post_Origin D 32 Caption{Origination}
KUMPV026I Processing record 0006 -> Post_Ack_Stamp D 28 Caption{Event time stamp}
KUMPV026I Processing record 0007 -> Comp_Type D 512 Caption{Component type}
KUMPV026I Processing record 0008 -> Comp_Name D 512 Caption{Component name}
KUMPV026I Processing record 0009 -> Comp_Guid D 512 Caption{Component GUID}
KUMPV026I Processing record 0010 -> Change_Type D 512 Caption{Change type}
KUMPV026I Processing record 0011 -> Chg_Det_Time D 512 Caption{Change detection time}
KUMPV026I Processing record 0012 -> Chg_Attr D 512 Caption{Changed attribute}
KUMPV026I Processing record 0013 -> Srv_Addr D 512 Caption{TADDM server}
KUMPV026I Processing record 0014 -> Srv_Port D 16 Caption{TADDM port}
KUMPV000I Validation completed successfully
KUMPV090I Application metafile validation report saved in file 
/opt/IBM/ITM//lx8266/um/metafiles/KUMPOST.rpt.
    3. When prompted for the action you want to perform on the metafile, type the following text:
      Refresh
    4. Type Yes to confirm.
To verify that the Universal Agent configuration has been successful, check the change event report in the Tivoli Enterprise Portal.
To open the change event report using IBM Tivoli Monitoring 6.2.1, or later, complete the following steps:
  1. Navigate to the Universal Agent that was configured to send and receive event notifications from TADDM.
  2. Expand the CONFIGCHANGE node.
  3. Click the DPPOST node.