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 Fine-Grained Opcode Tracing
- 7 Monitoring Connection Manager Activity
- 8 Monitoring Data Manager Activity
- 9 Getting Quality of Service Statistics
- 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 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
- Enabling SSL/TLS in Real-Time Pipeline
- Enabling SSL/TLS in Batch Pipeline
- 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
Tuning Your Billing Processes
- 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
-
31
Improving 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
- Improving Performance by Skipping Billing-Time Tax Calculation
- 32 Improving Invoicing Performance
- 33 Improving Client Performance
-
34
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
- Modifying the Cache for Storing Pricing Data
- Improving Performance in Retrieving Product Details During Product Purchase
- 35 Improving Performance by Disabling Unused Features
- 36 Improving the Performance of Multithreaded Applications
- 37 Troubleshooting Performance
-
Part IV Troubleshooting BRM
- 38 Resolving Problems in Your BRM System
-
39
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
- 40 Using Error Logs to Troubleshoot BRM
- 41 Reference Guide to BRM Error Codes
-
Part V Monitoring BRM with Prometheus
and Grafana
- 42 Monitoring BRM Components
- 43 Monitoring Business Operations Center
- 44 Monitoring Billing Care and Billing Care REST API
-
Part VI Synchronizing BRM Data with Other
Applications
- 45 Synchronizing Pricing Data Between the BRM Database and External CRMs
- 46 Synchronizing Account Data Between the BRM Database and ECE
-
47
Synchronizing Account Data Between BRM and
Pipeline Manager
- About Account Synchronization with Pipeline Manager
- About Controlling the Business Event Backlog
- 48 Exporting Pricing Data in a Batch
-
49
Configuring Your AQ Database Queues
-
Tasks for Setting Up AQ Database
Queues
- Configuring Your Database for Advanced Queuing
- Creating Additional Queues for Multischema BRM Systems
- Granting Execute Permission for Multiple Schemas
- Configuring Event Notification for Account and Pricing Synchronization
- Configuring EAI Payload for Synchronization
- Configuring the Primary Schema for AQ Queues
- Connecting Oracle DM to Queue Mapping File
- Mapping Business Events to Database Queues
-
Tasks for Setting Up AQ Database
Queues
-
50
Configuring Pipeline Manager to Retrieve
Business Events
- Configuring the DAT_Listener Module
- Configuring the Registry
- Configuring Interleaved Processing
- Switching to Business Event Processing When No CDRs Are Waiting
- Setting Up Service-Level Bill Items
- Modifying Business Events before Sending Them to Pipeline Manager
- Synchronizing Balance Group Transfer Data with Pipeline Manager
- 51 Monitoring and Maintaining Your AQ Queues
- 52 Configuring Object Auditing for GSM
- 53 Synchronization Utilities
-
Part VII Partitioning and Managing BRM Database Tables
-
54
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
- 55 Converting Nonpartitioned Classes to Partitioned Classes
-
56
About Purging Data
- About Purging Database Objects
- About Purging BRM Event Objects
- Enabling Open Items to Be Purged
- About Purging Account Sub-Balances
- 57 Generating Virtual Columns on Event Tables
-
54
Partitioning Tables
-
Part VIII Managing a Multischema System
-
58
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
- 59 Multischema Utilities
-
58
Managing a Multischema System
-
Part IX Running Business Operations
-
60
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
- Improving Business Operations Center Performance
- Enabling Secure Communication for the pin_job_executor Utility
- About Generating Metrics to Display in Business Operations Center
- 61 Configuring Business Operations Center to Run Custom Applications
- 62 Business Operations Center Utilities
-
60
Using Business Operations Center
-
Part X Configuration File Reference
-
63
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
- 64 System Administration pin.conf Reference
-
65
business_params Reference
- Accounts Receivable business_params Entries
- Billing business_params Entries
- Billing Flow business_params Entries
- Collections 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
-
63
Business Logic pin.conf Reference
-
Part XI PDC System Administration
- 66 Administering Pricing Design Center
- 67 Rotating PDC Log Files
- 68 Troubleshooting Pricing Design Center
- 69 Monitoring PDC with Prometheus and Grafana
-
Part XII ECE System Administration
- 70 ECE System Administration Overview
- 71 Setting Up and Managing Elastic Charging Engine Security
- 72 Starting and Stopping ECE
- 73 Monitoring ECE Using ECE Monitoring Agent
- 74 Monitoring ECE Components
- 75 Configuring Subscriber-Based Tracing and Logging
- 76 Managing Nodes and Clusters in ECE
- 77 Configuring ECE Data-Loading Utilities and Data Updaters
- 78 Configuring JVM Tuning Parameters
- 79 Configuring System Overload Protection
- 80 Configuring System Currency
-
81
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
- 82 Managing Failed Customer Data Updates
- 83 Removing Data from the ECE System
- 84 Configuring ECE for a Multischema BRM Environment
- 85 Backing Up and Restoring ECE
-
86
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 External Modules (EM)
- Configuring Rated Event Formatter for High Availability
- Viewing ECE High Availability Status
- Configuring Additional Data Storage Node Connections for High Availability
-
87
Configuring ECE for Disaster Recovery
- Introduction
- Business Continuity with ECE Disaster Recovery
- About Deployment Modes with Geo-Redundancy
- About Load Balancing in an Active-Active System
- About Rated Event Formatter in a Persistence-Enabled Active-Active System
- Configuring an Active-Active System
- Processing Usage Requests in the Site Received
- Replicating ECE Cache Data
- Migrating ECE Notifications
- Active-Active Sy/Gy Session Re-Anchoring
-
88
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
- 89 ECE Utilities
-
Part XIII Migrating Pricing Data from the BRM Database
to PDC
-
90
Migrating Pricing Data to PDC With ECE
- About Migrating BRM Pricing Data to PDC With ECE
- Performing Migration of BRM Pricing Data to PDC With ECE
- About Migrating PDC Pricing Data to PDC With ECE
- Performing Migration of PDC Pricing Data to PDC With ECE
-
Fixing Errors Found in the Analysis Phase
- Fixing Analysis "User Input Required" Errors
-
Analysis Errors Requiring Pricing Data Changes
- Multiple Impact Categories in a Rate Plan
- Derived Impact Category Used in Zone Model
- Zone Items Differentiated Only by Service Code
- Extended Service Class Event Mapping
- Service Contains Deal Mapped to Parent Service
- Using Overlapping Date Ranges to Sequentially Impact Multiple Resources
- Quantity Brackets in a Fold
- BRM Object Names Containing Special Characters
- Custom Fields
-
Fixing Errors Found in the Migration Phase
- Skipping Errors and Continue Pricing Objects Migration
- Fixing Compatibility "User Input Required" Errors
- Compatibility Errors Requiring Pricing Data Changes
- Changes Required After Migration
- Handling Migration Process Errors
- Restarting the Systems
- Testing the Migrated Data
- Importing the Migrated Data to the Production Systems
- About Working with the PDC Pricing Data After Migration
-
91
Migrating Pricing Data to PDC With RRE and BRE
- About Migrating BRM Pricing Data to PDC With RRE and BRE
- Performing Migration of BRM Pricing Data to PDC With RRE and BRE
- Creating a BackUp of Your BRM Database
- Setting Up the BRM Development System
- Migrating the BRM Pricing Data to PDC With RRE and BRE
-
Fixing Errors Found in the Analysis Phase
- Fixing Analysis "User Input Required" Errors
-
Analysis Errors Requiring Pricing Data Changes
- Multiple Impact Categories in a Rate Plan
- Derived Impact Category Used in Zone Model
- Zone Items Differentiated Only by Service Code
- Extended Service Class Event Mapping
- Service Contains Deal Mapped to Parent Service
- Using Overlapping Date Ranges to Sequentially Impact Multiple Resources
- Quantity Brackets in a Fold
- BRM Object Names Containing Special Characters
- Custom Fields
- Changes Required After Migration
- Handling Migration Process Errors
- Restarting the Systems
- Testing the Migrated Data
- Importing the Migrated Data to the Production Systems
- About Working with the Pricing Data after Migration
- 92 Migration Reports
- 93 BRM Pricing Migration Utility
-
90
Migrating Pricing Data to PDC With ECE
- A ECE Directory Structure and Contents
- B ECC Commands
- C ECE Configuration File Reference
-
D
WebLogic-Based Application
Metrics
- WLS Server Metrics Group
- Application Runtime Metric Group
- Servlets Metric Group
- JVM Runtime Metric Group
- Execute Queue Runtime Metric Group
- Work Manager Runtime 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
- E Diameter Gateway Error Codes
- F HTTP Gateway Error Codes
- G RADIUS Gateway Error Codes
- H ECE - Offline Mediation Controller Error Codes