SS7 MAP / Gateway-MSC Configuration
Configuration for HLR queries to retrieve MSRN (roaming numbers) and call forwarding information via SS7 MAP.
Related Documentation
Core Documentation
- 📋 Main README - Overview and quick start
- 🔧 Configuration Guide - SS7 MAP configuration (
ss7_mapparameters) - 🔧 Operations Guide - HLR/MAP testing in Control Panel
Call Processing Integration
- 🔀 Dialplan Configuration - Using MSRN and forwarded_to_number in dialplan routing
- ⚙️ Supplementary Services - HLR-based call forwarding (alternative to Sh/MMTel)
- 👥 Sh Interface - Sh vs MAP data priority
- 🔢 Number Translation - Number format for HLR queries
Testing & Monitoring
- 🧪 HLR & Call Simulator - Testing HLR/MAP integration
- 📊 Metrics Reference - HLR/MAP query metrics
Gateway-MSC Configuration
The TAS can query an HLR to retrieve the roaming number (MSRN) or MSC when a subscriber is roaming on 2G/3G networks, and can also retrieve call forwarding information.
This will set the msrn or forwarded_to_number dialplan variables which can then be used to route the call appropriately.
Configuration Parameters:
enabled- Enable/disable SS7 MAP functionalityhttp_map_server_url_base- Base URL of the MAP gateway HTTP APIgmsc- Gateway MSC address used for SRI/PRN queriestimeout_ms- HTTP timeout for MAP operations in milliseconds (default: 5000)
config :tas,
...
ss7_map: %{
enabled: true,
http_map_server_url_base: "http://10.5.1.216:8080",
gmsc: "55512411506",
timeout_ms: 5000 # Optional, defaults to 5000ms
},
Functionality: The TAS performs SRI (Send Routing Information) and handles routing based on the following priority:
- Call Forwarding Active - If the SRI response contains a forwarded number, it is treated as an MSRN (no PRN is performed). The forwarded number is set in the
msrnvariable and used for routing. - Roaming (2G/3G) - If the subscriber is roaming (VLR present) and no call forwarding is active, performs PRN (Provide Roaming Number) to get the MSRN for routing to the V-MSC
- Normal - If neither forwarding nor roaming applies, the call proceeds with standard routing
The msrn and tas_destination_number dialplan variables are set appropriately for routing (either from PRN or from the forwarded number)