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