Operating Systems: AIX, HP-UX, Linux, Solaris, Windows, z/OS
Enabling the on demand router to work with IBM Enterprise Workload Manager
Use this task to enable IBM® Enterprise Workload Manager™ to monitor WebSphere® Virtual Enterprise.
Before you begin
To perform this task, own IBM Enterprise Workload Manager software and have it installed. See the IBM Enterprise Workload Manager Information Center for installation instructions.
About this task
By performing this task, the on demand router (ODR) makes Application Response Measurement (ARM) calls to report response times to IBM Enterprise Workload Manager™. IBM Enterprise Workload Manager can use the response time information to monitor the environment both inside and outside of the WebSphere Virtual Enterprise domain. See WebSphere Virtual Enterprise and IBM Enterprise Workload Manager for more information.
Procedure
- Install WebSphere Virtual Enterprise. See Installing and configuring the product for more information.
- Configure service and transaction classes in IBM Enterprise Workload Manager. See the Enterprise Workload Manager Information Center for more information. The service and transaction classes that you configure in IBM Enterprise Workload Manager override any service classes that are configured in WebSphere Virtual Enterprise.
- Configure IBM Enterprise Workload Manager to manage WebSphere Virtual Enterprise. After you complete this step, any service policies that are configured in WebSphere Virtual Enterprise are not valid. IBM Enterprise Workload Manager has its own configured service and transaction classes.
- Copy the ARM libraries from IBM Enterprise Workload Manager to the WebSphere Virtual Enterprise configuration. Include the ARM libraries from IBM Enterprise Workload Manager in the install_root/bin directory. Remember the name of this class so that you can supply the information in the administrative console. Alternatively, you can add two custom properties to the application server or ODR Java™ virtual machine (JVM). First, define the java.library.path custom property and set its value to the IBM Enterprise Workload Manager library path, for example c:\Program Files\IBM\VE2\EWLMMS\classes\ms. Next, create the ws.ext.dirs custom property and set its value to the folder that contains the ARM libraries that are provided by IBM Enterprise Workload Manager, for example, c:\Program Files\IBM\VE2\EWLMMS\classes\ARM.
- Enable ARM reporting. Read the Getting performance data from request metrics topic in the WebSphere Application Server Information Center for more information. On the request metrics administrative console page, use the following settings:
- Select the appropriate application component, such as servlets or Web services, that needs to report ARM statistics.
- Defining the trace level is optional.
- Enter the name of the IBM Enterprise Workload Manager ARM factory in the ARM transaction factory implementation class name. The transaction class factory name for IBM Enterprise Workload Manager is com.ibm.wlm.arm40SDK.transaction.Arm40TransactionFactory.
- Enable ARM reporting on your other tiers and applications, such as IBM DB2®, IBM HTTP Server, and also for the various components running on WebSphere Application Server. You can enable ARM instrumentation in specific WebSphere Application Server components by selecting the appropriate components. Read the Getting performance data from request metrics topic in the WebSphere Application Server Information Center for more information. See WebSphere XD documentation for your specific tier applications regarding more information on enabling ARM reporting. Any tiers that send requests to the WebSphere Virtual Enterprise tier must be ARM enabled to facilitate the interaction between IBM Enterprise Workload Manager and WebSphere Virtual Enterprise. Any tiers that receive requests from the WebSphere Virtual Enterprise tier do not need to have ARM enabled, however, enabling ARM on these tiers is strongly encouraged.
- To enable WebSphere Application Server and WebSphere Virtual Enterprise with IBM Enterprise Workload Manager, manually update the WebSphere Application Server server.policy files. You must update the server.policy file for all application servers and on demand routers. See the server.policy file permissions topic in the WebSphere Application Server Information Center for more information about server.policy files.
- Restart all applications and servers that IBM Enterprise Workload Manager is now monitoring.
Results
After you complete this task, the on demand routers in the WebSphere Virtual Enterprise infrastructure begin to make ARM calls to report response times on requests, so IBM Enterprise Workload Manager can monitor the WebSphere Virtual Enterprise environment.
Related concepts
WebSphere Virtual Enterprise and IBM Enterprise Workload Manager
Related tasks
Configure the health controller
Configure the autonomic request flow manager
Getting performance data from request metrics
Related reference
Related information
IBM Enterprise Workload Manager Information Center