25 Oracle Enterprise Repository

The chapter describes the new and changed functionality in Oracle Enterprise Repository 11g Release 1 (11.1.1).

Note:

The issues and workarounds listed here are those that were known at the time of the product's initial release to the public. Additional issues and workarounds may have been discovered since the initial release. To view the latest known issues associated with Oracle SOA Suite, BPM Suite, and related SOA technologies, go to the Oracle Technology Network (OTN) at

http://www.oracle.com/technetwork/middleware/docs/aiasoarelnotes-196861.html

This chapter contains the following sections:

25.1 What's New in Oracle Enterprise Repository 11g Release 1 (11.1.1)

This section describes the new features and functionalities in Oracle Enterprise Repository 11g Release 1 (11.1.1):

Support for Integration with SAP

You can now manage SAP asssets as part of your overall enterprise service portfolio. Oracle Enterprise Repository harvests services that are published to the SAP UDDI v3.0 Registry. These services can be subsequently consumed through Oracle JDeveloper, Eclipse, or VS .Net.

Support for BPMN and BPEL 2.0

Oracle Enterprise Repository has enhanced the harvesting of BPM assets. Oracle Enterprise Repository now captures the complete BPM metamodel, including BPMN and BPEL 2.0.

Publishing SOA Web Services to UDDI

Oracle Enterprise Repository is now able to govern additional services managed by Oracle Enterprise Manager (OEM) Fusion Middleware Control using the Oracle Enterprise Repository Exchange Utility. OEM Fusion Middleware Control publishes these services to Oracle Service Registry (OSR) using the UDDI standard and the Oracle Enterprise Repository Exchange Utility is used to bring the services into Oracle Enterprise Repository.

In Oracle Enterprise Manager (OEM) Fusion Middleware Control, the Publishing SOA Web Services to UDDI feature is available in the Services tab of the Services and References page of SOAInfra target.

Harvesting Deployed Composites from Oracle JDeveloper

You can harvest a deployed service from the JDeveloper SOA connection browse tree, or the SOA Composite Navigator.

Oracle Enterprise Repository also supports Converged Application Repository (CAR) tools that are provided in other products to include enterprise application content in Oracle Enterprise Repository. This procedure includes loading Solution Packs into the repository and running the CAR harvester to obtain endpoints for your application services.

Running Harvester in Preview Mode

You can now see all of the assets that will be created in Oracle Enterprise Repository before the harvest is committed.

Upgrading to Oracle Enterprise Repository 11g

It is recommended to migrate from your custom service model to the Oracle provided SOA service model in 11g Relase 1(11.1.1). Migrating to the Oracle provided service model enables you to leverage new functionality in 11g such as the harvester, JDeveloper integration, and so on. Migrating to the Oracle Enterprise Repository 11g SOA asset model also makes it easier to migrate to future releases of the product.

Note:

Ensure you contact support in advance if you are planning to upgrade from Oracle Enterprise Repository 10g or earlier releases to Oracle Enterprise Repository 11g.

25.2 General Issues and Workarounds

This section describes the general issues and workarounds in Oracle Enterprise Repository 11g Release 1 (11.1.1). It includes the following topics:

25.2.1 Oracle Enterprise Repository

This section describes the general issues and workarounds found in Oracle Enterprise Repository:

25.2.1.1 Modifiying Projects with Multiple Users Assigned

In Oracle Enterprise Repository, the projects that have more than hundreds of users assigned to them take a lot of time to save, whenever the project was modified. This is resolved in Oracle Enterprise Repository 11g Release 1 (11.1.1).

25.2.2 Asset Editor

This section describes the issues and workarounds found in Oracle Enterprise Repository Asset Editor:

25.2.2.1 Navigator Displays Incorrect Details

When you launch the Navigator from the Asset detail, a relationship to the consuming project is also displayed, even if that asset has been rejected. This is resolved in Oracle Enterprise Repository 11g Release 1 (11.1.1).

25.2.2.2 Automatic Login in Navigator

The Navigator has a separate login than the Oracle Enterprise Repository Web tool. Prior to PS3, the Navigator would take the login information from cookies for the automatic login, which occurs when it is launched. This caused issues when cookies were turned off or if the Weblogic Server had the following setting set to false:

enterprise.security.cookielogin.allow

This has been resolved by not relying on cookies to pass the user information.

25.2.3 Harvester

This section describes the issues and workarounds found in Oracle Enterprise Repository Harvester:

25.2.3.1 Creating an Asset Type Without Harvester Solution Pack

Oracle Enterprise Repository throws an exception when you attempt to create a new Type in the Type Manager using Endpoint as the Type for Defaults. This only occurs when the Harvester Solution Pack is not installed. This is resolved in Oracle Enterprise Repository 11g Release 1 (11.1.1).

25.2.3.2 Invalid Characters in the Harvester Credentials

There was an issue in the password utility when harvesting a composite from the SOA server. If the SOA Server's credentials had a "#" sign in the password, then the harvester failed. This is resolved in Oracle Enterprise Repository 11g Release 1 (11.1.1).

25.2.3.3 Running Harvester and Exchange Utility on the Same Computer

There is a scenario in which a WSDL URL will resolve differently if harvested from one computer and published to Oracle Service Registry from a different computer. To correct this issue, run Exchange Utility and Harvester on the same computer. As an alternative, the Harvester and Exchange Utility may be run on seperate computers, but you must ensure that both resolve to the same WSDL URL.

25.2.3.4 Connecting to Oracle Enterprise Repository Fails

In the Eclipse plugin, when an Oracle Service Bus project is harvested and you attempt to launch the Oracle Enterprise Repository Access view, then the Oracle Enterprise Repository connections fails. The Oracle Enterprise Repository connection also fails if you do the reverse of it. That is, if you first launch the Oracle Enterprise Repository Access view and then browse for Oracle Enterprise Repository, then also the Oracle Service Bus harvesting fails.

The workaround for this is to restart Eclipse and then reconnect to Oracle Enterprise Repository.

25.2.3.5 Harvesting from Linux Shell Fails to Harvest

When you run Harvester from the Linux Shell prompt, the Harvest fails with a "No Match" error, as follows:

$ ./harvest.sh -file
./harvest.sh: No Match
$

This is a known issue.

Note:

The above command runs successfully in Windows as well as in the bash prompt.

Workaround

You must run the harvester script as follows:

./harvester -file "<URL>"

where URL represents the URL from where you run the the harvester. Also, note that the URL must be specified within the double quotes, for the harvester to run successfully.

25.2.3.6 Consuming SAP Services in Oracle JDeveloper

While consuming the SAP services in Oracle JDeveloper from Oracle Enterprise Repository, launch JDeveloper with the following option from the command line:

jdev .exe -J"-Dsoa.enable.wsdl.authentication=true"

This is to ensure that SAP WSDLs that are authentication-enabled are consumed properly into JDeveloper, else the WSDL would not be authenticated and downloadable in JDeveloper.

25.2.3.7 Using of Harvester - Known Issue

In some circumstances, the harvester prioritizes WSDL-harvested information over the user-supplied metadata. This is specific to the Description and Service Type fields when harvesting assets of the Service Type provided with Oracle Enterprise Repository. You can avoid this by moving the user-supplied metadata to the other fields on Service assets prior to harvesting.

Note:

To address this known issue in harvester, contact Oracle support for a patch.

25.2.4 Exchange Utility

This section describes the issues and workarounds that are found in Oracle Enterprise Repository Exchange Utility(XU):

25.2.4.1 Exchange Utility Truncates the Asset Name

When a wsdl is harvested with the namespace that is too long, Exchange Utility truncates the full asset name and the asset will not be published properly. This is resolved in Oracle Enterprise Repository 11g Release 1 (11.1.1).

25.3 Enhancements in Oracle Enterprise Repository

This section describes the enhancements in Oracle Enterprise Repository 11g Release 1 (11.1.1):

Harvester

Harvester includes the following enhnacements for 11g Release 1 (11.1.1):

  • Preview Mode feature

  • BPMN/BPEL 2.0 Introspection

  • Harvester core supports passing in keywords.

Exchange Utility

Exchange Utility includes the following enhnacements for 11g Release 1 (11.1.1):

  • Including policy information when receiving services

  • Support for integration with SAP

25.4 Deprecated Features

This section describes the deprecated features in Oracle Enterprise Repository 11g Release 1 (11.1.1):

Deprecation of System Settings

Several system settings are deprecated and should have no impact if changed. However, it is recommended not to change these in a production environment. For example, Database Connection Name, Company Name, and so on.

Deprecation of REX APIs

The APIs in Repository Extensibility Framework (REX) are deprecated, and will be replaced in a major future release, however, you can still continue to use REX APIs in 11g Release 1 (11.1.1) and in other minor releases of Oracle Enterprise Repository 11g.

The next major release of Oracle Enterprise Repository, which is 12g, is planned to include significant modifications to the current APIs in REX in order to align with standards, and improve ease of use and integration.