Professional Documents
Culture Documents
Yan Bin Hu Fred Feng Vasfi Gucer Jacky Huang Bin Jiang Richard Mackler
ibm.com/redbooks
This is not intended as a primer on installing the ITCAM monitoring environment or the IBM Tivoli Monitor environment. We assume that both ITCAM and IBM Tivoli Monitoring have been installed and configured, and that verification testing is complete and the systems are fully functional. We assume that the reader is a system administrator, or equivalent, and has been involved in setting up the IBM Tivoli Monitoring environment and is familiar with the IBM Tivoli Monitoring product. Our goal is to provide a straightforward document that utilizes your IBM Tivoli Monitoring system to verify that the ITCAM Managing Server is functioning correctly. In the event that an unexpected problem does occur, the goal is to utilize the IBM Tivoli Monitoring system to notify the central monitoring environment that a problem has occurred with the ITCAM Management Servers and should be addressed.
Contents
Monitoring the IBM Tivoli Composite Application Management Server V6.1 . . . 1 ITCAM for WebSphere . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Installation guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Component 1: kernel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Component 2: visualization engine (WebSphere User Interface) . . . . . 11 Component 3: database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Component 4: archive agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 Component 5: publishing server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 Component 6: message dispatcher . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 Component 7: database connection . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 ITCAM for J2EE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 ITCAM for Response Time Tracking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 URL monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 Monitor using UA HTTP data provider . . . . . . . . . . . . . . . . . . . . . . . . . . 41 Monitor using IBM Tivoli Monitoring situation . . . . . . . . . . . . . . . . . . . . 45 RTT Managing server port monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 Create situation to monitor port status . . . . . . . . . . . . . . . . . . . . . . . . . . 53 Management server database monitoring. . . . . . . . . . . . . . . . . . . . . . . . . . 57 The team that wrote this IBM Redpaper. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
In order to determine what components should be monitored it is beneficial to understand the makeup of the managing server. Figure 1 provides a visual representation of both the major (critical) and minor components of the managing server.
The principal or critical components that make up the managing server are the kernel, publishing server, archive agent, database, and visual engine (WebSphere). The critical components of the ITCAM for WebSphere Managing Server to be monitored are as listed in Table 1.
Table 1 Critical components of the ITCAM for WebSphere Managing Server Managing server component Archive agent Database - alive/active Database - connection IBM Tivoli Monitoring Agent Universal agent DB2 agent Universal agent
Managing server component Kernel Message dispatcher Publish server WebSphere - managing server URL
IBM Tivoli Monitoring Agent Universal agent Universal agent Universal agent Situation monitor for logon window
Installation guide
Our installation guide is intended to assist you with not only being able to understand IBM Tivoli Monitoring components, but to give enough details to virtually walk you through the steps. We assume that the reader is familiar with IBM Tivoli Monitoring, and that IBM Tivoli Monitoring is already installed. With that stated, we now address the respective pieces that are needed to install the IBM Tivoli Monitoring agents to permit monitoring the ITCAM for WebSphere Managing Server.
Component 1: kernel
To monitor the kernel server utilizing IBM Tivoli Monitoring Universal Agent (UA): 1. Change to the $CANDLEHOME/bin dir. The default CANDLEHOME is /opt/IBM/ITM, which is the IBM Tivoli Monitoring installation directory. 2. Run ./itmcmd manage and press Enter. A window appears, as shown in Figure 2.
3. Right-click Universal Agent and select Configure. A window appears, as shown in Figure 3.
4. In the above window input your TEMS host name in the blank field, which is circled in red, and select the Agent Parameters tab above the red circle. The window shown in Figure 4 appears.
6. Right-click Universal Agent and select Start Service. A window appears, as shown in Figure 5.
7. Select Universal Agent and select Start. A window appears, as shown in Figure 6.
9. Using a local file editor, such as VI, create and save a SHELL script as follows (Figure 7). The file name and directory are up to you.
Figure 7 Vi editor
Note: The /opt/IBM/itcam/WebSphere/MS/bin should be changed to the correct directory if your managing server was not installed there. Grant everyone execute permission to the script. 10.Change the directory to the $CANDLEHOME/aix516/um/metafiles dir. Using a local file editor, such as VI, create a metafile as follows (the file name should end with mdl, like sample.mdl). See Figure 8.
Note: The kernel.sh script is the one that you created in Component 1: kernel on page 5. The metafile name must end with mdl. 11.Change the directory to the $CANDLEHOME/bin directory and run um_console. See Figure 9.
12.Input "import <metafile>" and press Enter. The metafile is the one that you created in step 13. See Figure 10.
13.Verify the metafile has been imported successfully and press Enter to exit. See Figure 11.
10
14.Log on the portal client and start the monitoring. See Figure 12.
15.Create a situation for the KERNEL_SERVER_STATUS attribute group. You can refer to the Component 6: message dispatcher on page 27 to do this.
11
12
2. Add the Managing Server Visualization Engine URL to the Managed URL: a. Add the following lines to /opt/IBM/ITM/aix516/um/work/KUMPURLS: http://MS_HOSTNAME:9080/am ALIAS=VE INTERVAL=60 CACHE=30 USER=root
b. Restart UA to make it take effect. 3. Click Managed URL. The status of the URL can be seen in Figure 15.
13
14
c. Create a new situation. Name it ITCAMfWAS_VE_Status, and in the Select Condition dialog, select MANAGED URL' Status as the attribute. See Figure 17.
15
d. Set one minute as the sampling interval and status not equal to OK as the situation. See Figure 18.
16
2. Figure 19 is an example of a situation triggered when the visualization engine is not available. (Stop the ITCAM for WebSphere Server to test this.)
Component 3: database
In this section we discuss the steps to monitor the database utilizing the IBM Tivoli Monitoring DB2 Agent.
17
4. Go to $CANDLEHOME/bin dir. Start the DB2 agent from the CLI. (Sometimes we need su to db2inst1 first and then start the DB2 agent.) bash-2.05 # su - db2inst1 bash-2.05 # ./itmcmd agent -o db2inst1 start ud Sourcing db2profile for user db2inst1 Starting agent... Agent Started...
18
19
20
e. If DB2 on the managing server is shut down, you should see the situation triggered as shown in Figure 23.
Figure 24 Vi editor
21
Note: The /opt/IBM/itcam/WebSphere/MS/bin should be changed to the correct directory if your managing server was not installed there. Grant everyone execute permission to the script. 2. Verify that the IBM Tivoli Monitoring UA has configured and started successfully. 3. Change the directory to the $CANDLEHOME/aix516/um/metafiles dir. Using a local file editor, such as VI, create a metafile (ending with mdl), as shown in Figure 25.
Note: The underlined script is the one that you created previously. 4. Change the directory to the $CANDLEHOME/bin directory and run um_console. 5. Input "import <metafile>" and press Enter. The metafile is what you created in step 3.
6. Verify that the metafile was imported successfully and press Enter to exit.
22
7. Log on the portal client and begin your monitoring, as shown in Figure 27.
8. Create a situation for the ARCHIVE_AGENT_STATUS attribute group. You can refer to the Component 6: message dispatcher on page 27.
23
Figure 28 Vi editor
2. Verify that the IBM Tivoli Monitoring UA has configured and started successfully. 3. Change the directory to the $CANDLEHOME/aix516/um/metafiles dir. Using a local file editor, such as VI, create a metafile (ending with mdl), as shown in Figure 29.
24
5. Input "import <metafile>" and press Enter. The metafile is what you created in step 3. See Figure 30.
6. Verify that the metafile was imported successfully and press Enter to exit.
25
7. Log on to the portal and begin your monitoring. See Figure 32.
8. Create a situation for the PUBLISH_SERVER_STATUS attribute group. You can refer to Component 6: message dispatcher on page 27.
26
Figure 33 Vi editor
2. Verify that the IBM Tivoli Monitoring UA has configured and started successfully. 3. Change the directory to the $CANDLEHOME/aix516/um/metafiles dir. Using a local file editor, such as VI, create a metafile (ending with mdl), as shown in Figure 34.
Note: The /UASCRIPT/md.sh is the script that you created previously. 4. Change the directory to the $CANDLEHOME/bin directory and run um_console. 5. Input "import <metafile>" and press Enter.
27
6. Verify that the metafile was imported successfully and press Enter to exit.
28
8. Select the Message_Dispatcher_Status attribute group and create a situation, as shown in Figure 38.
29
30
31
32
12.Fill in the name and click OK. You will see Figure 42.
33
10.Select the status from the attribute item and click OK. A window appears, as shown in Figure 43.
34
11.Click the first status blank and input Not running, which means that if the status is not running, the situation will be fired. Then click OK. See Figure 43 on page 34.
35
12.Right-click the Message_Dispatcher_Status attribute group and select Situation. A window appears, as shown in Figure 45.
13.Right-click the situation that you just created, select Start Situation, and OK.
36
If the situation fires, the critical information appears, as shown in Figure 46.
37
status=Failed fi echo $status 2. Verify that the IBM Tivoli Monitoring UA has configured and started successfully. 3. Change the directory to the $CANDLEHOME/aix516/um/metafiles dir. Using a local file editor, such as VI, create a metafile (end by mdl). //APPL MSDBConnection //NAME MSDBConnection K 120 INTERVAL=30 AddTimeStamp //SOURCE SCRIPT /UASCRIPT/MSDBConnection.sh //ATTRIBUTES MSDBConnection D 30 4. Change the directory to the $CANDLEHOME/bin directory and run um_console. 5. Input "import <metafile>" and press Enter.
6. Verify that the metafile was imported successfully and press Enter to exit.
38
39
URL monitor
The URL monitor includes the ITCAM for Response Time Tracking Management Server URL and WebSphere Application Server admin console URL monitoring.
40
2. Configure the UA to connect to the monitoring server, if it is not already configured, or just leave the current configuration as it is if it is already configured.
41
3. Update the UA configuration file to include the HTTP data provider, as shown in Figure 50 and Figure 51 on page 43.
4. Add HTTP to the current list at the line KUMA_STARTUP_DP. See Figure 51 on page 43.
42
43
5. Go to the IBM Tivoli Monitoring UA installation directory, edit the file KUMPURLS, and add the URL for the RTT presentation server and the WebSphere Application Server admin console. See Figure 52.
Figure 52 KUMPUIRLS
6. Save the KUMPURLS file and restart the UA. From the portal, you see the new added HTTP data provider and the URLs managed by the HTTP data provider. See Figure 53.
44
45
46
47
3. Distribute the situation to the HTTP data provider. See Figure 57.
48
4. If the URL is down for some reason, the situation will be triggered. See Figure 58.
# cat /UASCRIPT/RTT_MS_Port.sh export LANG=C export LC_ALL=C telnet tivc10 9084 <<EOF 2>/dev/null | grep -i connected >>/dev/null 2>&1 <xml> </xml> EOF echo "MS_Port_9084 $?"
49
The RTT Management Server port number can be found from the ITCAM for Response Time Tracking config file.
Example 2 ITCAM for Response Time Tracking config file
tmtp.msPortWithoutAuth=9084 ( for non-SSL communication) tmtp.msPortWithAuth=9446 ( for SSL communicaton) To enable the port monitor: 1. Enable the UA script data provider using the same steps as for the HTTP data provider. 2. Write a metafile for the script data provider (Example 3).
Example 3 Metafile for the script data provider
#cd /opt/IBM/ITM/aix516/um/metafiles # cat RTT_MS_Port.mdl //APPL RTT_MS_Port //NAME RTT_MS_Port K 300 INTERVAL=30 AddTimeStamp //SOURCE SCRIPT /UASCRIPT/RTT_MS_Port.sh //ATTRIBUTES RTT_MS_Port D 16 KEY RTT_MS_Port_Status C 10 ENUM{ UP(0) DOWN(1) } 3. Import the metafile for the UA (Example 4).
Example 4 Importing the metafile
# cd /opt/IBM/ITM/bin # ./um_console KUMPS002I Enter console command <Application name or Metafile name or file name> import RTT_MS_Port.mdl KUMPS001I Console input accepted. KUMPS084I Selecting ASFS DP based on metafile type KUMPS020I Import successfully completed for RTT_MS_Port.mdl Press ENTER to exit
50
4. In portal, the newly added script data provider can be found with the port status, as shown in Figure 59.
Figure 59 Portal
51
52
53
54
2. Define the situation trigger when the port status is DOWN (Figure 63).
55
56
4. When the port status is DOWN, as returned by the test script, the situation is triggered (Figure 65).
57
years of IT experience. In the last four years, he has been working with many Tivoli ITCAM/OMXEGMON product development projects and providing both pre-sales and post-sales support for Tivoli products. He holds several certifications, including ITIL Foundations, WAS V5.0/WebSphere MQ V5.3 System Administrator, DB2 8.1 Database Administrator, and IBM Certified Deployment Professional - Tivoli Storage Manager 5.2. Fred Feng is a member of the IBM Tivoli WW ABSM SWAT team and is based in the China Software Development Lab (CSDL) in Beijing. He has over four years of experience in application architecture, design, development, and testing. He worked as a developer for three years, providing banking business solutions to Chinas major banks like CDB, CEB, and city commercial banks. He spent one year at IBM as a Testing Engineer including CT, CVT, GVT, and SVT, working on Tivoli products like ITM 6x, MTT. He currently utilizes his experience to support both pre-sales and post-sales engagements for the ABSM and ITCAM suite of products. Jacky Huang is a member of the IBM Tivoli WW ISM SWAT team and is based in the China Software Development Lab (CSDL) in Beijing. He has over eight years of experience in application architecture, design, development, and testing. He worked as an IBM Business Partner for three years, providing banking business solutions to Chinas major banks, such as BOC, ICBC, and ABC. He spent two years at IBM as a testing engineer, including CT, FVT, IVT, and SVT, working on Tivoli products like TMF, TEC, RC, TCM, ITM 5x, and ITM 5x PAC. Since then, he has worked as an IBM Directory Server on i5/OS development Team Lead. His current position requires extensive experience with on-site customer support and consultation of IBM ISM solutions. Qing Chun Huang is certified as an eNetwork Firewall for AIX Solutions Expert, AS/400 Professional System Operator, DB2 Database Administrator, Net.Commerce Solutions Expert, AIX System Administration, WAS V5.0 System Administrator, LPI Level 1, and an IBM Certified Deployment Professional for ITM 5x and TCM and ITIL Foundations. Bin Jiang is a member of the IBM Tivoli WW CAM SWAT team and is based in the China Software Development Lab (CSDL) in Beijing. He has over seven years of experience in IBM Tivoli Storage, availability development, and implementation. Prior to joining the SWAT he was a member of the team in CSDL responsible for testing ITCAM. With his deep knowledge of the ITCAM products he has successfully delivered numerous pre-sale and post-sale engagements, including for some of Chinas' largest banks. Bin is an IBM Certified Advanced Deployment Professional for Tivoli Storage Management Solutions as well as an IBM Certified Advanced Technical Expert for pSeries and AIX. Richard Mackler is a Senior IT Solutions Architect in the Tivoli Composite Application Management SWAT team. Based in Shanghai, China, on a one year
58
assignment, he is tasked with managing a China-based SWAT team, as well as supporting ITCAM and Tivoli products for both pre-sales and post-sales efforts. Previously, with Cyanea Systems, he provided installation and support for z/OS, WSAM, and WebSphere, and direct support for WSAM PoCs and Crit-Sit management. His initial professional employment began at Bell Telephone Laboratories as a developer of military projects, a systems programmer, and developed performance monitoring tools for the Bell System. Transferring to Pacific Bell, he held positions of Systems Programmer, Performance Management for MVS systems, Applications Project Architect, Technical Manager, and Manager for Security Systems Implementation. After leaving the Bell System, he held positions as publisher/editor of an international adventure travel magazine, underwater photographer, Director of Computer Production Services, AVP Computer Operations, Chief Security Officer for an international Bank, and security consultant to Charles Schwab. He holds BS and MS degrees in Computer Science and Mathematics. The team would like to express special thanks to Salman Kazmi from the WW ABSM SWAT team for his constructive review comments and input.
59
60
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 give 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. 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. 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. 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 illustrates 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. 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 IBM application programming interfaces. Copyright International Business Machines Corporation 2008. All rights reserved. Note to U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
61
This document REDP-4353-00 was created or updated on January 24, 2008. Send us your comments in one of the following ways: Use the online Contact us review Redbooks form found at: ibm.com/redbooks Send your comments in an email to: redbook@us.ibm.com Mail your comments to: IBM Corporation, International Technical Support Organization Dept. HYTD Mail Station P099, 2455 South Road Poughkeepsie, NY 12601-5400 U.S.A.
Redpaper
Trademarks
The following terms are trademarks of the International Business Machines Corporation in the United States, other countries, or both: Redbooks (logo) i5/OS pSeries z/OS AIX AS/400 Cyanea DB2 IBM MVS Net.Commerce Tivoli WebSphere
The following terms are trademarks of other companies: ITIL is a registered trademark, and a registered community trademark of the Office of Government Commerce, and is registered in the U.S. Patent and Trademark Office. J2EE, and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. Other company, product, or service names may be trademarks or service marks of others.
62