Contents

Title and Copyright Information

Send Us Your Comments

Preface

• Audience
• Related Documents
• Customer Support
• Review Patch Documentation
• Oracle Retail Documentation on the Oracle Technology Network
• Conventions
• Third-Party Open-Source Applications

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

• 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
    • 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