Skip Headers
Oracle® Retail Integration Bus Release Notes
Release 13.2


Oracle® Retail Integration Bus

Release Notes

Release 13.2


January 2011

This document highlights the major changes for Release 13.2 of Oracle Retail Integration Bus.

Product Overview

Oracle Retail Integration Bus (RIB) provides application integration message processing for the retail application suite. RIB is comprised of a set of adaptors and messages that allow an enterprise to integrate both Oracle Retail and third-party applications together in a scalable and supportable fashion.

The components built on the Oracle Fusion Middleware platform to create the Oracle Retail Integration Bus include the following:

Release Overview

Oracle Retail Integration Bus Release 13.2 is major release follow-up to the RIB 13.1 release, with enhancements to the core Oracle Retail Integration Bus and roll-up of defect fixes since RIB 13.1. The enhancements include the following:

The RIB 13.2 release includes numerous functional and technical changes; The following Oracle Retail applications participate in enterprise functional integration using RIB:

Hardware and Software Requirements

See the Oracle Retail Integration Bus Installation Guide for information about the following:

Functional Enhancements

Oracle Retail Integration Bus Release 13.2 introduces the following functional enhancements.

Localization Enhancements

Localization enhancements were added to the RIB kernel and extensions/placeholders in the RIB payloads to take advantage of locale-specific customizations. These localization enhancements are for use only by Oracle Retail and its partners; they are not for use by customers.

The approach implements a single localization hook per predefined business object complex type. There are placeholders for localization teams to add implementations as needed.

Each region has a placeholder for localizations. Localization teams or partners can add new regions and localizations as needed between releases. This approach allows base releases to be independent of localization branches, but a localization can be added easily to the base, following the same pattern introduced for customization and extension in RIB 13.1.

This approach permits the forward port of a regional localization to a new base release at a customer site to be as simple as a file save and restore.

The delivery of localizations will be from a code branch as a localization pack, never as a base. The only aspect of localizations in a base will be the placeholders.

For more information, see:

Support for Multiple Java Message Services

The RIB Integration Gateway Services support multiple Java Message Services (JMS). See the Oracle Retail Integration Bus Implementation Guide for more information.

Payload Changes

Payload changes have been made to take advantage of new integration points between specific Oracle Retail applications. See the Oracle Retail Integration Bus Integration Guide, and documentation for individual applications, for new integrations for this release.

Technical Enhancements

The following technical enhancements are included in Oracle Retail Integration Bus Release 13.2.

Oracle Exadata Database Machine X2 Support

Oracle Exadata Database Machine X2 is a combination of smart software and industry-standard hardware. It provides database-aware storage services, such as the ability to offload database processing from the database server to storage, transparently, without affecting SQL processing and your database applications.

RIB Release 13.2 is supported on Oracle Exadata Database Machine X2 through the binary compatibility with Oracle Linux Release 5 Update 3 and Oracle Database 11g Release 2 Enterprise Edition on Oracle Real Application Clusters (RAC) 11g.

Oracle WebLogic Server 11g (Java 6)

For Release 13.2, Oracle Retail Integration Bus and the Oracle Retail merchandising operations management product suite use Oracle WebLogic Server 11g, which replaces Oracle Application Server used in previous releases. Oracle WebLogic Server 11g is the industry's most comprehensive, standards-based platform for developing, deploying, and integrating enterprise applications. It provides the foundation for an application grid, an architecture that enables enterprises to pool and share resources with dynamic adjustment across multiple applications, to lower operational costs.

Security Enhancements

RIB 13.2 uses the Oracle Credential Store Framework (CSF) to store and retrieve passwords from a wallet (cwallet.sso) secure credential store. For more information see the Oracle Retail Integration Bus Installation Guide and Oracle Retail Integration Bus Operations Guide.

New RIB Hospital Administration Application

The RIB Hospital Administration (RIHA) application has been rewritten for the RIB 13.2 release. The application is now a Web-based thin-client application accessed through a browser. RIB Hospital Administration 13.2 was written using Oracle Application Development Framework (ADF) 11g.

For more information, see the Oracle Retail Integration Bus Hospital Administration User Guide.

Integration Enhancements

New RIB Pac RIBforRFM (Brazilian Localization)

RIB is used to integrate the Oracle Retail Fiscal Management (ORFM) to the other Oracle Retail 13.2 applications. Because ORFM is specific to Brazil localization support, RIBForRFM is an optional installation.

Known Issues

The following are known issues for Oracle Retail Integration Bus Release 13.2.

Defect 9523067 - Ability to Control Initial States of MDBs

RIB uses configuration files to control the startup state of RIB adapters. Message-driven beans (MDB) are used for subscribing adapters and TAFRs. This functionality has been in place for all releases of RIB to this point. Oracle WebLogic Server does not provide the ability to configure an initial state, or to read the configuration file in time to prevent an adapter from starting to process messages.


This is an open bug. The issue will be faced whenever a RIB application is started. Whether desired or not, all adapters will begin processing messages from the Java Message Service (JMS) until they are shut down by the RIB management controls.

These are the major impact scenarios:

To mitigate problems, try to ensure that RIB application restarts are not performed when messages are queued to the JMS on message flows that cannot be manually shut down in time to prevent conflicts.

Poison Messages

When an adapter receives a poison message (a message that cannot be consumed under any conditions and that is rolled back continuously), it could take up to one minute for the adapter to shut down.

Installation with AIX - Java Version 1.6.0 64-Bit

When installing RIB Release 13.2 on the AIX platform, the specific Java version required is 1.6.0 64-bit.

Error During rib-app-builder Deployment Process

When running the rib-app-builder deployment process, you may encounter the following error while encrypting the password:

face java.lang.StringIndexOutOfBoundsException: String index out of range: -9

This error may occur because of a slow network connection to the Oracle WebLogic Server where the rib-app is being deployed. Retrying the deployment might fix the issue.

Known Issues for RIB Hospital Administration (RIHA) 13.2

The following are known issues for the RIB Hospital Administration application:

Related Documentation

For more information, see the following documents in the Oracle Retail Integration Bus Release 13.2 documentation set:

Also see the following integration documents provided with the RIB 13.2 release:

Supplemental Documentation

The following documents are available through My Oracle Support. Access My Oracle Support at the following URL:

Oracle Retail Integration Bus Integration Guide (ID 1277421.1)

The RIB Integration Guide is an HTML document that summarizes the Oracle Retail messaging integration by functional area. Each functional area (or message family) includes the publishing and subscribing application's components, message documents, and TAFR operations (if applicable).

Oracle Retail Upgrade Guide 13.1 to 13.2 (ID 1073414.1)

Because the upgrade process varies among Oracle Retail applications, the Oracle Retail Upgrade Guide describes the approach that each Oracle Retail application takes for the upgrading, or uptaking, process, as well as product-specific upgrade assumptions and considerations. Actual procedures for the upgrade may be included in the application's Installation Guide.

Oracle® Retail Integration Bus Release Notes, Release 13.2

Copyright © 2011, Oracle and/or its affiliates. All rights reserved.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this software or related documentation is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

This software is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications which may create a risk of personal injury. If you use this software in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure the safe use of this software. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software in dangerous applications.

Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

This software and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.

Value-Added Reseller (VAR) Language

Oracle Retail VAR Applications

The following restrictions and provisions only apply to the programs referred to in this section and licensed to you. You acknowledge that the programs may contain third party software (VAR applications) licensed to Oracle. Depending upon your product and its version number, the VAR applications may include:

(i) the MicroStrategy Components developed and licensed by MicroStrategy Services Corporation (MicroStrategy) of McLean, Virginia to Oracle and imbedded in the MicroStrategy for Oracle Retail Data Warehouse and MicroStrategy for Oracle Retail Planning & Optimization applications.

(ii) the Wavelink component developed and licensed by Wavelink Corporation (Wavelink) of Kirkland, Washington, to Oracle and imbedded in Oracle Retail Mobile Store Inventory Management.

(iii) the software component known as Access Via™ licensed by Access Via of Seattle, Washington, and imbedded in Oracle Retail Signs and Oracle Retail Labels and Tags.

(iv) the software component known as Adobe Flex™ licensed by Adobe Systems Incorporated of San Jose, California, and imbedded in Oracle Retail Promotion Planning & Optimization application.

You acknowledge and confirm that Oracle grants you use of only the object code of the VAR Applications. Oracle will not deliver source code to the VAR Applications to you. Notwithstanding any other term or condition of the agreement and this ordering document, you shall not cause or permit alteration of any VAR Applications. For purposes of this section, "alteration" refers to all alterations, translations, upgrades, enhancements, customizations or modifications of all or any portion of the VAR Applications including all reconfigurations, reassembly or reverse assembly, re-engineering or reverse engineering and recompilations or reverse compilations of the VAR Applications or any derivatives of the VAR Applications. You acknowledge that it shall be a breach of the agreement to utilize the relationship, and/or confidential information of the VAR Applications for purposes of competitive discovery.

The VAR Applications contain trade secrets of Oracle and Oracle's licensors and Customer shall not attempt, cause, or permit the alteration, decompilation, reverse engineering, disassembly or other reduction of the VAR Applications to a human perceivable form. Oracle reserves the right to replace, with functional equivalent software, any of the VAR Applications in future releases of the applicable program.