Installing and Displaying the WLDF Console Extension

The WebLogic Diagnostic Framework (WLDF) Console Extension is included with WebLogic Server, but it is not installed by default. The following section describes how to install and display the WLDF Console Extension:

Installing the WLDF Console Extension

The WLDF Console Extension is delivered as a Java Archive (JAR) file, named diagnostics-console-extension.jar. You must install this JAR file into the Administration Server for a domain for the WLDF Console Extension to be incorporated into the WebLogic Server Console for that domain.

Installation Prerequisites

Before you can install and run the WLDF Console Extension, you need:

WebLogic Server 9.1 or higher installed

A Web browser that meets the requirements for running the Weblogic Server 9.1 or higher Administration Console

Java Plug-in version 1.5 (J2SE Runtime Environment 5.0)

Java and JavaScript enabled in your browser

Installing the Java Plug-in

For browsers other than Mozilla or Firefox in a Linux environment, if the Java plug-in 1.5 is not already installed in your Web browser, you will be prompted to initiate a download from the Sun Microsystems Java Web site. Follow the instructions on screen.

Alternatively, install the plug-in manually when you begin the installation process for the WLDF Console Extension:

Go the Java Software download page, at:

http://java.com/en/download/

Follow the instructions on screen.

If you are using Mozilla or Firefox on a Linux machine, you must install libjavaplugin_oji.so into your <browser_install>/plugins directory.

Installing the WLDF Console Extension

To install the WLDF Console Extension:

Find the diagnostics-console-extension.jar file in the WL_HOME\server\lib\console-ext directory, where WL_HOME is the directory in which you installed WebLogic Server.

Copy diagnostics-console-extension.jar into the DOMAIN-DIR/console-ext directory for every domain in which you want to use the Console Extension, where DOMAIN-DIR is the domain's root directory.

Restart the Administration Server for the domain where you installed the extension. The Administration Console for the domain is then deployed with the WLDF Console Extension.

Enable or disable the WLDF Console

You can enable or disable the WLDF Console Extension from the Administration Console:

In the banner toolbar region at the top of the right pane of the Console, click Preferences (to the right of the Logout link).

Select the Extensions tab.

In the list of extensions at the bottom of the page, select the check box for diagnostics-console-extension and click Enable to enable the extension or Disable to disable it.

Restart the Administration Server for the domain where you enabled or disabled the extension.

Removing the WLDF Console Extension

To remove the extension:

Stop the Administration Server.

Delete the JAR file from the DOMAIN-DIR/console-ext directory and restart the Administration Server.

Displaying the WLDF Console Extension

When you launch an Administration Console in which the WLDF Console Extension is installed, the Console appears with two tabs, Oracle WLS Console and WLDF Console Extension, as shown in Figure 2-1.

Figure 2-1 Console Extension Tab

By default, the Oracle WLS Console tab is initially selected on login, which shows the standard Administration Console. Select WLDF Console Extension to display the extension.

These two tabs are always present, so you can easily move back and forth between the primary Administration Console pages and the WLDF Console Extension.

Note:

All WLDF Console Extension functionality occurs in the context of a Java applet. Each time you select the WLDF Console Extension tab, the applet is loaded.

Note:

When you select the Oracle WLS Console tab, the applet is unloaded, and you are returned to the Administration Console context that existed before you displayed the WLDF Console Extension. All activity related to the applet and the WLDF Console Extension is terminated.

Look and Feel Support

The WLDF Console Extension does not implement a specific look and feel (that is, the visual user interface design). Rather, it adopts the look and feel of the environment in which the WLS Administration Console is running:

For non-Windows systems, the Console Extension uses the look and feel specified in the Java environment.

For Windows systems, the Console Extension uses the default Windows look and feel.