Title How to Configuring Data Collection for ITCAM for SOA When Upgrading IBM BPM Licensed Materials – Property of IBM Note: Before using this information and the product it supports, read the information in “Notices” © Copyright IBM Corporation 2013. US Government Users Restricted Rights–Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Background and Challenges To ensure that environment will not be damaged after upgrading, a worry-free guidance for upgrading is an important topic. This document provides a step by step solution to configure data collection for ITCAM for SOA when upgrading IBM BPM. Experience We should understand the ITCAM for SOA architecture first before starting the solution. ITCAM for SOA is installed and operates within the management infrastructure of the IBM Tivoli Monitoring environment. ITCAM for SOA has several components. Figure 1 . The ITCAM for SOA architecture diagram Component 1. Data collector An ITCAM for SOA data collector must be deployed and configured for every monitored runtime environment. The data collector is installed locally on the runtime environment host. The data collector saves data in metric files. The monitoring agent uses these files to prepare information for display in the Tivoli Enterprise Portal. You can also use these files with Web Services Navigator for detailed analysis. The data collector detects the information flow topology on the runtime environment and tracks the message traffic within the environment. The data collector collects the following information for every message: Source and destination (system name, application server name, service port name, and operation name) If the message is a request or a response Interaction type (synchronous or asynchronous) The association of a request to its response during an asynchronous interaction The response time for the message Whether the message generated a fault Whether the message is a one-way or a two-way message Optionally, the actual header and body content of the message itself A separate data collector is used for monitoring DataPower appliances. It collects the same information by acting as a proxy between the appliance and other services. Component 2. ITCAM for SOA monitoring agent An ITCAM for SOA Tivoli Enterprise Monitoring Agent (monitoring agent) interacts with the data collectors. The monitoring agent is installed on every host that runs one or more runtime environments. It receives data from the data collectors that are configured for the environments, and transmits it to the Tivoli Enterprise Monitoring Server. Component 3. ITCAM for SOA SDMS monitoring agent The ITCAM for SOA SDMS agent is provided with ITCAM for SOA version 7.2.0.1 and later. The agent is required if you want to view Business Process Management monitoring data in the IBM SmartCloud Application Performance Management version 7.6 or later. The agent provides minimal user-visible content in the Tivoli Enterprise Portal. No agent-specific Workspaces, situations, or take action commands are provided. The attribute groups are designed to provide a data interface to the Application Performance Management UI rather than for use in the Tivoli Enterprise Portal. Component 4. Tivoli Enterprise Monitoring Server infrastructure The Tivoli Enterprise Monitoring Server infrastructure consists of one or more Tivoli Enterprise Monitoring Servers and a Tivoli Enterprise Portal Server. It works with various agents, including the ITCAM for SOA monitoring agent. For more information about this infrastructure, see the Tivoli Enterprise Monitoring information center at http://publib.boulder.ibm.com/infocenter/tivihelp/v15r1/index.jsp?topic=%2Fcom.ibm.itm. doc_6.2.2fp2%2Fwelcome.htm. Use the Tivoli Enterprise Portal to view service-to-service topology spanning multiple servers, along with detailed information for individual servers. The Tivoli Monitoring Infrastructure also saves the monitoring information to the Tivoli Data Warehouse. Use ITCAM for SOA Agent Reports to create predefined and on-demand reports based on the monitoring information in Tivoli Data Warehouse. Component 5. Discovery Library Adapters Discovery Library Adapters (DLAs) run on the Tivoli Enterprise Portal Server. A DLA is a program that extracts data from a source application and creates XML files to pass to Tivoli Common Object Repository. Component 6. Tivoli Common Object Repository Tivoli Common Object Repository (TCORE) runs on the Tivoli Enterprise Portal Server. TCORE stores information that is received from DLAs in a database and passes the information to the SOA Domain Management Server. This information enables SOA Domain Management Server to integrate service registry and business process information with the information about service resources. Component 7. SOA Domain Management Server The SOA Domain Management Server runs on the Tivoli Enterprise Portal Server. The management server aggregates information received from monitored servers and prepares a single view of service-toservice topology. The management server also manages interaction between ITCAM for SOA and several other products. Configuring data collection for ITCAM for SOA when upgrading IBM BPM Before you upgrade from IBM BPM version 7.5.1.1 or later to IBM BPM version 8.0 or later, you must unconfigure ITCAM Data Collector for WebSphere. After you upgrade to IBM BPM version 8.0 or later, reconfigure the data collector with the same settings. Complete the following steps: 1. Unconfigure ITCAM Data Collector for WebSphere from all application server instances that you plan to migrate. Use the ITCAM Data Collector for WebSphere Unconfiguration utility to unconfigure the data collector as below steps: <1> From a command line, navigate to the DC_home\bin directory on Windows systems or the DC_home/bin directory on Linux or UNIX systems. <2> Set the location of the Java home directory before you run the script. For example: On Windows systems: set JAVA_HOME=C:\Progra~1\IBM\WebSphere\AppServer80\java On Linux or UNIX systems: export JAVA_HOME=/opt/IBM/AppServer80/java <3> Run the following command to start the ITCAM Data Collector for WebSphere Unconfiguration utility. On Windows systems: DC_home\bin\unconfig.bat On Linux or UNIX systems: DC_home/bin/unconfig.sh The utility searches for all server instances that are monitored by the ITCAM Data Collector for WebSphere. Remember: Application server instances must be running during the unconfiguration procedure. For Network Deployment environment, the Node Agent and Deployment Manager must also be running. The utility prompts you to select one or more application server instances from the list of configured servers: Choose one or more servers to unconfigure for data collection: Application Servers configured by the current version: 1. co098170Node01Cell.co098170Node01.server1(AppSrv01) Enter a number or numbers separated by commas, or enter * to select all. <4> Enter the number that corresponds to the application server instance to unconfigure for data collection or enter an asterisk (*) to unconfigure data collection for all application server instances. To specify a subset of servers, enter the numbers, separated by commas, that represent the servers. For example: 1,2,3. <5> The utility prompts you to specify whether you want to create a backup of your current WebSphere Application Server configuration: Do you want to backup current WebSphere configuration? [1 - YES, 2 - NO] [default is: 2]: Enter 1 to create a backup of the current configuration. Otherwise, enter 2 and skip to step 7. <6> The utility prompts you to specify the directory in which to store the backup of the configuration. For example: On Windows systems: Enter backup directory [default is: C:\IBM\ITM_DC\dchome\7.2.0.0.3\data]: On Linux or UNIX systems: Enter backup directory [default is: /opt/IBM/ITM_DC/dchome/7.2.0.0.3/data]: Specify a directory in which to store the backup of the configuration or accept the default directory. <7> The utility displays the name of the WebSphere home directory and the WebSphere profile for which a backup is created. For example: On Windows systems: WebSphere Home:C:\Program Files (x86)\IBM\WebSphere\AppServer WebSphere Profile:AppSrv01 On Linux or UNIX systems: WebSphere Home:/opt/IBM/WebSphere/AppServer/profiles/AppSrv01 WebSphere Profile:AppSrv01 <8> The utility indicates whether WebSphere Global Security is enabled for the WebSphere Application profile that you specified: WebSphere Global Security is enabled. If global security is not enabled, skip to step 10. <9> The utility prompts you to specify whether to retrieve security settings from a client properties file: Do you want to retrieve security settings from a client properties file (soap.client.props or sas.client.props)? [1 - YES, 2 - NO] [default is: 2]: The data collector communicates with the WebSphere Administrative Services using the RMI or the SOAP protocol. If global security is enabled for a profile, you must specify the user ID and password of a user who is authorized to log in to the IBM WebSphere Application Server administrative console for the profile. Alternatively, you can encrypt the user name and password and store them in client properties files before configuring the data collector. You must use the sas.client.props file for an RMI connection, or the soap.client.props file for an SOAP connection. Enter 1 to allow the utility to retrieve the user name and password from the appropriate client properties file and skip to step 11. Otherwise, enter 2 to enter the user name and password. Enter WebSphere admin user name: Enter WebSphere admin user password: <10> If you selected the option to back up the current WebSphere configuration, the utility starts backing up the configuration. For example: On Windows systems: Backing up profile: AppSrv01 home: C:\Program Files (x86)\IBM\WebSphere\AppServer\bin ... Backup file C:\IBM\ITM_DC\dchome\7.2.0.0.3\data\v525400e96601Cell01. v525400e96601Node01.AppSrv01.WebSphereConfig_20120716161102.zip is successfully created On Linux or UNIX systems: Backing up profile: AppSrv01 home: /opt/IBM/WebSphere/AppServer/bin ... Backup file /opt/IBM/ITM_DC/dchome/7.2.0.0.3/data/ v525400e96601Cell01.v525400e96601Node01.AppSrv01. WebSphereConfig_20120716161102.zip is successfully created. And A status message is displayed to indicate that the data collector was successfully unconfigured. 2. Migrate from IBM BPM version 7.5.1.1 or later profile to IBM BPM version 8.0 or later profile. To maintain the historical data view for data that was collected for IBM BPM version 7.5.1.1 or later, migrate the application servers to a profile that has the same node name. In a Network Deployment environment, migrate the deployment manager and node profile. 3. Verify that the application server instances are migrated and started. In a Network Deployment environment, make sure that the Deployment Manager and Node Agent are migrated and started. Tip: If you migrated the WebSphere profile to a different host, install ITCAM for SOA version 7.2 on the target machine. 4. Reconfigure the data collector for all application server instances using the configuration utility. Specify the same parameters values that were used for IBM BPM version 7.5.1.1 or later. Use the ITCAM Data Collector for WebSphere configuration utility to configure the data collector as below steps. <1> In the command line, navigate to the DC_home\bin directory on Windows systems or the DC_home/bin directory on Linux or UNIX systems. <2> Set the location of the Java home directory before you run the utility. For example: on Windows systems: set JAVA_HOME=C:\Progra~1\IBM\WebSphere\AppServer80\java on Linux or UNIX systems: export JAVA_HOME=/opt/IBM/AppServer80/java <3> Run the following command to start the configuration utility. On Windows systems: DC_home\bin\config.bat On Linux or UNIX systems: DC_home/bin/config.sh <4> The utility starts and displays the IP addresses of all network cards that are found on the local computer system. The utility prompts you to specify the interface to use for the data collector: List of TCP/IP interfaces discovered: 1. 9.111.98.108 Enter a number [default is: 1]: <5> Enter the number that corresponds to the IP address to use. The utility searches for WebSphere Application Server home directories on the computer system and prompts you to select a home directory: On Windows systems: List of WebSphere Application Server home directories discovered: 1. C:\Program Files\IBM\WebSphere\AppServer Enter a number or enter the full path to a home directory [default is: 1]: On Linux or UNIX systems: List of WebSphere Application Server home directories discovered: 1. /opt/IBM/WebSphere/AppServer Enter a number or enter the full path to a home directory [default is: 1]: <6>. Enter the number that corresponds to a WebSphere Application Server home directory. The utility searches for all profiles under the specified home directory and prompts you to select a profile: List of WebSphere profiles discovered: 1. AppSrv01 Enter a number [default is: 1]: <7> Enter the number that corresponds to the WebSphere Application Server profile that you want to configure. The utility indicates whether WebSphere Global Security is enabled for the WebSphere Application profile that you specified: WebSphere Global Security is enabled. If global security is not enabled, skip to step 9 <8> The utility prompts you to specify whether to retrieve security settings from a client properties file: Do you want to retrieve security settings from a client properties file (soap.client.props or sas.client.props)? [1 - YES, 2 - NO] [default is: 2]: The data collector communicates with the WebSphere Administrative Services using the Remote Method Invocation (RMI) or the Simple Object Access Protocol (SOAP) protocol. If global security is enabled for a profile, you must specify the user ID and password of a user who is authorized to log in to the IBM WebSphere Application Server administrative console for the profile. Alternatively, you can encrypt the user name and password and store them in client properties files before configuring the data collector. You must use the sas.client.props file for an RMI connection, or the soap.client.props file for an SOAP connection. Enter 1 to allow the utility to retrieve the user name and password from the appropriate client properties file and skip to step 9. Otherwise, enter 2 to enter the user name and password. Enter WebSphere admin user name: Enter WebSphere admin user password: <9> The utility searches for all application server instances under the specified profile. The utility displays all servers that are not configured yet for data collection and all servers that are configured to use the current version of ITCAM Data Collector for WebSphere. The utility prompts you to select one or more application server instances from the list: Choose one or more servers to configure for data collection: Application servers not yet configured: 1. co098170Node01Cell.co098170Node01.server1(AppSrv01) Enter a number or numbers separated by commas, or enter * to select all: Remember: For a stand-alone environment, application server instances must be running during the configuration. For a Network Deployment, WebSphere Virtual Enterprise, or WebSphere Compute Grid environment, the Node Agent and Deployment Manager must be running. Ensure that the application server instances that you select are the actual servers that host the applications or services that you want to monitor. <10> Enter the number that corresponds to the application server instance to configure for data collection or enter an asterisk (*) to configure all application server instances for data collection. To specify a subset of servers, enter the numbers, separated by commas, that represent the servers. For example: 1,2,3. <11>. In the Integration with ITCAM for SOA Agent section, the utility provides an option for integrating the data collector with the ITCAM for SOA agent. Do you want to integrate with an ITCAM for SOA Agent? [1 - YES, 2 - NO] [default is: 2]: You must install and configure the ITCAM for SOA Agent and its application support files, and optionally configure topology support to complete the installation and configuration of the ITCAM for SOA agent. For more information about installing and configuring the ITCAM for SOA Agent, see IBM Tivoli Composite Application Manager for SOA Installation Guide. Enter 1 to integrate the data collector with the ITCAM for SOA Agent. Otherwise, enter 2 and you can see the status message to indicate that the configuration of the data collector for the profile is complete. <12>. After configuring the data collector to monitor application server instances, you must restart the instances as directed by the utility. The data collector configuration takes effect when the application server instances are restarted. Data collection is configured for the specified application server instances. 5. Verify that the application servers are functioning correctly. Verify the connection from the data collector to the ITCAM for SOA monitoring agent and ITCAM for Transactions, as required. Introduction to Authors Ellen Chen has rich experience in Globalization project management. She's led and delivered over 100 testing projects. Her areas of expertise include globalization verification testing, translation verification testing, and translation management. Peter Chen is a experienced globalization test lead and has been working on globalization testing for ITCAM for SOA for several releases. Notices This information was developed for products and services offered in the U.S.A. IBM® may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106-0032, Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk. IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Corporation 958/NH04 IBM Centre, St Leonards 601 Pacific Hwy St Leonards, NSW, 2069 Australia IBM Corporation 896471/H128B 76 Upper Ground London SE1 9PZ United Kingdom IBM Corporation JBF1/SOM1 294 Route 100 Somers, NY, 10589-0100 United States of America Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us. Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment. Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products. All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. All IBM prices shown are IBM's suggested retail prices, are current and are subject to change without notice. Dealer prices may vary. This information is for planning purposes only. The information herein is subject to change before the products described become available. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. COPYRIGHT LICENSE: This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. If you are viewing this information softcopy, the photographs and color illustrations may not appear. Trademarks IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at www.ibm.com/legal/copytrade.shtml. Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates. Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both. UNIX is a registered trademark of The Open Group in the United States and other countries. Adobe, Acrobat, Portable Document Format (PDF), PostScript, and all Adobe-based trademarks are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, other countries, or both. Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both. UNIX is a registered trademark of The Open Group in the United States and other countries. Other company, product, or service names may be trademarks or service marks of others. Licensed Materials – Property of IBM
© Copyright 2024