The WebSphere® Applications agent does not need any configuration after agent installation. However, you must configure the data collector, which is a component of the agent, to set up monitoring for your WebSphere environment.
Before you begin
- Install the WebSphere Applications agent on the
system where the application server to be monitored is installed and running.
- Check the user access requirements.
- Use the administrator ID that is used to install the
application server to configure the data collector. Make sure that this user ID has full write
permission the data collector home directory,
install_dir\dchome\7.3.0.14.08.
- Use the user ID that is used to install the application server
to configure the data collector. Make sure that this user ID has read and write permissions to the
following subdirectories within install_dir/yndchome/7.3.0.14.08:
About this task
A simple configuration utility, simpleconfig
, is used in this procedure to
provide the basic configuration of data collector.
The simpleconfig
utility configures the data collector with default settings. To
configure the data collector with more customization options, use the full configuration utility,
config
, in the same directory. For instructions, see Configuring or reconfiguring the data collector with full configuration utilities.
In most cases, the simpleconfig
utility is sufficient. For more complex
environment, you can use the config
configuration utility to configure the data
collector. If the simpleconfig
utility fails, use the config
utility instead.
Procedure
-
Log in to the system with the user ID that is used to install the application server.
-
Change to the bin directory within the data collector home
directory.
- install_dir\dchome\7.3.0.14.08\bin
- install_dir/yndchome/7.3.0.14.08/bin
-
Run the following simple configuration utility:
- simpleconfig.bat
- ./simpleconfig.sh
-
Follow the prompts to continue with the data collector configuration.
You are required to do some or all of the following things, depending on the application server
settings:
- For traditional WebSphere Application Server:
- Select the auto-discovered WebSphere installation
directory or manually specify the installation directory.
- Select the WebSphere Application Server profile to
monitor.
- Select the security properties profile to use or provide the user name and password of the WebSphere administrative console (if security is enabled for
the application server).
- For WebSphere Application Server Liberty:
- Specify the full path of the Liberty home directory that contains bin and
servers directories. For example, /opt/ibm/wlp.
- Specify the home directory of the JRE that is used by Liberty.
-
After the data collector configuration completes, restart the application server.
-
Go to the bin directory under the home directory for the application
server profile. For example,
opt/IBM/WebSphere/AppServer/profiles/profile_name/bin.
-
Stop the application server by entering the stopServer command in the
command console.
./stopServer.sh server_name
stopServer.bat server_name
-
When prompted, enter the user ID and password of WebSphere administrative console administrator.
-
Start the application server again by entering the startServer command in
the command console.
./startServer.sh server_name
startServer.bat server_name
-
Log in to the Cloud APM console to view data in the
dashboards.
-
Access the console by using the link that is provided in the email alerting you that your
service is ready. Alternatively, access the console from the IBM® Marketplace website. For detailed instructions, see Starting the Cloud APM console.
-
Use the Applications editor to add the monitored application server to the Application Performance Dashboard. You can add it as a new component to your
existing application or create an application to contain this component.
Results
The data collector is configured to monitor the application server instance. Remember that
data collection can increase the application server overhead. You can control the data collection
with more advanced configuration options for tuning.