Table of Contents
- Title and Copyright Information
- Preface
-
Part I Basic BRM System Administration
-
1
Starting and Stopping the BRM System
- About Starting and Stopping BRM Components
- Running the pin_ctl Utility
-
Setting Up and Configuring the pin_ctl Utility
- Customizing the List of Components to Start or Stop
- Starting and Stopping Optional Components by Using pin_ctl
- Creating a Custom Component List
- Customizing the Components List
- Customizing the pin_ctl Startup Configuration
- Customizing the pin_ctl Utility Environment Variables
- Configuring the Start and Stop Validation Settings for pin_ctl
- Using Custom pin_ctl Configuration Files
- Starting BRM Components Automatically
- Starting Multiple Families of BRM Components on the Same Computer
- Confirming That a BRM Component Started Successfully
- Stopping a Process by Using Commands
- 2 Monitoring Your BRM System
- 3 Tracking Failed BRM Operations
- 4 Backing Up and Restoring Your BRM System
- 5 Using Logs to Monitor Components
- 6 Monitoring Connection Manager Activity
- 7 Monitoring Data Manager Activity
- 8 Getting Quality of Service Statistics
- 9 Collecting Diagnostic Information by Using RDA
- 10 Monitoring Key Performance Indicators
- 11 Running Stored Procedures
-
12
Using Configuration Files
- About Configuration Files
- Syntax for Configuration Entries
- Syntax for Facilities Module Entries
- Guidelines for Editing Java Properties Files
- Configuring BRM by Using the pin_bus_params Utility
- Configuring a Shared pin.conf File
- Preparing for Platform Migration by Using Variables in pin.conf Files
- About Oracle Wallet
- Viewing Configuration Entries in the Client Wallet
- Storing Configuration Entries for Java PCM Applications in Client Wallet
- Retrieving Configuration Entries from Client Wallet for Java PCM Applications
- Storing Configuration Entries for BRM PCM Applications in Client Wallet
- Retrieving Configuration Entries from Client Wallet for BRM PCM Applications
- 13 Connecting BRM Components
- 14 Controlling Batch Operations
- 15 About Connection Pooling
- 16 Running Utilities in Multischema Systems
- 17 System Administration Utilities and Scripts
-
1
Starting and Stopping the BRM System
-
Part II Implementing Security
- 18 Implementing System Security
-
19
Managing Login Names and Passwords
- Managing Login Names and Passwords for BRM Access
- Configuring the Maximum Number of Invalid Login Attempts
- Configuring the CM to Verify Application Logins with the Service Only
- Enabling Password Restriction for /service Objects
- Storing Passwords in Oracle Wallet
- Configuring Applications to Provide Login Information
- 20 Logging Customer Service Representative Activity Events
- 21 Setting Up Permissions in BRM Applications
-
22
Enabling Secure Communication between BRM Components
- Working with SSL/TLS Certificates and Oracle Wallets
- BRM-Supported Cipher Suites
- Enabling or Disabling SSL/TLS for BRM Components
- Enabling or Disabling SSL/TLS for BRM Clients
- Enabling SSL/TLS in Connection Managers
- Enabling SSL/TLS in Data Managers
- Enabling SSL/TLS for C and C++ PCM Clients
- Enabling SSL/TLS for Java PCM Clients
- Enabling SSL for Web Start Deployment
- Enabling SSL/TLS for Java Server Processes
- Enabling SSL/TLS in Connection Manager Master Processes
- Enabling SSL/TLS for Payment Tool
- Enabling SSL/TLS with Custom Applications
- Enabling SSL/TLS for Paymentech DM
- Enabling SSL/TLS for Paymentech Answer Simulator
- Verifying Server Host Name
- SSL/TLS Client Certificate Authentication
- Creating Debugging Logs for SSL/TLS
- 23 Managing Closed Accounts
-
Part III Improving Performance
- 24 Improving BRM Performance
- 25 Improving Connection Manager Performance
- 26 Using Connection Manager Master Process to Improve Performance
-
27
Improving Data Manager and Queue Manager Performance
- About Queuing-Based Processes
-
Configuring DM Front Ends and Back Ends
- Ratio of Front Ends to Back Ends
- Providing Enough Front-End Connections
- Determining the Required Number of Back Ends
- Determining the Maximum Number of Back Ends Dedicated to Transactions
- Setting the DM Time Interval between Opcode Requests
- Setting How Long the DM Waits for the Background Startup Process to Complete
- Setting DM Shared Memory Size
- Reducing Resources Used for Search Queries
- Load Balancing DMs
- Optimizing Memory Allocation during Database Searches
- Improving BRM Performance during Database Searches
- Increasing DM CPU Usage
- Examples of DM Configurations
- 28 Improving Interprocess Communication (IPC) Performance
- 29 Improving Database Performance
-
30
Improving Billing Performance
- About Billing Configuration File Entries
- Tuning the Number of Children for Billing Utilities
- Tuning the Account Cache Size for Billing Utilities (fetch_size)
- Tuning the Performance for the pin_collect Utility
- Filtering Search Results
- Specifying the Number of Retries in Case of a Deadlock
- Ensuring the Sequence of Scheduled Actions
- Rearranging Accounts to Improve Billing Performance
- Additional Issues Related to Billing Performance
- Improving Performance in Retrieving Purchased Offerings for a Bill Unit
- Improving Performance by Skipping Previous Total Unpaid Bill for Open Item Accounting Type
- Improving Trial Billing Performance by Enabling General Ledger Collection
- Excluding Searches on Closed Offerings
- Improving Performance by Skipping Previous Total for Open Item Accounting Type When Calculating the Current Bill
- Improving Performance by Using Multiple Item Configurations
- Improving Item Search Performance
- 31 Improving Invoicing Performance
- 32 Improving Client Performance
-
33
Improving Pricing and Rating Performance
- Changing the Precision of Rounded and Calculated Values
- Setting the Interval for Checking for Product Offering Changes
- Setting the Interval for Updating Value Maps
- Filtering the ERAs Considered during Rating and Discounting
- Configuring the Maximum Number of Charge and Discount Offers Cached
- Improving Performance for Loading Large Product Offerings
- Improving Performance in Retrieving Product Details During Product Purchase
- 34 Improving Performance by Disabling Unused Features
- 35 Improving the Performance of Multithreaded Applications
- 36 Troubleshooting Performance
-
Part IV Troubleshooting BRM
- 37 Resolving Problems in Your BRM System
-
38
Diagnosing Some Common Problems with BRM
- Problems Starting BRM Components
- Problems Stopping BRM Components
- Problems Connecting to BRM
- Problems with Deadlocking
- Problems with Memory Management
- Problems Running Billing
- Problems Creating Accounts
- Problems Loading Configuration Objects
- Problems During BRM Upgrade
- 39 Using Error Logs to Troubleshoot BRM
- 40 Reference Guide to BRM Error Codes
-
Part V Monitoring BRM with Prometheus
and Grafana
-
41
Monitoring BRM Components
- About Monitoring Your BRM Components
-
Setting Up Monitoring for BRM
Components
- Customizing Pushgateway for BRM
- Enabling Monitoring of Your CM
- Enabling Monitoring of Your Oracle DM
- Enabling Monitoring of dm_ifw_sync and dm_aq
- Enabling Monitoring of BRM Java Applications
- Enabling Monitoring of Web Services Manager
- Configuring Prometheus for BRM Components
- Creating Grafana Dashboards for BRM Components
- BRM Opcode Metrics
- 42 Monitoring Business Operations Center
- 43 Monitoring Billing Care and Billing Care REST API
-
41
Monitoring BRM Components
-
Part VI Partitioning and Managing BRM Database Tables
-
44
Partitioning Tables
- About Partitioning
- About Partitioning Schemes
- About Running the partition_utils Utility
- Restarting partition_utils
- Adding Partitions
- Enabling Delayed-Event Partitioning
- Updating Partitions
- Purging Objects by Removing Partitions
- Purging Objects without Removing Partitions
- Finding the Maximum POID for a Date
- Customizing Partition Limitations
- Customizing the List of Events and Items Stored in partition_historic
- 45 Converting Nonpartitioned Classes to Partitioned Classes
-
46
About Purging Data
- About Purging Database Objects
- About Purging BRM Event Objects
- Enabling Open Items to Be Purged
- About Purging Account Sub-Balances
- 47 Generating Virtual Columns on Event Tables
-
44
Partitioning Tables
-
Part VII Managing a Multischema System
-
48
Managing a Multischema System
- About Multischema Systems
- Converting a Single-Schema System to a Multischema System
- Preparing to Manage a Multischema System
- Adding a BRM Installation Machine to a Multischema Environment
- Adding Database Schemas to a Multischema System
- Setting Database Schema Status
- Setting Database Schema Priorities
- Creating Custom Tables That Are Available to All Database Schemas
- Synchronizing Database Schema Data Dictionaries
- Synchronizing the Database Schema /uniqueness Objects
- Changing the Interval for Checking New Accounts
- Changing the Interval for Updating the Distribution Table
- 49 Multischema Utilities
-
48
Managing a Multischema System
-
Part VIII Running Business Operations
-
50
Using Business Operations Center
- About Using Business Operations Center
- About Running Jobs in Business Operations Center
- How Business Operations Center Runs Jobs
- Setting Up Custom Clients to Run Business Operations and BRM Applications
- Setting Up Business Operations Center to Run Custom Applications on Multischema Systems
- Improving Business Operations Center Performance
- Enabling Secure Communication for the pin_job_executor Utility
- About Generating Metrics to Display in Business Operations Center
- 51 Business Operations Center Utilities
-
50
Using Business Operations Center
-
Part IX Configuration File Reference
-
52
Business Logic pin.conf Reference
- Account Creation pin.conf Entries
- Accounts Receivable pin.conf Entries
- Billing pin.conf Entries
- Collections pin.conf Entries
- Customer Management pin.conf Entries
- Discounting pin.conf Entries
- General Ledger pin.conf Entries
- Invoicing pin.conf Entries
- Payments pin.conf Entries
- Pricing and Rating pin.conf Entries
- Revenue Assurance pin.conf Entries
- Service Lifecycle Management pin.conf Entries
- Services Framework pin.conf Entries
- Tax Calculation pin.conf Entries
- 53 System Administration pin.conf Reference
-
54
business_params Reference
- Accounts Receivable business_params Entries
- Billing business_params Entries
- Customer business_params Entries
- General Ledger business_params Entries
- Installment business_params Entries
- Invoicing business_params Entries
- Multibalance business_params Entries
- Notification business_params Entries
- Pricing and Rating business_params Entries
- Subscription business_params Entries
- System Administration business_params Entries
-
52
Business Logic pin.conf Reference
-
Part X PDC System Administration
- 55 Administering Pricing Design Center
-
56
Troubleshooting Pricing Design Center
- Troubleshooting Checklist
- Using Error Logs to Troubleshoot PDC
- Diagnosing PDC Problems
-
Fixing PDC Problems
- Errors When Obsoleting a Bundle in PDC
- SyncPDC Fails and Restarts
- Recurring Discounts are Applied Outside the Date Range
- Error When Adding GLIDs to Rule Attributes
- Error from ImportExportPricing Utility when Exporting Offers from Production to Test Environment
- Error When Importing a One-Time Offer
- Filtering IP Addresses in CDRs
- Charge Offers Do Not Appear in the Applicable To Field
- Getting Help for PDC Problems
- 57 Monitoring PDC with Prometheus and Grafana
-
Part XI ECE System Administration
- 58 ECE System Administration Overview
- 59 Setting Up and Managing Elastic Charging Engine Security
- 60 Starting and Stopping ECE
- 61 Monitoring ECE Using ECE Monitoring Agent
- 62 Monitoring ECE Components
- 63 Configuring Subscriber-Based Tracing and Logging
- 64 Managing Nodes and Clusters in ECE
- 65 Configuring ECE Data-Loading Utilities and Data Updaters
- 66 Configuring JVM Tuning Parameters
- 67 Configuring System Overload Protection
- 68 Configuring System Currency
-
69
Managing Persisted Data in the Oracle
Database
- About Persisting Data in the Oracle Database
- Accessing ECE Configuration MBeans
- Enabling Multischema Support in the Persistence Database
- About Persisting Rated Events and Customer Data
- About Persisting POIDs
- Enabling ECE Cache Override from Original Source
- Enabling Partition Recovery
- Enabling Partial Loading of Data
- Querying Persistence Database
- 70 Managing Failed Customer Data Updates
- 71 Removing Data from the ECE System
- 72 Configuring ECE for a Multischema BRM Environment
- 73 Backing Up and Restoring ECE
-
74
Configuring ECE for High Availability
- Configuring Backup Driver Machine for High Availability
- About Configuring Data Updaters for High Availability
- Configuring Customer Updater for High Availability
- Configuring Pricing Updater for High Availability
- Configuring BRM Gateway for High Availability
- Configuring EM Gateway for High Availability
- Configuring Rated Event Formatter for High Availability
- Viewing ECE High Availability Status
- Configuring Additional Data Storage Node Connections for High Availability
-
75
Configuring ECE for Disaster Recovery
- About Disaster Recovery
- About the Active-Cold Standby System
- About the Active-Warm Standby System
- About the Active-Hot Standby System
- About the Segmented Active-Active System
- About the Active-Active System
- Replicating ECE Cache Data
- Migrating ECE Notifications
- About Configuring Oracle NoSQL Database Data Store Nodes
-
76
Troubleshooting ECE
- ECE Troubleshooting Checklist
- Collecting Diagnostic Information
- Collecting Log Files for Sending to Oracle Technical Support
- Troubleshooting Performance Issues by Using Coherence JMX Metrics
- Troubleshooting Failed Usage Requests
- Troubleshooting Problems with Rating
- Troubleshooting Problems with Rerating
- Diameter Gateway Error Codes
- Troubleshooting a Corrupted ECE Configuration File
- Troubleshooting JVM and Coherence
- Troubleshooting Failed Diameter-Message Processing in Diameter Gateway
- Troubleshooting Failed RADIUS-Message Processing in RADIUS Gateway
- Apache Kafka Notification Timeout Issue
- 77 ECE Utilities
-
A
WebLogic-Based Application
Metrics
- WLS Server Metrics Group
- Application Runtime Metric Group
- Servlets Metric Group
- JVM Runtime Metric Group
- Execute Queue Runtimes Metric Group
- Work Manager Runtimes Metric Group
- Thread Pool Runtime Metric Group
- JDBC Service Runtime Metric Group
- JTA Runtime Metric Group
- WLS Scrape MBean Metric Group
- Persistent Store Runtime MBean Metric Group
- B ECE Directory Structure and Contents
- C ECC Commands
- D ECE Configuration File Reference
- E Diameter Gateway Error Codes