IBM Performance Management

Configuring the WebLogic agent

The WebLogic agent provides a central point of monitoring for the health, availability, and performance of your WebLogic server environment. The agent provides a comprehensive set of metrics to help you make informed decisions about your WebLogic resources, including Java virtual machines (JVMs), Java messaging service (JMS), Java Database Connectivity (JDBC), and more. Before the agent can be used, you must configure the agent.

Before you begin

Note: Most of the Oracle WebLogic server configuration is done by using the administrative console, typically at http://weblogic-server:7001/console.

Before you configure the WebLogic agent, the Oracle WebLogic server first must be configured by completing the following tasks:

Set up a monitor user in the Monitors group.
- Select the domain that you would like to monitor/edit.
- Select Security Realms.
- Select your security realm (or create one if one does not exist).
- Create a user that will be used to communicate with WebLogic over JMX.
- Give this user the Monitor group (a default group set up by WebLogic).
- Save the changes to the domain.
Enable the Listen Ports.
- Select the domain that you would like to monitor/edit.
- On each server that you would like to monitor, click Environment > Servers > Select a server .
- Ensure that the Listen Port is enabled and note its port number.
- If you would like to enable SSL, then ensure that the SSL Listener Port is enabled and set a port for SSL as well.
Enable the JMX MBean Server Connections.
- Select the domain that you would like to monitor/edit.
- Select Configure and expand the Advanced section.
- Check Platform Mbean Server Enabled.
- Save the change.
Enable the IIOP Protocol option.
- Select the domain that you would like to monitor/edit.
- On each server that you would like to monitor, click Environment > Servers > Select a server .
- Select the Protocol Tab > Select IIOP.
- Under the Advanced section, enter the default IIOP user name and password.
- Save the change.
Enable SSL (Optional).
- Copy the necessary .jar files into the TMAITM6_x64 directory.
  - Locate the wlclient.jar and wljmxlcinet.jar under ORACLE_HOME.
  - Copy the files to the TMAITM6_x64 directory on the agent.
  - Save the change.
- Enable HTTP Tunneling.
  - Go to Environment > Servers > Select a server > Protocol > General.
  - Check Enable HTTP Tunneling.
- Enable SSL Listen Port.
  - Go to Environment > Servers > Select a server > Configuration > General.
  - Configure a port number.

About this task

Configuring the WebLogic agent involves extracting and installing the installation files from a command-line interface and configuring an instance.

You can use the Performance Management console to configure the instance.
Use the command-line interface.

Procedure

Extract the file that contains the installation files:
- .zip
- .tar
Run the command for the applicable operating system:
- Run the installAPMAgents.bat command as Administrator from the command line.
- Run the installAPMAgents.sh command as root from the command line.
On the command line, type 1 and press Enter to select the WebLogic agent.
On the command line, specify the installation directory.
On the command line, accept the End User License Agreement.
Log in to the Performance Management console and find Monitoring Agent for WebLogic Template in the Service/Application list.
1. Right-click the Monitoring Agent for WebLogic Template and select Configure Agent.
2. In the configuration window, enter a unique name for this instance of the monitoring agent.
3. Continue by clicking OK and then click Next.
4. Enter the following information:
  - WebLogic Server Name (or IP address) of the monitored WebLogic server
  - User name of the monitor user
  - Password of the monitor user
  - Confirm Password
  - Port: If you use SSL as defined on the WebLogic server, set the Port field to SSL Listen Port. If you do not use SSL, set the Port field to Listen Port.
  - Protocol: If you use SSL, set the Protocol field to https. If you do not use SSL, set the Protocol field to iiop.
5. In the first set of fields, which are a template, click New to use the template values for a new site. After you create a new site, enter an Oracle WebLogic Site Name and click OK.
6. Start the agent by right-clicking the instance that you created and selecting Start.
Open the /opt/ibm/apm/agent/bin directory, and run the following command:
```
./oracle_weblogic-agent.sh config INSTANCE
```
Where INSTANCE is the name of the agent instance.

What to do next

Within the Performance Management console, go to your Application Performance Dashboards to view the data that is collected. For information about using the Performance Management console, see “Starting the Performance Management console”.