Informatica Plug-in for IBM Tivoli Monitoring · v Preface The Informatica Plug-in for IBM Tivoli Monitoring User Guide is written for administrators responsible for installing, configuring

User Guide

Informatica® Plug-in for IBM Tivoli Monitoring(Version 8.5.1)

Informatica® Plug-in for IBM Tivoli Monitoring User Guide

Version 8.5.1 April 2009

Copyright © 2009 Informatica Corporation. All rights reserved. Printed in the USA.

This software and documentation contain proprietary information of Informatica Corporation and are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright law. Reverse engineering of the software is prohibited. No part of this document may be reproduced or transmitted in any form, by any means (electronic, photocopying, recording or otherwise) without prior consent of Informatica Corporation. This Software may be protected by U.S. and international Patents and other Patents Pending.

Use, duplication, or disclosure of the Software by the U.S. Government is subject to the restrictions set forth in the applicable software license agreement and as provided in DFARS 227.7202-1(a) and 227.7702-3(a) (1995), DFARS 252.227-7013(c)(1)(ii) (OCT 1988), FAR 12.212(a) (1995), FAR 52.227-19, or FAR 52.227-14 (ALT III), as applicable.

The information in this product or documentation is subject to change without notice. If you find any problems in this product or documentation, please report them to us in writing.

Informatica, PowerCenter, PowerExchange, Informatica B2B Data Exchange, Informatica Data Quality, Informatica Data Explorer, Informatica Identity Resolution and Matching, Informatica On Demand, PowerMart, PowerBridge, PowerConnect, PowerChannel, PowerPartner, PowerAnalyzer, PowerCenter Connect and PowerPlug are trademarks or registered trademarks of Informatica Corporation in the United States and in jurisdictions throughout the world. All other company and product names may be trade names or trademarks of their respective owners.

The product includes software © Copyright 2002-2009 The Perl Foundation. All Rights Reserved (http://dev.perl.org/perl5/news/2006/perl-5.8.8.html). Permissions and limitations regarding this software are subject to terms available at http://dev.perl.org/licenses/.

DISCLAIMER: Informatica Corporation provides this documentation “as is” without warranty of any kind, either express or implied, including, but not limited to, the implied warranties of non-infringement, merchantability, or use for a particular purpose. Informatica Corporation does not warrant that this software or documentation is error free. The information provided in this software or documentation may include technical inaccuracies or typographical errors. The information in this software and documentation is subject to change at any time without notice.

Part Number: SPI_TVU_85100_0001

Table of Contents

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v

Informatica Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi

Informatica Customer Portal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi

Informatica Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi

Informatica Web Site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi

Informatica How-To Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi

Informatica Knowledge Base . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi

Informatica Global Customer Support . . . . . . . . . . . . . . . . . . . . . . . . . . vii

Chapter 1: Understanding Informatica Plug-in . . . . . . . . . . . . . . . . . . . 1

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Chapter 2: Installation and Configuration. . . . . . . . . . . . . . . . . . . . . . . 5

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Installing and Configuring Informatica Plug-in . . . . . . . . . . . . . . . . . . . . 6

Step 1. Install Informatica Plug-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Installing the Informatica Plug-in Package . . . . . . . . . . . . . . . . . . . . . . . . 7

Copying the Configuration Files (Optional) . . . . . . . . . . . . . . . . . . . . . . 7

Step 2. Configure Tivoli Enterprise Monitoring Portal Workspaces (Optional) . 9

Step 3. Configure Tivoli Environment Variables . . . . . . . . . . . . . . . . . . . . . . 10

Step 4. Configure the Tivoli Event Server . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Step 5. Install the Informatica Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Step 6. Configure Informatica Plug-in Monitoring . . . . . . . . . . . . . . . . . . . . 14

Defining TEC to Receive the Informatica Alarms . . . . . . . . . . . . . . . . . . 15

Registering the Informatica Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Managing Informatica Plug-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Changing Informatica Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Changing Monitor Intervals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Uninstalling Informatica Plug-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Unregistering the Informatica Monitors . . . . . . . . . . . . . . . . . . . . . . . . . 18

Removing the Informatica Plug-in Package from the Informatica System . 18

Removing the Informatica Plug-in Package from the TEMS . . . . . . . . . . 19

Table of Contents iii

Chapter 3: Working with Informatica Plug-in . . . . . . . . . . . . . . . . . . .21

Viewing Alarms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Informatica Plug-in Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Baroc File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Rules File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Monitoring Informatica Component Status . . . . . . . . . . . . . . . . . . . . . . . . . 24

Monitoring PowerCenter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Monitoring PowerExchange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Informatica Plug-in Debugging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Appendix A: Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

iv Table of Contents

Preface

The Informatica Plug-in for IBM Tivoli Monitoring User Guide is written for administrators responsible for installing, configuring and managing Informatica Plug-in for IBM Tivoli Monitoring. It helps first-time users learn how to use Informatica Plug-in.

This guide assumes you have knowledge of your operating systems, IBM Tivoli Monitoring, and Informatica PowerCenter and PowerExchange. It also assumes you are familiar with the interface requirements for the supporting applications.

v

Informatica Resources

Informatica Customer Portal

As an Informatica customer, you can access the Informatica Customer Portal site at http://my.informatica.com. The site contains product information, user group information, newsletters, access to the Informatica customer support case management system (ATLAS), the Informatica How-To Library, the Informatica Knowledge Base, Informatica Documentation Center, and access to the Informatica user community.

Informatica Documentation

The Informatica Documentation team takes every effort to create accurate, usable documentation. If you have questions, comments, or ideas about this documentation, contact the Informatica Documentation team through email at [email protected]. We will use your feedback to improve our documentation. Let us know if we can contact you regarding your comments.

The Documentation team updates documentation as needed. To get the latest documentation for your product, navigate to the Informatica Documentation Center from http://my.informatica.com.

Informatica Web Site

You can access the Informatica corporate web site at http://www.informatica.com. The site contains information about Informatica, its background, upcoming events, and sales offices. You will also find product and partner information. The services area of the site includes important information about technical support, training and education, and implementation services.

Informatica How-To Library

As an Informatica customer, you can access the Informatica How-To Library at http://my.informatica.com. The How-To Library is a collection of resources to help you learn more about Informatica products and features. It includes articles and interactive demonstrations that provide solutions to common problems, compare features and behaviors, and guide you through performing specific real-world tasks.

Informatica Knowledge Base

As an Informatica customer, you can access the Informatica Knowledge Base at http://my.informatica.com. Use the Knowledge Base to search for documented solutions to known technical issues about Informatica products. You can also find answers to frequently asked questions, technical white papers, and technical tips.

vi Preface

Informatica Global Customer Support

There are many ways to access Informatica Global Customer Support. You can contact a Customer Support Center through telephone, email, or the WebSupport Service.

Use the following email addresses to contact Informatica Global Customer Support:

♦ [email protected] for technical inquiries

♦ [email protected] for general customer service requests

WebSupport requires a user name and password. You can request a user name and password at http://my.informatica.com.

Use the following telephone numbers to contact Informatica Global Customer Support:

North America / South America Europe / Middle East / Africa Asia / Australia

Informatica Corporation Headquarters100 Cardinal WayRedwood City, California 94063United States

Toll Free +1 877 463 2435

Standard RateBrazil: +55 11 3523 7761 Mexico: +52 55 1168 9763 United States: +1 650 385 5800

Informatica Software Ltd.6 Waltham ParkWaltham Road, White WalthamMaidenhead, BerkshireSL6 3TNUnited Kingdom

Toll Free 00 800 4632 4357

Standard RateBelgium: +32 15 281 702France: +33 1 41 38 92 26Germany: +49 1805 702 702Netherlands: +31 306 022 797Spain and Portugal: +34 93 480 3760United Kingdom: +44 1628 511 445

Informatica Business Solutions Pvt. Ltd.Diamond DistrictTower B, 3rd Floor150 Airport RoadBangalore 560 008India

Toll Free Australia: 1 800 151 830Singapore: 001 800 4632 4357

Standard RateIndia: +91 80 4112 5738

Preface vii

viii Preface

C h a p t e r 1

Understanding Informatica Plug-in

This chapter includes the following topics:

♦ Overview, 2

♦ Architecture, 3

1

Overview

IBM Tivoli Monitoring is a software solution designed to help administrators monitor and manage critical hardware and software in distributed environments. IBM Tivoli Monitoring uses the Informatica Plug-in to monitor, recognize, solve, and prevent problems reported by Informatica components.

Informatica Plug-in consists of a set of extensions to and customizations of IBM Tivoli Monitoring, which allow for quick and seamless integration with Informatica PowerCenter and PowerExchange.

Informatica Plug-in monitors the status of the following Informatica components:

♦ PowerCenter nodes

♦ PowerCenter services

♦ PowerCenter workflows

♦ PowerExchange Listener services

♦ PowerExchange Condense processes

Informatica Plug-in for IBM Tivoli Monitoring reports only the Informatica component status information that is relevant to the administrator. The following configuration files define the information that Informatica Plug-in reports:

♦ infa.rls file. Prevents sending duplicate information to the Tivoli Enterprise Console Event Server. This file ensures that alarms are sent only when the status of a component changes.

♦ example.rls file. Provides rules for monitoring a specific component, such as a workflow. To load this file, use the wrb command.

♦ infa.baroc file. Defines the message class for a particular monitor.

In environments where Informatica components are distributed across several systems, Informatica Plug-in has the following advantages:

♦ Centralized monitoring of Informatica component status

♦ Real-time monitoring of Informatica component status

2 Chapter 1: Understanding Informatica Plug-in

Architecture

Informatica Plug-in for IBM Tivoli Monitoring is not supported in Tivoli Monitoring Regions, only in non-TME environments. Informatica Plug-in does not require the installed Tivoli Management Framework or Tivoli agents to send alarms to the Tivoli Enterprise Console.

Tivoli Monitoring includes the following components for the Informatica PowerCenter and PowerExchange integration:

♦ Tivoli Management Framework, including the Tivoli Enterprise Console Event Server and Tivoli Enterprise Console Clients

♦ Tivoli Enterprise Monitoring Server

♦ Tivoli Universal Agent

♦ Tivoli Enterprise Portal Server and Tivoli Enterprise Portal Clients (optional)

The following figure shows the Informatica Plug-in architecture:

The Tivoli Enterprise Monitoring Server (TEMS) is a server that deploys the Informatica Agent. The Informatica Agent is an extension for the Tivoli Universal Agent. The Tivoli Universal Agent starts the data collection within the defined time frame, but needs the Informatica Agent to collect data on the status of monitors and Informatica components. The Tivoli Enterprise Console (TEC) receives alarms based on the status check that was started by the Tivoli Universal Agent.

TivoliEnterpriseMonitoringServer

Informatica Agent

Tivoli Universal Agent

Informatica

PowerExchange

Informatica

PowerCenter

Architecture 3

The following figure shows the Informatica Plug-in message flow:

A key component of Informatica Plug-in is the Informatica Agent, which queries PowerCenter and PowerExchange for monitored information. The postzmsg command sends the information to the Tivoli Enterprise Console (TEC). Within the TEC, the Tivoli Event Server filters the information and displays it in the form of various alarms. The Tivoli Event Server filters the alarms according to correlation rules and custom message class definitions.

A managed system is a computer system in a network that Tivoli Monitoring system monitors for performance, status, and messages.

Managed System

InformaticaPowerCenter

Services Workflow Node

InformaticaPowerExchange

Listener Condense

postzmsg

Informatica Agent

Tivoli

Tivoli

Enterprise

Console

EventServer

TivoliMonitoring

System

4 Chapter 1: Understanding Informatica Plug-in

C h a p t e r 2

Installation and Configuration


♦ Overview, 6

♦ Step 1. Install Informatica Plug-in, 7

♦ Step 2. Configure Tivoli Enterprise Monitoring Portal Workspaces (Optional), 9

♦ Step 3. Configure Tivoli Environment Variables, 10

♦ Step 4. Configure the Tivoli Event Server, 11

♦ Step 5. Install the Informatica Agent, 12

♦ Step 6. Configure Informatica Plug-in Monitoring, 14

♦ Managing Informatica Plug-in, 17

♦ Uninstalling Informatica Plug-in, 18

5

Overview

This chapter provides information about installing, configuring, managing, and uninstalling Informatica Plug-in for IBM Tivoli Monitoring. Install Informatica Plug-in to extend and customize Tivoli Monitoring.

Informatica Plug-in includes the following extensions:

♦ Information sources. Access and relay information about the status of Informatica components to Tivoli Monitoring System.

♦ Configuration files. Correlation rules files and custom message class definitions that define the component status and information to report.

Prerequisites

Before you install Informatica Plug-in, install and configure the following products:

♦ Non-TME environment

♦ Tivoli Universal Agent on the systems where you want to monitor PowerCenter and PowerExchange

♦ PowerCenter, PowerExchange, or both, depending on what you want to monitor

♦ Lsof version 4.7 or higher on AIX

♦ Sharutils 4.2.1-22.2 on Linux systems where you want to deploy the Informatica Agent

Installing and Configuring Informatica Plug-in

To install and configure Informatica Plug-in, complete the following steps:

1. Install Informatica Plug-in.

2. Configure Tivoli Enterprise Monitoring Portal Workspaces (optional).

3. Configure Tivoli environment variables.

4. Configure the Tivoli Event Server.

5. Install the Informatica Agent.

6. Configure Informatica Plug-in monitoring.

6 Chapter 2: Installation and Configuration

Step 1. Install Informatica Plug-in

Informatica Plug-in for IBM Tivoli Monitoring installation is provided in one server distribution package that contains all the components required for monitoring. The distribution package contains the following components:

♦ Agent package.

♦ Installation and removal script for each supported managed platform.

♦ Distribution configuration file used to deploy Informatica Plug-in from central Tivoli Enterprise Management Server to managed systems.

♦ Prepackaged Perl, which is automatically installed.

To install Informatica Plug-in, complete the following steps on the Tivoli Enterprise Monitoring Server system:

1. Install the Informatica Plug-in package.

2. Optionally, if the Tivoli Enterprise Console Server is installed on a different system, copy the configuration files to the Tivoli Enterprise Console Server machine.

Installing the Informatica Plug-in Package

To install Informatica Plug-in package on UNIX:

Change to the directory with the Informatica Plug-in package and run the following command:

sh INFA-SPI.shar

To install Informatica Plug-in package on Windows:

1. Change to the directory with the Informatica Plug-in package.

2. Double-click the INFA-SPI.msi file.

3. Follow the installation wizard to complete the installation.

Copying the Configuration Files (Optional)

If the Tivoli Enterprise Console Server (TECS) is installed on a different machine than Tivoli Enterprise Monitoring Server (TEMS), copy the following configuration files from the TEMS machine to the TECS machine:

♦ Rules files (*.rls)

♦ Baroc files (*.baroc)

The configuration files are located in the following directory:

♦ On UNIX:

$CANDLEHOME/infaspi/config/tec/

Step 1. Install Informatica Plug-in 7

♦ On Windows:

%CANDLE_HOME%\infaspi\config\tec\

<CANDLE_HOME> is the Tivoli Monitoring installation directory. The default value for CANDLE_HOME is /opt/IBM/ITM on UNIX, and C:\ibm\itm on Windows.

To copy the configuration files on UNIX:

1. Log in as a system administrator to the operating system where the TECS is running.

2. Run the following command to create the following directory:

mkdir -p $TISDIR/../../infaspi/

3. Copy the configuration files from TEMS $CANDLEHOME/infaspi/config/tec/ to TECS $TISDIR/../../infaspi/.

To copy the configuration files on Windows:

1. Log in as a system administrator to the operating system where the TECS runs.

2. Run the following command to create the following directory:

md "%TISDIR%\..\..\infaspi"

3. Copy the configuration files from TEMS CANDLE_HOME%\infaspi\config\tec\ to TECS %TISDIR%\..\..\infaspi.


Step 2. Configure Tivoli Enterprise Monitoring Portal Workspaces (Optional)

You can configure the Tivoli Monitoring environment to view TEC events in the Tivoli Enterprise Portal. For more information, see the IBM Tivoli Monitoring documentation.

Step 2. Configure Tivoli Enterprise Monitoring Portal Workspaces (Optional) 9

Step 3. Configure Tivoli Environment Variables

Configure the Tivoli environment to access the Tivoli command-line interface, tacmd.

To configure the Tivoli environment variables on UNIX:

1. Change to the following directory:

/etc/Tivoli

2. Run the following command:

. setup_env.sh

To configure the Tivoli environment variables on Windows:


%TISDIR%


setup_env.cmd


Step 4. Configure the Tivoli Event Server

To enable the Tivoli Event Server to accept messages from the Informatica Agent, configure the Tivoli Event Server as a central point where the Tivoli alarms are collected and processed. To configure the Tivoli Event Server, import the configuration files to Tivoli Event Server.

The Tivoli Event Server identifies alarms based on information defined in the rules and baroc files.

To import the configuration files on AIX:


$TISDIR/../../infaspi

2. Run the following command to import the configuration files and restart the server:

infaupload.sh RuleBaseName RuleBaseDir

RuleBaseName is the name of the Informatica Plug-in. By default, RuleBaseName is INFA. RuleBaseDir is the TEC temporary directory. By default, RuleBaseDir is /usr/local/Tivoli/RuleBase.

To import the configuration files on Windows:


%TISDIR%\..\..\infaspi

2. Run the following command to import the configuration files and restart the server:

infaupload.bat RuleBaseName RuleBaseDir

RuleBaseName is the name of the Informatica Plug-in. By default, RuleBaseName is INFA. RuleBaseDir is the TEC temporary directory. By default, RuleBaseDir is C:\RuleBase.

Step 4. Configure the Tivoli Event Server 11

Step 5. Install the Informatica Agent

Informatica Plug-in uses the Tivoli Universal Agent to deploy and configure the Informatica Agent on monitored systems.

You can install the Informatica Agent from the TEMS on AIX or Windows to any supported operating system.

To deploy the Informatica Agent from TEMS on AIX:

1. Run the following command to log in to the TEMS:

$CANDLEHOME/bin/tacmd login -s <server_name> -u <user_name> -p <password>

2. List the available managed systems and select the system to which you want to deploy the Informatica Agent:

$CANDLEHOME/bin/tacmd listsystems

3. Run the command to deploy the Informatica Agent.

For AIX, run the following command:

$CANDLEHOME/bin/tacmd addsystem -t um -n <managed_system_name> -p UA.CONFIG="infa_deploy.mdl" UA.SCRIPT="INFA-SUBAGT-AIX.shar"

For Linux, run the following command:

$CANDLEHOME/bin/tacmd addsystem -t um -n <managed_system_name> -p UA.CONFIG="infa_deploy.mdl" UA.SCRIPT="INFA-SUBAGT-LINUX.shar"

For Windows 32-bit, run the following command:

$CANDLEHOME/bin/tacmd addsystem -t um -n <managed_system_name> -p UA.CONFIG="infa_deploy.mdl" UA.SCRIPT="INFA-SUBAGT-32.msi"


$CANDLEHOME/bin/tacmd addsystem -t um -n <managed_system_name> -p UA.CONFIG="infa_deploy.mdl" UA.SCRIPT="INFA-SUBAGT-64.msi"

To deploy the Informatica Agent from TEMS on Windows:

1. Run the following command to log in to the TEMS:

%CANDLE_HOME%\bin\tacmd.exe login -s <server_name> -u <user_name> -p <password>

2. List the available managed systems and select the system to which you want to deploy the Informatica Agent:

%CANDLE_HOME%\bin\tacmd.exe listsystems

3. Run the command to deploy the Informatica Agent.

For AIX, run the following command:

%CANDLE_HOME%\bin\tacmd.exe addsystem -t um -n <managed_system_name> -p UA.CONFIG="infa_deploy.mdl" UA.SCRIPT="INFA-SUBAGT-AIX.shar"


For Linux, run the following command:

%CANDLE_HOME%\bin\tacmd.exe addsystem -t um -n <managed_system_name> -p UA.CONFIG="infa_deploy.mdl" UA.SCRIPT="INFA-SUBAGT-LINUX.shar"


%CANDLE_HOME%\bin\tacmd.exe addsystem -t um -n <managed_system_name> -p UA.CONFIG="infa_deploy.mdl" UA.SCRIPT="INFA-SUBAGT-32.msi"


%CANDLE_HOME%\bin\tacmd.exe addsystem -t um -n <managed_system_name> -p UA.CONFIG="infa_deploy.mdl" UA.SCRIPT="INFA-SUBAGT-64.msi"

To install the Informatica Agent on UNIX:

1. Log in as a system administrator to the managed system with the Informatica Agent.


$CANDLEHOME/tmaitm6/agentdepot

3. Run the command to install the Informatica Agent.

On AIX, run the following command:

sh INFA-SUBAGT-AIX.shar

On Linux, run the following command:

sh INFA-SUBAGT-LINUX.shar

To install the Informatica Agent on Windows:



%CANDLE_HOME\TMAITM6\agentdepot

3. Start the installer.

On Windows 32-bit, double-click the INFA-SUBAGT-32.msi file.

On Windows 64-bit, double-click the INFA-SUBAGT-64.msi file.

4. Follow the installation wizard to complete the installation.

Step 5. Install the Informatica Agent 13

Step 6. Configure Informatica Plug-in Monitoring

The Informatica Plug-in infa_register_spi.pl script configures managed systems with Informatica. Register systems to distribute Informatica Plug-in software to them and to receive data about them.

Before you start the infa_register_spi.pl script, verify that PowerCenter is running on Informatica managed systems you want to register. Start the script locally on the Informatica managed system.

The infa_register_spi.pl script uses a series of questions to gather the data required to register managed systems with Informatica. Provide data to the script for every open infa_register_spi.pl script terminal. The data is stored in the infa-spi-config.properties file and its locale-specific counterparts.

To configure Informatica Plug-in monitoring:

1. Start the infa_register_spi.pl script.

On UNIX, log in to the Informatica managed system as a root user and run the following command:

$CANDLEHOME/infaspi/bin/infa_perl.bat infa_register_spi.sh

On Windows, log in to the Informatica managed system as an administrator and run the following command:

%CANDLE_HOME%\infaspi\bin\infa_perl.bat infa_register_spi.pl

2. In the application script terminal, enter the PowerCenter home directory or press Enter to confirm the default directory.

On UNIX, the default directory is /Informatica/PowerCenter8.5.1.

On Windows, the default directory is C:\Informatica\PowerCenter8.5.1.

Or, if PowerCenter is not installed on this managed system, enter S.

3. For every PowerCenter Integration Service on which you want to monitor workflows, enter Y. Or, for every PowerCenter Integration Service on which you do not want to monitor workflows, enter N.

The script lists each Integration Service that runs on the monitored PowerCenter system, matches them against each Repository Service, and lists matched pairs as suggestions.

4. If you want to monitor PowerCenter workflows and PowerCenter services on the managed system, enter the username and password for an Informatica user with the required rights. If you do not want to monitor PowerCenter workflows and PowerCenter services on the managed node, press Enter to skip this step.

Workflow and service monitor require Informatica credentials to list and gather status for all monitored objects.


5. When you enter the user credentials, enter Y to confirm the credentials. Enter N to enter new credentials.

The script verifies if a connection to the PowerCenter repository can be established. If the connection cannot be established, verify the user credentials and check if Informatica services are running.

6. If you want to monitor PowerCenter nodes, enter Y. Otherwise, enter N.

7. If you want to monitor PowerCenter workflows, enter Y. Otherwise, enter N.

The script lists all PowerCenter services that are configured to run on the monitored PowerCenter system.

8. For every PowerCenter service you want to monitor, enter Y. Or, for every PowerCenter service you do not want to monitor, enter N.

9. If you want to monitor another PowerCenter instance on the managed system, enter Y. Otherwise, enter N.

10. Enter the PowerExchange home directory or press Enter to confirm the default directory.

On UNIX, the default directory is /Informatica/PowerExchange.

On Windows, the default directory is C:\Informatica\PowerExchange.

Or if PowerExchange is not installed on this managed system, enter S.

11. For the PowerExchange processes you want to monitor, enter Y. Or, for the PowerExchange processes you do not want to monitor, enter N.

12. Enter the absolute path to the PowerExchange Listener configuration file.

Enter the absolute path to the PowerExchange Listener configuration file or press Enter to confirm the default. The default is /Informatica/PowerExchange/dbmover.cfg.

You can enter additional paths, or enter S and press Enter to continue.

13. If you want to monitor another PowerExchange instance on the managed system, enter Y. Otherwise, enter N.

The configuration script updates the infa-spi-config.properties file and configures the Informatica Plug-in.

Defining TEC to Receive the Informatica Alarms

To define the TEC to receive alarms from the managed system, create the server.txt file. The server.txt file is a configuration file for the postzmsg command. It defines the TECS location and port where alarms are sent.

To define the TEC to receive Informatica alarms:


2. Create the server.txt file in the following directory:

Step 6. Configure Informatica Plug-in Monitoring 15

On UNIX:

$CANDLE_HOME/infaspi/config/server.txt

On Windows:

%CANDLE_HOME%\infaspi\config\server.txt

3. Enter the following information:

ServerLocation=<full_TEC_name>

ServerPort=<port_nr>

BufferEvents=NO

<full_TEC_name> represents the TECS fully qualified domain name. By default, <port_nr> on a Windows TECS is 5529, and on an AIX TECS is 0.

4. Save the file.

Registering the Informatica Agent

To register the Informatica Agent on UNIX:

1. Log in as a system administrator to the TEMS.


$CANDLEHOME/bin/tacmd configuresystem -m <managed_system_name> -p UA.CONFIG="<monitor_name>.mdl" UA.RESTART="Y"

<monitor_name> represents the monitor that you want to integrate with the Tivoli Universal Agent. For more information about the PowerCenter and PowerExchange components that you can monitor, see “Monitoring Informatica Component Status” on page 24.

3. Run the following command to log out:

$CANDLEHOME/bin/tacmd logout

To register the Informatica Agent on Windows:

1. Log in as a system administrator to the TEMS.


%CANDLE_HOME%\bin\tacmd.exe configuresystem -m <managed_system_name> -p UA.CONFIG="<monitor_name>.mdl" UA.RESTART="Y"

<monitor_name> represents the monitor that you want to integrate with the Tivoli Universal Agent. For more information about the PowerCenter and PowerExchange components that you can monitor, see “Monitoring Informatica Component Status” on page 24.

3. Run the following command to log out:

%CANDLE_HOME%\bin\tacmd.exe logout


Managing Informatica Plug-in

You can change the Informatica configuration and monitor intervals on managed systems.

Changing Informatica Configuration

You change the configuration by running the configuration script infa_register_spi.pl. When you start the configuration script, the script displays values that were previously saved in the configuration file as default values.

To change the configuration:

1. Log in to the Informatica managed system and run one of the following commands:

On UNIX:

$CANDLEHOME/infaspi/bin/infa_perl.bat infa_register_spi.pl

On Windows:

%CANDLE_HOME%\infaspi\bin\infa_perl.bat infa_register_spi.pl

2. In an application script terminal, change the script options.

For more information, see “Step 6. Configure Informatica Plug-in Monitoring” on page 14.

The Workflow Monitor process, INFAWFMon, restarts automatically after you complete the configuration.

Changing Monitor Intervals

You can change the monitor intervals to reduce the time for data collection for particular monitors, such as the service monitor.

To change the monitor intervals:

1. Log in to the TEMS as a system administrator.

2. Edit the <monitor_name>.mdl file.

<monitor_name> represents the monitor for which you want to change the polling interval, for example INFAPCISMon.mdl.

Change the numeric value of the interval in the following line:

//SOURCE SCRIPT test.bat Interval=500

The interval is defined in seconds.

3. Save the file.

4. In the console, run the following command:

<CANDLE_HOME>/bin/tacmd configuresystem -m <managed_system_name> -p UA.CONFIG="<monitor_name>.mdl" UA.RESTART="Y"

Managing Informatica Plug-in 17

Uninstalling Informatica Plug-in

Uninstall the Informatica Agent to unregister Informatica Plug-in from the Tivoli Universal Agent. When you uninstall the Informatica Plug-in from the Tivoli Universal Agent, uninstall Informatica from the TEMS.

To uninstall Informatica Plug-in, complete the following steps:

1. Unregister the Informatica monitors.

2. Remove the Informatica Plug-in from the Informatica system.

3. Remove the Informatica Plug-in package from the TEMS.

Unregistering the Informatica Monitors

Unregister the Informatica monitors to stop receiving data from Informatica Plug-in and to remove Informatica Plug-in software from the managed systems.

To unregister the Informatica monitors on UNIX:

Run the following commands for every monitor you want to unregister:

um_console -h $CANDLEHOME

delete $CANDLEHOME/tmaitm6/infa/config/<monitor_name>.mdl

To unregister the Informatica monitors on Windows:

Run the following command for every monitor you want to unregister:

kumpcon delete %CANDLE_HOME%\TMAITM6\infa\config\<monitor_name>.mdl

Removing the Informatica Plug-in Package from the Informatica System

To remove the Informatica Plug-in package from the Informatica system on UNIX:

Run the following command:

$CANDLEHOME/infaspi/bin/infa_perl.bat infa_unregister_spi.pl

To remove the Informatica Plug-in package from the Informatica system on Windows:


%CANDLE_HOME%\infaspi\bin\infa_perl.bat infa_unregister_spi.pl


Removing the Informatica Plug-in Package from the TEMS

To remove the Informatica Plug-in package from TEMS on AIX:


rm -rf $CANDLEHOME/infaspi

To remove the Informatica Plug-in package from TEMS on Windows:

Use Add/Remove Programs to remove the Informatica Plug-in for IBM Tivoli Monitoring.

Uninstalling Informatica Plug-in 19


C h a p t e r 3

Working with Informatica Plug-in


♦ Viewing Alarms, 22

♦ Informatica Plug-in Components, 23

♦ Monitoring Informatica Component Status, 24

♦ Informatica Plug-in Debugging, 27

♦ Troubleshooting, 28

21

Viewing Alarms

Tivoli Enterprise Console (TEC) provides a centralized view of the network computing environment. The TEC collects, processes, and presents alarms based on configuration files.

To view and administer Informatica alarms, log in to the TEC as a system administrator.

Informatica alarms include the following details:

♦ Time received. Time the TEC receives the alarm.

♦ Event type. Type of event.

♦ Class. Name of the monitor.

♦ Hostname. Name of the system that sent the alarm.

♦ Severity. Severity of the alarm: Critical or Harmless.

♦ Status. Status of the alarm: Opened, Acknowledged, or Closed.

♦ Message. Description of the event that triggered the alarm.

22 Chapter 3: Working with Informatica Plug-in

Informatica Plug-in Components

Informatica Plug-in includes the following components:

♦ Baroc file

♦ Rules file

♦ Tools to configure managed systems with Informatica components

Baroc File

Informatica Plug-in uses the event class file, infa.baroc, to define different types of event class that the Tivoli Event Server receives. The infa.baroc file provides multiple event class definition according to the monitored Informatica components.

Tivoli Monitoring assigns a severity level to every alarm it displays. Informatica Plug-in uses the Critical and Harmless severity types.

Rules File

Tivoli Monitoring uses rules to specify and control responses to events throughout an enterprise. Informatica Plug-in uses the correlation rules file, infa.rls, to store and compare status checks. When a value of a particular event changes, the Informatica Agent sends an alarm to TEC.

Tools

Informatica Plug-in installs the following Informatica Plug-in tools:

♦ infa_register_spi.pl script. Use this tool to provide the following information to configure managed systems:

− PowerCenter home directory

− PowerCenter Integration Services on which you want to monitor workflows

− Credentials for an Informatica user to monitor PowerCenter workflows and PowerCenter services

− PowerExchange home directory

− PowerExchange processes you want to monitor

− Multiple PowerExchange Listener configuration file locations (optional)

♦ infa_unregister_spi.pl script. Use this tool to stop receiving data from the Informatica Plug-in and to remove the Informatica Plug-in software.

Informatica Plug-in Components 23

Monitoring Informatica Component Status

Informatica Plug-in includes the following monitors:

♦ INFAPC. PowerCenter Monitor.

♦ INFAPWX. PowerExchange Monitor.

Monitoring PowerCenter

Informatica Plug-in provides the following monitors for PowerCenter components and objects:

♦ Node Monitor

♦ Service Monitors

♦ Workflow Monitor

Node Monitor

The Node Monitor, INFAPCNodeMon, monitors managed nodes with PowerCenter.

The default polling interval for the monitor is one minute. The Node Monitor issues an alarm when the monitored PowerCenter node aborts or starts. An alarm contains information about the following parameters:

♦ PowerCenter domain name

♦ PowerCenter node name

♦ Managed node type: gateway or worker node

♦ PowerCenter node port

The alarm also provides information on node parameters and the location of the error log, such as “/Informatica/PowerCenter8.5.1/server/tomcat/logs/node.log.”

Service Monitors

Informatica Plug-in provides the following PowerCenter service monitors:

♦ INFAPCISMon. Integration Service Monitor.

♦ INFAPCMMMon. Metadata Manager Service Monitor.

♦ INFAPCRPSMon. Reporting Service Monitor.

♦ INFAPCRSMon. Repository Service Monitor.

♦ INFAPCSAPBWMon. SAP BW Service Monitor.

♦ INFAPCWSMon. Web Service Hub Monitor.


The default polling interval for each service monitor is five minutes. A service monitor issues an alarm when the monitored services have either aborted, stopped, or started. An alarm contains information about the following parameters:

♦ Service name


♦ PowerCenter service type


♦ Managed node name

♦ PowerCenter node port

The alarm also provides information for service identification and the exact command that you can use to retrieve the error log.

Note: If a service is running on a PowerCenter node grid, the monitor issues an alarm for every worker node on the grid.

Workflow Monitor

The Workflow Monitor, INFA_WFMon, monitors PowerCenter workflows on managed nodes with PowerCenter.

The default polling interval for the monitor is one minute. The Workflow Monitor issues an alarm when a workflow on the monitored Integration Service has failed, stopped, succeeded, or suspended. An alarm contains information about the following parameters:

♦ PowerCenter workflow name



♦ PowerCenter Repository Service name

♦ PowerCenter Integration Service name

♦ PowerCenter repository folder name

♦ PowerCenter workflow run instance name

♦ PowerCenter workflow run instance ID

♦ PowerCenter workflow run user name

The alarm also contains required information for workflow identification and provides the exact command that you can use to retrieve the error log.

Monitoring PowerExchange

Informatica Plug-in provides the following monitors for PowerExchange components and processes:

♦ Condense Monitor

♦ Listener Monitor

Monitoring Informatica Component Status 25

Condense Monitor

The Condense Monitor, INFAPWXCondenseMon, monitors PowerExchange Condense processes.

The default polling interval for the monitors is one minute. The monitor issues an alarm when a PowerExchange Condense process has either failed or started. An alarm contains information about the following parameters:

♦ Dbmover file name

♦ PowerExchange Condense configuration file name

The alarm also contains required information for service identification.

Listener Monitor

The Listener Monitor, INFAPWXListenerMon, monitors PowerExchange database server Listeners.

The default polling interval for the monitors is one minute. The monitor issues an alarm when a PowerExchange Listener has failed or started. An alarm contains information about the following parameters:

♦ PowerExchange Listener name

♦ PowerExchange source

♦ PowerExchange Listener protocol

♦ PowerExchange Listener port

The alarm also contains required information for Listener identification.


Informatica Plug-in Debugging

Informatica Plug-in provides debugging so you can view details about logged events. By default, the debugging is disabled. Enable debugging to view additional information to help resolve any issues you might have.

To enable Informatica Plug-in debugging:


On UNIX:

$CANDLEHOME/infaspi/lib

On Windows:

%CANDLE_HOME%\infaspi\lib\

2. Change the debug option from 0 to 1 in the following perl modules as shown:

ConfigUtil.pm:my $debug = 1;

ConfigUtil.pm:'Debug' => 1

LocalConfig.pm: Debug' => 1

NodeMonitor.pm:'Debug' => 1

PWXCondenseMonitor.pm:'Debug' => 1

PWXListenerMonitor.pm:'debug' => 1

RemoteConfig.pm:'Debug' => 1

Terminal.pm: Debug => 1

Informatica Plug-in Debugging 27

Troubleshooting

The monitor interval is too short for the environment.

Informatica Plug-in verifies the monitor status based on the interval configured in the associated .mdl file. If the following text appears in the log file, the configured interval is too short for the environment:

(49CBDBBF.0000-16:kumplscr.c,2678,"KUMP_LaunchScript") ***** Child process 413904 </opt/IBM/ITM/aix526/um/work/../scripts/infa_perl.bat> did not exit in the 60 seconds allowed

Update the monitor interval. For more information, see “Changing Monitor Intervals” on page 17.


A p p e n d i x A

Glossary

alarm

A message that appears at a console to indicate an event has occurred. Provides information about the status of a managed object, an event related to a managed object, or a problem with a managed object.

baroc file

An internal representation of the defined event classes at the Tivoli Event Server. Defines the type of information that the Informatica Agent sends to the Tivoli Event Server.

event

Any significant change in the state of a system resource, network resource, or network application. An event can be generated for a problem, for the resolution of a problem, or for the successful completion of a task.

Informatica Agent

An Informatica Plug-in module that queries PowerCenter and PowerExchange for monitored information.

29

managed system

A computer system in a network that a Tivoli Monitoring system monitors for performance, status, and messages. Includes the Tivoli Enterprise Monitoring Agent.

postzmsg

A command that sends an event to an Tivoli Event Server. This command works in non-TME environments where Tivoli software is not installed.

rules file

A file that identifies events and prevents duplicate events from appearing in the event list.

Tivoli Enterprise Console

An interface for viewing the events stream from the Informatica Agent.

Tivoli Enterprise Monitoring Server

A host data management component for IBM Tivoli Monitoring that provides a collection and control point for alerts received from agents.

Tivoli Enterprise Portal Server

A repository of user data that displays methods, such as workspaces and views. It also enables the retrieval, manipulation, and analysis of data from monitoring agents.

Tivoli Enterprise Portal Client

An application that connects to the Tivoli Enterprise Portal Server to display all monitoring data.

Tivoli Monitoring system

A user interface that consists of a Tivoli Enterprise Console and Tivoli Event Server. Tivoli Event Server receives information from the Informatica Agent, and then correlates and displays the information in the form of alarms.

Tivoli Universal Agent

The part of Tivoli system that collects and distributes data from various applications, databases, and servers.

30 Appendix A: Glossary

Documents

Informatica Plug-in for IBM Tivoli Monitoring · v Preface The Informatica Plug-in for IBM Tivoli Monitoring User Guide is written for administrators responsible for installing, configuring