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). For information about supported browsers for accessing Enterprise Manager, see Java CAPS 6.3 System Requirements in Planning for Oracle Java CAPS 6.3 Installation .

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.

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.

To 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.

To 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.

Adding an Application Server Domain to Enterprise Manager

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

To 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. 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. The default port number is 4848. 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.

   
   

Adding an Application Server Instance to Enterprise Manager

In order to manage a GlassFish Application Server instance in Enterprise Manager, you must first add the instance. Managing instances is more limited than managing domains.

• You cannot deploy, undeploy, enable, or disable projects for an instance.

• The message server nodes (for example, IQ_Manager_18007 and Sun_JMQ_7676) do not appear in the Explorer panel of Enterprise Manager.

• The instance can receive alerts only if the corresponding domain has been added to Enterprise Manager.

• When you add the instance to Enterprise Manager, authentication is not performed.

To 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 inInstalling Oracle Java CAPS Domains and Runtime Components to manually install the runtime on any additional domains.

1. Log in to the GlassFish Application Server Admin Console.

   The URL is http://hostname:port. The default port number is 4848.

2. In the left pane, expand Web Applications and select SeeBeyondSunOneDeployer.
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.

To 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 GlassFish Application Server Instance. 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.

   
   

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.

You can adjust the position of the Connectivity Map, and 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.

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:

• The 100% icon sets the zoom percentage to 100.

• The Fit All icon sets the width and height of the Connectivity Map to the width and height of the upper Details panel.

• The Fit Width icon sets the width of the Connectivity Map to the width of the upper Details panel.

• The Fit Height icon sets the height of the Connectivity Map to the height of the upper Details panel.

To 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.

To Zoom In on the Connectivity Map

• Click the Zoom In icon.

To Zoom Out from the Connectivity Map

• Click the Zoom Out icon.

To Specify an Exact Zoom Percentage

• 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.

To Stop the Enterprise Manager Server

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