Server SIP: Configurazione: Generale
Utilizzare questa pagina per configurare le funzioni e il funzionamento predefinito del contenitore servlet SIP.
Opzioni di configurazione
Nome Descrizione Nome servlet predefinito Il nome di un servlet SIP predefinito da chiamare se il server non riesce a mappare una richiesta iniziale in arrivo a un servlet utilizzando le regole di mapping del servlet disponibili.
Il nome specificato nell'elemento default-servlet-name deve corrispondere al valore servlet-name di un servlet SIP distribuito. Se il nome definito in default-servlet-name non corrisponde a un servlet distribuito o non è specificato nessun valore (la configurazione predefinita), WebLogic Communications Server registra il nome com.bea.wcp.sip.engine.BlankServlet come servlet predefinito. Anche nel caso di annullamento della distribuzione nel container di un servlet distribuito registrato come default-servlet-name viene utilizzato il nome BlankServlet.
Il funzionamento del BlankServlet è configurato con l'elemento default-behavior. Per impostazione predefinita il servlet funge da proxy per tutte le richieste senza corrispondenza. Tuttavia, se l'elemento default-behavior è impostato sulla modalità "ua", BlankServlet è responsabile della restituzione di 481 risposte per le richieste CANCEL e BYE e di 500/416 risposte in tutti gli altri casi. BlankServlet non risponde ad ACK e invalida sempre la sessione applicazione.
Attributo MBean:
SipServerBean.DefaultServletNameLe modifiche diventano effettive dopo la ridistribuzione del modulo o il riavvio del server.
Intervallo timeout T1 La durata del timer T1 del protocollo SIP in millisecondi.
Il timer T1 specifica anche i valori iniziali dei timer A, E e G, che controllano l'intervallo di ritrasmissione delle richieste e delle risposte INVITE su UDP. Il timer T1 interessa i valori dei timer F, H e J, che controllano gli intervalli di ritrasmissione delle richieste e delle risposte INVITE; questi timer sono impostati su un valore di 64*T1 millisecondi. Per ulteriori informazioni sui timer SIP, vedere Specifica SIP. Vedere anche "Configurazione di NTP per la precisione dei timer SIP" nella Guida alla configurazione.
Se il valore di timeout T1 non è configurato, WebLogic Communications Server utilizza il valore predefinito del protocollo SIP di 500 millisecondi.
Attributo MBean:
SipServerBean.T1TimeoutIntervalLe modifiche diventano effettive dopo la ridistribuzione del modulo o il riavvio del server.
Intervallo timeout T2 La durata del timer T2 del protocollo SIP in millisecondi.
Il timer T2 definisce l'intervallo di ritrasmissione per le risposte INVITE e le richieste non INVITE. Per ulteriori informazioni sui timer SIP, vedere Specifica SIP. Vedere anche "Configurazione di NTP per la precisione dei timer SIP" nella Guida alla configurazione.
Se il valore di timeout T2 non è configurato, WebLogic Communications Server utilizza il valore predefinito del protocollo SIP di 4 secondi.
Attributo MBean:
SipServerBean.T2TimeoutIntervalLe modifiche diventano effettive dopo la ridistribuzione del modulo o il riavvio del server.
Intervallo timeout T4 La durata del timer T4 del protocollo SIP in millisecondi.
Il timer T4 specifica la quantità massima di tempo in cui un messaggio rimane nella rete. Il timer T4 specifica inoltre i valori iniziali dei timer I e K, che controllano i tempi di attesa per la ritrasmissione di ACK e risposte su UDP. Per ulteriori informazioni sui timer SIP, vedere Specifica SIP. Vedere anche "Configurazione di NTP per la precisione dei timer SIP" nella Guida alla configurazione.
Se il valore di timeout T4 non è configurato, WebLogic Communications Server utilizza il valore predefinito del protocollo SIP di 5 secondi.
Attributo MBean:
SipServerBean.T4TimeoutIntervalLe modifiche diventano effettive dopo la ridistribuzione del modulo o il riavvio del server.
Intervallo timeout timer B La durata del timer B del protocollo SIP in millisecondi.
Il timer B specifica la quantità di tempo durante la quale una transazione client ritenta di inviare una richiesta. Per ulteriori informazioni sui timer SIP, vedere Specifica SIP. Vedere anche "Configurazione di NTP per la precisione dei timer SIP".
Se il valore del timer B non è configurato, il server deriva un valore dal timer T1 (64*T1 o 32000 millisecondi per impostazione predefinita).
Attributo MBean:
SipServerBean.TimerBTimeoutIntervalLe modifiche diventano effettive dopo la ridistribuzione del modulo o il riavvio del server.
Intervallo timeout timer F La durata del timer F del protocollo SIP in millisecondi.
Il timer F specifica l'intervallo di timeout per la ritrasmissione delle richieste non INVITE. Per ulteriori informazioni sui timer SIP, vedere Specifica SIP. Vedere anche "Configurazione di NTP per la precisione dei timer SIP" nella Guida alla configurazione.
Se il valore del timer F non è configurato, il server deriva un valore dal timer T1 (64*T1 o 32000 millisecondi per impostazione predefinita).
Attributo MBean:
SipServerBean.TimerFTimeoutIntervalLe modifiche diventano effettive dopo la ridistribuzione del modulo o il riavvio del server.
Durata massima sessione applicazione Durata massima, in minuti, dell'esistenza di una sessione dell'applicazione SIP prima che WebLogic Communications Server invalidi la sessione. Questo valore deve essere uguale o maggiore della durata predefinita della sessione di ogni applicazione distribuita.
Il valore -1 (predefinito) indica che non ci sono limiti di durata per la sessione SIP.
Attributo MBean:
SipServerBean.MaxApplicationSessionLifetimeLe modifiche diventano effettive dopo la ridistribuzione del modulo o il riavvio del server.
Abilita consegna locale Abilita l'ottimizzazione del server che consente di evitare traffico di rete non necessario durante l'invio e l'inoltro dei messaggi.
Quando abilitato, se un'istanza del server deve inviare o inoltrare un messaggio e la destinazione del messaggio è l'indirizzo del cluster del livello motore o l'indirizzo del server locale, il messaggio viene inoltrato internamente al server locale invece di essere inviato tramite la rete.
Attributo MBean:
SipServerBean.EnableLocalDispatchLe modifiche diventano effettive dopo la ridistribuzione del modulo o il riavvio del server.
Funzionamento server SIP predefinito Il funzionamento predefinito dell'istanza di WebLogic Communications Server se il server non riesce a collegare una richiesta SIP in entrata a un servlet SIP distribuito o se il servlet corrispondente è stato invalidato o è in timeout.
I valori validi sono:
proxy: opera come server proxy senza conservazione dello stato;
ua: opera come agente utente.
Se non si specifica un valore, "proxy" viene utilizzato come impostazione predefinita.
Quando opera come un agente utente (UA, User Agent), WebLogic Communications Server effettua le operazioni riportate di seguito in risposta alle richieste SIP.
Le richieste ACK vengono scartate senza avviso.
Le richieste CANCEL o BYE ricevono il codice di risposta 481 - La transazione non esiste.
Tutte le altre richieste ricevono il codice di risposta 500 - Errore interno del server.
Quando opera come un proxy senza conservazione dello stato, le richieste vengono automaticamente inoltrate a un proxy in uscita, se ne è stato configurato uno. Se non è stato definito nessun proxy, WebLogic Communications Server funge da proxy per un URI delle richieste specificato solo se l'URI delle richieste non corrisponde all'IP e al numero di porta di un indirizzo locale noto per un contenitore servlet SIP o all'indirizzo di un load balancer configurato per il server. Questo consente di evitare che la richiesta esegua un loop sempre verso gli stessi server. Quando l'URI della richiesta corrisponde all'indirizzo di un contenitore locale o di un load balancer, WebLogic Communications Server opera invece come UA.
Attributo MBean:
SipServerBean.DefaultBehaviorLe modifiche diventano effettive dopo la ridistribuzione del modulo o il riavvio del server.
Inserimento intestazione server Specifica le condizioni per l'inserimento di un'intestazione server nei messaggi SIP.
Utilizzare questo attributo per limitare o eliminare le intestazioni server in modo da ridurre la dimensione del messaggio per le reti mobili o aumentare la sicurezza. Per configurare il funzionamento, selezionare uno dei seguenti valori di stringa:
none (predefinito): non inserisce alcuna intestazione server;
request: inserisce l'intestazione server solo per le richieste SIP generate dal server;
response: inserisce l'intestazione server solo per le risposte SIP generate dal server;
all: inserisce l'intestazione server per tutte le richieste e le risposte SIP.
Per impostazione predefinita, WebLogic Communications Server non inserisce l'intestazione server nei messaggi SIP.
Attributo MBean:
SipServerBean.ServerHeaderValore intestazione server Il valore dell'intestazione server inserita nei messaggi SIP.
WebLogic Communications Server consente di controllare il testo inserito nell'intestazione server dei messaggi generati. Ciò consente un ulteriore controllo sulla dimensione dei messaggi SIP e inoltre permette di mascherare l'entità server per motivi di sicurezza. Per configurare il contenuto dell'intestazione, immettere un valore di stringa.
Per impostazione predefinita, WebLogic Communications Server non inserisce un'intestazione server nei messaggi SIP generati. Se Inserimento intestazione server è abilitato ma non è specificato alcun valore per l'intestazione server, WebLogic Communications Server inserisce il valore "WebLogic SIP Server".
Attributo MBean:
SipServerBean.ServerHeaderValueFormato predefinito per inserimento intestazione Specifica come il server applica le regole per comprimere le intestazioni di messaggio SIP.
Questo elemento configura il funzionamento predefinito a livello di server per utilizzare o conservare le intestazioni compresse nei messaggi SIP. È possibile impostare questo elemento su uno dei seguenti valori:
compact: WebLogic Communications Server utilizza la forma compressa per tutte le intestazioni generate dal sistema. Tuttavia, eventuali intestazioni copiate da un messaggio di origine (piuttosto che da un messaggio generato) utilizzano il formato originale.
force compact: WebLogic Communications Server utilizza il formato compresso per tutte le intestazioni, convertendo le intestazioni lunghe dei messaggi esistenti in intestazioni compresse quando necessario.
long: WebLogic Communications Server utilizza il formato lungo per tutte le intestazioni generate dal sistema. Tuttavia, le intestazioni copiate da un messaggio di origine (piuttosto che da un messaggio generato) utilizzano il formato originale.
force long: WebLogic Communications Server utilizza il formato long per tutte le intestazioni, convertendo le intestazioni compresse dei messaggi esistenti in intestazioni lunghe quando necessario.
Attributo MBean:
SipServerBean.UseHeaderFormAbilita ricerca server DNS Specifica se il server effettua la ricerca DNS.
Se si imposta questo attributo su "true", il server può utilizzare DNS per effettuare le operazioni riportate di seguito:
trovare trasporto, indirizzo IP e numero di porta di un server proxy quando una richiesta viene inviata a un URI SIP;
risolvere un indirizzo IP e/o un numero di porta durante l'instradamento delle risposte, a seconda del contenuto del campo Sent-by.
Per la ricerca del proxy, WebLogic Communications Server utilizza la risoluzione del DNS solo una volta per ciascuna transazione SIP per determinare le informazioni su trasporto, IP e numero di porta. Tutte le richieste ACK, CANCEL o di ritrasmissione vengono inviate allo stesso indirizzo e alla stessa porta utilizzando lo stesso trasporto. Per ulteriori dettagli su come avviene la risoluzione del DNS, vedere RFC 3263: Session Initiation Protocol (SIP): Individuazione dei server SIP.
Quando un proxy deve inviare un messaggio di risposta, WebLogic Communications Server utilizza la ricerca DNS per determinare l'indirizzo IP e/o il numero di porta della destinazione, a seconda delle informazioni fornite nel campo sent-by e mediante l'intestazione.
Per impostazione predefinita, la risoluzione del DNS non viene utilizzata ("false").
Nota: poiché la risoluzione DNS viene eseguita all'interno del contesto dell'elaborazione del messaggio SIP, qualsiasi problema di prestazione del DNS ha come risultato l'aumento delle prestazioni di latenza. Oracle consiglia di utilizzare un server cache DNS in un ambiente di produzione per ridurre al minimo i potenziali problemi di prestazioni.
Attributo MBean:
SipServerBean.EnableDnsSrvLookupAbilita cache stato chiamata Specifica se i motori inseriscono nella cache locale una parte dei dati di stato della chiamata.
Attributo MBean:
SipServerBean.EngineCallStateCacheEnabledLe modifiche diventano effettive dopo la ridistribuzione del modulo o il riavvio del server.
Abilita intestazione Contact per risposta (1xx) provvisoria non affidabile Specifica se il server inserisce l'intestazione Contact nella risposta (1xx) provvisoria non affidabile con tag To.
Non è applicabile per 100 e i valori possibili sono true e false.
Se si imposta questo attributo su "true" il server inserisce l'intestazione Contact, altrimenti la salta.
Attributo MBean:
SipServerBean.EnableContactProvisionalResponseGRUU GRUU (Globally-Routable User Agent URI) inserito automaticamente da WebLogic Communications Server nelle intestazioni Contact e Route-Set durante la comunicazione con gli elementi di rete.
L'URI specificato in questo elemento deve essere il GRUU di tutto il cluster di WebLogic Communications Server. In un dominio a server singolo, specificare un GRUU per il server.
Gli agenti utente (UA, User Agent) distribuiti in WebLogic Communications Server generalmente ottengono GRUU mediante una richiesta di registrazione. In questo caso, il codice dell'applicazione è responsabile della richiesta e della successiva gestione del GRUU. Per richiedere un GRUU l'agente utente include il parametro di campo dell'intestazione Contact "+sip.instance" in ciascun Contact per cui è richiesto il GRUU. Alla ricezione di un GRUU, l'agente utente utilizza il GRUU come URI per il campo dell'intestazione Contact durante la generazione di nuove richieste.
Attributo MBean:
SipServerBean.GloballyRoutableUriLe modifiche diventano effettive dopo la ridistribuzione del modulo o il riavvio del server.
Abilita affinità timer Specifica se ogni timer viene elaborato nel motore in cui è stato impostato.
Se questo attributo viene impostato su "true", i timer verranno elaborati nel motore in cui il timer è stato creato. È importante per alcune applicazioni. Se impostato su "false", i timer possono essere elaborati in qualsiasi motore.
Attributo MBean:
SipServerBean.EnableTimerAffinityValore Retry After Numero di secondi utilizzato nell'intestazione Retry-After per 5xx risposte. Questo valore può includere anche un parametro o una motivazione, ad esempio "Retry-After: 18000;duration=3600" or "Retry-After: 120 (Sono in riunione)".
Se questo valore non è configurato, WebLogic Communications Server utilizza il valore predefinito di 180 secondi
Attributo MBean:
SipServerBean.RetryAfterValueLe modifiche diventano effettive dopo la ridistribuzione del modulo o il riavvio del server.
Alias dominio La lista dei nomi di dominio di cui il server è responsabile.
I messaggi ai domini presenti in questa lista vengono elaborati localmente, invece che inoltrati. È possibile includere nella lista nomi di dominio completamente qualificati o nomi di dominio che iniziano con un carattere jolly, ad esempio *.mycompany.com.
Attributo MBean:
SipServerBean.DomainAliasNamesInstradamento simmetrico risposte Specificare se l'instradamento simmetrico delle risposte viene richiesto (mediante il parametro rport) per le richieste generate da WebLogic Communications Server.
Quando questa opzione viene abilitata, è attivo l'instradamento simmetrico delle risposte come definito in RFC3581.
Attributo MBean:
SipServerBean.EnableRportLivello di dump immagine diagnostica Specifica il livello di dettaglio da registrare nei file immagine diagnostica.
"basic" registra tutti i dati possibili eccetto i dati di stato delle chiamate.
"full" registra tutti i dati, compresi i dati di stato delle chiamate.
Attributo MBean:
SipServerBean.ImageDumpLevelGestione sessione non più valida Azione da eseguire quando un messaggio in entrata contiene identificatori di sessione errati.
WebLogic Communications Server codifica gli ID di stato delle chiamate e della sessione in URL in uscita per consentire l'identificazione della sessione corretta nei messaggi restituiti. I valori riportati di seguito determinano l'azione da eseguire se un messaggio in arrivo contiene identificatori di sessione errati:
error: rispondere con un errore 481 o 404;
continue: ignorare gli identificatori codificati e continuare con l'elaborazione del messaggio;
drop: eliminare il messaggio in background.
L'azione predefinita è "error".
Attributo MBean:
SipServerBean.StaleSessionHandling