LA ROCCA SOLUTIONS

GL Communications Inc
818 West Diamond Avenue - Third Floor, Gaithersburg, MD 20878
Phone: (301) 670-4784 Fax: (301) 670-9187 Email: gl-info@gl.com
Website: http://www.gl.com

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl-MAPS-SIPI 1

 MAPS™ SIP-I
Message Automation & Protocol Simulation
 Message Automation & Protocol Simulation
 Advanced protocol simulator/tester for SIP-ISUP
over IP.
 Manuale Utente
 Documento No-PKS126-1.4.5-03
 Versione 1.4.5
 Augosto 2011
 SIP Protocol Testing - PKS120

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl-MAPS-SIPI 2 / ..

 MAPS™ SIP-I - ITU Q.1912.5
 Creato per :
 SIP-I Testing – Simuzione
 Signaling Gateway / Softswitch come un User Agents Client
(UAC), che invia richieste SIP con messaggi ISUP e User Agent
Server (UAS), che riceve le richieste come Signaling Gateway /
Softswitch e rispondere a SIP con messaggi appropriati ISUP.
 Questo applicativo può essere usato per simulare interfacce
in una rete ed eseguire test di protocollo (SIPI).
 E’ disponibile come MAPS™ SIP-I (Item # PKS126).
 MAPS™ SIP-I supporta tools come :
 Message Editor, Script Editor & Profile Editor che consente di
creare o modificare scenari utilizzando messaggi SIP-I e
parametri.

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 3 / ..

 SIP-I Testing Features
 Simulare :
 Signaling Gateway, Softswitch come UAC, UAS, nella rete.
 Gestire :
 Ritrasmissioni e Ritrasmissioni Remote.
 Supporta :
 Sia UDP che TCP.
 Generare e processare :
 Messaggi SIP-I validi e invalidi.
 Completamente integrato, ambiente di test completo per SIP-I.
 Castomizzazione completa del flusso e dei messaggi della chiamata.
 Script Call Generation e Call Reception automatico.
 Supporta “Massage Template” per ogni messaggio SIP-I e la castomizzazione dei
valori di ogni campo.
 Funzionalità per la definizione della variabili di ogni campo e per ogni tipo di
messaggio SIP-I.
 Compatibile con sistemi operativi :
 Windows® XP o superiore.

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 4 / ..

 Message Automation & Protocol Simulation

 MAPS™ è un simulatore di protocollo SIP-

ISUP - Over IP.
 Può simulare segnalazione SIP con messaggi
incapsulati ITU/ANSI/ETSI ISUP.
 Il prodotto MAPS™ con SIP-I fornisce solo lato IP
del Gateway.

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 5 / ..

 SIP-I Call Scenario
 Terminale PSTN verso un’altro terminale PSTN attraverso una
rete SIP

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 6 / ..

 Principio di funzionamento MAPS
 Diagramma a Blocchi
 Message Automation & Protocol Simulation

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 7 / ..

 Requisiti Base per la Simulazione
 Struttura dei Messaggi “Message Templates”
 La struttura dei messaggi è salvata in un file di un particolare formato.
 Uno ‘Script’
 Lo script serve per trasmettere (tx) o ricevere (rx) questi messaggi, tra due nodi,
e prendere le azioni appropriate con un particolare messaggio..
 Un meccanismo di ‘Import’
 Un meccanismo di lettura dei contenuti della struttura del messaggio, e di
sostituzione del “Key Identifier” con il valore dato dall’utente, durante
l’esecuzione.
 Questo processo di inserimento del valore utente nella struttura del messaggio
prima della trasmissione si chiama “ Import”.

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 8 / ..

 Requisiti Base per la Simulazione
 Un meccanismo di ‘Export’
 Un meccanismo di estrazione del valore “Key Identifier” dalle risposte
ricevute e memorizzazione del valore per usi futuri (nello stesso
scenario di chiamata).
 Questo meccanismo viene chiamato “Export”
 Può essere importata anche la struttura del messaggio per usi futuri.

 Un file ‘Profile’
 Nel momento in cui il “Key Identifiers” sono stati identificati per tutte
le strutture dei messaggi in uno scenario di chiamata, questi valori di
“Key Identifiers” vengono configurati in un file chiamato “Profile”.

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 9 / ..

 MAPS-Massage Template
 Struttura del Messaggio

Ci sono file *.txt , che sono composti da un certo numero di campi “ Protocol Message “
con dei valori di default. Questi valori possono essere cambiati durante l’esecuzione.

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 10 / ..

 MAPS - Script Editor
 Script – Sequenza di comandi

Scripts comprende una sequenza di comandi per eseguire le operazioni richieste.

Scripts call - struttura predefinita dei messaggi come parte del comando.
Script Editor - consente di creare scripts per simulare scenari in tempo reale.

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 11 / ..

 MAPS-Profile Editor
 Profile – Valori assegnati a dei campi variabili

Profiles – Consiste di valori assegnati alle variabili durante l’esecuzione.

Profile Editor – Consente di definire le variabili che devono essere cambiati durante
l’esecuzione. Message Templates importa questi valori durante l’esecuzione dello script.

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 12 / ..

 Selezione di un Profile
 Profile Editor from Editor to
configure MAPS™ SIP-I
 CallFlow

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 13 / ..

 MAPS-Event Profile Editor
 Event

Event Profiles – consiste di valori assegnati alle variabili durante l’esecuzione.

Event Profile Editor – consente di creare “ Event Profiles “ per user-defined events in
uno script. Il valore nel profilo può essere cambiato durante l’esecuzione dello script.

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 14 / ..

 Configurazione Test Bed
 Opzioni per configurare i parametri e stabilire la connessione tra
MAPS e DUT
 Dopo aver fatto partire il programma MPAS, la prima cosa da
fare è impostare i parametri di base del test in “ Test Bed Setup “.
 Il primo dato è l’indirizzo IP del PC locale – 192.168.1.98.

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 15 / ..

 Simulazione tra A e B
 Chiamata tra A e B
 Quello che vogliamo fare è una simulazione tra
due utenti IP
 A genera la chiamata – Call Generator
 B riceve la chiamata – Call Reception

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 16 / ..

 A – Call Generator
 Selezioniamo Emulator
– Call Generator
 Nel campo “Script
Name” selezioniamo lo
script che vogliamo
eseguire, nel nostro caso
selezioneremo tra gli
scripts esistenti “User
Agent Client”.
 Se premiamo subito start
viene eseguito
immediatamente lo
script.
12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 17 / ..
 A – Call Generator
 Selezioniamo
Emulator – Call
Generator
 Posizionandosi sulla
Chiamata nella finestra
Scripts si può vedere
lo script che è stato
eseguito.

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 18 / ..

 A – Call Generator - Sequence
 Selezioniamo Emulator – Call Generator
 Posizionandosi sulla Chiamata nella finestra “
Message Sequence” si può vedere la sequenza dei
messaggi scambiati.

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 19 / ..

 A – Call Generator - Profile
 Selezioniamo Editor - Profile
 Il Profile determina quali valori
vengono inseriti nelle intestazioni
dei messaggi dello scripts.
 Se proviamo ad aprire il profilo
“UA_IPV4_Profile.

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 20 / ..

 A – Call Generator - Profile
 Profile
UA_IPV4_Prof
ile
 In questo caso
l’indirizzo IP
192.168.30.102,
chiama (Tx-
Trasmette)
l’indirizzo IP
192.168.30.03
risponde (Rx-
Riceve)
12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 21 / ..
 A – Call Generator - Script
 Quello che determina
come/quando inviare i
messaggi è lo script.
 Esempio di Scripts
 UserAgentClient
 Troviamo tutti i comportamenti
del nostro simulatore durante la
generazione della chiamata.
 Questo script è la base per poter
inviare una chiamata.
 Call Gen – UserAgentClient
 Profile01 – Ip-Addr
 Save Profile
 Stop test
 Start test
12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 22 / ..
 Load/Save Configurazione Master
 Save Master Configuration
 Salva tutte le finestre Info
 Call Generation
 Incoming Call Handler
 Load Generation …. .
 Load Master Configuration
 Carica le configurazioni
precedentemente salvate.

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 23 / ..

 Incoming Call Handler Call Reception
 Per ricevere le
chiamate, gli script
devono essere
configurati, per poter
ricevere i messaggi
nella finestra “
Incoming Call
Handler
Configuration.

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 24 / ..

 Configurazioni

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 25 / ..

 Call Generation – GUI Funzioni
 Simulazione comunicazioni uscenti,
con messaggi configurati con Scripts
e Profiles.
 Il profilo cambia necessariamente del
controllo dei messaggi della chiamata
durante l’esecuzione.
 GUI :
 Script Name, Profile, Call Info, Status,
Events, Risultati e Statistiche, con una facile
visualizzazione degli scripts che sono stati
eseguiti.
 Visualizzazione “Call Flow “ del
flusso dei messaggi della chiamata con
la decodifica di tutti i messaggi
trasmessi e ricevuti.

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 26 / ..

 SIP-I Call Scenario - Generation

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 27 / ..

 Call Reception – GUI funzioni
 Esecuzione di Trigger sulla ricezione
di particolari messaggi.
 Per ricevere le chiamate, gli scripts devono
essere configurati in funzione dei
messaggi ricevuti.
 Processare i messaggi ricevuti in
funzione delle specifiche impostate
negli scripts.
 Nel momento in cui la chiamata è
stata instaurata, la chiamata viene
visualizzata automaticamente nella
finestra Call Reception.
 Fornire i risultati del test, con
decodifica dettagliata del protocollo
e visualizzazione grafica.

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 28 / ..

 SIP-I Call Scenario - Reception
 Per ricevere le chiamate, gli scripts vengono configurati per poter
ricevere i messaggi utilizzando “ Script Configuration window”,
 “Call Reception” attende messaggi entranti e risponde con i
camandi corrispondenti.

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 29 / ..

 SIP-I Call Scenario - Reception

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 30 / ..

 SIP-I Call Scenario - Reception
 Scripts :
UserAgentServer_GL
 Script
 Message Sequence
 Event Config
 Script Flow

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 31 / ..

 SIP-I Call – Reception Profile
 Profilo Call Reception
 Nel file profili
“UA_IPV4_Profiles”, si
trova anche la parte che
riguarda i parametri per la
“Call Reception”.
 Il primo numero da
impostare è ovviamente
l’indirizzo a cui bisogna
rispondere, il resto potrebbe
rimanere invariato.
 E’ l’indirizzo dalla macchina
ricevente.
12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 32 / ..
12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 33 / ..
12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 34 / ..
12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 35 / ..
12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 36 / ..
12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 37 / ..
 Struttura dei Messaggi

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 38 / ..

 Messaggio - Invite
 Invite

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 39 / ..

 Script Editor

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 40 / ..

 Script Editor
 Script Editor
 Event Driven Script
Execution
 Execution of the
Script in the
MAPS™ is based on
the Events
 Message Received
 User events
 Timer Expiry -
Retxmit Timeout,
Receive Message
Timeout
 ……

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 41 / ..

 Profile Editor
 Profile

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 42 / ..

 SIP Call Flow Scenario

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 43 / ..

 Testing over VoIP
 SIP Call Flow
 Può essere implementato il seguente script …

MAPS DUT
MAPS DUT
Invite

200 OK

ACK

BYE

200 OK

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 44 / ..

 MAPS™ - SIP
 Script - CallFlow

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 45 / ..

 Configurazioni
 I messaggi sono dei file testo *.txt

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 46 / ..

Invite
Parametri generati da MAPS in real time
Profile Importazione: Importa i valori di configurazione dal
Profilo per la struttura del messaggio Invite e la
struttura del messaggio Invite uscente

Messaggio Outgoing ‘Invite’

Import Profile

Buffer
Action: send "Invite" IpAddress port
….; D
Run Script
U
T
MAPS™

‘Invite’ Message Template

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 47 / ..

200 OK

Export: esportazione valori di configurazione da

messaggi entranti

Buffer Totag = GLPG_707644080-5177

Rcontact = 0001
<sip:0001@192.168.1.192

Action: recv "200OK" wait recvwaitTime msec stop T1;

D
Run Script
U
T
MAPS™

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 48 / ..

 ACK Import: Importazione valori di configurazione dal Profilo dal template
del messaggio Invite alla forma del messaggio Invite uscente
Parametri generati da MAPS in tempo reale

ToTag exported from 200 Ok is sent in Ack

Buffer ToTag = GLPG_707644080-5177

Rcontact = 0001 Outgoing ‘ACK’ Message
sip:0001@192.168.1.192>
Action: send “Ack" …
IpAddress port …; D
Run Script
U
T
MAPS™

‘Invite’ Message Template

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 49 / ..

Bye Import: Importing configuration values from Profile to Invite
Message template to form Outgoing Invite message
Parametri generati da MAPS durante l’esecuzione
ToTag esportato da 200 Ok è inviata in in Ack

New BranchId and Cseq is generated by Maps for Bye Message

GLPG_707644080-5177
Buffer
0001 sip:0001@192.168.1.192> Outgoing ‘BYE’ Message
…
Action: send “Bye_uac" IpAddress port
…; D
U
Run Script

MAPS™
T

‘Invite’ Message Template

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 50 / ..

 200 OK

Buffer SIP/2.0 200 OK

SIP/2.0 200 OK
Via: SIP/2.0/UDP 192.168.1.10;branch=z9hG4bK_1812560024-1628

D
Action: recv "200OK" wait recvwaitTime msec stop Via: SIP/2.0/UDP 192.168.1.10;branch=z9hG4bK_1812560024-1628
From: sip:0001@192.168.1.10;tag=FromTag_1809764024-1626
T1; From: sip:0001@192.168.1.10;tag=FromTag_1809764024-1626
To: sip:0001@192.168.1.20;tag=GLPG_1817889024-4336
To: sip:0001@192.168.1.20;tag=GLPG_1817889024-4336
Call-ID: ProtScriptId_1809748024-1624

U
Call-ID: ProtScriptId_1809748024-1624
CSeq: 101 BYE
CSeq: 101 BYE
Contact: 0001 <sip:0001@192.168.1.20>
Contact: 0001 <sip:0001@192.168.1.20>
Run Script Allow:

T
Allow:
INVITE,BYE,CANCEL,ACK,INFO,PRACK,COMET,OPTIONS,SUBSCRIBE,
INVITE,BYE,CANCEL,ACK,INFO,PRACK,COMET,OPTIONS,SUBSCRIBE,
NOTIFY,REGISTER,UPDATE
NOTIFY,REGISTER,UPDATE
Content-Length: 0
MAPS™ Content-Length: 0

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 51 / ..

 Reports

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 52 / ..

 GL Dongle
 Serial # - Informazioni con il programma “ Haspinfo.exe “
 1C648880 – MPAS – SIPI / SIP
 4EE9C434 - PacketScan
 7542E10F - PacketGen
 Ogni Dongle ha un numero di serie.
 File da inserire è “extension.enc ”.
 C:\Programmi\GL Communications\GLDongle
 Data di scadenza 16/11/2012.

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 53 / ..

 Lista delle Applicazioni
 SIP, MEGACO, MGCP, TDM,
RTP
 Programmi installati sono :
 PacketScan
 MAPS-SIP I
Part # Description
PKS120 MAPS™ - SIP
PKS121 MAPS™ – SIP Conform. Test Suite
PKS122 MAPS™ - MEGACO
PKS123 MAPS™ – MEGACO Conform. Test Suite
PKS124 MAPS™ - MGCP
PKS125 MAPS™ - MGCP Conf. Suite (Test Scripts)
PKS150 TDM / VoIP Gateway
PKS102 RTP Traffic Option

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl – MAPS-SIPI 54 / ..

 LA ROCCA SOLUTIONS
FINE

Grazie

GL Communications Inc
818 West Diamond Avenue - Third Floor, Gaithersburg, MD 20878
Phone: (301) 670-4784 Fax: (301) 670-9187 Email: gl-info@gl.com
Website: http://www.gl.com

12/22/2021 Amerigo Masiani - 347 5749322 - La Rocca Solutions Srl 55