Contents

Title and Copyright Information

Preface

• Audience
• Related Documents
• Accessing Oracle Communications Documentation
• Documentation Accessibility
• Document Revision History

1 OSM Production Installation Overview

• Overview of OSM Installed Components
• Overview of the OSM Production Installation Procedure
• Installation Options
• Ensuring a Successful OSM Installation
• Directory Placeholders Used in This Guide

2 OSM System Requirements

• Software Requirements
  • About Critical Patch Updates
  • Oracle Application Integration Architecture for Communications Alignment
  • Design Studio Installation and Version Compatibility
  • Oracle VM Support
• Information Requirements
  • Oracle Database Information
  • WebLogic Server Information
  • OSM Server Information

3 Planning Your OSM Production Installation

• Overview of Planning Your OSM Production Installation
  • Types of Systems
  • High Availability Architecture
  • Initial Sizing Based on Order Complexity and Performance Needs
  • Planning the Solution Architecture, System Deployment, and Maintenance
• Planning the Physical Architecture
  • OSM COM Hardware Sizing Guidelines for RODOD Orders
    • Sizing Guidelines for Simple RODOD COM Orders
    • Sizing Guidelines for Complex RODOD COM Orders
  • OSM SOM Hardware Sizing Guidelines for RSDOD Orders
  • Simple Order Hardware Sizing Guidelines (Non-RODOD or -RSDOD)
• General Hardware Sizing and Configuration Recommendations
  • OSM Installer and Application Server System Sizing
  • Application Server Hardware Sizing
    • Running Multiple WebLogic Servers on the Same System
  • Shared Storage for the WebLogic Server
  • Database Hardware Sizing
  • Shared Storage for the Database
  • RAID Recommendations for the Database
  • Understanding Order Affinity
    • About Order Affinity and Ownership in an OSM WebLogic Cluster
    • About Load Balancing for OSM and Order Affinity
    • About the Performance Differences Between JMS and HTTP or HTTPS
    • About Order Affinity and Ownership in an Oracle RAC Database
• Planning the Network Infrastructure
  • Planning Network IP Addresses
  • Planning Bi-Directional Network and Firewall Access
  • Network Latency Between WebLogic Server and the Database
  • Network Latency and NFS Configuration for WebLogic Server Shared Storage
• Operating System Planning
  • Installing OSM on Unix, Linux, or Windows System
• Database Planning
  • Oracle RAC Database Active-Active Deployments
  • Database Partitioning
  • Database Failover with Oracle RAC
  • Listener Considerations for Oracle RAC
    • Remote Listener Considerations
    • Local Listener Considerations
• WebLogic Server Planning
  • Understanding the WebLogic Cluster Configuration
    • About Cluster Domain Management
    • About the WebLogic Messaging Mode and OSM Cluster Size
    • About Coherence and Unicast
  • Understanding the Administration Server
  • Understanding Node Manager Configuration
  • Understanding JMS Messaging
    • JMS Distributed Destinations
    • About WebLogic Server JMS T3 and T3S Load Balancing
    • About JMS Load Balancing Schema Options
  • Understanding Whole Server Migration for High Availability
    • Managing WebLogic Transactions
    • Persistent Store: JMS File Store and JDBC Store
  • Understanding Hardware or Software HTTP and HTTPS Load Balancing Options
    • About HTTP and HTTPS Load Balancing and Session ID Configuration
  • About Oracle Coherence

4 Installing and Configuring the Oracle RAC Database

• Database Information You Should Record
• Creating the Oracle Database for OSM
  • Setting Up the Database and Clusterware for Oracle RAC
  • Memory Settings for the OSM Database
  • Character Sets
  • Database Parameters
  • Configuring Time Zone Settings in the Database
  • Preventing Stuck Orders Due to Inactive Database Sessions
• Tablespace and Schema Considerations for OSM Production Systems
  • Sizing the OSM Database Schemas
  • Tablespaces

5 Installing and Configuring the WebLogic Server Cluster

• Preparing WebLogic Server for an OSM Cluster Installation
• Preparing the Operating System
• Installing WebLogic Server Software
  • WebLogic Server Software Installation Overview
• Creating Database Schemas Using RCU
• Creating the WebLogic Server Domain
• Replicating the Domain on Other Machines
  • Starting and Configuring Credentials on the First Machine
  • Creating a Domain Template for Use on Other Machines
  • Replicating the Domain Template on Other Machines
  • Starting the Administration Server
• Configuring the Domain and Managed Servers
  • Configuring Oracle Coherence for an OSM Cluster
    • Increasing Buffer Sizes to Support Coherence
    • Preventing Unnecessary Use of Swap Space
    • Securing Coherence
  • Configuring Node Manager on All Machines in the Domain
    • Configuring Node Manager for Starting and Stopping Managed Servers
    • Configuring Node Manager for Whole Server Migration
    • Configured Whole Server Migration Floating IP Controls
    • Enrolling Each Machine with the Domain
    • Starting Node Manager on Each Machine
  • Configuring a Multicast IP Address for the Cluster Messaging Mode
  • Preventing Connection Timeout when Using a Remote Database
  • Recommended Configuration for WebLogic Servers for Production Systems
  • Configuring Managed Server Startup Parameters
  • Configuring Cluster Settings
  • Configuring Server Settings
  • Starting and Verifying all Machines in the Cluster
  • Configuring Whole Server Migration
    • Creating the Leasing Tablespace and Active Table in the Database
    • Create the Leasing Multi Data Source
    • Configure the Cluster for Whole Server Migration
    • Configure Managed Servers for Whole Server Migration
    • Testing Whole Server Migration
    • Migrating a Managed Server Back
• Installing OSM in a Clustered Environment

6 Performing an Interactive Installation of OSM

• Installing OSM
• Handling an OSM Database Schema Installation Failure

7 Performing a Silent Installation of OSM

• Prerequisites
• Configuring the installOptions.txt and install_cfg.xml Files
  • Configuring the installOptions.txt File
  • Configuring the install_cfg.xml File
• Performing a Silent Installation

8 Performing OSM Post-Installation Tasks

• OSM Client Configuration Post Installation Tasks
  • Enabling Graphical Display on UNIX or Linux Systems
• Connection, File Store, and Thread Configuration Post Installation Tasks
  • Customizing OSM Runtime Parameters
  • Preventing Connection Timeout Issues During Cartridge Deployment
  • Configuring OSM JDBC Connections
  • Creating and Configuring Persistent File Stores
  • Configuring and Monitoring Coherence Threads
  • Externalizing the Coherence Thread Configuration File
  • Monitoring Coherence Threads
• Copying Metric Rule Files
  • Relocating ADML Files Without Restarting the Server
  • Registering Oracle HTTP Server Instance
• Queue Configuration Post Installation Tasks
  • Creating the Queue for the Account Manager
  • Configuring Distributed Queues for an OSM Solution
• OSM Integration with External Systems
  • Integrating OSM and ASAP or IP Service Activator Using SAF Agent and JMS Bridging
  • Integrating OSM and UIM Using SAF Agent
• Deploying Custom Plug-Ins When Running on Managed Server
• Changing the WebLogic Server of Oracle RAC Database Size
  • Connecting Oracle RAC with JDBC Multi Data Source
    • Adding Oracle RAC Instances
    • Manually Configuring Additional Data Sources for an Oracle RAC Instance
    • Manually Creating and Configuring Data Sources
    • Configuring Connection Pool Properties
    • Adding Data Sources to Multi Data Sources
  • Adding a New Managed Server to a Clustered Environment
    • Configuring a New Managed Server that uses JMS Service Migration
  • Removing a Managed Server from a Clustered Environment
    • Preparing to Remove a Managed Server from a Clustered Environment
    • Removing a Managed Server from a WebLogic Cluster

9 Troubleshooting OSM Installation Problems

• Coherence Configuration Error: ORA-00001: unique constraint
• Coherence Configuration Error: [STUCK] ExecuteThread
• Error About T3 After Initial OSM Startup
• Node Manager Does Not Create IP Address for Whole Server Migration
• Database Connection Problems During Installation
• DataDictionary Expansion Level
• JMS Server Connection Problems
• Problems When Running Multiple WebLogic Domains on One Host
• JDBC Errors When First Order Submitted
• Unable to Bring Up Managed Server After Database Failure
• Slow Query Performance in OSM Web Clients
• Delayed JMS Messages
• Error Message For Events From a JMS Topic in a Cluster
• JMS Message Delivery Failure
• OSM and RCU Installers Are Slow to Run Database Tablespace Query
• OSM Installer Issues for UNIX or Linux
• Command for unpack.jar Fails with a Write Error
• JBoss Cache Timeouts

10 Verifying the OSM Installation

• Checking the State of All Installed Components
• Verifying the OSM Clients
• Configuring and Verifying HTTPS Connectivity for OSM Client Browsers
• Configuring OSM to Evaluate System Configuration Compliance
  • Manually Installing Compliance Files
  • Configuring Compliance for an OSM Cluster
  • Evaluating System Configuration Compliance
    • Running the Compliance Tool
    • Cluster Considerations
    • Evaluating Compliance Results

11 OSM Pre-Production Testing and Tuning

• OSM Performance Testing and Tuning Overview
• Guidelines for the Performance Test Environments
  • About Configuring the Environment for Performance Testing
    • About Work Managers, Work Manager Constraints, and the JDBC Connection Pool
    • About the JBoss and Coherence Order Cache
    • Synchronizing Time Across Servers
    • Determining Database Size
    • Setting Up Emulators
    • Setting Up a Test Client for Load Generation
  • Example Managed Server Configuration
• Guidelines for Performance Testing and Tuning
  • General Guidelines for Running Tests and Analyzing Test Performance
  • Example Performance Tests on OSM Managed Servers
    • Setting the Order Volatility Level
    • Warming Up the OSM System
    • Determining the Sustainable Order Rate for a Managed Server
    • Tuning Work Manager Constraints and the Maximum Connection Pool Capacity
    • Tuning the JBoss and Coherence Maximum Order Cache
    • Sizing the Redo Log Files
• Additional Performance Testing Options
  • Performance Related Features for Large Orders
  • Distribution of High-Activity Orders
  • Measuring Order Throughput
  • Using the OM_ORDER_NODE_ANCESTRY Table
    • Enabling the OM_ORDER_NODE_ANCESTRY Table
    • Disabling the OM_ORDER_NODE_ANCESTRY Table

12 Upgrading to OSM 7.3.1

• About OSM Upgrades
  • Supported Upgrade Paths
  • About Backing Up Your Data
  • About Upgrading Oracle Database
  • About OSM Customizations
  • About Creating a New Localization JAR File
  • About Installer Disk Space
  • About Execute Queues and Work Managers
• Preparing for an OSM Upgrade
  • Preparing the Environment
  • Upgrading or Creating the WebLogic Domain
    • Upgrading the OSM 7.2.2 or OSM 7.2.4 WebLogic Domain to Fusion Middleware 12.1.3
    • Creating a New 12.1.3 WebLogic Domain
  • Updating the WebLogic Domain
    • Updating JMS Security Policy Settings
  • Upgrading the Database
  • Updating Coherence Properties for Managed Servers
  • Upgrading the SDK Library Names
• Upgrading OSM to 7.3.1
  • Upgrading the Database Schema for OSM Versions 7.2.2.0 through 7.2.2.3 Only
  • Recovering from a Database Upgrade Failure
    • Finding the Issue that Caused the Failure
    • Fixing the Issue that Caused the Failure
    • Restarting the Upgrade from the Point of Failure
  • Performing the OSM Upgrade
  • XQuery Model Changes
    • Using java.util.Map as an Argument or Return Type
    • Using java.util.Collection as a Return Type
    • Invoking Overloaded Methods of Same Number of Arguments with Ambiguous Types
    • Handling Null Values from Java Functions
  • Converting OSM Data Source Configurations
    • Oracle RAC Active-Passive to Active-Active
    • Oracle RAC Active-Active to Active-Passive
    • Oracle RAC Active-Active to Active-Active
  • Additional Configuration for JMS Service Migration
  • Configuring Attachment Location for Whole Server Migration
• Upgrading the Development and Administration Environment
• Upgrading Pre-7.3.1 Cartridges to OSM 7.3.1
  • Cartridge Upgrade Prerequisites
  • Cartridge Upgrade Procedure
• Upgrade Impacts on Cartridges from Previous Releases to OSM 7.3.1
  • Updating the Common Data Dictionary Manually
  • Modeling Order Components to Use Calculated Start Dates
  • Turning On Inheritance of Keys and Significance for Existing Cartridges
  • Creating the Common Data Dictionary Project in Your Workspace
  • Updating Cartridges to a Five-Digit Version
  • Specifying Task Views for Order-Related Automation
  • Configuring Order Lifecycle Policy Transition Error Messages
  • Modeling Data Entries Above the 1000-Character Limit

13 Updating Order-to-Activate Cartridges

• System Requirements
• Preparing to Update the Order-to-Activate 7.0.3, 7.2.0, 2.0.1, 2.1.0, and 2.1.0.2 Cartridges
  • Ensuring Order-to-Activate Cartridge Compatibility
  • Getting the Latest Patch for Your Version of the Cartridges
  • Updating the oms-config.xml File When Updating Order-to-Activate 7.0.3 Cartridges
  • Setting Design Studio Preferences
  • Downloading the Migration Package
  • Importing the Migration Package Cartridge
• Updating the Order-to-Activate Cartridges
  • Updating Unmodified or Modified Order-to-Activate 7.2.0, 2.0.1, 2.1.0, or 2.1.0.2 Cartridges to Run on OSM 7.3.1
    • Importing the Installation Cartridge for Order-to-Activate 7.2.0, 2.0.1, 2.1.0, or 2.1.0.2
    • Importing Unmodified OSM Order-to-Activate 7.2.0, 2.0.1, 2.1.0, or 2.1.0.2 Cartridges
    • Importing Modified Order-to-Activate 7.2.0, 2.0.1, 2.1.0, or 2.1.0.2 Cartridges
    • Migrating the Order-to-Activate 7.2.0, 2.0.1, 2.1.0, or 2.1.0.2 Cartridges
    • Configuring WebLogic Server Resources for Order-to-Activate 7.2.0, 2.0.1, 2.1.0, or 2.1.0.2
  • Updating Unmodified Order-to-Activate 7.0.3 Cartridges to Run on OSM 7.3.1
  • Updating Modified Order-to-Activate 7.0.3 Cartridges to Run on OSM 7.3.1
• Configuring WebLogic Server Resources for 7.0.3 Cartridge Updates
  • Setting Up the Configuration File for Connecting to Oracle AIA
    • Setting Up the Configuration File for OSM on WebLogic Cluster
    • Setting Up the Configuration File for OSM on Standalone WebLogic Server
  • Running the config_All Target
• Deploying the Updated Order-to-Activate Cartridges

14 Uninstalling OSM

• Uninstalling OSM Components
• OSM Uninstall: Additional Tasks
• Performing a Silent Uninstall

A Production Checklist

• About Using the Production Checklist
• Checking for a Current OSM Patch Before Going Into Production
• Checking for Deployment Architecture
• Checking the OSM Production System Configuration
• Checking for Performance Expectations
• Checking for a Migration Strategy and Production Schedule
• Checking for Database Management Procedures
• Checking for Database Optimizer Statistics Schedule
• Checking for Outage and Order Failure Plans
• Checking for Change Control Management Plans
• Checking for Performance Monitoring Procedures

B Upgrading OSM to an Oracle RAC Environment

• Upgrading OSM After Converting the Database to Oracle RAC
• Upgrading OSM to Oracle RAC Using Data Pump Import and Export
  • Upgrade Overview
  • Shutting Down the OSM Server
  • Turning Off the Notification Engine
  • Exporting and Importing the Database Data
  • Running the OSM Installer
  • Restarting the Notification Engine
  • Restarting the OSM Server

C OSM Development System Guidelines and Best Practices

• OSM Development Planning Overview
  • Installing OSM Components on a Windows System
  • Hardware Requirements for Development Systems
• Preparing the Database
  • Oracle Database Kernel Configuration
  • Downloading and Installing the Oracle Database
  • Database Configuration Considerations for Development Instances
    • Database Parameters
    • Tablespaces
• Preparing WebLogic Server
  • Installing WebLogic Server Software
    • WebLogic Server Software Installation Overview
  • Creating Database Schemas Using RCU
  • Creating the WebLogic Server Domain
  • Increasing the Memory Settings for WebLogic Servers
  • Configuring the WebLogic Server Domain
    • Configuring WebLogic Server for 64-Bit Java on Solaris
    • Preventing Connection Timeout when Using a Remote Database
• Other Supported High Availability Options
  • Configuring Oracle Database with Clusterware
    • Setting Up the Database and Clusterware for Cold Standby
  • Configuring WebLogic for Cold Cluster Failover
  • Oracle RAC Active-Passive
  • Cold Cluster Failover
  • JMS Service Migration

D Silent Installation install_cfg.xml Parameters

• WebLogic Parameters
• OSM Parameters
• Database Parameters

E Installing OSM on Engineered Systems

• JDBC Recommendations
• Configuring Exalogic
  • Exalogic User Process Limit
  • Exalogic Kernel Parameters
  • OSM WebLogic Server Configuration
  • JVM Options
• Tuning Oracle Database
  • Configuring Database Schema Partitioning
  • Multi-database Source Configuration Using N-RAC Nodes
  • Database Storage