Home
MATRIXX Call Control Framework Integration
LDAP Callout Service
Call Control Framework (CCF) provides support for making Lightweight Directory Access Protocol (LDAP) call out requests to an LDAP server in response to TCAP or Diameter messages that require them.
Configuring LDAP Callout Service
System Administrators configure the LDAP callout service to enable communication between Apache ActiveMQ, MATRIXX Engine, and the LDAP callout service.
Configure Apache ActiveMQ for LDAP
To enable the LDAP Gateway to communicate with Apache ActiveMQ, system administrators must configure the LDAP service properties in /opt/mtx/conf/ldap_gateway.yaml file.

Welcome
MATRIXX Release Notes
MATRIXX Architecture
MATRIXX Installation and Upgrade
MATRIXX Configuration
MATRIXX Security
MATRIXX Integration
MATRIXX Diameter Integration
MATRIXX Call Control Framework Integration
- About Call Control Framework Integration
  MATRIXX Call Control Framework Integration provides information about MATRIXX Call Control Framework support and configuration.
- MATRIXX Call Control Framework
  MATRIXX includes an integrated GSM Service Control Function to support call control capabilities for telephony services.
- Supported Message Sequences
  MATRIXX Call Control Framework (CCF) provides support for message sequences using the Camel Application Part (CAP) protocol.
- Configuring MATRIXX Network Enabler
  This section describes how to configure MATRIXX Network Enabler.
- Configuring CAMEL Gateway
  CAMEL Gateway is a CAMEL Application Part (CAP) server. Configure CAMEL Gateway to allow communication between MATRIXX Engine and Network Enablers through the CAP protocols.
- Configuring Routing Preferences
  Configuring routing preferences allows you to define how routes are prioritized between CAMEL Gateway on each engine and Network Enablers.
- Configuring Correlation ID Length
  Call Control Framework (CCF) supports configurable correlation ID lengths. CCF handles 10 digit correlation ID lengths by default.
- Support for CAP1
  Call Control Framework (CCF) supports the processing of roaming voice calls that use the CAP1 protocol.
- Charging for CS1 INAP Calls
  Call Control Framework (CCF) provides support for processing and applying charging for voice calls that use the CS1 INAP protocol.
- Sending Furnish Charging Information
  You can configure Call Control Framework (CCF) to send Furnish Charging Information (FCI) operations at specific points during call handling. CCF sends FCI operations to instruct the Mobile Switching Center (MSC), or service switching point (SSF), to add charging information to the call data record (CDR) for a call.
- Support for MT Call Forwarding
  When handling a mobile terminating (MT) call, Call Control Framework (CCF) can forward the call to another number if the call is not answered, or the called number is busy.
- TCAP Handover and Relay Configuration
  Call Control Framework (CCF) can handover (relay) incoming TCAP requests for subscribers that MATRIXX cannot find in its subscriber database to another platform for processing. For example, when migrating to the MATRIXX platform, CCF can relay incoming TCAP requests to the incumbent platform for subscribers that have not yet been migrated across. After handover, the incumbent platform processes the TCAP request without any further involvement with MATRIXX.
- Support for Announcements
  MATRIXX Call Control Framework (CCF) provides support for playing pre-call announcements. The following topics describe CCF pre-call announcement functionality and explain how to configure CCF to play announcements.
- Support for USSD Services
  Call Control Framework (CCF) supports making Mobile Application Part (MAP) Unstructured Supplementary Service Data (USSD) call out requests to deliver USSD notifications to a subscriber. CCF also supports USSD services for queries, call back, and interactive menus using MAP-Process-UnstructuredSS-Request messages, and MAP-UnstructuredSS-Request messages.
- Announcements (IVR) and USSD Menus
  Call Control Framework (CCF) provides support for menu driven announcements using IVRs and interactive USSD service menus that give subscribers options for retrieving and updating their balances and account details.
- Apache FreeMarker Template Configuration
  You can configure Apache FreeMarker templates for handling Call Control Framework (CCF) services such as Unstructured Supplementary Service Data (USSD) query and call back services, and menu services using announcements or interactive USSD menus.
- Mobile Application Part (MAP) Call Outs
  MATRIXX Call Control Framework (CCF) provides support within the Charging Server for making MAP call out requests to an external platform in response to TCAP or Diameter messages that require them.
- Extending MAP Callouts
  You can extend the data used in Mobile Application Part (MAP) callout requests and results. You can include customized private extension data in the extensionContainer parameter in MAP ATI (AnyTimeInterrogation) and MAP SRI (SendRoutingInfo) operations. This feature enables you to manipulate the data sent and returned in MAP callouts, for example, to correct the digits dialed by a user when roaming.
- LDAP Callout Service
  Call Control Framework (CCF) provides support for making Lightweight Directory Access Protocol (LDAP) call out requests to an LDAP server in response to TCAP or Diameter messages that require them.
  - LDAP Callout Service Components
    Lightweight Directory Access Protocol (LDAP) service uses multiple components for processing LDAP call out requests and responses.
  - High Availability and Failover
    Load balancing and high availability (HA) for LDAP Gateway is implemented through LDAP server configuration and not through LDAP Gateway configuration.
  - Configuring LDAP Callout Service
    System Administrators configure the LDAP callout service to enable communication between Apache ActiveMQ, MATRIXX Engine, and the LDAP callout service.
    - LDAP Callout Service Configuration
      System administrators must configure the LDAP callout service during system configuration.
    - Configure Apache ActiveMQ for LDAP
      To enable the LDAP Gateway to communicate with Apache ActiveMQ, system administrators must configure the LDAP service properties in /opt/mtx/conf/ldap_gateway.yaml file.
      - LDAP Gateway Properties
        You configure the following LDAP Gateway properties in the ldap-gateway.yaml file.
    - My MATRIXX Configuration
      During charging configuration in My MATRIXX, pricing administrators can configure prerating callout actions that define the queries to send to the LDAP server.
  - LDAP Request Data MDC
    MATRIXX Engine stores Lightweight Directory Access Protocol (LDAP) callout request data in the MtxLdapRequestDataExtension MATRIXX Data Container (MDC).
  - LDAP Callout Results
    Call Control Framework (CCF) uses MtxCallOutResponseData MDCs to hold response data for Lightweight Directory Access Protocol (LDAP) callouts for a call or a session.
- Callout Response Data MDCs
  Call Control Framework (CCF) holds response data for Mobile Application Part (MAP) callouts and Lightweight Directory Access Protocol (LDAP) callouts for a call or a session in MATRIXX Data Container (MDC) format.
- Appendixes
MATRIXX TM Forum Integration
MATRIXX 5G Integration
MATRIXX 5G Event Streaming
MATRIXX Event Streaming
MATRIXX Administration
MATRIXX Web App Administration
MATRIXX Monitoring and Logging
MATRIXX Policy
MATRIXX Kafka CDR Consumer
MATRIXX Pricing and Rating
MATRIXX Pay Now
MATRIXX Subscriber Management
MATRIXX Subscriber Management API
MATRIXX Business API SDK
My MATRIXX Help
MATRIXX Backoffice Customer Tool Help
MATRIXX Third-Party Licenses
Glossary

Configure Apache ActiveMQ for LDAP

To enable the LDAP Gateway to communicate with Apache ActiveMQ, system administrators must configure the LDAP service properties in /opt/mtx/conf/ldap_gateway.yaml file.

Before you begin

Apache ActiveMQ and the Gateway Proxy must be installed.

Procedure

Log into the server as a user with sudo permissions and change to user matrixxsw.
For example:
ssh server_ip_address
sudo su - matrixxsw
Open the /opt/mtx/conf/ldap-gateway.yaml file with a text editor, such as vi.
If this file does not exist, you must create it.
Configure the properties listed in the discussion about LDAP Gateway properties.
Close and save the properties file.

What to do next

The ActiveMQ Gateway must be configured as described in the discussion about ActiveMQ Gateway configuration.

Note: The ActiveMQ Gateway and LDAP Gateway must be configured to use the same Apache ActiveMQ queues.

For more information about configuring the ActiveMQ Gateway, see the discussion about ActiveMQ Gateway configuration in MATRIXX Configuration.