Go to main content
1/18
Contents
Title and Copyright Information
Preface
Audience
Documentation Accessibility
Accessing Oracle Communications Documentation
Document Revision History
1
ECE System Administration Overview
Overview of System Administration Tasks
Overview of ECE System Administration Tools
Overview of Third-Party System Administration Tools
Directory Placeholders Used in This Guide
2
Setting Up and Managing Elastic Charging Engine Security
Setting Up User Accounts and User Groups
Creating UNIX User Accounts and Groups
Managing ECE Permissions
About Permission Types
Configuring Specific File Permissions
Granting ECE User Permissions
About the Default umask for ECE Users
About External Permissions
Managing Passwords in ECE
About Managing External Application Passwords
About the Keystores
Encrypting New Passwords
Checking Keystore Validity
Setting Up Cluster Security
Adding Trusted Hosts
Securing Intra-Cluster Communication
Enabling SSL Within the ECE Cluster
Enabling Well Known Addresses
Securing Inter-Cluster Communication
Enabling SSL Communication between BRM Gateway and the CM
Setting Up Password-less SSH Between the Driver and Servers
3
Starting and Stopping ECE
About Starting and Stopping ECE
Starting an ECE Standalone System
Starting and Stopping Diameter Gateway
Starting and Stopping RADIUS Gateway
Starting and Stopping Rated Event Formatter
Starting and Stopping External Manager Gateway
Starting Charging Server Nodes
Stopping Charging Server Nodes
Stopping Non-Charging Server Nodes
Starting and Stopping BRM Gateway
Starting and Stopping Data-Loading Utility Nodes
Restoring the ECE System
Troubleshooting Starting ECE
Start Command Fails When Trying to Start Nodes in a Large Cluster
4
Configuring the ECE System
About ECE Configuration
About Centralized Configuration
Initial Configuration
System-Level Configuration
Usage-Charging Configuration
Configuring ECE Topology
Enabling a Charging Server Node for JMX Management
Configuring JVM Tuning Parameters
Deploying JVM Tuning Parameter Updates onto a Running System
Configuring Trusted Hosts of the Cluster
Configuring ECE System-Level Settings
Configuring Coherence
Configuring Logging
Setting Log Levels by Editing MBeans
Configuring Charging-Server Health Thresholds
About the Charging-Server Health Threshold
Configuring the Charging-Server Health Threshold
Checking the Ongoing Health of ECE Charging Client Nodes
Configuring System Overload Protection
About Overload Protection Infrastructure
Configuring Overload Protection
About MBean Attributes Used to Configure Overload
About Request Prioritization
Configuring Client-Side ECE Request Queues
Configuring Default System Currency
Configuring Housekeeping: Expired Object Clean Up
About Cleaning Up Expired Objects in Update Requests
Configuring Expired Object Clean Up in Update Requests
About MBean Attributes Used to Configure Expired Object Retention Time
About Cleaning Up Expired Objects in Usage Requests
Setting Eviction Policies for the Identity Cache
Configuring Notifications
Configuring ECE Data-Loading Utilities and Data Updaters
Configuring Usage-Charging Settings
Updating Subscriber Lifecycle States for BRM
Adding Diameter Gateway Nodes for Online Charging
Specifying Diameter Gateway Node Properties
Adding RADIUS Gateway Nodes for Authentication and Accounting
Configuring RADIUS Gateway Nodes
Customizing the RADIUS Data Dictionary
About the RADIUS Data Dictionary
Creating a Custom Data Dictionary
Selecting a RADIUS Data Dictionary When Using Different NAS Vendors
Adding Custom Vendor-Specific Attributes
Loading the RADIUS Mediation Specification Data
About Mapping RADIUS Network Attributes to Event Attributes
Mapping RADIUS Network Attributes to Event Attributes
5
Monitoring and Managing ECE
Overview of Monitoring and Managing Tasks
Configuring Alerts for ECE Charging Servers
Configuring and Reading Log Files
Monitoring Rated Event Formatter Health
6
Managing Persisted Data in the Oracle NoSQL Database
About Persisting Data in the Oracle NoSQL Database
Purging Rated Events from the Oracle NoSQL Database
About Purging Rated Events from the Oracle NoSQL Database
Configuring How Rated Events Are Purged from the Oracle NoSQL Database
7
Using the Elastic Charging Controller to Manage Nodes
About Elastic Charging Controller (ECC)
About Using ECC on the Driver Machine
Prerequisites for Using ECC
Using ECC
ECC Command Output
Running ECC Commands
Running the start Command
Running the stop Command
Running the addNode Command
Running the removeNode Command
Running the infoCollector Command
Running the rollingUpgrade Command
Getting Help Using ECC
Using the help Command
Using Completion Support
Performing a Rolling Upgrade
Roll-Back
8
Backing Up and Restoring ECE
About Backing Up and Restoring ECE
About Standard Configuration Backup
About Complete System Backup
About Backing Up Oracle NoSQL Installation and Configuration
Backing Up Standard Configuration
Backing Up the Oracle NoSQL Database Installation
Restoring a Standard System Configuration
Restoring a Complete System Backup
9
Configuring ECE for Disaster Recovery
About Disaster Recovery
Overview of Disaster Recovery Architecture
About Replicating Data in a Disaster Recovery System
About Configuring Oracle NoSQL Database Data Store Nodes
About Load Balancing in a Segmented Active-Active System
Configuring a Disaster Recovery System
Configuring an Active-Cold Standby System
Configuring an Active-Hot Standby System or a Segmented Active-Active System
Replicating ECE Cache Data
About Disaster Recovery Operations
Switching Over to a BackUp Site
Failing Over to a Backup Site or a Remote Production Site
Switching Back to the Original Production Site
Migrating ECE Notifications
10
Troubleshooting ECE
Overview of Troubleshooting ECE
Troubleshooting JVM and Coherence
Troubleshooting Checklists
ECE Troubleshooting Checklist When Offline
ECE Troubleshooting Checklist When Online
ECE General Troubleshooting Checklist
Using Error Logs to Troubleshoot ECE
Collecting Diagnostic Information
Collecting Log Files for Sending to Oracle Support
Displaying Data in the Coherence Caches When Troubleshooting
Troubleshooting Failed Diameter-Message Processing in Diameter Gateway
Troubleshooting Failed RADIUS-Message Processing in RADIUS Gateway
Troubleshooting Failed Update Requests from BRM
About Customer Updater Error Log Files
Viewing Failed Events in the Suspense Queue
Removing Excess Failed Updates in the BRM Gateway Suspense Queue
Propagating Events from the Suspense Queue to the Account Synchronization DM Database Queue
Troubleshooting Problems with Coherence
Troubleshooting Problems with Rerating
Troubleshooting Performance Issues by Using Coherence JMX Metrics
Getting Help for ECE Problems
11
ECE System Administration Utilities
encrypt.sh
events_propagate_utility.pl
gridSync
A
ECE Directory Structure and Contents
ECE Directory Structure and Contents
ECE Server Software
ECE SDK
ECE BRM Integration Pack
ECE Oracle Management Server Integration Pack
B
ECC Commands
ECC Commands
C
ECE Configuration File Reference
System Configuration Files
Business Configuration Files
D
Diameter Gateway Result Codes
Supported Result Codes
Success Result Codes
Protocol-Error Result Codes
Transient-Failure Result Codes
Permanent-Failure Result Codes
Scripting on this page enhances content navigation, but does not change the content in any way.