Go to main content
1/33
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
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
Using Log4j
Classpath
Configuration File
Configuring Logging Using the Administration Console
Changing the Logging Level
Log4J Hierarchies, Loggers, and Appenders
Understanding the Trace Service
Understanding Basic Tracing
Understanding Context Tracing
Configuring Trace for Access Tier servers
Using the Log4J Configuration File
Example Log4J Configuration file
TraceServiceMBean Reference
TraceService MBean Attributes
TraceService MBean Operations
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
Minimizing EDRs Sent to JMS
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: listEdrListenerStatistics
Managing EDR, CDR, and Alarm Processing
Persisting EDRs Until You Configure JMS Listeners
Processing EDRs Using EdrServiceMBean
Publishing Statistics
Log4j Loggers
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
Managing Timeouts
Timeout Results
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: Using OAuth-secured APIs Causes maximumcolumnlength Errors
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
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
15
Managing and Configuring Communication Service Storage
Understanding the Storage Service
Specifying Attributes for Column Value Definitions
XSD Schema
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
16
Using Tunneled Parameters
About Filtering Tunneled Parameters
Configuring Tunneled Parameters Filtering
About the XParameter Filter Application
XParameter Filter Configuration File
XParameter Rejection
Internal XParameters
17
Configuring Network Node Heartbeats
Understanding Network Node Heartbeats
Configuring and Managing Heatbeats
HeartBeatMBean Reference
18
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
Accessing a Traditional Communication Service from DAF
Installing and Configuring
Send Traffic
Authentication
Service Types and Interfaces
Dynamic Versus Static Mode
Configuring DAF Two-Way SSL Support
Choosing an Alias When Multiple Aliases Are Matched
Additional Considerations
Configuring Two-Way SSL for Southbound
Configuring Two-Way SSL for Northbound
Adding Communication Service Applications
Using the Tool
Overview of Container Services and Their Configuration Files
Finding Container services
Patching Container Services
19
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
Overload Protection
OverloadProtectionMBean
StatisticsCollector
OverloadProtectionController
TrafficThrottler
20
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
21
Managing and Configuring the Tier Routing Manager
Understanding the Tier Routing Manager
Configuring Tier Routing
22
Charging and Integrating Billing
About Charging
Content-Based Charging
CDR-Based Charging
Diameter Charging Support
Billing System Integration
Billing Gateways
CDR Database
23
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
24
Implementing Diameter Rf Offline Charging
About CDRs and Diameter
CdrToDiameter Service Deployment Characteristics
Configuration of CdrToDiameter
Management of CdrToDiameter
CDR to AVP mapping
25
Managing and Configuring Native UCP Connections
Understanding the Connection Information Manager
Configuring and Managing the Connection Information Manager
ConnectionInfoManagerMBean Reference
26
Managing and Configuring Parlay X 2.1 Shortcode Mappings
Understanding the Shortcode Mapper
Configuring and Managing the Shortcode Mapper
Management operations
27
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
28
Managing Legacy Application Service Providers
About the Management Framework
The Administration Model
Partner Relationship Management Interfaces
Scripting on this page enhances content navigation, but does not change the content in any way.