Skip Headers
Oracle® Retail Integration Bus Operations Guide
Release 13.2
Next
Contents
Title and Copyright Information
Preface
Audience
Related Documents
Customer Support
Review Patch Documentation
Oracle Retail Documentation on the Oracle Technology Network
Conventions
1
Introduction
Oracle WebLogic 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
setup-security-credential
Hot Fix Installation Reports
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 Deployment Configuration File Editor
Important Installation Warning
Key Rule
Editor Usage
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
retail_service_config_info_ribserver.xml
remote_service_locator_info_ribserver.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
Integration Gateway Services (IGS) Testing
Using the soapUI Tool and the IGS Test Suite
Download soapUI
Import IGS
Execute IGS Test Cases
5
RIB and JMX
RIB JMX Client
User Interface
Third Party JMX Client Example
6
Admin GUI
RIB Admin URLs
RIB Admin GUI
RIB Functional Artifacts
RIB Message Flows
RIB Payloads (xsds)
RIB Admin GUI Home
Adapter Manager
Adapter Manager Screen
Log Viewer
Log Manager
RIB Logs
7
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 Application Server and JDBC Connections
RIB 13.2 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
8
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
9
Diagnostic and Monitoring Tools
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
WLS/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 installation is correct?"
"How do I know if the local WLS 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 WLS instance?"
"How do I know the subscriber for a particular JMS topic?"
10
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
Areas of Responsibility
RIB Application Administrator
Technology Background
Experience or Training on
Areas of Responsibility:
Hospital Monitoring and Maintenance
11
Testing the RIB
RIB Test Harness
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
Java EE Application API Stubs
Architecture and Design
Installation and Setup
Prerequisite Tasks
Installation
Configuration of the rib-<app> to use Injection Stubs
12
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
Adding Multi-Channels to a Message Family
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