Monitoring Java EE Components

Enterprise Manager Basics

Enterprise Manager is a web-based interface with which you can manage running Java CAPS applications for both the Java Platform, Enterprise Edition (Java EE platform) and the Schema Runtime Environment (SRE).

You can access Enterprise Manager with any of the following browsers:

Enterprise Manager contains an Explorer panel on the left and a Details panel on the right.

Java EE platform applications and SRE applications appear in different branches of the Explorer panel.

Screen capture of the Explorer panel.

Enterprise Manager also includes a command-line client.

Starting the Enterprise Manager Server

Before users can log in to Enterprise Manager, you must start the server component.

ProcedureTo Start the Enterprise Manager Server

  1. Run the start_emanager script in the JavaCAPS-install-dir directory.

  2. Wait for an INFO message that indicates the startup time in milliseconds. For example:


    INFO: Server startup in 130006 ms

    On UNIX platforms, this message appears in the catalina.out file in the JavaCAPS-install-dir/emanager/server/logs directory. On Windows platforms, this message appears in the command-line window.

Logging In to Enterprise Manager

Users log in to Enterprise Manager from a browser.

For detailed information about Enterprise Manager user names and passwords, see Managing Java CAPS Users.

This procedure assumes that the Enterprise Manager server has been started.

ProcedureTo Log In to Enterprise Manager

  1. In a supported browser, enter the following URL:


    http://hostname:portnumber/

    Set the hostname to the TCP/IP host name or IP address of the server where Enterprise Manager is installed. Set the port number to the port number that was specified during the installation of Enterprise Manager. For example:


    http://myserver.company.com:15000/

    The Enterprise Manager Security Gateway screen appears.

  2. In the User ID field, enter an Enterprise Manager user name.

  3. In the Password field, enter the corresponding password.

  4. Click Login.

    Enterprise Manager appears.

Adding an Application Server Domain to Enterprise Manager

In order to manage a Sun Java System Application Server domain in Enterprise Manager, you must first add the domain.

ProcedureTo Add an Application Server Domain to Enterprise Manager

  1. In the Explorer panel of Enterprise Manager, click the Java EE node.

    The Manage Servers tab appears.

  2. Enter the connection information.

    Field 

    Description 

    Server Type 

    The type of application server. Set this field to Sun Java System Application Server Domain (9.1) 

    Host Name 

    The fully qualified host name (for example, myhost.company.com) or IP address of the computer on which the application server is running.

    HTTP Administration Port 

    The port number of the Domain Administration Server. 

    User Name 

    The user name required to access the domain. 

    Password 

    The password required to access the domain. 

  3. Click Connect to Server.

    The application server domain is added to the Current Application Server List table.

    Screen capture of the Current Application Server List
table with the added server.

Adding an Application Server Instance to Enterprise Manager

In order to manage a Sun Java System Application Server instance in Enterprise Manager, you must first add the instance.

Managing instances is more limited than managing domains.

ProcedureTo Perform Prerequisite Steps on the Application Server

Before You Begin

In this procedure, you manage targets for the SeeBeyondSunOneDeployer web application and the logging connector module. These components are part of the Java CAPS runtime. The default application server domain includes the runtime. Any additional domains that you create do not include the runtime. Follow the steps in Java CAPS Runtime Installation to manually install the runtime on any additional domains.

  1. Log in to the Sun Java System Application Server Admin Console.

  2. In the left pane, expand the Web Applications node and select the SeeBeyondSunOneDeployer node.

  3. Click the Target tab.

  4. Click Manage Targets, add the instance to the Selected Targets list, and click OK.

  5. In the left pane, expand the Connector Modules node and select the logging node.

  6. Click the Target tab.

  7. Click Manage Targets, add the instance to the Selected Targets list, and click OK.

  8. Go to the asadmin tool.

  9. Stop and restart the instance.

ProcedureTo Add an Application Server Instance to Enterprise Manager

  1. In the Explorer panel of Enterprise Manager, click the Java EE node.

    The Manage Servers tab appears.

  2. Enter the connection information.

    Field 

    Description 

    Server Type 

    The type of application server. Set this field to Sun Java System Application Server Instance (9.1) 

    Host Name 

    The fully qualified host name (for example, myhost.company.com) or IP address of the computer on which the application server is running.

    HTTP Instance Port 

    The port number of the HTTP port that the instance is using. 

    Server Instance Name 

    The name of the instance. 

  3. Click Connect to Server.

    The application server instance is added to the Current Application Server List table.

    Screen capture of the Current Application Server List
table with the added server.

Using the Connectivity Map Controls

When you select a Connectivity Map node in the Explorer panel of Enterprise Manager, the actual Connectivity Map appears in the Details panel.

Screen capture of a Connectivity Map and the toolbar.

You can adjust the position of the Connectivity Map. In addition, you can zoom in and out.

In order to perform these tasks, you must enable the Zoom and Pan icon. The Zoom and Pan appears on the left of the toolbar. By default, the icon is disabled. To enable the icon, click the icon.

Screen capture of disabled Zoom and Pan icon.Screen capture of enabled Zoom and Pan icon.

If you are using Internet Explorer, then you must install the SVG Viewer in order for the zoom functionality to work correctly. Follow the steps in the Java CAPS installation documentation to upload the Enterprise_Manager_SVGPlugin-win32.sar file to the Repository. Then download the executable file to the computer where the browser is located. Run the executable file to install the SVG Viewer.

The 100%, Fit All, Fit Width, and Fit Height icons provide the following functionality:

ProcedureTo Adjust the Position of the Connectivity Map

  1. Press the Alt key.

    Your cursor becomes a hand symbol.

  2. Click the Connectivity Map and move it to the desired position.

ProcedureTo Zoom In on the Connectivity Map

  1. Click the Zoom In icon.

ProcedureTo Zoom Out from the Connectivity Map

  1. Click the Zoom Out icon.

ProcedureTo Specify an Exact Zoom Percentage

  1. Enter a whole number in the field between the Zoom Out and Zoom In icons.

Stopping the Enterprise Manager Server

You use a script to stop the server component of Enterprise Manager.

ProcedureTo Stop the Enterprise Manager Server

  1. Run the stop_emanager script in the JavaCAPS-install-dir directory.