18
System Management with Oracle Enterprise Manager

This chapter provides an overview of Oracle Application Server ProcessConnect monitoring and administration tasks that you can perform from Oracle Enterprise Manager.

This chapter contains these topics:

• Oracle Enterprise Manager Monitoring and Administration Overview

• Managing and Monitoring a Middle-Tier Instance from Oracle Enterprise Manager Application Server Control

• Starting and Stopping Oracle Application Server ProcessConnect Components with OPMN

• Additional Oracle Application Server and Oracle Application Server ProcessConnect Management Tasks

• Changing Port Numbers

• Chapter Summary

  See Also: Chapter 19, "Performance Tuning" for details about using Oracle Enterprise Manager to manage Oracle Application Server ProcessConnect performance The Oracle Application Server 10g Administrator's Guide for details about using Oracle Enterprise Manager to manage Oracle Application Server

Oracle Enterprise Manager Monitoring and Administration Overview

Figure 18-1 provides a high-level overview of how Oracle Application Server ProcessConnect (called OracleAS ProcessConnect) is managed.

Figure 18-1 Monitoring and Management with Oracle Enterprise Manager

Text description of the illustration ipusr097.gif

In Figure 18-1, Oracle Application Server ProcessConnect is installed on three Oracle Application Server middle tiers that connect to an Oracle Application Server Metadata Repository.

The Oracle Enterprise Manager Application Server Control is designed to provide local monitoring and administration tasks on an Oracle Application Server ProcessConnect middle-tier instance basis. The Oracle Enterprise Manager Application Server Control also provides real-time systems monitoring details such as up and down status, current CPU and memory consumption, and current performance status on the instance.

Oracle Application Server ProcessConnect Management Concepts and Components

This section describes the following Oracle Application Server ProcessConnect management concepts and components:

• Oracle Application Server Metadata Repository

• Oracle Application Server ProcessConnect Instance

• Integration Manager

• Adapter Framework

• OC4J Instance for Oracle Application Server ProcessConnect

Oracle Application Server Metadata Repository

The Oracle Application Server Metadata Repository contains all the profile data and modeling metadata required for an integration. The Oracle Application Server Metadata Repository can be installed either through OracleAS Infrastructure 10g or with the Repository Configuration Assistant. Every Oracle Application Server ProcessConnect middle-tier instance requires a connection to the Oracle Application Server Metadata Repository to work properly.

See Also: Oracle Application Server ProcessConnect Installation Guide for Oracle Application Server Metadata Repository installation concepts

Oracle Application Server ProcessConnect Instance

An Oracle Application Server ProcessConnect middle-tier instance is a logical grouping of the integration manager, adapter framework, and an Oracle Application Server Containers for J2EE (OC4J) instance for Oracle Application Server ProcessConnect. There is one Oracle Application Server ProcessConnect middle-tier instance for each Oracle home. When you install Oracle Application Server ProcessConnect, you install an Oracle Application Server ProcessConnect instance and its subcomponents: integration manager, adapter framework, and the OC4J instance for Oracle Application Server ProcessConnect.

Integration Manager

The integration manager is a standalone Java process that executes all integration processes and invokes a set of services required as events move through Oracle Application Server ProcessConnect.

Adapter Framework

The adapter framework is a standalone Java process that is responsible for both invoking adapter services and receiving data from adapters.

OC4J Instance for Oracle Application Server ProcessConnect

The OC4J instance hosts the Oracle Application Server ProcessConnect user interface tool used for creating integrations, generating reports, managing trading partners, and other integration aspects. The OC4J instance also hosts a number of adapters required for integration.

See Also: The Oracle Application Server 10g Administrator's Guide for details about troubleshooting OC4J instance issues

Oracle Enterprise Manager Application Server Control Tasks

You can perform the following local monitoring and administration tasks from the Oracle Enterprise Manager Application Server Control:

• Start and stop the Oracle Application Server ProcessConnect integration manager, adapter framework, and OC4J instance components running in each Oracle Application Server middle-tier instance.

• View the current running status (started or stopped) and memory and CPU usage for the integration manager, adapter framework, and OC4J instance running in each Oracle Application Server middle-tier instance.

• View and edit Oracle Application Server ProcessConnect configuration parameters. The online help lists all configuration parameter properties, including descriptions, default values, and allowed ranges.

• View integration manager and adapter framework performance.

• View integration manager and adapter framework log files.

• Access the Oracle Application Server ProcessConnect user interface tool for designing and deploying integrations.

  See Also: "Managing and Monitoring a Middle-Tier Instance from Oracle Enterprise Manager Application Server Control"

Managing and Monitoring a Middle-Tier Instance from Oracle Enterprise Manager Application Server Control

Follow these instructions to access Oracle Application Server ProcessConnect from the Oracle Enterprise Manager Application Server Control.

To access Oracle Application Server ProcessConnect from the Oracle Enterprise Manager Application Server Control:

1. Go to the following URL:

   http://hostname:port/
   
   

   where:

   • hostname is the name of the host on which the Oracle Application Server ProcessConnect middle-tier instance is installed

   • port was the number assigned when you installed Oracle Application Server ProcessConnect. At the end of installation, the port number displayed onscreen.

2. Enter the following login details when prompted:

   Field	Description
   Username	Enter ias_admin
   Password	Enter the password you specified during J2EE and Web Cache installation and Oracle Application Server ProcessConnect installation for the ias_admin user.

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

   The Oracle Application Server home page appears:

   

   Text description of the illustration oem_homepage.gif

3. Select a management task to perform and see the referenced section for instructions.

   Page Elements	Management Task	See Also
   Name list of System Components section	Select the Oracle Application Server ProcessConnect middle-tier instance to monitor and administer from the Oracle Enterprise Manager Application Server Control	"Oracle Application Server ProcessConnect Monitoring and Administration Tasks" for an overview of Oracle Application Server ProcessConnect tasks you can perform
   Process Management link (at bottom)	Select Process Management to view and edit the opmn.xml file.	"Oracle Process Management Notification Management"
   Ports link (at bottom)	Select Ports to view ports assigned to Oracle Application Server ProcessConnect and other Oracle Application Server components	"Oracle Application Server ProcessConnect Port Management"
   Infrastructure link (at bottom)	Select Infrastructure to review and modify details about the relationship between this Oracle Application Server instance and the rest of your enterprise.	"Oracle Application Server and Enterprise Relationship Management"

   See Also: Oracle Application Server 10g Administrator's Guide for instructions on changing the ias_admin username password

Oracle Application Server ProcessConnect Monitoring and Administration Tasks

Figure 18-2 shows the Oracle Application Server ProcessConnect middle-tier instance page that displays after selecting the specific instance in Step 3. You can perform the following monitoring and administration tasks.

Figure 18-2 Oracle Application Server ProcessConnect Middle-Tier Instance Page

Text description of the illustration oem_standalone.gif

Table 18-1 identifies the tasks that you can perform. These tasks are further described in the online help available by clicking Help in the top right corner of each page.

Table 18-1  Oracle Enterprise Manager Application Server Control Monitoring and Administration Tasks

Page Elements	Management Task
Summary section	View an overall status of the integration manager, adapter framework, and OC4J instance components on this middle-tier instance. For the overall status to display as Up, all three components must be running.
Summary section	Click Stop All to stop the integration manager, adapter framework, and OC4J instance together.
Summary section	Click Restart All to restart the integration manager, adapter framework, and OC4J instance together.
Adapter Framework, Integration Manager, or OC4J Instance section	Click Stop to stop a specific component (either integration manager, adapter framework, or OC4J instance). Each component has its own Stop button.
Adapter Framework, Integration Manager, or OC4J Instance section	Click Restart to restart a specific component (either integration manager, adapter framework, or OC4J instance). Each component has its own Restart button.
Adapter Framework Log File link (at bottom)	Click to access a page from which to view adapter framework log files. See Also: "Oracle Application Server ProcessConnect Log Files"
Integration Manager Log File link (at bottom)	Click to access a page from which to view integration manager log files. See Also: "Oracle Application Server ProcessConnect Log Files"
ProcessConnect UI Tool link (in OC4J Instance section)	Click to access the Oracle Application Server ProcessConnect user interface tool login page from which you can design and deploy an integration.
Server Properties link (at bottom)	Click to access a page from which you can view and edit Oracle Application Server ProcessConnect configuration parameters in the metadata repository. See Also: "Oracle Application Server ProcessConnect Middle-Tier Instance Configuration Parameters"
Performance link (at bottom)	Click to access a page from which you can view integration manager and adapter framework performance. See Also: "Oracle Application Server ProcessConnect Middle-Tier Instance Performance"

See Also: The Oracle Application Server 10g Administrator's Guide for details about viewing log files and troubleshooting OC4J instance issues

Oracle Application Server ProcessConnect Log Files

Oracle Application Server components such as Oracle Application Server ProcessConnect generate log files describing all types of events, including startup and shutdown details, errors, warning messages, access details on HTTP requests, and so on. You can view adapter framework and integration manager log files for Oracle Application Server ProcessConnect (for this example, integration manager logs are selected).

1. Ensure that you followed the instructions in "Oracle Application Server ProcessConnect Monitoring and Administration Tasks" to access the page for viewing log files.

   The View Logs page appears.

   

   Text description of the illustration oem_logs.gif

2. Select components for which to generate log details in the Available Components list.

3. Use the Move arrows to move selected components to the Selected Components list.

4. Click Search.

   A list of log files appears in the Results table.

5. Click a specific log to view in the Log File column.

   See Also: Oracle Application Server 10g Administrator's Guide and the online help for details about viewing log files

Oracle Application Server ProcessConnect Middle-Tier Instance Configuration Parameters

You can edit parameters settings for logging levels, security, number of role threads, trading partner (B2B) properties, and so on. These parameters also display in a file called tip.properties. However, Oracle recommends that you edit these parameters only through the Server Properties page. Do not edit these parameters by accessing the tip.properties file from the directory path location and using an ASCII editor. Figure 18-3 shows the upper portion of the page for viewing and editing configuration parameters.

Figure 18-3 Oracle Application Server ProcessConnect Middle-Tier Instance Configuration Parameters Page

Text description of the illustration manage_oem3.gif

See Also: The online help for a description of parameters you can edit, their range of values, and the default values

Oracle Application Server ProcessConnect Middle-Tier Instance Performance

You can view details about integration manager and adapter framework performance in a specific Oracle Application Server ProcessConnect middle-tier instance, including:

• Transformation details, such as the average time to process a transformation, the maximum and minimum times to process a transformation, the size of the last transformation processed, and the number of transformations performed since the integration manager was started

• Translation details, such as the average time to process a translation, the maximum and minimum times to process a translation, the size of the last translation processed, and the number of translations performed since the integration manager was started

• Active application and trading partner details, such as the adapter used, the application name, the direction of the adapter interaction, the average adapter processing time, number of events processed, and number of event errors occurring since the adapter framework was started.

Figure 18-4 shows the performance page for a specific Oracle Application Server ProcessConnect middle-tier instance.

Figure 18-4 Oracle Application Server ProcessConnect Middle-Tier Instance Performance Page

Text description of the illustration oem_sa_perf.gif

Oracle Process Management Notification Management

You can access the opmn.xml file to modify the configuration of Oracle Process Management and Notification (OPMN). OPMN manages Oracle HTTP Server and OC4J processes within an application server instance, and passes events from different component instances to components interested in receiving them.

1. Ensure that you selected Process Management in Step 3 of "Managing and Monitoring a Middle-Tier Instance from Oracle Enterprise Manager Application Server Control" to access the page for viewing and changing the opmn.xml file.

   The Process Management page displays the contents of the opmn.xml file. You can perform various management tasks by modifying the properties in the opmn.xml file, including the following:

   • Configuring timeout and retry values for stop, start, and restart operations

   • Configuring environment variables and options to send to components when you start or restart components

   • Setting logging levels for OPMN log files

2. Click the online help for additional details.

   See Also: Oracle Application Server 10g Administrator's Guide for details about OPMN and the opmn.xml file

Oracle Application Server ProcessConnect Port Management

You can view Oracle Application Server ProcessConnect and Oracle Application Server component ports, and change some Oracle Application Server ports. However, it is strongly recommended that you not change Oracle Application Server ProcessConnect ports for this release.

1. Ensure that you selected Ports in Step 3 of "Managing and Monitoring a Middle-Tier Instance from Oracle Enterprise Manager Application Server Control" to access the page for viewing and changing component ports.

   The page listing component ports appears.

2. Click the Component title in the Component column to alphabetically arrange the order of ports by name.

   The integration manager, adapter framework, and B2B components of Oracle Application Server ProcessConnect display the following details:

   

   Text description of the illustration oem_ports.gif

3. View details about ports, including the current port number and range of available ports.

4. Click the Configure column for a port that you want to change. Only ports with the pencil icon in the Configure column can be changed.

5. Follow the instructions on the page that displays to change the component port. Click the online help for additional details.

   If you install additional application adapters included on the Oracle Application Server ProcessConnect software CD-ROM, the following components and port numbers also display in this list:

   Component	Assigned Port Range	Default Port Number
   Actional AgentFoot 1	20300 - 20350	20300
   Actional Listener1	4550 - 4599	4550
   Attunity Adapters (Legacy Adapters)Foot 2	2550 - 2577	2552

   1 Actional agent and listener ports apply to the Oracle Application Server Integration Adapter for SAP R/3, Oracle Application Server Integration Adapter for Peoplesoft 8, Oracle Application Server Integration Adapter for Siebel 2000, and Oracle Application Server Integration Adapter for J.D. Edwards. 2 Attunity adapter ports apply to the Oracle Application Server Integration Adapter for IM/STM, Oracle Application Server Integration Adapter for IMS/DB, Oracle Application Server Integration Adapter for CICS Adapter, Oracle Application Server Integration Adapter for VSAM Adapter, and the Oracle Application Server Integration Adapter for Tuxedo.

   See Also: "Port Changing Error Message" for the type of error message you receive if you attempt to start Oracle Application Server ProcessConnect components, but another component is already using the assigned port

Oracle Application Server and Enterprise Relationship Management

You can view and change details about the relationship between the selected Oracle Application Server instance and the rest of your enterprise. For example, you can view or change the Oracle Application Server Metadata Repository schema and passwords used by your Oracle Application Server components.

1. Ensure that you selected Infrastructure in Step 3 of "Managing and Monitoring a Middle-Tier Instance from Oracle Enterprise Manager Application Server Control" to access the page for managing the following details about the selected Oracle Application Server instance and the rest of your enterprise:

   Section	Enables You To...
   Identity Management	Associate the Oracle Application Server instance with an initial Oracle Internet Directory instance or change an association to a different Oracle Internet Directory instance
   Database Managed Oracle Application Server Clusters	Use Oracle Application Server clusters
   Metadata Repository	Review or modify the Oracle Application Server Metadata Repository schema and passwords used by the Oracle Application Server components

2. Click the online help for additional details.

   See Also: Oracle Application Server 10g Administrator's Guide for specific details

Starting and Stopping Oracle Application Server ProcessConnect Components with OPMN

You can also start and stop the adapter framework, integration manager, and OC4J instance components of Oracle Application Server ProcessConnect from the operating system command prompt using OPMN.

To stop the adapter framework, integration manager, and OC4J instance individually:

1. Enter the following commands at your operating system command prompt to stop the adapter framework, integration manager, and OC4J instance.

   prompt> opmnctl stopproc process-type=AdapterFramework
   
   prompt> opmnctl stopproc process-type=IntegrationManager
   
   prompt> opmnctl stopproc process-type=OC4J_ProcessConnect
   

To start the adapter framework, integration manager, and OC4J instance individually:

1. Enter the following commands at your operating system command prompt to start the adapter framework, integration manager, and OC4J instance.

   prompt> opmnctl startproc process-type=AdapterFramework
   
   prompt> opmnctl startproc process-type=IntegrationManager
   
   prompt> opmnctl startproc process-type=OC4J_ProcessConnect
   
   

To start and stop the adapter framework, integration manager, and OC4J instance together:

1. Enter the following commands at your operating system command prompt to start or stop the adapter framework, integration manager, and OC4J instance together.

   prompt> opmnctl startproc ias-component=ProcessConnect
   
   prompt> opmnctl stopproc ias-component=ProcessConnect
   

   See Also: The Oracle Application Server 10g Administrator's Guide located in the Oracle Application Server 10g Documentation Library for details on OPMN

Additional Oracle Application Server and Oracle Application Server ProcessConnect Management Tasks

This table describes additional Oracle Application Server administration tasks that also relate to Oracle Application Server ProcessConnect. References to documentation that describes these tasks are also provided.

Table 18-2  Additional Oracle Enterprise Manager Tasks

Task	See Also
Configure an Oracle Application Server instance to use Infrastructure Services.	Oracle Application Server 10g Administrator's Guide
Installing and configuring Oracle Application Server for high availability (including Oracle Application Server Cold Failover Cluster and Oracle Application Server Active Failover Cluster)	Oracle Application Server 10g Installation Guide
Changing internet protocol (IP) addresses and hostnames for an Oracle Application Server host	Oracle Application Server 10g Administrator's Guide
Viewing and changing ports	Oracle Application Server 10g Administrator's Guide "Oracle Application Server ProcessConnect Port Management" "Changing Port Numbers"
Using the dynamic host configuration protocol (DHCP) in Windows and Linux environments.	Oracle Application Server 10g Administrator's Guide
Configuring Oracle HTTP Server for secure socket layer (SSL) and secure HTTP	Oracle HTTP Server Administrator's Guide
Configuring OC4J for secure socket layer (SSL) and secure HTTP	Oracle Application Server 10g Security Guide
Configuring fire walls and load balancing	Oracle Application Server 10g High Availability Guide

Changing Port Numbers

Oracle Enterprise Manager uses dynamic monitoring services (DMS) ports to gather performance data about Oracle Application Server components. For this release, Oracle Application Server ProcessConnect does not seamlessly support the use of dynamic ports. Instead, static port numbers assigned during installation are used for gathering performance data. Changing a port number is a complicated procedure. Oracle strongly recommends that you do not change port numbers. Instead, find the process that uses the integration manager or adapter framework ports, and stop that process (or whatever else is required to free that port). However, if you must change the port number, follow the instructions in this section.

This section contains these topics:

• Port Changing Error Message

• Modifying Ports

  See Also: Oracle Application Server 10g Performance Guide for additional details about DMS "Oracle Application Server ProcessConnect Monitoring and Administration Tasks" for instructions on stopping Oracle Application Server ProcessConnect processes

Port Changing Error Message

This error message occurs when you attempt to start Oracle Application Server ProcessConnect components, but another component is already using the assigned port:

isunrak21(17:45:03):/private/sabburi/m13/opmn/bin % opmnctl startproc 
process-type=IntegrationManager
opmnctl: starting opmn managed processes...
 
================================================================================
     opmn id=isunrak21:6200
         0 of 1 processes started.
      
     ias-instance id=m13.isunrak21
     
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
     ias-component/process-type/process-set:
         ProcessConnect/IntegrationManager/m13.isunrak21
      
     Error
     --> Process (pid=0)
         failed to start a managed process after the maximum retry limit
         no port available from the port range
         no port available from the port range
         Log:
         none

Modifying Ports

If you must change the port number, follow these instructions.

1. Make backup copies of the opmn.xml and targets.xml files to be modified in these procedures before you begin.

2. Stop all OPMN and Oracle Enterprise Manager processes:

   emctl stop em
   opmnctl stopall
   
   

3. Open the $ORACLE_HOME/opmn/conf/opmn.xml file.

4. Modify the range attribute of the port element for the corresponding Oracle Application Server ProcessConnect component.

   <process-type id="IntegrationManager"
    module-id="integration-manager"working-dir="$ORACLE_HOME/ip">
      <port id="dms" range="8777"/>
      <process-set id="m14_midtier.isunrak23" numprocs="1"/>
      <start timeout="3600"/>
      <stop timeout="3600"/>
      </process-type>
   <process-type id="AdapterFramework" module-id="adapter-framework" 
    working-dir="$ORACLE_HOME/ip">
      <port id="dms" range="8778"/>
      <process-set id="m14_midtier.isunrak23" numprocs="1"/>
      <start timeout="3600"/>
      <stop timeout="3600"/>
   </process-type>
   
   

5. Open $ORACLE_HOME/sysman/emd/targets.xml and go to the integration manager or adapter framework section.

6. Change the "HTTPPort" attribute to the port you specified in opmn.xml in Step 4.

   <Target TYPE="oracle_processconnect_im" NAME="m14_midtier.isunrak23_
   IntegrationManager" 
          VERSION="3.0">
               <Property NAME="OracleHome" VALUE=""/>
               <Property NAME="HTTPPort" VALUE="8777"/>
               <Property NAME="HTTPMachine" VALUE="isunrak23"/>
               <Property NAME="OPMNPort" VALUE="6003"/>
               <CompositeMembership>
                   <MemberOf TYPE="oracle_processconnect_instance" 
          NAME="m14_midtier.isunrak23_ProcessConnect_Instance"/>
               </CompositeMembership>
           </Target> 
   
          <Target TYPE="oracle_processconnect_af" NAME="m14_midtier.isunrak23_
   AdapterFramework" 
          VERSION="3.0">
               <Property NAME="OracleHome" VALUE="/home/msarma/M14_
   midtier/OracleHome"/>
               <Property NAME="EmptyOracleHome" VALUE=""/>
               <Property NAME="HTTPPort" VALUE="8778"/>
               <Property NAME="HTTPMachine" VALUE="isunrak23"/>
               <Property NAME="OPMNPort" VALUE="6003"/>
               <Property NAME="OidRepSchemaName" VALUE="IP"/>
               <CompositeMembership>
                   <MemberOf TYPE="oracle_processconnect_instance" 
          NAME="m14_midtier.isunrak23_ProcessConnect_Instance"/>
               </CompositeMembership>
           </Target>
   
   

7. Run the following command:

   $ORACLE_HOME/dcm/bin/dcmctl updateConfig
   

8. Restart OPMN (and the Oracle Enterprise Manager Application Server Control, if you are using it).

   opmnctl startall
   emctl start iasconsole
   

   See Also: Oracle Application Server 10g Administrator's Guide for details about integration manager and adapter framework port ranges

Chapter Summary

This chapter explains how to use Oracle Enterprise Manager to manage Oracle Application Server ProcessConnect (for example, starting and stopping the integration manager, adapter framework, or OC4J instance components, viewing log files, viewing log files, or editing configuration parameters).