Skip Headers
Oracle® Application Server Integration InterConnect User's Guide
10g Release 2 (10.1.2)
B14069-02
  Go To Documentation Library
Home
Go To Product List
Solution Area
Go To Table Of Contents
Contents
Go To Index
Index

Previous
Previous
Next
Next
 

11 Using Enterprise Manager

This chapter describes how to manage OracleAS Integration InterConnect using the Oracle Enterprise Manager 10g Application Server Control Console. It contains the following topics:

Overview of OracleAS Integration InterConnect Management using Oracle Enterprise Manager 10g Application Server Control Console

The Oracle Enterprise Manager 10g Application Server Control Console provides a comprehensive system management platform to perform monitoring and administration tasks on an OracleAS Integration InterConnect instance. It provides real-time system monitoring details such as up and down status, current CPU and memory consumption, and current performance status of various adapters.

OracleAS Integration InterConnect Management Concepts and Components

The following OracleAS Integration InterConnect components can be managed by using the Oracle Enterprise Manager 10g Application Server Control Console:

Repository

Repository is used to store metadata in the hub database. At run time, the repository provides access to this metadata to adapters. You can use the Oracle Enterprise Manager 10g Application Server Control Console to monitor and configure the repository.

Hub Queue

Oracle Advanced Queuing (AQ) is the underlying messaging infrastructure of OracleAS Integration InterConnect. The OAI_HUB_QUEUE advanced queue in OracleAS Integration InterConnect is responsible for routing and delivering the messages. You can use the Oracle Enterprise Manager Database Control to manage hub queues and to view and manage the errors that may have occurred during message delivery.

Adapters

Adapters are the run-time engines that carry out the integration based on the metadata modeled during design time. Adapters transform and route messages between the application and the hub. You can use the Oracle Enterprise Manager 10g Application Server Control Console to configure and monitor adapters.

Oracle Enterprise Manager 10g Application Server Control Console Tasks

You can perform the following monitoring and administration tasks by using the Oracle Enterprise Manager 10g Application Server Control Console:

  • Start and stop the repository, adapters, and hub queue.

  • View the current running status (started or stopped) and memory and CPU usage of the repository, adapters, and hub queue.

  • Configure the repository and adapters.

  • View the OracleAS Integration InterConnect log files.

Monitoring and Configuring OracleAS Integration InterConnect from Oracle Enterprise Manager 10g Application Server Control Console

This section provides information about how to monitor and configure various OracleAS Integration InterConnect components. It contains the following topics:

Accessing OracleAS Integration InterConnect

Perform the following steps to access OracleAS Integration InterConnect from the Oracle Enterprise Manager 10g Application Server Control Console:

  1. Go to the following URL:

    http://hostname:port/
    
    

    where:

    • hostname is the name of the host on which the OracleAS Integration InterConnect middle-tier instance is installed

    • port is the number assigned during OracleAS Integration InterConnect installation. The following sources also identify the port number used to access the Oracle Enterprise Manager 10g Application Server Control Console:

      • The ipsetupinfo.txt file in the install subdirectory of your Oracle home directory

      • The End of Installation page that is displayed during installation

  2. Enter the following login details when prompted:

    Field Value
    Username Enter ias_admin
    Password Enter the password you specified during J2EE and Web Cache installation and OracleAS Integration InterConnect installation for the ias_admin user.


    Note:

    If you have multiple Oracle Application Server middle-tier instances installed on a single host, then you need to specify different Oracle Enterprise Manager 10g ports for each instance. See the portlist.ini file in the $ORACLE_HOME/install directory for a list of ports currently in use.

    The Oracle Enterprise Manager 10g Application Server Control Console is displayed, as shown in Figure 11-1:

    Figure 11-1 Oracle Enterprise Manager 10g Application Server Control Console

    Description of Figure 11-1  follows
    Description of "Figure 11-1 Oracle Enterprise Manager 10g Application Server Control Console"

  3. The System Components section provides basic information about various component installed on Oracle Application Server. Click InterConnect. The OracleAS Integration InterConnect middle-tier instance page is displayed, as shown in Figure 11-2:

    Figure 11-2 OracleAS Integration InterConnect Middle-Tier Instance Page

    Description of Figure 11-2  follows
    Description of "Figure 11-2 OracleAS Integration InterConnect Middle-Tier Instance Page"

Viewing Status and System Metrics

You can view the status and metrics of an OracleAS Integration InterConnect instance by using the following sections on the OracleAS Integration InterConnect middle-tier instance page:

General Section

The General section of the OracleAS Integration InterConnect middle-tier instance page, as shown in Figure 11-2, displays the current status of the OracleAS Integration InterConnect instance. It provides the following information:

  • Status: The status of the OracleAS Integration InterConnect instance. The overall status of the instance depends upon the status of the repository and adapters. If the repository and all the adapters are running, then the status is shown as UP. However, if any one of these components is not running, then the status is shown as Down.

  • Version: The version of OracleAS Integration InterConnect.

  • Host: The Application Server middle-tier host computer on which OracleAS Integration InterConnect is installed.

  • Oracle Home: The location of the Oracle home directory on the host computer.

Repository Section

The Repository section of the OracleAS Integration InterConnect middle-tier instance page, as shown in Figure 11-2, displays the current status of the repository. It provides the following information:

  • Start Time: The time when the repository was started.

  • CPU Usage: The amount of CPU being used by the repository.

  • Memory Usage: The amount of memory being used by the repository.

Adapters Section

The Adapters section of the OracleAS Integration InterConnect middle-tier instance page, as shown in Figure 11-2, displays the current status of all adapters. It provides the following information about each adapter:

  • Status: The status of an adapter.

  • Start Time: The time when an adapter was started.

  • CPU Usage: The amount of CPU being used by an adapter.

  • Memory Usage: The amount of memory being used by an adapter.

Starting and Stopping OracleAS Integration InterConnect Components

This section describes how to start and stop various components of OracleAS Integration InterConnect by using the Oracle Enterprise Manager 10g Application Server Control Console. It contains the following topics:

Starting and Stopping the Repository

To start, stop, or restart the repository, use either of the following methods:

  • Click Start, Stop, or Restart in the Repository section of the OracleAS Integration InterConnect middle-tier instance page, as shown in Figure 11-2.

  • Click Start All, Stop All, or Restart All in the General section of OracleAS Integration InterConnect middle-tier instance page, as shown in Figure 11-2.


    Note:

    The Start All, Stop All, or Restart All buttons in the General section start, stop, or restart all the adapters and the repository. However, the hub queue is not started.

Starting and Stopping the Adapters

To start, stop, and restart adapters, use either of the following methods:

  • Select one or more adapters in the Adapters section of the OracleAS Integration InterConnect middle-tier instance page. Click Start, Stop, or Restart, as shown in Figure 11-2.

  • Click Start All, Stop All, and Restart All in the General section of OracleAS Integration InterConnect middle-tier instance page, as shown in Figure 11-2.

Starting and Stopping the Hub Queue

You cannot start or stop the hub queue from the Oracle Enterprise Manager 10g Application Server Control Console. You can start and stop the hub queue by using the Oracle Enterprise Manager Database Control Console.


See Also:

For information about Oracle Enterprise Manager Database Control, refer <Guide name to be added>.

Monitoring Adapter Performance

You can view the performance metrics of all adapters by clicking the Performance tab on the OracleAS Integration InterConnect middle-tier instance page. The Adapter Performance page is displayed, as shown in Figure 11-3. You can use the Type list to view only inbound messages, only outbound messages, or all messages.

Figure 11-3 OracleAS Integration InterConnect Middle-Tier Instance Adapters Performance Page

Description of Figure 11-3  follows
Description of "Figure 11-3 OracleAS Integration InterConnect Middle-Tier Instance Adapters Performance Page"

The Adapter Performance page provides the following information for each adapter:

  • Name: The name of the adapter.

  • Type: The type of the adapter, Inbound or Outbound.

  • Instance Name: The name of the adapter instance.

  • Partition Name: The name of the adapter partition.

  • Number of Processed Messages: The number of messages successfully processed.

  • Number of Recovered Messages: The number of messages that have been recovered. When a message could not be delivered to the target application by the adapter, it is moved to the oai_agent_error table. If the adapter is down, then the message is persisted in the queue until the adapter is up and running. The message is then delivered to the application.

  • Number of Errored Messages: The number of messages that are not successfully processed and delivered to the target application.

  • Throughput: The number of messages processed in a second.

Configuring OracleAS Integration InterConnect Components

You can configure the OracleAS Integration InterConnect components by clicking the Administration tab on the OracleAS Integration InterConnect middle-tier instance page. Figure 11-4 displays the page that appears when you click the Administration link.

Figure 11-4 OracleAS Integration InterConnect Middle-Tier Instance Administration Page

Description of Figure 11-4  follows
Description of "Figure 11-4 OracleAS Integration InterConnect Middle-Tier Instance Administration Page"

You can use the Administration page to configure the following OracleAS Integration InterConnect components:

  • Repository

  • Adapters

  • Hub

Configuring the Repository

To configure the repository:

  1. Click Repository Properties, shown in Figure 11-4. The Repository Properties page is displayed, as shown in Figure 11-5.

    Figure 11-5 OracleAS Integration InterConnect Middle-Tier Instance Repository Properties Page

    Description of Figure 11-5  follows
    Description of "Figure 11-5 OracleAS Integration InterConnect Middle-Tier Instance Repository Properties Page"

  2. Modify any of the properties listed in Table 11-1 and click Apply.

    Table 11-1 Repository Properties

    Property Description

    Repository Owner

    The name of the repository owner.

    Debug

    Enable or Disable debugging of messages in the logs.

    Service Path

    The value of the environment variable PATH. This parameter is mandatory when Oracle Application Server middle-tier is installed on Microsoft Windows.

    Service Classpath

    The class path used by the adapter Java Virtual Machine. This parameter is mandatory when Oracle Application Server middle-tier is installed on Microsoft Windows.

    Service Class

    The Entry Class for the Windows Operating System Service. This parameter is mandatory when Oracle Application Server middle-tier is installed on Microsoft Windows.

    Maximum Java Stack Size

    The maximum size up to which the Java Virtual Machine Stack can grow. This parameter is required for Microsoft Windows only.

    Maximum Native Stack Size

    The maximum size to which the Java Virtual Machine Native Stack can grow. This parameter is required for Microsoft Windows only.

    Minimum Heap Size

    The minimum heap size for the Adapter Java Virtual Machine. This parameter is required for Microsoft Windows only.

    Maximum Heap Size

    The maximum heap size for the Adapter Java Virtual Machine. This parameter is required for Microsoft Windows only.

    JDK Version

    The JDK Version.

    JDK DLL Name

    The name of the JDK DLL.


Configuring the Adapters

To configure the adapters:

  1. Click Adapter Properties, shown in Figure 11-4. The Adapter Properties page is displayed, as shown in Figure 11-6.

    Figure 11-6 OracleAS Integration InterConnect Middle-Tier Instance Adapters Properties Page

    Description of Figure 11-6  follows
    Description of "Figure 11-6 OracleAS Integration InterConnect Middle-Tier Instance Adapters Properties Page"

  2. Select an adapter from the Adapter Name list. The properties for the selected adapter are displayed.


    Note:

    The adapter properties are different for different adapters. For example, the properties that are displayed when you select a database adapter are different from the properties of the FTP adapter.

  3. Modify the adapter properties and click Apply.

Configuring the Hub Queue

To configure the Hub properties, click Hub Properties, shown in Figure 11-4. The Hub Properties page is displayed, as shown in Figure 11-7.

Figure 11-7 OracleAS Integration InterConnect Middle-Tier Instance Hub Properties Page

Description of Figure 11-7  follows
Description of "Figure 11-7 OracleAS Integration InterConnect Middle-Tier Instance Hub Properties Page"

You can use the Hub Properties page to:

Modify the Common Database Connection Parameters

To modify the common database connection parameters, update any of the following fields and click Save:

  • User Name: The user name for connecting to Real Application Cluster.

  • Use Thin JDBC: Specify whether to use a thin JDBC driver or thick JDBC driver.

Add a Database Node

To add a database node instance on the Real Application Cluster:

  1. Click Add. The Add Database Node page is displayed, as shown in Figure 11-8.

    Figure 11-8 OracleAS Integration InterConnect Middle-Tier Instance Add Database Node Page

    Description of Figure 11-8  follows
    Description of "Figure 11-8 OracleAS Integration InterConnect Middle-Tier Instance Add Database Node Page"

  2. Enter the host name of the database node.

  3. Enter the instance name of the database node.

  4. Enter the TNS listener port number for the hub database instance of a node.

  5. Click Apply.

Modify a Database Node

To modify a database node:

  1. Click the node name. The Edit Database Node page is displayed.

  2. Enter the host name of the database node.

  3. Enter the instance name of the database node.

  4. Enter the TNS listener port number for the hub database instance of a node.

  5. Click Apply.

Delete a Database Node

To delete a database node, click Remove.

Locating and Viewing Log Files

To view the InterConnect log files:

  1. Click Log on the OracleAS Integration InterConnect middle-tier instance page. The View Logs page is displayed, as shown in Figure 11-9.

    Figure 11-9 OracleAS Integration InterConnect Middle-Tier Instance View Logs Page

    Description of Figure 11-9  follows
    Description of "Figure 11-9 OracleAS Integration InterConnect Middle-Tier Instance View Logs Page"

  2. Select InterConnect from the Available Components list and click Move.

  3. Click Search. All InterConnect log files are displayed in the Results section.

  4. Select the file that you want to view.