Skip Headers
Oracle® Retail Integration Bus Operations Guide
Release 13.0.3
Next
Contents
List of Figures
Title and Copyright Information
Preface
1
Introduction
Oracle Application Server
Oracle Retail RIB Supplied Components
2
Application Builder
RIB Application Builder Directory Structure
Directory Structure and Key Files
RIB App Builder Tools
Logging
Backup and Archive of Key Files
rib-app-compiler
rib-app-deployer
Check-version-and-unpack
check-version-and-apply-defect-fix
inventory-management
rib-adapter-controller
Start Flow
Stop Flow
List Flow
Start Adapters By Type
Stop Adapters by Type
Start Adapter
Stop Adapter
Test Durable Subscriber for Adapter
Test Durable Subscriber for RIB App
List RIB App Adapters
RIB Artifacts Generator Tools
RIB Functional Artifacts
RIB XML Schemas
RIB Castor Java Payloads
RIB JAXB Java Beans
RIB Objects (Oracle Objects)
Sample RIB XML Files
Installation
Prerequisites
Installation and Setup
Usage
Directories and Outputs
Commands
General Usage Example: Modify Existing XSD
Hot Fix Installation Reports
Sample: file-change-history-report
Sample: defect-fix-detail-<defect-fix-id>
3
Backend System Administration and Logging
rib-<app>-adapters.xml
<subscribers> element
<publisher> element
<timer-driven>
<hospital> element
rib-<app>-adapters-resource.properties
rib-<app>-plsql-api.xml
rib-<app>.properties
rib-system.properties
rib-integration-flows.xml
rib-deployment-env-info.xml
app-in-scope-for-integration
rib-jms-server
rib-application-server
rib-javaee-containers
rib-applications
commons-logging.properties
log4j.xml
rib-app-builder-paths.properties
rib-application-assembly-info.xml
RIB Logging
Log Level Recommendations
Changing Logging Levels
RIB Administration GUI
log4j.xml Configuration File
Adapter Logging (RIBLOGS)
RIB Timing Logs
RIB Audit Logs
Other RIB Management Logs
deploy.rib.log
management.rib.log
global.rib.log
4
RIB and JMX
Overview
RIB JMX Client
User Interface
Third Party JMX Client Example
5
Admin GUI
RIB Admin URLs
RIB Admin GUI
RIB Functional Artifacts
RIB Message Flows
RIB Payloads (xsds)
RIB Admin GUI Home
Home Screen
Adapter Manager
Adapter Manager Screen
Log Viewer
Log Manager
Log Manager Screen
RIB Logs
RIB Logs Screen
6
JMS Provider Management
The RIB on AQ JMS
Queue Monitor Process Setup
Optimizing Enqueue/Dequeue Performance
Sizing Considerations
The RIB on AQ JMS - Server Side Processes
Types of Oracle Database Side Processes
The RIB and OAS and JDBC Connections
RIB Connections - Summary
rib-rms Connections
rib-rwms Connections
rib-sim Connections
rib-tafr Connections
rib-rpm Connections
Configuration Recommendations
Support for Multiple JMS Servers Within a Single Deployment
Design
rib-app-builder Validation Checks
How to Set Up Multiple JMS Servers
Process Overview
General Recommendations
AQ Recommendation
Sample Configuration
rib-integration-flows.xml
rib-deployment-env-info.xml
RIB-RMS Application Configuration
rib-rms-adapters.xml changes
rib-rms-adapters-resources.properties
RIB-TAFR Application Configuration
rib-tafr-adapters.xml
rib-tafr-adapters-resources.properties
RIB-SIM Application Configuration
rib-sim-adapters.xml
rib-sim-adapters-resources.properties
RIB-RWMS Application Configuration
rib-rwms-adapters.xml
rib-rwms-adapters-resources.properties
Compile and Deploy
RIB-ADMIN-GUI
7
Message Transform, Filtering and Routing (TAFR)
TAFR Adapter Process
Configuration
Transformation
Filtering Configuration
Routing
Configuration Example - Facility ID
Single RWMS Configuration
Configuration Process
Two RWMS Configuration
Description
Configuration Process
8
Diagnostic and Monitoring Tools
Overview
Functionality
RDMT and User Roles and Responsibilities
Local or Remote Installations and Capabilities
RDMT Support jars
Sample XML Messages
Tools Overview
RDMT as an Application
SCRIPTDIR
Setup
Current Configuration
RDMTLOGS
RDMT RAC Support
RDMT Main Menu
OC4J/JMX Utilities
JMS Tools
PUB/SUB Msg Tools
RIB Health Tools
Hospital Scan Tools
RIB Admin Tools
RIB App Builder Tools
Scan RIB Logs / Scan RIB Logs (Delta)
RIB Health
RIB Configuration Report
RIB Timings Utility
JMS Publish Utility
EJB Publish Utility
TAFR Msg Utility
EJB Ping (RIB)
EJB Ping (APP)
Tool Usage Examples
"How do I know if the RIB install is correct?"
"How do I know if the local OC4J is running or not?"
"How do I know where my issue is occurring?"
"How do I know if the adapter's status is up or down?"
"How can I config/switch for a new OC4J instance?"
"How do I know if the configured OC4J instance is running?"
"How do I know the subscriber for a particular JMS topic?"
9
The RIB in Operation
Operational Considerations
Alerts and Notifications
RIB Log File Monitoring
Log File Archive and Purge
Hospital Size and Growth
RMS MFQ and RWMS UPLOAD Tables Sizes
Remote RWMS
RIB Components Start and Stop
RIB Operation Support Staff Requirements
RIB Components - Source Code Control
RIB HA Requirements
RIB Disaster Recovery
RIB Admin Roles and Security
RIB Operation Support Staff Requirements
RIB System Administrator
Technology Background
Experience or Training on
Areas of Responsibilities:
RIB Application Administrator
Technology Background
Experience or Training on
Areas of Responsibilities:
Hospital Monitoring and Maintenance
10
Testing the RIB
RIB Test Harness
Overview
Master Checklist
PL/SQL Application API Stubs
Architecture and Design
The Common Subsystem
The Thin API layer
The Stub Admin and Setup Functions
Configuration Files
Installation and Setup
Prerequisite Tasks
Installation
Configure_api
Prerequisites
JavaEE Application API Stubs
Architecture and Design
Installation and Setup
Prerequisite Tasks
Installation
Configuration of the rib-<app> to use Injection Stubs
11
Performance Considerations
Performance Factors
Performance Requirements
Multi-Channel
End-to-End Timing
How to Calculate Average Message Size
Purchase Order Example
Understand the Message Family
RIB Timing Log Analysis
Purchase Order Example
Key Interfaces to Consider
ASN (Inbound/Outbound)
Receipts
Stock Order (Allocations & Transfers)
How to Approach a RIB Performance Test
Multi-Channel Adapters
Logical Channels and threadValue
Algorithm Used to Calculate Channel
How to Configure a Multi-Channel Flow
Generalized Process
Example
RIB-RMS
RIB-TAFR
RIB-SIM
RIB-RWMS
Edit the RIB_SETTINGS table
Compile and Deploy
Message Aggregation
How to Configure Message Aggregate
Aggregation Example
Multiple Hospital Retry
Family Specific Hospital Retry Adapters
How Family Specific Hospital Retry Works
How to Configure a Family Specific Retry Adapter