|
Oracle® Application Server ProcessConnect User’s Guide
10g (9.0.4) Part No. B12121-02 |
|
|
|
|
Oracle® Application Server ProcessConnect User’s Guide
10g (9.0.4) Part No. B12121-02 |
|
|
|
|
This chapter provides an overview of Oracle Application Server ProcessConnect monitoring and administration tasks that you can perform from Oracle Enterprise Manager 10g.
This chapter contains these topics:
Oracle Enterprise Manager 10g Monitoring and Administration Overview
Starting and Stopping Oracle Application Server ProcessConnect Components with OPMN
Additional Oracle Application Server and Oracle Application Server ProcessConnect Management Tasks
|
See Also:
|
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 10g
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. Each Oracle Application Server middle tier is running the Oracle Management Agent. Oracle Management Agents monitor and perform administrative functions on managed targets. All three Oracle Application Server middle tiers are configured to use the Oracle Management Service as their management infrastructure. The Oracle Management Service works with all Oracle Management Agents in processing monitoring and job information.
The set of all Oracle Application Server ProcessConnect middle-tier instances that connect to the same Oracle Application Server Metadata Repository and that repository is called an Oracle Application Server ProcessConnect Domain. You can have multiple Oracle Application Server ProcessConnect Domains, all managed through the same Oracle Management Service.
The Oracle Management Service uses its own Oracle Management Agent. The Oracle Management Agent running in each middle tier uploads Oracle Application Server ProcessConnect specific metric details to the Oracle Management Server repository. In Figure 18-1, you can perform two types of system management tasks by connecting to either the Oracle Application Server middle tier (and using the Oracle Enterprise Manager 10g Application Server Control Console) or the Oracle Management Service (and using the Oracle Enterprise Manager 10g Grid Control Console).
The Oracle Enterprise Manager 10g Application Server Control Console and Oracle Enterprise Manager 10g Grid Control Console are designed to work together to perform the following tasks:
The Oracle Enterprise Manager 10g Application Server Control Console is designed to provide local monitoring and administration tasks on an Oracle Application Server ProcessConnect middle-tier instance basis. The Oracle Enterprise Manager 10g Application Server Control Console 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 Enterprise Manager 10g Grid Control Console is designed to provide monitoring and administration across multiple Oracle Application Server ProcessConnect middle-tier instances. The Oracle Enterprise Manager 10g Grid Control Console also provides historical data.
|
See Also: Oracle Enterprise Manager Concepts |
This section describes the following Oracle Application Server ProcessConnect management concepts and components:
The Oracle Application Server ProcessConnect domain is a logical grouping of one Oracle Application Server Metadata Repository and all the Oracle Application Server ProcessConnect middle-tier instances associated with that repository. Associations between an Oracle Application Server ProcessConnect middle-tier instance and the Oracle Application Server ProcessConnect domain are automatically created during installation. Further grouping of Oracle Application Server ProcessConnect middle-tier instances to create server groups can be accomplished using the grouping feature available from the Oracle Enterprise Manager 10g Grid Control Console.
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 |
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.
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.
The adapter framework is a standalone Java process that is responsible for both invoking adapter services and receiving data from adapters.
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 |
You can perform the following local monitoring and administration tasks from the Oracle Enterprise Manager 10g Application Server Control Console:
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.
You can perform the following remote monitoring tasks from the Oracle Enterprise Manager 10g Grid Control Console:
Manage and monitor multiple Oracle Application Server ProcessConnect domains
Identify which Oracle Application Server ProcessConnect middle-tier instances are part of which Oracle Application Server ProcessConnect domain
Identify which Oracle Application Server Metadata Repository is used by which Oracle Application Server ProcessConnect middle-tier instance or Oracle Application Server ProcessConnect domain
Monitor Oracle Application Server ProcessConnect components running in multiple Oracle9i Application Server middle-tier instances. For example, in Figure 18-1 you can monitor the running status and metric details for the Oracle Application Server ProcessConnect components running in all three Oracle Application Server middle-tier instances.
Monitor the status of inbound and outbound events for all instances, including details about the number of events currently being processed, the number of successfully processed events, and the number of events that failed to process
Manage alerts and notifications. You can edit thresholds for different metrics, and register for notification on different alerts and alert levels. For example, you can raise a critical alert when the average transformation processing time takes more than 5000 milliseconds and send an e-mail to an appropriate contact such as an administrator when this alert happens.
Oracle Application Server ProcessConnect monitors metric statistics (for example, average transformation time). Custom thresholds can be set for any given metric (for example, the critical threshold for average transformation time is 3000 milliseconds). When a given metric violates a set threshold, an alert is initiated. Response actions and notifications can be registered with alerts (for example, send e-mail when a critical alert is raised for average transformation time).
Change the server from which the Oracle Application Server ProcessConnect domain is managed.
Monitor adapter framework activity, including details about adapters, applications, and trading partners
Identify which Oracle Application Server middle-tier instance is using a particular adapter, integrating with a particular endpoint, or both.
Monitor integration manager activity, including performance details about the sizes of transformations and translations and the amount of time they take to complete
Analyze historical data. (For example, you can see the rate of incoming events over a period of 21 days.)
Log into an individual Oracle Enterprise Manager 10g Application Server Control Console to perform instance specific administration tasks such as modifying Oracle Application Server ProcessConnect configuration details or starting individual Oracle Application Server ProcessConnect components.
|
See Also:
|
Follow these instructions to access Oracle Application Server ProcessConnect from the Oracle Enterprise Manager 10g Application Server Control Console.
To access Oracle Application Server ProcessConnect from the Oracle Enterprise Manager 10g Application Server Control Console:
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.
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.
|
The Oracle Application Server home page appears:
Select a management task to perform and see the referenced section for instructions.
Table 18-1 Management Tasks
| 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 10g Application Server Control Console | "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"
|
Figure 18-2 shows the Oracle Application Server ProcessConnect middle-tier instance page that displays after selecting the specific instance in Step 2. You can perform the following monitoring and administration tasks.
Figure 18-2 Oracle Application Server ProcessConnect Middle-Tier Instance Page
Table 18-2 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-2 Oracle Enterprise Manager 10g Application Server Control Console 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 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).
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.
Select components for which to generate log details in the Available Components list.
Use the Move arrows to move selected components to the Selected Components list.
Click Search.
A list of log files appears in the Results table.
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 |
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
|
See Also: The online help for a description of parameters you can edit, their range of values, and the default values |
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
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.
Ensure that you selected Process Management in Step 2 of "Managing and Monitoring a Middle-Tier Instance from Oracle Enterprise Manager 10g Application Server Control Console" 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
Click the online help for additional details.
|
See Also: Oracle Application Server 10g Administrator's Guide for details about OPMN and theopmn.xml file
|
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.
Ensure that you selected Ports in Step 2 of "Managing and Monitoring a Middle-Tier Instance from Oracle Enterprise Manager 10g Application Server Control Console" to access the page for viewing and changing component ports.
The page listing component ports appears.
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:
View details about ports, including the current port number and range of available ports.
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.
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 |
|---|---|---|
| AgentFoot 1 | 20300 - 20350 | 20300 |
| ListenerFootref 15 | 4550 - 4599 | 4550 |
| Adapters (Legacy Adapters)Foot 2 | 2550 - 2577 | 2552 |
|
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 |
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.
Ensure that you selected Infrastructure in Step 2 of "Managing and Monitoring a Middle-Tier Instance from Oracle Enterprise Manager 10g Application Server Control Console" 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 |
| Central Management | Manage this Oracle Application Server instance from the Oracle Enterprise Manager 10g Grid Control Console. |
| 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 |
Click the online help for additional details.
|
See Also: Oracle Application Server 10g Administrator's Guide for specific details |
Follow these instructions to access Oracle Application Server ProcessConnect from the Oracle Enterprise Manager 10g Grid Control Console.
To access Oracle Application Server ProcessConnect from the Oracle Enterprise Manager 10g Grid Control Console:
Go to the following Web site.
http://hostname:port/em
where:
hostname is the name of the host on which the Oracle Management Service is installed
port is the specific port number. The port number to enter depends on how your Oracle Application Server environment is configured. See the Oracle Application Server 10g Administrator's Guide for details on the port number to enter.
Enter the following login details when prompted:
| Field | Description |
|---|---|
| Username | Enter sysman.
|
| Password | Enter the password you specified during Oracle Enterprise Manager 10g installation. |
The main Oracle Enterprise Manager 10g page appears.
Click the Targets tab.
Click the All Targets tab.
Select the component you want to manage in the Name column. For example:
| If You Want to Manage the... | Select a Component of Type... |
|---|---|
| Oracle Application Server ProcessConnect domain
(consists of the metadata repository and each Oracle Application Server ProcessConnect middle-tier instance using it) |
Oracle Application Server ProcessConnect Domain |
| Oracle Application Server ProcessConnect middle-tier instance | Oracle Application Server ProcessConnect Instance |
| Adapter framework of an Oracle Application Server ProcessConnect middle-tier instance | Adapter Framework |
| Integration manager of an Oracle Application Server ProcessConnect middle-tier instance | Integration Manager |
See "Oracle Application Server ProcessConnect Monitoring Tasks" for an overview of tasks you can perform.
|
Note: You can view, but not modify, details from the Oracle Enterprise Manager 10g Grid Control Console. Modification of details, such as changing configuration parameters, is only permitted from the Oracle Enterprise Manager 10g Application Server Control Console. |
|
See Also:
|
Figure 18-5 shows the Oracle Enterprise Manager 10g Grid Control Console main page that displays after selecting an Oracle Application Server ProcessConnect middle-tier domain in Step 5. You can perform the following monitoring tasks.
Figure 18-5 Oracle Application Server ProcessConnect Domain Main Page
|
Note: Tables for two types of alerts can also appear on this page:
|
Table 18-3 identifies the tasks that you can perform. These tasks are described in detail in the online help available by clicking Help in the top right corner of each page.
Table 18-3 Oracle Enterprise Manager 10g Grid Control Console Management Tasks
| Page Elements | Management Task |
|---|---|
| Performance link | Click to view overall event performance for all Oracle Application Server ProcessConnect middle-tier instances using this metadata repository.
See Also: "Oracle Application Server ProcessConnect Domain Event Performance" for additional details |
| System Exception Log link | Click to view errors for all Oracle Application Server ProcessConnect instances using this metadata repository, including the error severity, the component that failed, the specific error message, and the time of error occurrence. |
| Target Administration link | Click to view a list of Oracle Application Server ProcessConnect instances using this metadata repository. One of these instances can be selected to manage this Oracle Application Server ProcessConnect domain. A Oracle Application Server ProcessConnect domain consists of a single metadata repository and all of the Oracle Application Server ProcessConnect instances that use it. The Oracle Management Agent of each instance also displays. |
| Statistics section | View specific details about all Oracle Application Server ProcessConnect instances using this metadata repository, including events currently being processed, the number of incoming events received in the last hour, the number of successfully processed events in the last hour, and the number of events that failed to process in the last hour (integration manager was unable to process them). |
| Integration Manager Status section | Click to view integration manager performance details for a specific Oracle Application Server ProcessConnect middle-tier instance.
See Also: "Integration Manager Performance" |
| Adapter Framework Status section | Click to view adapter framework performance details for a specific Oracle Application Server ProcessConnect middle-tier instance.
See Also: "Adapter Framework Performance" |
| ProcessConnect Repository section | View the following details about the metadata repository:
See Also: Chapter 16, " Creating and Deploying a Configuration" for details about configurations |
| ProcessConnect Instances section | Lists the Oracle Application Server ProcessConnect middle-tier instances using this metadata repository. Click to view a specific Oracle Application Server ProcessConnect middle-tier instance and the status of its OC4J, integration manager, and adapter framework components.
See Also: "Oracle Application Server ProcessConnect Middle-Tier Instance Page" for additional details |
| Related Links section | Provides links to related Oracle Enterprise Manager 10g topics. |
You can view the performance details in graphical charts for all Oracle Application Server ProcessConnect middle-tier instances using this metadata repository, including the following:
Number of events currently being processed
Number of events raised and messages received
Number of events successfully processed
Number of events that failed to process
The View Data list in the upper right corner of the page enables you to select a specific time period over which to view event performance. Figure 18-6 and Figure 18-7 show this page.
You can view details about the Oracle Application Server ProcessConnect middle-tier instances that use this metadata repository, including the following:
Status of the Oracle Application Server ProcessConnect middle-tier instances
Percentage of time the Oracle Application Server ProcessConnect middle-tier instance has been available in the last day
Name of the host on which the Oracle Application Server ProcessConnect middle-tier instances is installed
The Oracle Application Server ProcessConnect middle-tier instance components, each of which provide links to pages that describe the following details:
The adapter framework pages that provide details about adapters used, adapter interaction directions, active applications, active trading partners, events processed, adapter processing times, and number of errors
The integration manager pages that provide details about events processed, and graphical charts describing historical data, translation and transformation performance, including average processing time, time to process the last transformation or translation, the size of the last transformation or translation, and the number of transformations or translations performed since integration manager and adapter framework startup, respectively
The Oracle Enterprise Manager 10g OC4J page
Figure 18-8 shows the page that lists each Oracle Application Server ProcessConnect middle-tier instance. Click a specific component in the ProcessConnect Instance Components column to view the details described previously.
Figure 18-8 Oracle Application Server ProcessConnect Middle-Tier Instance Page
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:
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:
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:
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 |
Table 18-4 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-4 Additional Oracle Enterprise Manager 10g 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" |
| 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
|
Oracle Enterprise Manager 10g 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:
|
See Also:
|
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
If you must change the port number, follow these instructions.
Make backup copies of the opmn.xml and targets.xml files to be modified in these procedures before you begin.
Stop all OPMN and Oracle Enterprise Manager 10g processes:
emctl stop em opmnctl stopall
Open the $ORACLE_HOME/opmn/conf/opmn.xml file.
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>
Open $ORACLE_HOME/sysman/emd/targets.xml and go to the integration manager or adapter framework section.
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>
Run the following command:
$ORACLE_HOME/dcm/bin/dcmctl updateConfig
Restart OPMN (and the Oracle Enterprise Manager 10g Application Server Control Console, 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 |
This chapter explains how to use Oracle Enterprise Manager 10g 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).
