Foglight for Java EE Technologies 5.9.12

You can use the Java EE Integration Agent to integrate the Java EE agent with WebLogic® domain startup scripts. Supply a description and the domain home path for the application server with which you want to integrate. If you are integrating with WebLogic running as a Windows® Service, specify the name of the Windows Service.

Prerequisite:

•

You must have a Windows Service defined before attempting an integration with WebLogic running as a Windows Service.


	IMPORTANT: If you are integrating with WebLogic 8.1.x, you cannot use the Integration Wizard described in this section. Instead, you must manually integrate. For detailed information, see Creating a Generic Installation for Manual Java EE Agent Integration .

To integrate with WebLogic on Solaris®, Linux®, HP-UX®, or AIX®, or on Windows®

On the navigation panel, under Dashboards, click Application Servers > Administration.

On the Application Servers Administration dashboard, in the Monitoring Agents section, click Setup agents...

In the menu that opens, select Java. The Java — Setup New Application Server Integration wizard opens.

On the Setup Options page, select the type of integration. This example describes how to Setup a new application server integration (the default selection).


	TIP: For other integration methods, see Reusing an integration configuration .

On the New Integration — Type page, select the type of Java application server you want to integrate with. In this case, select WebLogic on Solaris, Linux, HP-UX, or AIX, or WebLogic on Windows.

The wizard refreshes, providing the option to select the WebLogic application server startup method:

Table 2. Integration types
Integration Type	Description
Windows Service	Integrates a WebLogic Server or NodeManager Windows Service.
Domain Startup Script	Integrates the startWebLogic.sh/.cmd scripts within a WebLogic Domain (DOMAIN_HOME/bin/startWebLogic).
NodeManager Startup Script	Integrates the startNodeManager.sh/.cmd scripts within a WebLogic installation (WL_HOME/server/bin/startNodeManager). NOTE: By default, all servers managed by the Node Manager are instrumented.
Managed Server Startup Script	Integrates the startManagedWebLogic.sh/.cmd scripts within a WebLogic 12.1.1 or earlier installation (WL_HOME/common/bin/startManagedWebLogic).
Non-Domain startWLS Startup Script	Integrates the startWLS script within a WebLogic 10.0 or earlier installation (WL_HOME/server/bin/startWLS).
All Non-Domain Scripts	Combines the NodeManager, Managed Server, and startWLS Startup Script tasks into a single integration.

Select a startup method.

Click Next.

On the New Integration — Details page, provide the details required for integrating with your WebLogic server, including command-line options.

For most WebLogic integrations, type or select the absolute path to the WebLogic Home directory. WebLogic Home is the installation directory of a particular WebLogic version.

If you are integrating using startWebLogic as the startup method, type or select the absolute path to the Domain Home. Domain Home is the directory containing a WebLogic Domain.

If you are integrating with WebLogic as a Windows Service, type the name of the Windows service in the Service Name box.

Optional — If your application server uses startup scripts with customized names, click the arrow beside Other Options to open a list of script paths and names. Type the custom names in the appropriate boxes.


	NOTE: Always use forward slashes to separate directory names, regardless of whether the application server is running on Windows or UNIX.

Optional — Click the arrow beside Command Line Options to show the agent and pre-instrumentor option boxes. Use these boxes to provide command-line parameters for the agent or pre-instrumentor.

•

To add agent options, type them in the Agent Options box.


	NOTE: If you need to add more than one option to the Agent Options, separate them with spaces. Do not use quotes.

•

To add pre-instrumentation options, type them in the pre-instrumentor Options box.

To set pre-instrumentor options specific to the JVM you are running, type the desired VM options in the pre-instrumentor Options box.

For example, to set the memory limit for the pre-instrumentor to 256MB, type the following: ‑Xmx256m


	NOTE: If you need to add more than one option to the pre-instrumentor Options, separate them with spaces. Do not use quotes.


	TIP: For information about pre-instrumentation, see Creating a Generic Installation for Manual Java EE Agent Integration .

Click Next.

On the Nexus Connection page, select or create the connection that the agent should use to locate and communicate with a Nexus.


	TIP: For more information about the Nexus, see Nexus and Agent-Nexus connections .

If you are using the default Nexus on the embedded Agent Manager, or if you have created a single remote Nexus, a default Nexus Connection is created and pre-selected for you.

Otherwise, select or define at least one Nexus connection. For more information, see Creating or editing Agent-Nexus connection settings.

Click Next.

On the Logging page, select or create a logging configuration to control how logs are written, including retention policies and rollovers.

•

Select an existing log configuration from the list. The default log provides a basic log configuration that you can use to get started.

•

Click New log configuration. The New Log Configuration dialog box opens.


	TIP: If you are uncertain about how to adjust these settings, click Help for an overview of log targets and their purposes. For details, see Creating or editing logging properties .

Click Next.

On the Integration Hosts page, select the host where WebLogic is installed. By default, only eligible hosts (that is, hosts that have an active Foglight Agent Manager of a compatible version installed and running) are listed.

Select one or more hosts and click Next.

On the Agent Configuration page, select the configuration that the agent will use. This agent configuration defines the requests to monitor and collect details.


	TIP: You can create agent configurations or edit existing ones from the Java Administration dashboard. For more information, see Managing Java EE Agent Configurations.

Select a configuration and click Next.

On the Installation Directory page, define the location for the directory that contains all installation components and log files.

To accept the default directory, leave the Directory name box blank.


	NOTE: If you have previously configured the host for agent installation, the existing installation directory is used.

To specify a custom directory, type a path in the Directory name box.

Click Next.

On the Review page, verify the details of the integration.

By default, the instrumentation script is assigned a name based on the integration type. For example: WebLogic on Windows: startWebLogic.

If you want to customize this name, type the new value in the Name box.

Click Finish.

The Application Servers Administration dashboard refreshes, and the integration task appears in the Task History list, where you can monitor its progress.

Restart your application server.

The agent starts collecting data after the application server has restarted and the agent is successfully integrated. Use the Application Servers Monitor dashboard to view the application servers status. For more information about the Application Servers Monitor dashboard, see the Foglight for Application Servers User Guide.

Integrating with WebSphere

Before you begin remote agent integration with an IBM® WebSphere® application server, first review the following sections:

•

Understanding what should be instrumented

•

Setting the PMI levels on WebSphere

•

Running WebSphere with security enabled

Next, follow the procedure in Integrating with WebSphere startup scripts , as appropriate for your system.

Understanding what should be instrumented

The following guidelines identify the components in a WebSphere® domain that require instrumentation to ensure that the Nexus can do a full data collection.

For standalone servers:

•

Each standalone server process must be integrated and running.

•

To collect WebSphere metrics on the average size of an HTTP session, enable Average Size (b) Current in the Show columns list and then restart your WebSphere application server using the
-Dquest.configfilter.httpsessionsize=true command. For more information about show and hide columns, see the Foglight for Application Servers User Guide.

•

WebSphere standalone servers must be integrated by their server startup scripts, or by individual Windows® server processes.


	NOTE: Standalone servers started solely by an instrumented Admin agent do not need to be integrated individually. However, if a standalone server is started by other means (startup script, or Windows Service), then integrating using these methods is required.

•

WebSphere version 8.x/9.0.0.x standalone servers registered with a WebSphere 8.x/9.0.0.x Admin agent possess an extra integration option: integrating the Admin agent process instead of individual registered servers. Any standalone servers launched by an instrumented Admin agent are also instrumented. However, the Admin agent is not required for monitoring of any standalone servers it may have started, and it may be shut down once all startup activities have been completed. To manually integrate a WebSphere version 8.x/9.0.0.x Admin agent, see Manual integration with IBM WebSphere Application Server .

For WebSphere Servers federated in a WebSphere Cell:

•

The Domain Manager of each WebSphere Cell must be integrated for complete cell monitoring, and must remain running during the monitored period. Any interruption in the service of an instrumented domain manager results in incomplete Nexus data collection, and possible false alarms.

•

Each Node agent must be integrated with the agent, and must remain running during the monitored period. Any interruption in the service of an instrumented nodeagent results in incomplete data collection, and possible false alarms. Individual application servers started by an instrumented Node agent are instrumented automatically.

•

No integration is required for individual servers. Attempts to start an individual server using a startup script fail, as WebSphere requires you to send the start command by using the server’s node agent.


	CAUTION: For any server with a corresponding Windows service: Attempts to start a server by using a startup script may launch a Windows service instead. If the startup script is instrumented with the Java EE Integration Agent, then the resulting WebSphere process is instrumented as well. Otherwise, the integration properties of the Service are used. This release changes the behavior of services launched as a result of a start script invocation.

Running WebSphere with security enabled

Set security levels and define PMI levels before configuring your environment.

If you want to run WebSphere® while J2EE security or Global security is enabled, edit the WebSphere's server.policy file to prevent problems between WebSphere and the Java EE agent.

To edit the server.policy file:

Open the server.policy file located in <websphere_home>/properties or in <websphere_profile_home>/properties.

Add the following block to the file:

grant codeBase "file:* QUEST_DEPLOYMENT_DIRECTORY */-" {
permission java.security.AllPermission;
};

Restart your application server for the changes to take effect.


	TIP: To understand what metrics Foglight for Java EE Technologies collects, review the agent_collector_<SERVER>.config files for your server type. For example, agent_collector_websphere-6.config. You can access these files from the Application Servers Administration > Java Administration > Advanced Configuration view.

Please select your product:

To serve you better, please complete the Purpose of your Chat:

Recommended Solutions for Your Problem

Foglight for Java EE Technologies 5.9.12 - Installation Guide

Integrating with WebLogic Domain Startup Scripts

Integrating with WebSphere

Understanding what should be instrumented

Running WebSphere with security enabled