18 System Management with Oracle Enterprise Manager 10g

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

This chapter contains the following topics:

Oracle Enterprise Manager 10g Monitoring and Administration Overview
Managing and Monitoring a Middle-Tier Instance from Oracle Enterprise Manager 10g Application Server Control Console
Starting and Stopping OracleAS Integration B2B Components with OPMN
Additional Oracle Application Server and OracleAS Integration B2B Management Tasks
Changing Port Numbers

See the following for more information:

Oracle Application Server Administrator's Guide for details about using Oracle Enterprise Manager 10g to manage Oracle Application Server
Oracle Enterprise Manager Concepts for conceptual details about Oracle Enterprise Manager 10g

Oracle Enterprise Manager 10g Monitoring and Administration Overview

Figure 18-1 provides a high-level overview of how OracleAS Integration B2B is managed.

Figure 18-1 Monitoring and Management with Oracle Enterprise Manager 10g

Description of "Figure 18-1 Monitoring and Management with Oracle Enterprise Manager 10g"

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

The Oracle Enterprise Manager 10g Application Server Control Console is designed to provide local monitoring and administration tasks on an Oracle Application Server Integration B2B 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.

Note:

OracleAS Integration B2B cannot be managed from the Oracle Enterprise Manager 10g Grid Control Console for this release. Only management from the Oracle Enterprise Manager 10g Application Server Control Console is supported.

See Oracle Enterprise Manager Concepts for more information:

OracleAS Integration B2B Management Concepts and Components

This section describes the following OracleAS Integration B2B management concepts and components:

Oracle Application Server Metadata Repository
OracleAS Integration B2B Instance
B2B Server of OracleAS Integration B2B
OC4J Instance of OracleAS Integration B2B

Oracle Application Server Metadata Repository

The Oracle Application Server Metadata Repository contains all the partner data required for an integration. The Oracle Application Server Metadata Repository can be installed either through Oracle Application Server Infrastructure or with the Oracle Application Server Metadata Repository Creation Assistant. Every OracleAS Integration B2B middle-tier instance requires a connection to the Oracle Application Server Metadata Repository to work properly.

See Oracle Application Server Installation Guide for Oracle Application Server Metadata Repository installation concepts.

OracleAS Integration B2B Instance

An OracleAS Integration B2B middle-tier instance is a logical grouping of the B2B server and the Oracle Application Server Containers for J2EE (OC4J) instance. There is one OracleAS Integration B2B middle-tier instance for each Oracle home.

B2B Server of OracleAS Integration B2B

The B2B server is the run-time component of OracleAS Integration B2B. The B2B server processes B2B transactions.

OC4J Instance of OracleAS Integration B2B

The OC4J instance hosts the OracleAS Integration B2B user interface tool used for designing and deploying configurations, generating reports, managing trading partners, and other integration aspects.

See Oracle Application Server Administrator's Guide for details about troubleshooting OC4J instance issues.

Oracle Enterprise Manager 10g Application Server Control Console Tasks

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

Start and stop the B2B server and OC4J instance components running in each OracleAS Integration B2B middle-tier instance.
View the current running status (started or stopped) and memory and CPU usage for the B2B server and OC4J instances running in each Oracle Application Server middle-tier instance.
View and edit OracleAS Integration B2B server properties. The online Help lists all server properties, including detailed descriptions, default values, and allowed ranges.
View OracleAS Integration B2B performance (the number of messages received and number of messages that errored).
Access the OracleAS Integration B2B user interface tool for designing and deploying integrations.
View the OracleAS Integration B2B log files.

See "Managing and Monitoring a Middle-Tier Instance from Oracle Enterprise Manager 10g Application Server Control Console" for more information.

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

Follow these instructions to access OracleAS Integration B2B 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 OracleAS Integration B2B middle-tier instance is installed
- port is the number assigned during OracleAS Integration B2B 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 displayed during installation

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 B2B 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 10g 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:

Description of the illustration oem_homepage.gif

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 B2B for the OracleAS Integration B2B middle-tier instance to monitor and administer from the Oracle Enterprise Manager 10g Application Server Control Console.	"OracleAS Integration B2B Monitoring and Administration Tasks" for an overview of OracleAS Integration B2B tasks you can perform
J2EE Applications link	Select J2EE Applications to view the J2EE applications you have deployed using this instance.	Online Help available with this page
Ports link	Select Ports to view ports assigned to OracleAS Integration B2B and other Oracle Application Server components.	"OracleAS Integration B2B Port Management"
Infrastructure link	Select Infrastructure to review and modify details about this Oracle Application Server instance, including identity management status.	Online Help available with this page

See Oracle Application Server Administrator's Guide for instructions on changing the ias_admin username password.

OracleAS Integration B2B Monitoring and Administration Tasks

Figure 18-2 shows the OracleAS Integration B2B middle-tier instance page that displays after selecting the B2B component from the System Components section in Step 2.

Figure 18-2 OracleAS Integration B2B Middle-Tier Instance Page

Description of "Figure 18-2 OracleAS Integration B2B 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
General section	View an overall status of the B2B server and OC4J instance components on this middle-tier instance. For the overall status to display as Up, both components must be running. Click Start All to start the B2B server and OC4J instance together. Click Stop All to stop the B2B server and OC4J instance together. Click Restart All to restart the B2B server and OC4J instance together.
B2B Server and OC4J Instance sections	View CPU and memory usage details and the time at which each component started. Click Start to start a specific component (either the B2B server or OC4J instance). Each component has its own Start button. Click Stop to stop a specific component (either the B2B server or OC4J instance). Each component has its own Stop button. Click Restart to restart a specific component (either the B2B server or OC4J instance). Each component has its own Restart button.
Logs link (at bottom or top right)	Click to access a page from which you can view OracleAS Integration B2B log files. See "OracleAS Integration B2B Log Files" for more information.
Performance link	Click to access a page from which you can view business message performance. See "OracleAS Integration B2B Middle-Tier Instance Performance" for more information.
Administration link	Click to display a page from which you can access the Server Properties link (to view and edit OracleAS Integration B2B server properties) and the OracleAS Integration B2B user interface tool login page See "OracleAS Integration B2B Middle-Tier Instance Server Properties" for more information.

See Oracle Application Server Administrator's Guide for details about viewing log files and troubleshooting OC4J instance issues.

OracleAS Integration B2B Log Files

Oracle Application Server components such as OracleAS Integration B2B 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 log files for OracleAS Integration B2B.

Ensure that you followed the instructions in "OracleAS Integration B2B Monitoring and Administration Tasks" to access the page for viewing log files.

The View Logs page appears.

Select B2B 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 Oracle Application Server Administrator's Guide and the online Help for details about viewing log files.

OracleAS Integration B2B Middle-Tier Instance Performance

You can view details about performance in a specific OracleAS Integration B2B middle-tier instance, including:

The number of messages received since the B2B server was started
The number of messages that have errored out since the B2B server was started

Figure 18-3 shows the performance page for a specific OracleAS Integration B2B middle-tier instance.

Figure 18-3 OracleAS Integration B2B Middle-Tier Instance Performance Page

Description of "Figure 18-3 OracleAS Integration B2B Middle-Tier Instance Performance Page"

OracleAS Integration B2B Middle-Tier Instance Server Properties

You can edit server property settings for logging levels, security, and trading partner (B2B) properties. These parameters are stored 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-4 shows the page for viewing and editing server properties.

Figure 18-4 Server Properties Page

Description of "Figure 18-4 Server Properties Page"

Note:

If using OracleAS Integration B2B on Windows operating systems, you must update server properties settings in the following order:

Stop the B2B server and OC4J instance of OracleAS Integration B2B.
Make updates to server property settings in the Server Properties page.
Start the B2B server and OC4J instance.

If you do not follow this order, these updates are not applied correctly.

OracleAS Integration B2B Port Management

You can view OracleAS Integration B2B and Oracle Application Server component ports, and change some Oracle Application Server ports. However, it is strongly recommended that you not change OracleAS Integration B2B 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 B2B server and OC4J instance components of OracleAS Integration B2B display 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.

See "Port Changing Error Message" for the type of error message you receive if you attempt to start OracleAS Integration B2B components while another component is using the assigned port.

Starting and Stopping OracleAS Integration B2B Components with OPMN

You can also start and stop the B2B server and OC4J instance components of OracleAS Integration B2B from the operating system command prompt of Oracle_Home/opmn/bin using the Oracle Process Manager and Notification Server (OPMN).

To stop the B2B server and OC4J instance individually:

Enter the following commands at your operating system command prompt to stop the B2B server and OC4J instance.
```
prompt> opmnctl stopproc process-type=B2BServer

prompt> opmnctl stopproc process-type=OC4J_B2B
```

To start the B2B server and OC4J instance individually:

Enter the following commands at your operating system command prompt to start the B2B server and OC4J instance.
```
prompt> opmnctl startproc process-type=B2BServer

prompt> opmnctl startproc process-type=OC4J_B2B
```

To start and stop the B2B server and OC4J instance together:

Enter the following commands at your operating system command prompt to start and stop the B2B server and OC4J instance together.
```
prompt> opmnctl startproc ias-component=B2B

prompt> opmnctl stopproc ias-component=B2B
```

See the following for more information:

Additional Oracle Application Server and OracleAS Integration B2B Management Tasks

Table 18-3 describes additional Oracle Application Server administration tasks that also relate to OracleAS Integration B2B. References to documentation that describes these tasks are also provided.

Table 18-3 Additional Oracle Enterprise Manager 10g Tasks

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

Changing Port Numbers

Oracle Enterprise Manager 10g uses dynamic monitoring services (DMS) ports to gather performance data about Oracle Application Server components. For this release, OracleAS Integration B2B 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 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 the following for more information:

Oracle Application Server Performance Guide for additional details about DMS
"OracleAS Integration B2B Monitoring and Administration Tasks" for instructions on stopping OracleAS Integration B2B processes

Port Changing Error Message

This error message occurs when you attempt to start OracleAS Integration B2B components, while another component is already using the assigned port:

isunrak21(17:45:03):/private/sabburi/m13/opmn/bin % opmnctl startproc process-type=B2BServer
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:
         B2B/B2BServer/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:

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 iasconsole
opmnctl stopall
```
Open the Oracle_Home/opmn/conf/opmn.xml file.

Modify the range attribute of the port element for the corresponding OracleAS Integration B2B component.

<process-type id="B2BServer" module-id="b2bengine" 
working-dir="$ORACLE_HOME/ip" status="enabled">
    <module-data>
       <category id="start-parameters">
          <data id="java-parameters" value="-server -Xms8M -Xmx512M"/>
       </category>
    </module-data>
    <port id="dms" range="8777"/>
    <process-set id="%IASNAME%" numprocs="1"/>
    <start timeout="3600"/>
    <stop timeout="3600"/>
  </process-type>

Open Oracle_Home/sysman/emd/targets.xml.

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

<Target TYPE="oracle_integb2b_engine" 
NAME="as.dhcp-dci-stevens-towers-125-95-159-245.dci.acme.com_B2BServer" 
DISPLAY_NAME="B2BServer" VERSION="3.0">
        <Property NAME="OracleHome" VALUE="D:\OraHome1\as"/>
        <Property NAME="EmptyOracleHome" VALUE=""/>
        <Property NAME="HTTPPort" VALUE="8777"/>
        <Property NAME="HTTPMachine" VALUE="stdevtemp"/>
        <Property NAME="OPMNPort" VALUE="6003"/>
        <Property NAME="OidRepSchemaName" VALUE="B2B"/>
        <AssocTargetInstance ASSOC_TARGET="ias" TYPE="acme_ias" 
NAME="as.dhcp-dci-stevens-towers-125-95-159-245.dci.acme.com"/>
        <CompositeMembership>
            <MemberOf TYPE="oracle_integb2b_instance" 
NAME="as.dhcp-dci-stevens-towers-125-95-159-245.dci.acme.com_B2B_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 Oracle Application Server Administrator's Guide for details about port ranges.

Chapter Summary

This chapter explains how to use Oracle Enterprise Manager 10g to manage OracleAS Integration B2B (for example, starting and stopping the B2B server or OC4J instance components, viewing log files, and editing server properties). For this initial release, OracleAS Integration B2B can only be managed from the Oracle Enterprise Manager 10g Application Server Control Console. Oracle Enterprise Manager 10g Grid Control Console management of OracleAS Integration B2B is not supported.