1/34

Contents

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documents

1 Administration Overview

• About Administering Your Services Gatekeeper Implementation
• Services Gatekeeper Configuration Workflow

Part I Services Gatekeeper Administration

2 Understanding Services Gatekeeper System Administration Tools

• About Services Gatekeeper Installation
• About the Oracle WebLogic Platform
• Using the Administration Console to Configure Services Gatekeeper
  • About Using the Administration Console
  • Starting and Using the Administration Console
    • Logging in to the Administration Console
    • About the Administration Console
    • Navigating the Domain Structure
    • Using the Configuration and Provisioning Pane
    • Oracle Communications Services Gatekeeper Alarms Pane
    • Using the Services Gatekeeper CDRs Pane
  • Converged Application Server Administration Console for SIP-based Services
  • Localizing the Administration Console
• Understanding the Java Management MBeans
• Using the WebLogic Scripting Tool to Administer Services Gatekeeper
  • Using WLST in Interactive Mode
    • Connecting to Services Gatekeeper with WLST
    • Disconnecting from WLST
    • Changing an MBean Attribute
    • Calling an MBean Method
  • Scripting WLST

3 Managing Users and User Groups

• About Services Gatekeeper Users and User Groups
  • About User and Group Roles in the Production Environment
  • User Types
  • About User Levels
• About User Management Methods
  • Managing Access Privileges Through Policies

4 Starting, Stopping, and Administering Servers

• Overview of Starting and Stopping Servers
  • Performance Implications
• Starting Service Gatekeeper Servers
  • Special Instruction for Starting Servers on Solaris 64-bit Systems
  • Starting and Stopping Services Gatekeeper Servers with Scripts
  • About User Credentials for WebLogic Servers
  • Starting Servers with the WebLogic Node Manager Utility
• Configuring Domain Server Heartbeats
  • Understanding the Services Gatekeeper Heartbeat Settings
• HeartBeatMBean Reference
• Stopping Service Gatekeeper Servers

5 Managing, Backing Up, and Restoring Services Gatekeeper

• About Managing, Backing Up and Restoring Services Gatekeeper
  • Configuring Services Gatekeeper to Avoid Server Failure
  • Backing Up an Oracle Enterprise Database
  • Backing up a MySQL Database
  • Backing Up a JavaDB Database
• Cleaning Services Gatekeeper Database Tables
  • About Cleaning Database Tables
  • About Cleaning EDR Analytics Tables
  • About Cleaning the SLEE_CHARGING Table
  • Creating a Script to Clean SLEE_CHARGING

6 Setting Up Geographic Redundancy

• Understanding Geographic Redundancy
• Understanding the Geographic Redundancy Configuration Options
  • Best Practices for Domain-Specific GeoRedundant Services
    • About Unicast Addressing with WKA
  • About Recovering from a Geographic Redundant Failure
• Configuring Basic Geographic Redundancy
  • Configuring Both Sites for Geographic Redundancy
  • Defining One Site as the GeoMaster
• Configuring Geographic Redundancy Without Registering Applications at Every Site
  • Understanding the Configuration Workflow
  • Understanding the Configuration Prerequisites
  • Understanding the Configuration Example
  • Configuring the MySQL Database
  • Configuring the Services Gatekeeper Cache
    • Replicating SMS Configuration Database Tables
    • Replicating MMS Configuration Database Tables
    • Replicating Terminal Location Configuration Database Tables
  • Configuring Services Gatekeeper MBeans
  • Configuring Cache Types
  • Protecting the Modified MBean Files
  • Changing the type_id of Tables Replicated by MySQL
  • Configuring the my.cnf File for MySQL Replication
  • Merging the Data Tables
  • Restarting the MySQL Servers
  • Connecting the Master and Slave Databases
• Removing Geographic Redundancy
  • Removing the GeoRedundant Service from the Administration Console
  • Removing the GeoRedundant Service Programmatically
  • Troubleshooting
• GeoStorageService Reference
• GeoRedundantService Reference

7 Configuring Coherence Clusters

• Understanding Coherence
  • Configuring Coherence in GeoRedundancy Scenarios
• Configuring Coherence

8 Understanding and Managing SLA Budgets

• Understanding How the PRM Portals Use SLA Settings
• Understanding Budgets
  • Synchronizing Budgets Between Servers
    • Understanding Slave intervals
    • Understanding Masters
    • Understanding Failure Conditions
    • Understanding Budget Overrides
    • Budget Calculations and Relationship to SLA Settings
• Extending SLAs for Budget Services
• Configuring and Managing Budgets
• BudgetServiceMBean Reference
• Adding a Datasource

9 Configuring Logging and Tracing

• Configuring Logging Using the Administration Console
• Understanding the Trace Service
  • Understanding Basic Tracing
  • Understanding Context Tracing
• Log4J Hierarchies, Loggers, and Appenders
• Configuring Trace for Access Tier servers
• Using the Log4J Configuration File
  • Example Log4J Configuration file
• TraceServiceMBean Reference

10 Collecting Alarms Using the SNMP Service

• Understanding the SNMP Service
• Configuring and Managing the SNMP Service
  • Configuring SNMP Service
    • Trap Receivers
  • Generating SNMP MIB Files
• SNMPServiceMBean Reference

11 Managing and Configuring EDRs, CDRs, and Alarms

• About EDRs, CDRs, and Alarms
  • Understanding EDRs
  • Understanding CDRs
  • Understanding Alarms
  • Understanding External EDR listeners
  • Changing EDR, CDR, and Alarm Content
  • Capturing EDR Statistics with EDRAnalyticMBean
    • Working with EdrAnalytic
      • Operation: listEdrListnerStatistics
  • Managing EDR, CDR, and Alarm Processing
    • Persisting EDRs Until You Configure JMS Listeners
    • Processing EDRs Using EdrServiceMBean
• Managing EDRs in an API Management Implementation
  • Understanding EDR Fields for API Management
    • Example Default API Management EDRs
  • Understanding When EDRs are Generated
    • Understanding Action Chain EDR Handling
  • Directing EDRs to Specific JMS Listeners (Partitioned EDRs)
    • Configuring Partitioned EDRs

12 Resolving EDR Policy Deny Codes

• Understanding the Policy Deny Codes
• Policy Deny Code Values

13 Troubleshooting Your Services Gatekeeper Implementation

• General Checklist for Resolving Problems with Services Gatekeeper
  • Finding the Current Patch Level of Your Services Gatekeeper System
    • Listing What Is Currently Installed on Your Services Gatekeeper System
    • Running the OPatch lsinventory Command
    • Other Usages of the lsinventory Command
  • Handling Performance Issues
• Diagnosing Problems from Alarms
• Using Error Logs to Troubleshoot Services Gatekeeper
  • About Error Log Files
    • Finding Error Log Files
    • Resolving Clusters of Error Messages
  • Changing Log Levels in Services Gatekeeper
  • Collecting Log Data
• Diagnosing Some Common Problems with Services Gatekeeper
  • Problem: The Server Will Not Start
  • Problem: Reports Extension Installation Fails
  • Problem: The Server is Hanging
  • Problem: Memory Issues
  • Problem: Enabling SSL on Admin Server Fails If All Local Addresses Used
  • Problem: Receiving an Internal Server Error and Incident ID
• Getting Help for Problems with Services Gatekeeper
  • Before You Contact Oracle
  • Reporting Problems to Oracle

14 Using Cloud Monitoring with Multi-tier Services Gatekeeper

• About Monitoring Multi-tier Services Gatekeeper Using Enterprise Manager
• Integrating Enterprise Manager with Multi-tier Services Gatekeeper

15 Generating Statistics for Transaction Licenses

• About Generating Statistics and Reports
• Understanding Statistics Reports
  • Accessing the System Report from the Console
  • Retrieving the System Report as a File
  • Retrieving the Weekly System Report
  • Retrieving the Transaction Usage Log Report
  • Understanding Counter Snapshots
• Managing Statistics
  • Configuring the Statistics Time Interval
  • Configuring Statistics Types and Transaction Types
  • Viewing In-Flight Statistics counters
  • Generating Statistics Reports
  • Add Usage Thresholds
• Transaction Types
• StatisticsServiceMBean Reference

Part II Services Gatekeeper Advanced Administration

16 Managing and Configuring Communication Service Storage

• Understanding the Storage Service
• Configuring Storage Expiration
  • Configuring the System Wide Expiration Interval
  • Overriding the Expiration Interval Using Jar files
  • Overriding the Expiration Interval Using the store.properties File
• StorageServiceMBean Reference

17 Using Tunneled Parameters

• About Filtering Tunneled Parameters
  • Configuring Tunneled Parameters Filtering
    • About the XParameter Filter Application
    • XParameter Filter Configuration File
    • XParameter Rejection
    • Internal XParameters

18 Configuring Network Node Heartbeats

• Understanding Network Node Heartbeats
• Configuring and Managing Heatbeats
• HeartBeatMBean Reference

19 Deploying and Administering Communication Services

• About Communication Services
• Understanding How Communication Services are Packaged
  • A Communication Service Packaging Example
    • About the wlng_nt_third_party_call_px21.ear File
  • Deploying SOAP and RESTful Facades on Multiple AT Clusters
    • About the Deployment Procedure
  • Understanding Communication Service Version Handling
  • Deploying and Undeploying Communication Services and Plug-ins
  • Version Handling and Patching of Communication Services
• Overview of Container Services and Their Configuration Files
  • Finding Container services
  • Patching Container Services

20 Configuring and Managing Communication Service Traffic

• Understanding Plug-ins and the Plug-in Manager
  • Understanding the Plug-in Manager Execution and Evaluation Flow
    • How Plug-in Manager Evaluates Application-initiated Requests
    • How Plug-in Manager Evaluates Network-triggered Requests
  • Understanding Plug-in Routing Logic
    • Defining Routing Logic
    • Plug-in Routing Configuration Examples
    • Plug-in Routing XSD
  • Specifying Address Ranges in Routes
  • Understanding Plug-in Routes and Routing Logic
• Configuring Plug-in Manager
  • Creating a Plug-in instance
  • Administering Plug-in Routing Logic and Node IDs
  • Adding Bulk Messaging Support to a Communication Service
• PluginManagerMBean Reference

21 Upgrading and Redeploying Communication Services and Service Interceptors

• Understanding the Production Redeployment Process
  • Performing a Hitless Upgrade
• Performing Production Redeployment
  • Understanding the Redeployment Sequence
  • Understanding Redeployment Requirements
  • Typical Production Redeployment Scenarios
    • Redeploying Communication Services Using HTTP-based Network Protocol Plug-ins
    • Redeploying the Parlay X 2.1 Short Messaging-Binary SMA/SMPP Communication Service
    • Redeploying Communication Services With OSA/Parlay Type Plug-ins
    • Redeploying Communication Services With SIP Type Plug-ins
    • Redeploying Extended Web Service Subscriber Profile/LSAP Communication Services
    • Redeploying Native SMPP Communication Services

22 Managing and Configuring the Tier Routing Manager

• Understanding the Tier Routing Manager
• Configuring Tier Routing

23 Charging and Integrating Billing

• About Charging
  • Content-Based Charging
  • CDR-Based Charging
  • Diameter Charging Support
• Billing System Integration
  • Billing Gateways
  • CDR Database

24 Implementing Diameter Ro Online Charging

• Understanding Credit Control Interceptors
  • Using Application-Initiated Requests
  • Using Network-Triggered Requests
  • Using Credit Control Interception Points
• Writing Credit Control SLAs
  • Defining Static and Dynamic Parameter Mappings
  • Correlating Reservation and Commit Triggers in Asynchronous Credit Control Checks
  • Example Credit Control SLA
• Configuring, Managing, and Provisioning Credit Control Interceptors
  • Properties for Credit Control Service Interceptors
  • Deployment of CreditControlInterceptor
  • Configuring CreditControlInterceptor
  • Managing CreditControlInterceptor
  • Provisioning Credit Control SLAs

25 Implementing Diameter Rf Offline Charging

• About CDRs and Diameter
• CdrToDiameter Service Deployment Characteristics
  • Configuration of CdrToDiameter
  • Management of CdrToDiameter
• CDR to AVP mapping

26 Managing and Configuring Native UCP Connections

• Understanding the Connection Information Manager
• Configuring and Managing the Connection Information Manager
• ConnectionInfoManagerMBean Reference

27 Managing and Configuring Parlay X 2.1 Shortcode Mappings

• Understanding the Shortcode Mapper
• Configuring and Managing the Shortcode Mapper
  • Management operations

28 Managing OSA/Parlay Gateway Connections Using Parlay_Access

• Understanding OSA/Parlay Gateway and account mappings
  • Connection model
  • Information and Certificate Exchange with OSA/Parlay Gateway Administrator
• Connecting to an OSA Gateway
  • Adding an OSA/Parlay Gateway
  • Adding an OSA Gateway Connection
  • Creating an OSA client
  • Mapping the OSA client to an OSA Gateway and an OSA/Parlay SCS

29 Managing Legacy Application Service Providers

• About the Management Framework
• The Administration Model
• Partner Relationship Management Interfaces