Da DexWiki.

E' possibile configurare Dexgate per utilizzare connettività VoIP fornita da alcuni operatori. Con questo sistema è possibile telefonare evitando l'impegno della rete telefonica tradizionale.

Indice 1 Provider VoipVoice - novità 1.1 Creazione e configurazione del trunk 1.1.1 Esempio di configurazione di un trunk per la registrazione su VoipVoice 1.2 Verifica dello stato del trunk VoipVoice 1.3 Settaggio Regola chiamata in uscita 1.4 Creazione della regola di redirezione numero esterno 2 Provider Eutelia 2.1 Creazione e configurazione del trunk 2.1.1 Esempio di configurazione di un trunk per la registrazione su Eutelia 2.2 Verifica dello stato del trunk Eutelia 2.3 Settaggio Regola chiamata in uscita 2.4 Creazione della regola di redirezione numero esterno 3 Provider Messagenet 3.1 Creazione e configurazione del trunk 3.1.1 Esempio di configurazione di un trunk per la registrazione su Messagenet 3.2 Verifica dello stato del trunk messagenet 3.3 Settaggio Regole Uscita 3.4 Creazione della regola di redirezione numero esterno 4 Unidata 4.1 Modifica del file di configurazione jswitch.properties 4.2 Settaggio delle Linee uscita gateway 4.3 Creazione di una regola URI personalizzata 4.4 Creazione della regola di redirezione numero esterno

Provider VoipVoice - novità

Creazione e configurazione del trunk

Da interfaccia web del Dexgate accedendo a Gestione->Gestione numeri->Gestione dei trunk-> Aggiungi si presenta la seguente schermata:

In questa schermata si deve indicare:

• Il nome del trunk (sono ammessi solo caratteri alfanumerici quindi si raccomanda di non utilizzare caratteri come "." oppure "_")
• Il numero di porta su cui il Dexgate sarà in ascolto
• Il tipo di trunk "Account Voip".
  

Ipotizziamo che VoipVoice vi abbia assegnato il seguente account:

   * Numero telefonico geografico: 0550998877
   * User (coincide con il numero geografico): 0550998877
   * Password: 123pass456 
   * Sip Domain: sip.voipvoice.it
   * Proxy Server: sip.voipvoice.it
   * Proxy Socket: 5060
   * Stun Server: stun.voipvoice.it

Dovremo modificare le seguenti linee nalla configurazione del trunk:

• Il parametro registrar.name che verrà settato con l'identificativo del client SIP dell'account a noi assegnato da VoipVoice(in questo caso 0550998877)
• Il parametro registrar.password che verrà settato con la password dell'account a noi assegnato da VoipVoice(in questo caso 123pass456)
• Il parametro callernumber.default che deve essere settato uguale al numero geografico assegnato (in questo caso 0550998877)
• E' consigliabile settare il parametro stun.address con lo Stun Server di VoipVoice: stun.voipvoice.it
• Opzionalmente, i parametri stun.backup.address e stun.backup2.address che andranno valorizzati con gli indirizzi di eventuali stun server di backup. Nel caso non si voglia valorizzare uno o entrambi questi campi, lasciare commentata la riga corrispondente e quella del relativo parametro porta: stun.backup.port e stun.backup2.port.

Opzionalmente si possono configurare anche i seguenti parametri:

• Public address: si usa nel caso in cui si abbia un ip pubblico statico e il router non faccia port forwarding; settando un ip statico non è più necessario interrogare lo stun server. Quindi in questo caso le proprietà relative allo stun server devono essere commentate.
  

Esempio di configurazione del public address:
channels.phone.jswitch.trunks.trunk-voipvoice.public.address=***.***.***.***

• Numero massimo di risorse sul trunk: se il provider permette di avere più di una chiamata in contemporanea per account, si può abiliare max.resources che limita il numero di chiamate contemporanee per trunk al valore specificato
  Per l'abilitazione si devono scommentare le due righe relative al max.resources, abilitando e inserendo il numero massimo di risorse (ad esempio 3). Il file di configurazione sarà così definito:
  channels.phone.jswitch.trunks.trunk-voipvoice.max.resources.enable=yes
channels.phone.jswitch.trunks.trunk-voipvoice.max.resources.number=4
• Il range di porte utilizzate dal trunk: la loro conoscenza e' necessaria per l'apertura delle porte sul firewall aziendale. Nel caso non vi siano problemi di firewall lasciare commentate le proprieta'

channels.phone.jswitch.trunks.trunk-voipvoice.rtp.port.enable=yes
channels.phone.jswitch.trunks.trunk-voipvoice.rtp.port.min=*****
channels.phone.jswitch.trunks.trunk-voipvoice.rtp.port.max=*****

altrimenti basta scommentare tali righe ed impostare il range opportuno di porte da usare indicando il valore minimo e massimo. Le porte corrispondenti, oltre a quella su cui abbiamo messo in ascolto il trunk (nell'esempio, la 4061) dovranno essere aperte sul firewall e routate internamente verso Dexgate

Esempio di configurazione di un trunk per la registrazione su VoipVoice

Nell'esempio utilizzeremo :

• Nome del trunk voipvoice in ascolto sulla porta 4061
• Lo stun server e non l'indirizzo pubblico
• Un numero massimo di chiamate sul trunk pari a 4
• Un range di porte rtp fra 16000 e 16012 (NOTA: per ogni chiamata contemporanea vengono utilizzate 3 porte rtp, quindi il range di porte dovra' avere ampiezza almeno tripla rispetto al numero di chiamate contemporanee che si vogliono poter effettuare sul trunk)

Si configura quindi il trunk in questo modo:

# Trunk gateway voip voipvoice
channels.phone.jswitch.trunks.trunk-voipvoice.classname=it.tradesoft.tegate.channels.CorbaChannel.jswitch.trunks.sip.SipTrunk
channels.phone.jswitch.trunks.trunk-voipvoice.port=4061
channels.phone.jswitch.trunks.trunk-voipvoice.stun.enable=yes
channels.phone.jswitch.trunks.trunk-voipvoice.stun.ttl=20
channels.phone.jswitch.trunks.trunk-voipvoice.stun.address=stun.voipvoice.it
channels.phone.jswitch.trunks.trunk-voipvoice.stun.port=3478
#channels.phone.jswitch.trunks.trunk-voipvoice.stun.backup.address=stun.fwdnet.net
#channels.phone.jswitch.trunks.trunk-voipvoice.stun.backup.port=3478
#channels.phone.jswitch.trunks.trunk-voipvoice.stun.backup2.address=stun.voxgratia.it
#channels.phone.jswitch.trunks.trunk-voipvoice.stun.backup2.port=3478
channels.phone.jswitch.trunks.trunk-voipvoice.stun.address.detector.enable=yes
channels.phone.jswitch.trunks.trunk-voipvoice.stun.address.detector.port=4161
channels.phone.jswitch.trunks.trunk-voipvoice.stun.address.detector.ttl=60
channels.phone.jswitch.trunks.trunk-voipvoice.callernumber.default=0550998877
channels.phone.jswitch.trunks.trunk-voipvoice.registrar.enable=yes
channels.phone.jswitch.trunks.trunk-voipvoice.registrar.domain=sip.voipvoice.it
channels.phone.jswitch.trunks.trunk-voipvoice.registrar.name=0550998877
channels.phone.jswitch.trunks.trunk-voipvoice.registrar.password=123pass456
channels.phone.jswitch.trunks.trunk-voipvoice.registrar.address=sip.voipvoice.it
channels.phone.jswitch.trunks.trunk-voipvoice.registrar.port=5060
channels.phone.jswitch.trunks.trunk-voipvoice.registrar.refresh=60
channels.phone.jswitch.trunks.trunk-voipvoice.checkbusytable=no
channels.phone.jswitch.trunks.trunk-voipvoice.limbo.enable=yes
channels.phone.jswitch.trunks.trunk-voipvoice.limbo.time=2000
channels.phone.jswitch.trunks.trunk-voipvoice.video.enable=no

## COMMENTARE / DECOMMENTARE LA COPPIA DI LINEE SOTTOSTANTI A SECONDA DEL CODEC SCELTO ##
channels.phone.jswitch.trunks.trunk-voipvoice.codecs.0.classname=it.tradesoft.tegate.rtp.codecs.alaw
channels.phone.jswitch.trunks.trunk-voipvoice.dtmf=sipinfo
#channels.phone.jswitch.trunks.trunk-voipvoice.codecs.0.classname=it.tradesoft.tegate.rtp.codecs.g729FixedPacket2
#channels.phone.jswitch.trunks.trunk-voipvoice.dtmf=rfc2833

channels.phone.jswitch.trunks.trunk-voipvoice.sessionprogress.ignoring=yes
channels.phone.jswitch.trunks.trunk-voipvoice.sessionprogress.connect=yes
channels.phone.jswitch.trunks.trunk-voipvoice.response4xx.action=REMOTE_BUSY
channels.phone.jswitch.trunks.trunk-voipvoice.max.resources.enable=yes
channels.phone.jswitch.trunks.trunk-voipvoice.max.resources.number=4
channels.phone.jswitch.trunks.trunk-voipvoice.rtp.port.enable=yes
channels.phone.jswitch.trunks.trunk-voipvoice.rtp.port.min=16000
channels.phone.jswitch.trunks.trunk-voipvoice.rtp.port.max=16012

Inoltre fare attenzione che non vi siano altri trunk in ascolto sulla stessa porta (indicata dal parametro port) del trunk VoipVoice appena settato e che il range di porte eventualmente riservato ad un trunk non si sovrapponga al range di altri trunk. Cambiare il numero di porta nel caso sia già utilizzato da qualche altro trunk.

Verifica dello stato del trunk VoipVoice

Effettuando l'accesso via web al Dexgate come amministratore si accede in Gestione->Gestione numeri->Gestione dei trunk. Se non ci sono errori nella configurazione del trunk appena creato e il provider ha accettato la registrazione apparirà una schermata come questa sotto:

La riga relativa al trunk VoipVoice indica che siamo registrati.

Settaggio Regola chiamata in uscita

Vediamo ora come creare una regola per chiamare con il trunk VoipVoice appena creato.
Cliccando su Gestione->Gestione numeri->Regole chiamate in uscita compare una tabella con i prefissi utilizzati per chiamare sui vari trunk.
Cliccando su Aggiungi regola chiamate in uscita possiamo aggiungere un nuovo prefisso relativo al trunk VoipVoice.
Supponiamo di voler uscire con VoipVoice con il prefisso 0, aggiungiamo i dati nella form così come mostrato nella seguente immagine:

Clicchiamo quindi su "Esegui"
La schermata successiva permette di associare al prefisso precedentemente indicato un trunk di uscita. Per VoipVoice configurare la regola come da figura (in particolare come dominio inserire sip.voipvoice.it):

Creazione della regola di redirezione numero esterno

Immaginiamo a questo punto di voler indirizzare verso un certo interno, IVR o numero di gruppo ogni chiamata entrante dall'esterno sul trunk VoipVoice (destinata cioè al nostro numero geografico 0550998877) e supponiamo che tale numero sia il 100.

In “Gestione numeri” cliccare sul link "Regole chiamate in ingresso" (nelle versioni di Dexgate meno recenti cliccare su “Lista numeri esterni rediretti”), quindi su “Redirigi numero esterno” e creare una nuova redirezione come mostrato di seguito:

Cliccare su “Esegui” per salvare le impostazioni.

A questo punto si è pronti per utilizzare il nostro account VoipVoice con il Dexgate

In particolare, da qualunque terminale SIP registrato sul trunk interno “tegate” del Dexgate si può utilizzare il trunk VoipVoice premettendo al numero da chiamare il prefisso '0' (oppure un altro prefisso scelto nella regola di uscita) e nel contempo saremo in grado d'indirizzare ogni chiamata diretta al nostro numero geografico 0550998877 verso un terminale, un numero di gruppo o un IVR di nostra scelta.

Provider Eutelia

Creazione e configurazione del trunk

Da interfaccia web del Dexgate accedendo a Gestione->Gestione numeri->Gestione dei trunk-> Aggiungi si presenta la seguente schermata:

In questa schermata si deve indicare:

• Il nome del trunk (sono ammessi solo caratteri alfanumerici quindi si raccomanda di non utilizzare caratteri come "." oppure "_")
• Il numero di porta su cui il Dexgate sarà in ascolto
• Il tipo di trunk "Account Voip".
  

Ipotizziamo che Eutelia ci abbia assegnato il seguente account:

   * Numero telefonico geografico: 02999888777
   * Account utente (coincide con il numero geografico): 02999888777
   * Password: 123pass456 
   * Dominio: voip.eutelia.it
   * Sip proxy server: voip.eutelia.it
   * Sip proxy socket: 5060

Dovremo modificare le seguenti linee nalla configurazione del trunk:

• Il parametro registrar.name che verrà settato con l'identificativo del client SIP dell'account a noi assegnato da Eutelia (in questo caso 02999888777)
• Il parametro registrar.password che verrà settato con la password dell'account a noi assegnato da Eutelia (in questo caso 123pass456)
• Il parametro callernumber.default che deve essere settato uguale al numero geografico assegnato (in questo caso 02999888777)
• Opzionalmente, i parametri stun.backup.address e stun.backup2.address che andranno valorizzati con gli indirizzi di eventuali stun server di backup. Nel caso non si voglia valorizzare uno o entrambi questi campi, lasciare commentata la riga corrispondente e quella del relativo parametro porta: stun.backup.port e stun.backup2.port.

Opzionalmente si possono configurare anche i seguenti parametri:

• Public address: si usa nel caso in cui si abbia un ip pubblico statico e il router non faccia port forwarding; settando un ip statico non è più necessario interrogare lo stun server. Quindi in questo caso le proprietà relative allo stun server devono essere commentate.
  

Esempio di configurazione del public address:
channels.phone.jswitch.trunks.trunk-Eutelia.public.address=***.***.***.***

• Numero massimo di risorse sul trunk: se il provider permette di avere più di una chiamata in contemporanea per account, si può abiliare max.resources che limita il numero di chiamate contemporanee per trunk al valore specificato
  Per l'abilitazione si devono scommentare le due righe relative al max.resources, abilitando e inserendo il numero massimo di risorse (ad esempio 3). Il file di configurazione sarà così definito:
  channels.phone.jswitch.trunks.trunk-Eutelia.max.resources.enable=yes
channels.phone.jswitch.trunks.trunk-Eutelia.max.resources.number=3
• Il range di porte utilizzate dal trunk: la loro conoscenza e' necessaria per l'apertura delle porte sul firewall aziendale. Nel caso non vi siano problemi di firewall lasciare commentate le proprieta'

channels.phone.jswitch.trunks.trunk-Eutelia.rtp.port.enable=yes
channels.phone.jswitch.trunks.trunk-Eutelia.rtp.port.min=*****
channels.phone.jswitch.trunks.trunk-Eutelia.rtp.port.max=*****

altrimenti basta scommentare tali righe ed impostare il range opportuno di porte da usare indicando il valore minimo e massimo. Le porte corrispondenti, oltre a quella su cui abbiamo messo in ascolto il trunk (nell'esempio, la 4005) dovranno essere aperte sul firewall e routate internamente verso Dexgate

Esempio di configurazione di un trunk per la registrazione su Eutelia

Nell'esempio utilizzeremo :

• Nome del trunk Eutelia in ascolto sulla porta 4005
• Lo stun server e non l'indirizzo pubblico
• Un numero massimo di chiamate sul trunk pari a 3
• Un range di porte rtp fra 10000 e 10009 (NOTA: per ogni chiamata contemporanea vengono utilizzate 3 porte rtp, quindi il range di porte dovra' avere ampiezza almeno tripla rispetto al numero di chiamate contemporanee che si vogliono poter effettuare sul trunk)

Si configura quindi il trunk in questo modo:

# Trunk gateway voip Eutelia
channels.phone.jswitch.trunks.trunk-Eutelia.classname=it.tradesoft.tegate.channels.CorbaChannel.jswitch.trunks.sip.SipTrunk
channels.phone.jswitch.trunks.trunk-Eutelia.port=4005
#channels.phone.jswitch.trunks.trunk-Eutelia.public.address=****
channels.phone.jswitch.trunks.trunk-Eutelia.stun.enable=yes
channels.phone.jswitch.trunks.trunk-Eutelia.stun.ttl=20
channels.phone.jswitch.trunks.trunk-Eutelia.stun.address=stun.voip.eutelia.it
channels.phone.jswitch.trunks.trunk-Eutelia.stun.port=3478
channels.phone.jswitch.trunks.trunk-Eutelia.stun.backup.address=stun.xten.com
channels.phone.jswitch.trunks.trunk-Eutelia.stun.backup.port=3478
channels.phone.jswitch.trunks.trunk-Eutelia.stun.backup2.address=stun.voxgratia.org
channels.phone.jswitch.trunks.trunk-Eutelia.stun.backup2.port=3478
channels.phone.jswitch.trunks.trunk-Eutelia.stun.address.detector.enable=yes
channels.phone.jswitch.trunks.trunk-Eutelia.stun.address.detector.port=4105
channels.phone.jswitch.trunks.trunk-Eutelia.stun.address.detector.ttl=60
channels.phone.jswitch.trunks.trunk-Eutelia.callernumber.default=02999888777
channels.phone.jswitch.trunks.trunk-Eutelia.registrar.enable=yes
channels.phone.jswitch.trunks.trunk-Eutelia.registrar.domain=voip.eutelia.it
channels.phone.jswitch.trunks.trunk-Eutelia.registrar.name=02999888777
channels.phone.jswitch.trunks.trunk-Eutelia.registrar.password=123pwd123
channels.phone.jswitch.trunks.trunk-Eutelia.registrar.address=voip.eutelia.it
channels.phone.jswitch.trunks.trunk-Eutelia.registrar.port=5060
channels.phone.jswitch.trunks.trunk-Eutelia.registrar.refresh=60
channels.phone.jswitch.trunks.trunk-Eutelia.checkbusytable=no
channels.phone.jswitch.trunks.trunk-Eutelia.limbo.enable=yes
channels.phone.jswitch.trunks.trunk-Eutelia.limbo.time=1000
channels.phone.jswitch.trunks.trunk-Eutelia.video.enable=no
channels.phone.jswitch.trunks.trunk-Eutelia.codecs.0.classname=it.tradesoft.tegate.rtp.codecs.gsm
channels.phone.jswitch.trunks.trunk-Eutelia.codecs.1.classname=it.tradesoft.tegate.rtp.codecs.alaw
channels.phone.jswitch.trunks.trunk-Eutelia.sessionprogress.ignoring=yes
channels.phone.jswitch.trunks.trunk-Eutelia.sessionprogress.connect=yes
channels.phone.jswitch.trunks.trunk-Eutelia.response4xx.action=REMOTE_BUSY
channels.phone.jswitch.trunks.trunk-Eutelia.max.resources.enable=yes
channels.phone.jswitch.trunks.trunk-Eutelia.max.resources.number=3
channels.phone.jswitch.trunks.trunk-Eutelia.rtp.port.enable=yes
channels.phone.jswitch.trunks.trunk-Eutelia.rtp.port.min=10000
channels.phone.jswitch.trunks.trunk-Eutelia.rtp.port.max=10009

Inoltre fare attenzione che non vi siano altri trunk in ascolto sulla stessa porta (indicata dal parametro port) del trunk Eutelia appena settato e che il range di porte eventualmente riservato ad un trunk non si sovrapponga al range di altri trunk. Cambiare il numero di porta nel caso sia già utilizzato da qualche altro trunk.

Verifica dello stato del trunk Eutelia

Effettuando l'accesso via web al Dexgate come amministratore si accede in Gestione->Gestione numeri->Gestione dei trunk. Se non ci sono errori nella configurazione del trunk appena creato e il provider ha accettato la registrazione apparirà una schermata come questa sotto:

La riga relativa al trunk eutelia indica che siamo registrati.

Settaggio Regola chiamata in uscita

Vediamo ora come creare una regola per chiamare con il trunk Eutelia appena creato.
Cliccando su Gestione->Gestione numeri->Regole chiamate in uscita compare una tabella con i prefissi utilizzati per chiamare sui vari trunk.
Cliccando su Aggiungi regola chiamate in uscita possiamo aggiungere un nuovo prefisso relativo al trunk Eutelia.
Supponiamo di voler uscire con Eutelia con il prefisso 0, aggiungiamo i dati nella form così come mostrato nella seguente immagine:

Clicchiamo quindi su "Esegui"
La schermata successiva permette di associare al prefisso precedentemente indicato un trunk di uscita. Per Eutelia configurare la regola come da figura (in particolare come dominio inserire voip.eutelia.it):

Creazione della regola di redirezione numero esterno

Immaginiamo a questo punto di voler indirizzare verso un certo interno, IVR o numero di gruppo ogni chiamata entrante dall'esterno sul trunk Eutelia (destinata cioè al nostro numero geografico 02999888777) e supponiamo che tale numero sia il 100.

In “Gestione numeri” cliccare sul link "Regole chiamate in ingresso" (nelle versioni di Dexgate meno recenti cliccare su“Lista numeri esterni rediretti”), quindi su “Redirigi numero esterno” e creare una nuova redirezione come mostrato di seguito:

Cliccare su “Esegui” per salvare le impostazioni.

A questo punto si è pronti per utilizzare il nostro account Eutelia con il Dexgate

In particolare, da qualunque terminale SIP registrato sul trunk interno “tegate” del Dexgate si può utilizzare il trunk Eutelia premettendo al numero da chiamare il prefisso '0' (oppure un altro prefisso scelto nella regola di uscita) e nel contempo saremo in grado d'indirizzare ogni chiamata diretta al nostro numero geografico 02999888777 verso un terminale, un numero di gruppo o un IVR di nostra scelta.

Provider Messagenet

Creazione e configurazione del trunk

Da interfaccia web del Dexgate accedendo a Gestione->Gestione numeri->Gestione dei trunk-> Aggiungi si presenta la seguente schermata:

In questa schermata si deve indicare:

• Il nome del trunk (sono ammessi solo caratteri alfanumerici quindi si raccomanda di non utilizzare caratteri come "." oppure "_")
• Il numero di porta su cui il Dexgate sarà in ascolto
• Il tipo di trunk "Account Voip".
  

Ipotizziamo che Messagenet ci abbia assegnato il seguente account:

   * Numero telefonico geografico: 02111222
   * Account utente (non coincide con il numero geografico): 555666
   * Password: 123pass456 
   * Dominio: sip.messagenet.it
   * Sip proxy server: sip.messagenet.it
   * Sip proxy socket: 5061

Dovremo modificare le seguenti linee nalla configurazione del trunk:

• Il parametro registrar.name che verrà settato con l'identificativo del client SIP dell'account a noi assegnato da Messagenet (in questo caso 02111222)
• Il parametro registrar.password che verrà settato con la password dell'account a noi assegnato da Messagenet (in questo caso 123pass456)
• Il parametro callernumber.default che, per MESSAGENET, DEVE ESSERE SETTATO con l'identificativo del client SIP dell'account a noi assegnato da Messagenet (in questo caso 555666)
• Opzionalmente, i parametri stun.backup.address e stun.backup2.address che andranno valorizzati con gli indirizzi di eventuali stun server di backup. Nel caso non si voglia valorizzare uno o entrambi questi campi, lasciare commentata la riga corrispondente e quella del relativo parametro porta: stun.backup.port e stun.backup2.port.

Opzionalmente si possono configurare anche i seguenti parametri:

• Public address: si usa nel caso in cui si abbia un ip pubblico statico e il router non faccia port forwarding; settando un ip statico non è più necessario interrogare lo stun server. Quindi in questo caso le proprietà relative allo stun server devono essere commentate.
  

Esempio di configurazione del public address:
channels.phone.jswitch.trunks.trunk-messagenet.public.address=***.***.***.***

• Numero massimo di risorse sul trunk: se il provider permette di avere più di una chiamata in contemporanea per account, si può abiliare max.resources che limita il numero di chiamate contemporanee per trunk al valore specificato
  Per l'abilitazione si devono scommentare le due righe relative al max.resources, abilitando e inserendo il numero massimo di risorse (ad esempio 3). Il file di configurazione sarà così definito:
  channels.phone.jswitch.trunks.trunk-messagenet.max.resources.enable=yes
channels.phone.jswitch.trunks.trunk-Messagenet.max.resources.number=3
• Il range di porte utilizzate dal trunk: la loro conoscenza e' necessaria per l'apertura delle porte sul firewall aziendale. Nel caso non vi siano problemi di firewall lasciare commentate le proprieta'

channels.phone.jswitch.trunks.trunk-messagenet.rtp.port.enable=yes
channels.phone.jswitch.trunks.trunk-messagenet.rtp.port.min=*****
channels.phone.jswitch.trunks.trunk-messagenet.rtp.port.max=*****

altrimenti basta scommentare tali righe ed impostare il range opportuno di porte da usare indicando il valore minimo e massimo. Le porte corrispondenti, oltre a quella su cui abbiamo messo in ascolto il trunk (nell'esempio, la 4006) dovranno essere aperte sul firewall e routate internamente verso Dexgate

Esempio di configurazione di un trunk per la registrazione su Messagenet

Nell'esempio utilizzeremo :

• Nome del trunk MESSAGENET in ascolto sulla porta 4005
• Lo stun server e non l'indirizzo pubblico
• Un numero massimo di chiamate sul trunk pari a 3
• Un range di porte rtp fra 10010 e 10019 (NOTA: per ogni chiamata contemporanea vengono utilizzate 3 porte rtp, quindi il range di porte dovra' avere ampiezza almeno tripla rispetto al numero di chiamate contemporanee che si vogliono poter effettuare sul trunk)

Si configura quindi il trunk in questo modo:

## Trunk Provider Messagenet
channels.phone.jswitch.trunks.trunk-messagenet.classname=it.tradesoft.tegate.channels.CorbaChannel.jswitch.trunks.sip.SipTrunk
channels.phone.jswitch.trunks.trunk-messagenet.port=4006
#channels.phone.jswitch.trunks.trunk-messagenet.public.address=****
channels.phone.jswitch.trunks.trunk-messagenet.stun.enable=yes
channels.phone.jswitch.trunks.trunk-messagenet.stun.ttl=20
channels.phone.jswitch.trunks.trunk-messagenet.stun.address=stun.voip.eutelia.it
channels.phone.jswitch.trunks.trunk-messagenet.stun.port=3478
channels.phone.jswitch.trunks.trunk-messagenet.stun.backup.address=stun.xten.com
channels.phone.jswitch.trunks.trunk-messagenet.stun.backup.port=3478
#channels.phone.jswitch.trunks.trunk-messagenet.stun.backup2.address=****
#channels.phone.jswitch.trunks.trunk-messagenet.stun.backup2.port=3478
channels.phone.jswitch.trunks.trunk-messagenet.stun.address.detector.enable=yes
channels.phone.jswitch.trunks.trunk-messagenet.stun.address.detector.port=4106
channels.phone.jswitch.trunks.trunk-messagenet.stun.address.detector.ttl=20
channels.phone.jswitch.trunks.trunk-messagenet.callernumber.default=555666
channels.phone.jswitch.trunks.trunk-messagenet.registrar.enable=yes
channels.phone.jswitch.trunks.trunk-messagenet.registrar.domain=sip.messagenet.it
channels.phone.jswitch.trunks.trunk-messagenet.registrar.name=555666
channels.phone.jswitch.trunks.trunk-messagenet.registrar.password=123pass456
channels.phone.jswitch.trunks.trunk-messagenet.registrar.address=sip.messagenet.it
channels.phone.jswitch.trunks.trunk-messagenet.registrar.port=5061
channels.phone.jswitch.trunks.trunk-messagenet.registrar.refresh=60
channels.phone.jswitch.trunks.trunk-messagenet.checkbusytable=no
channels.phone.jswitch.trunks.trunk-messagenet.limbo.enable=yes
channels.phone.jswitch.trunks.trunk-messagenet.limbo.time=1000
channels.phone.jswitch.trunks.trunk-messagenet.video.enable=no
channels.phone.jswitch.trunks.trunk-messagenet.codecs.0.classname=it.tradesoft.tegate.rtp.codecs.gsm
channels.phone.jswitch.trunks.trunk-messagenet.codecs.1.classname=it.tradesoft.tegate.rtp.codecs.alaw
channels.phone.jswitch.trunks.trunk-messagenet.sessionprogress.ignoring=yes
channels.phone.jswitch.trunks.trunk-messagenet.sessionprogress.connect=yes
channels.phone.jswitch.trunks.trunk-messagenet.response4xx.action=REMOTE_BUSY
channels.phone.jswitch.trunks.trunk-messagenet.max.resources.enable=yes
channels.phone.jswitch.trunks.trunk-messagenet.max.resources.number=3
channels.phone.jswitch.trunks.trunk-messagenet.rtp.port.enable=yes
channels.phone.jswitch.trunks.trunk-messagenet.rtp.port.min=10010
channels.phone.jswitch.trunks.trunk-messagenet.rtp.port.max=10019

Inoltre fare attenzione a che non vi siano altri trunk in ascolto sulla stessa porta (indicata dal parametro port) del trunk messagenet appena settato e che il range di porte eventualmente riservato ad un trunk non si sovrapponga al range di altri trunk. Cambiare il numero di porta nel caso sia già utilizzato da qualche altro trunk.

Verifica dello stato del trunk messagenet

Effettuando l'accesso via web al Dexgate come amministratore si accede in Gestione->Gestione numeri->Gestione dei trunk. Se non ci sono errori nella configurazione del trunk appena creato e il provider ha accettato la registrazione apparirà una schermata come questa sotto:

La riga relativa al trunk messagenet indica che siamo registrati.

Settaggio Regole Uscita

Vediamo ora come creare una regola per chiamare con il trunk messagenet appena creato. Cliccando su Gestione->Gestione numeri->Regole chiamate in uscita compare una tabella con i prefissi utilizzati per chiamare sui vari trunk. Cliccando su Aggiungi regola chiamate in uscita possiamo aggiungere un nuovo prefisso relativo al trunk messagenet. Supponiamo di voler uscire con messagenet con il prefisso 0, aggiungiamo i dati nella form così come mostrato nella seguente immagine:

Clicchiamo quindi su "Esegui"

La schermata successiva permette di associare al prefisso precedentemente indicato un trunk di uscita. Per Messagenet configurare la regola come da figura (in particolare come dominio inserire sip.messagenet.it):

Creazione della regola di redirezione numero esterno

Immaginiamo a questo punto di voler indirizzare verso un certo interno, IVR o numero di gruppo ogni chiamata entrante dall'esterno sul trunk Messagenet (destinata cioè al nostro numero geografico 02111222) e supponiamo che tale numero sia il 100.

In “Gestione numeri” cliccare sul link "Regole chiamate in ingresso" (oppure “Lista numeri esterni rediretti” per versioni Dexgate meno recenti), quindi su “Redirigi numero esterno” e creare una nuova redirezione come mostrato di seguito:

Cliccare sul link “Esegui” per salvare le impostazioni.

A questo punto si è pronti per utilizzare il nostro Account Messagenet con il Dexgate.

In particolare, da qualunque terminale SIP registrato sul trunk interno “tegate” del Dexgate potremo utilizzare il nostro account Messagenet premettendo al numero da chiamare il prefisso '0' (oppure il prefisso '9' nel caso si sia seguita la configurazione avanzata) e nel contempo saremo in grado d'indirizzare ogni chiamata diretta al nostro numero geografico 02111222 verso un terminale, un numero di gruppo o un IVR di nostra scelta.

Unidata

WORK IN PROGRESS! Questa sezione e' obsoleta o ancora in fase di scrittura e pertanto le informazioni contenute in essa possono essere inesatte e/o incomplete.

Modifica del file di configurazione jswitch.properties

A servizio (Dexgate) arrestato, aprire con un qualunque elaboratore di testi il file jswitch.properties nella cartella:

<Path d'installazione del DexgateMicro>\prop

e cercare in esso il blocco relativo al provider Unidata.

Scommentare le righe di tale blocco (eliminando il carattere # di inizio riga) come mostrato di seguito:

## TRUNK Provider UNIDATA
 #channels.phone.jswitch.trunks.trunk-providerUNIDATA.classname=it.tradesoft.tegate.channels.CorbaChannel.jswitch.trunks.sip.SipTrunk
#channels.phone.jswitch.trunks.trunk-UNIDATA.port=4002
#channels.phone.jswitch.trunks.trunk-UNIDATA.stun.enable=yes
#channels.phone.jswitch.trunks.trunk-UNIDATA.stun.address=stun.voip.eutelia.it
#channels.phone.jswitch.trunks.trunk-UNIDATA.stun.port=3478
#channels.phone.jswitch.trunks.trunk-UNIDATA.stun.backup.address=stun.xten.com
#channels.phone.jswitch.trunks.trunk-UNIDATA.stun.backup.port=3478
#channels.phone.jswitch.trunks.trunk-UNIDATA.stun.backup2.address=****
#channels.phone.jswitch.trunks.trunk-UNIDATA.stun.backup2.port=3478
#channels.phone.jswitch.trunks.trunk-UNIDATA.registrar.enable=yes
#channels.phone.jswitch.trunks.trunk-UNIDATA.registrar.domain=217.72.100.4
#channels.phone.jswitch.trunks.trunk-UNIDATA.registrar.name=****
#channels.phone.jswitch.trunks.trunk-UNIDATA.registrar.password=****
#channels.phone.jswitch.trunks.trunk-UNIDATA.registrar.address=217.72.100.4
#channels.phone.jswitch.trunks.trunk-UNIDATA.registrar.port=5060
#channels.phone.jswitch.trunks.trunk-UNIDATA.registrar.refresh=170
#channels.phone.jswitch.trunks.trunk-UNIDATA.checkbusytable=no
#channels.phone.jswitch.trunks.trunk-UNIDATA.limbo.enable=no
#channels.phone.jswitch.trunks.trunk-UNIDATA.video.enable=no
#channels.phone.jswitch.trunks.trunk-UNIDATA.codecs.0.classname=it.tradesoft.tegate.rtp.codecs.gsm
#channels.phone.jswitch.trunks.trunk-UNIDATA.codecs.1.classname=it.tradesoft.tegate.rtp.codecs.alaw
#channels.phone.jswitch.trunks.trunk-UNIDATA.callernumber.default=****
#channels.phone.jswitch.trunks.trunk-UNIDATA.dtmf=rfc2833
#channels.phone.jswitch.trunks.trunk-UNIDATA.sessionprogress.ignoring=no
#channels.phone.jswitch.trunks.trunk-UNIDATA.response4xx.action=REMOTE_BUSY
#channels.phone.jswitch.trunks.trunk-UNIDATA.max.resources.enable=no
#channels.phone.jswitch.trunks.trunk-UNIDATA.max.resources.number=*****
#channels.phone.jswitch.trunks.trunk-UNIDATA.rtp.port.enable=yes
#channels.phone.jswitch.trunks.trunk-UNIDATA.rtp.port.min=*****
#channels.phone.jswitch.trunks.trunk-UNIDATA.rtp.port.max=*****

A questo punto ipotizziamo che da Unidata ci sia stato assegnato il seguente account:

• Numero telefonico geografico: 3902999888777
• Indirizzo IP del server Unidata: 217.72.100.4
• Password: 123pass456

Dovremo modificare le seguenti linee del blocco:

• il parametro registrar.name che verrà settato con l'identificativo del client SIP dell'account a noi assegnato da Unidata (in questo caso 02999888777)
• il parametro registrar.password che verrà settato con la password dell'account a noi assegnato da Unidata (in questo caso 123pass456)
• il parametro callernumber.default che deve essere settato uguale al numero geografico assegnato (in questo caso 02999888777)
• opzionalmente, i parametri stun.backup.address e stun.backup2.address che andranno valorizzati con gli indirizzi di eventuali stun server di backup. Nel caso non si voglia valorizzare uno o entrambi questi campi, lasciare commentata la riga corrispondente e quella del relativo parametro porta: stun.backup.port e stun.backup2.port.
• Il range di porte utilizzate dal trunk: la loro conoscenza e' necessaria per l'apertura delle porte sul firewall aziendale. Nel caso non vi siano problemi di firewall lasciare commentate le proprieta'

channels.phone.jswitch.trunks.trunk-UNIDATA.rtp.port.enable=yes
channels.phone.jswitch.trunks.trunk-UNIDATA.rtp.port.min=*****
channels.phone.jswitch.trunks.trunk-UNIDATA.rtp.port.max=*****

altrimenti basta scommentare tali righe ed impostare il range opportuno di porte da usare indicando il valore minimo e massimo. Le porte corrispondenti, oltre a quella su cui abbiamo messo in ascolto il trunk (nell'esempio, la 4002) dovranno essere aperte sul firewall e routate internamente verso Dexgate

Nell'esempio utilizzeremo :

• lo stunk server e non l'indirizzo pubblico
• un numero massimo di chiamate sul trunk pari a 2
• un range di porte rtp fra 10020 e 10029 (NOTA: per ogni chiamata contemporanea vengono utilizzate 3 porte rtp, quindi il range di porte dovra' avere ampiezza almeno tripla rispetto al numero di chiamate contemporanee che si vogliono poter effettuare sul trunk))

Il blocco dovrà essere a questo punto configurato nel modo seguente:

# TRUNK Provider UNIDATA
channels.phone.jswitch.trunks.trunk-UNIDATA.classname=it.tradesoft.tegate.channels.CorbaChannel.jswitch.trunks.sip.SipTrunk
channels.phone.jswitch.trunks.trunk-UNIDATA.port=4002
channels.phone.jswitch.trunks.trunk-UNIDATA.stun.enable=yes
channels.phone.jswitch.trunks.trunk-UNIDATA.stun.address=stun.voip.eutelia.it
channels.phone.jswitch.trunks.trunk-UNIDATA.stun.port=3478
channels.phone.jswitch.trunks.trunk-UNIDATA.stun.backup.address=stun.xten.com
channels.phone.jswitch.trunks.trunk-UNIDATA.stun.backup.port=3478
#channels.phone.jswitch.trunks.trunk-UNIDATA.stun.backup2.address=****
#channels.phone.jswitch.trunks.trunk-UNIDATA.stun.backup2.port=3478
channels.phone.jswitch.trunks.trunk-UNIDATA.registrar.enable=yes
channels.phone.jswitch.trunks.trunk-UNIDATA.registrar.domain=217.72.100.4
channels.phone.jswitch.trunks.trunk-UNIDATA.registrar.name=3902999888777
channels.phone.jswitch.trunks.trunk-UNIDATA.registrar.password=123pass456
channels.phone.jswitch.trunks.trunk-UNIDATA.registrar.address=217.72.100.4
channels.phone.jswitch.trunks.trunk-UNIDATA.registrar.port=5060
channels.phone.jswitch.trunks.trunk-UNIDATA.registrar.refresh=170
channels.phone.jswitch.trunks.trunk-UNIDATA.checkbusytable=no
channels.phone.jswitch.trunks.trunk-UNIDATA.limbo.enable=no
channels.phone.jswitch.trunks.trunk-UNIDATA.video.enable=no
channels.phone.jswitch.trunks.trunk-UNIDATA.codecs.0.classname=it.tradesoft.tegate.rtp.codecs.gsm
channels.phone.jswitch.trunks.trunk-UNIDATA.codecs.1.classname=it.tradesoft.tegate.rtp.codecs.alaw
channels.phone.jswitch.trunks.trunk-UNIDATA.callernumber.default=3902999888777
channels.phone.jswitch.trunks.trunk-UNIDATA.dtmf=rfc2833
channels.phone.jswitch.trunks.trunk-UNIDATA.sessionprogress.ignoring=no
channels.phone.jswitch.trunks.trunk-UNIDATA.response4xx.action=REMOTE_BUSY
channels.phone.jswitch.trunks.trunk-UNIDATA.max.resources.enable=yes
channels.phone.jswitch.trunks.trunk-UNIDATA.max.resources.number=2
channels.phone.jswitch.trunks.trunk-UNIDATA.rtp.port.enable=yes
channels.phone.jswitch.trunks.trunk-UNIDATA.rtp.port.min=10020
channels.phone.jswitch.trunks.trunk-UNIDATA.rtp.port.max=10029

Inoltre fare attenzione a che non vi siano altri trunk nel file jswitch.properties in ascolto sulla stessa porta (indicata dal parametro port) del trunk UNIDATA appena settato e che il range di porte eventualmente riservato ad un trunk non si sovrapponga al range di altri trunk. Cambiare il numero di porta nel caso sia già utilizzato da qualche altro trunk.

A questo punto salvare i cambiamenti e ristartare il servizio.

Settaggio delle Linee uscita gateway

Una volta ripartito il servizio, loggarsi sul DexGateMicro come amministratore ed in “Gestione numeri” cliccare sul link “Linee uscita gateway”. Cliccare sul link “Aggiungi linea in uscita” ed inserire la regola d'instradamento per le chiamate in uscita mediante il servizio Eutelia come mostrato nella seguente immagine:

Il campo “Nome Gateway”, in particolare, andrà valorizzato col nome del trunk Unidata precedentemente creato nel file jswitch.properties senza il prefisso “trunk-”.

Cliccare sul link “Esegui” per salvare le impostazioni:

Si sarà creata in questo modo una regola che permetterà l'instradamento di ogni chiamata uscente con called number iniziante per '0' verso il trunk relativo al nostro account Unidata.

Nel caso siano già presenti una o più linee gateway in uscita, la nuova regola d'instradamento verso il nostro account Unidata sarà inserita in coda alle linee in uscita gateway preesistenti, come mostrato nella seguente figura:

In questo caso ogni chiamata uscente con prefisso '0' sarà instradata prima sui trunk a priorità più alta (nel nostro esempio, il trunk Messagenet), quindi verso il nostro trunk Unidata solo se sui precedenti si saranno verificati eventi di occupato o di fallimento per indisponibilità della linea. A questo punto, si potrà modificare la precedente regola a proprio piacimento agendo sui link “Su” e “Giù” di ciascuna linea per adattare alle proprie particolari necessità la politica d'instradamento precedentemente descritta, modificando l'ordine d'impegno delle linee gateway di uscita.

Nel caso si voglia creare una regola d'instradamento personalizzata che associ al nostro account Unidata un prefisso d'uscita diverso da '0', piuttosto che al presente paragrafo, si faccia riferimento al paragrafo successivo. Quest'ultimo potrà invece essere tralasciato nel caso in cui quanto descritto in questo paragrafo sia confacente alle proprie necessità.

Creazione di una regola URI personalizzata

Immaginando di voler usare un certo prefisso diverso da '0' per chiamare numeri esterni mediante il nostro account Eutelia e supponiamo che tale prefisso sia '9'. In questo caso, loggarsi sul DexGateMicro come amministratore ed in “Gestione avanzata”, “Regole trasformazioni URI” cliccare sul link “Aggiungi regola di trasformazione URI”.

Dopodiché:

• Valorizzare Priorità Regola a 7500 ;
• Valorizzare Match in avanti con virtual:///9(.*) (9 è proprio il prefisso per uscire su Unidata);
• Valorizzare Trasformazione in avanti con sip://trunk-UNIDATA/$1@217.72.100.4 ;
• Valorizzare Match all'indietro con sip://trunk-UNIDATA/((.*)@)?(.*) ;
• Valorizzare Trasformazione all'indietro con virtual:///9$2 (9 è proprio il prefisso per uscire su Unidata)

Dopo aver inserito la “Nota” la schermata apparirà come nella figura in basso.

Cliccare su “Esegui” per salvare le impostazioni.

Creazione della regola di redirezione numero esterno

Immaginiamo a questo punto di voler indirizzare verso un certo interno, IVR o numero di gruppo ogni chiamata entrante dall'esterno sul trunk Unidata (destinata cioè al nostro numero geografico 02999888777) e supponiamo che tale numero sia il 100.

In “Gestione numeri” cliccare sul link “Lista numeri esterni rediretti”, quindi su “Redirigi numero esterno” e creare una nuova redirezione come mostrato di seguito:

Cliccare sul link “Esegui” per salvare le impostazioni.

A questo punto si è pronti per utilizzare il nostro Account Unidata con il DexGateMicro.

In particolare, da qualunque terminale SIP registrato sul trunk interno “tegate” del DexGateMicro potremo utilizzare il nostro account Unidata premettendo al numero da chiamare il prefisso '0' (oppure il prefisso '9' nel caso si sia seguita la configurazione avanzata) e nel contempo saremo in grado d'indirizzare ogni chiamata diretta al nostro numero geografico 02999888777 verso un terminale, un numero di gruppo o un IVR di nostra scelta.