Skip Headers
Oracle® Application Server Release Notes
10g Release 2 (10.1.2) for Microsoft Windows
B15501-23
  Go To Documentation Library
Home
Go To Product List
Solution Area
Go To Table Of Contents
Contents

Previous
Previous
 
Next
Next
 

17 Oracle Application Server Integration B2B

This chapter describes issues associated with Oracle Application Server Integration B2B (OracleAS Integration B2B). It includes the following topics:

17.1 General Issues and Workarounds

This section describes general issues and workarounds. It includes the following topics:

17.1.1 Redeployment Issue

If you see that redeployment does not reflect your design-time data changes (for example, a change in the XPath expression is not recognized), restart the B2B server as follows:

opmnctl restartproc process-type=B2BServer

17.1.2 Purging Removes Instance Data

Purging a retired configuration removes the associated run-time data. Oracle recommends that you do a database archive of run-time data before purging.

17.1.3 Self-service API for Creating Trading Partners and Agreements

Only creating trading partners and agreements is supported, not updating or deleting. Also, RosettaNet collaborations are not supported in this API.

17.1.4 Oracle Application Server Clustering and Integration B2B

Oracle Application Server Integration B2B cannot be installed on a clustered application server middle-tier environment. Also, after you install Oracle Application Server Integration B2B on a middle tier, you cannot add it as a node on a cluster.

17.1.5 B2B User Login Must Have a Role

Logging in as the b2b user, without first assigning a role to the b2b user, produces a blank page. You must first log in as admin and assign a role to the b2b user. Then the b2b user can log in, with functionality based on the assigned role.

17.1.6 Cannot Update the admin User Password

You cannot update the password for the predefined admin user. Instead, create a new user and assign it the Administrator role. You can update the password for this new user.

17.1.7 OracleAS Integration B2B Pages in Oracle Enterprise Manager

If you are using OracleAS Integration B2B in a non-English language, note that parts of some OracleAS Integration B2B pages in Oracle Enterprise Manager 10g Application Server Control appear only in English.

17.1.8 Configuring OracleAS Integration B2B in Enterprise Environments

In a typical Oracle Application Server environment, the Oracle Application Server middle tier with its installations of J2EE and Web Cache and OracleAS Integration B2B communicates with the OracleAS Infrastructure tier and its installation of the OracleAS Metadata Repository.

You can also configure OracleAS Integration B2B to run in enterprise environments. Enterprise environments are slightly different than the typical Oracle Application Server environment in that they include an additional middle tier known as a web tier that is installed and configured outside your corporate network. The web tier includes the J2EE and Web Cache install type. However, there is no installation of OracleAS Integration B2B and no applications are deployed on the web tier. The web tier is used only to exchange HTTP requests (through the Oracle HTTP Server) with the Oracle Application Server middle tier (and its installations of J2EE and Web Cache and OracleAS Integration B2B). The Oracle Application Server middle tier, in turn, communicates with the OracleAS Infrastructure tier and its installation of the OracleAS Metadata Repository.

To use OracleAS Integration B2B in enterprise environments with a web tier, you must perform the following configuration tasks:

On the Oracle Application Server middle tier (with its installations of J2EE and Web Cache and OracleAS Integration B2B):

  1. Go to the ORACLE_HOME/opmn/conf directory.

  2. Use a text editor to open opmn.xml.

  3. Find the entry for OC4J_B2B.

  4. Change the range of AJP Ports from 3301-3400 to 3301-3301.

    This enables OC4J_B2B to run on just one AJP port.

  5. Save your changes.

On the web tier (with its installation of only J2EE and Web Cache):

  1. Go to the ORACLE_HOME/Apache/Apache/conf directory.

  2. Use a text editor to open mod_oc4j.conf.

  3. Add the following entries near the end of the file, but before the </IfModule> line. These entries enable AJP routing to communicate with the configured OC4J_B2B:

    Oc4jMount /b2b ajp13://hostname:ajpport
    Oc4jMount /b2b/* ajp13://hostname:ajpport
    

    where:

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

    • ajpport is the AJP port range that you configured on the Oracle Application Server middle tier

  4. Save your changes.


See Also:

Oracle Application Server Integration B2B Installation Guide for additional instructions on configuring a web tier (and its Oracle HTTP Server) outside your corporate network

17.2 Documentation Errata

This section describes known errors in the documentation. It includes the following topics:

17.2.1 User's Guide Documentation

This section describes corrections and clarifications to Oracle Application Server Integration B2B User's Guide, 10g Release 2 (10.1.2.0.2), part number B19370-01.

Chapter: 3, "Supported Protocols" (supp_protos.htm)

Heading: "Document Protocols"

Page: online version

The first paragraph in this section should read as follows:

The document protocol defines the document type of the message payload. Business protocols can have multiple document protocols. Document protocols follow the hierarchy shown in Figure 3-1.

Chapter: 11, "Managing Callouts" (callouts.htm)

Heading: "Tutorial: Adding Callout Usages to the RosettaNet over the Internet Transaction"

Page: 11-16 and online version

The first paragraph in this section should read as follows:

This tutorial assumes you have completed the tutorial described in "Tutorial 1: Setting Up a RosettaNet over the Internet Transaction."

Chapter: 11, "Managing Callouts" (callouts.htm)

Heading: "Tutorial: Adding Callout Usages to the RosettaNet over the Internet Transaction"

Page: 11-17 and online version

This procedure has a missing step without which the tutorial does not work.For the sending party server (Acme in the example), the remote trading partner (GlobalChips in the example) must have a Trading Partner Identifier - EDI Location Code set as PARTY_SITE_ID (3101 - as in the example) in the enqueued message on the ECXMSG queue. This does not have to be selected in the agreement; however, it must be set for the remote trading partner. Without the preceding Trading Partner Identifier, the enqueued OAG PO message cannot find the to-party information.

17.2.2 Installation Documentation

This section describes corrections and clarifications to Oracle Application Server Integration B2B Installation Guide, 10g Release 2 (10.1.2), part number B25761-01.

The Oracle Application Server Integration B2B Installation Guide, in a Note under Section 3.2.1 Beginning the Installation, states the following:

OracleAS Integration B2B cannot be installed on a node which is part of an OracleAS Middle Tier cluster. Additionally, nodes with individual installations of OracleAS Integration B2B may not be clustered.

It is important to clarify that, while you cannot cluster the B2B server itself, you can use Distributed Configuration Management (dcm) to keep your B2B servlet configuration equal across multiple instances.

Note the distinction between servlet and server in this regard: in 10g Release2 10.1.2, OracleAS Integration B2B runs outside the Oracle Containers for Java (OC4J) container as a separate Java application; it is not dcm-enabled. But OracleAS Integration B2B does deploy a servlet in the OC4J container which takes care of B2B's inbound http transport. Only this servlet can utilize OC4J clustering. As stated in the installation guide, the main B2B engine cannot be part of the cluster.