Servidor SIP: Configuração: Geral
Use essa página para configurar os recursos e o comportamento default do container de Servlet SIP.
Opções de Configuração
Nome Descrição Nome do Servlet Default O nome de um Servlet SIP default a ser chamado se o servidor não puder mapear uma solicitação inicial de entrada para um Servlet usando as regras de mapeamento de Servlet disponíveis.
O nome especificado no elemento default-servlet-name deve corresponder ao valor servlet-name de um Servlet SIP implantado. Se o nome definido em default-servlet-name não corresponder a um Servlet implantado, ou nenhum valor for especificado (a configuração default), o WebLogic Communications Server registrará o nome com.bea.wcp.sip.engine.BlankServlet como o Servlet default. O nome BlankServlet também será usado se um Servlet implantado e registrado como default-servlet-name tiver sua implantação cancelada no container.
O comportamento do BlankServlet é configurado com o elemento default-behavior. Por default, o Servlet atua como proxy para todas as solicitações sem correspondência. Entretanto, se o elemento default-behavior for definido com o modo "ua", o BlankServlet será responsável por retornar 481 respostas para as solicitações CANCEL e BYE, bem como 500/416 respostas em todos os demais casos. O BlankServlet não responde ao ACK, e sempre invalida a sessão da aplicação.
Atributo MBean:
SipServerBean.DefaultServletNameAs alterações entram em vigor após a reimplantação do módulo ou a reinicialização do servidor.
Intervalo de Timeout T1 A duração do timer T1 do protocolo SIP, em milissegundos.
O timer T1 também especifica os valores iniciais dos Timers A, E e G, que controlam o intervalo de retransmissão para solicitações e respostas INVITE por meio do UDP. O timer T1 afeta os valores dos timers F, H e J, que controlam os intervalos de retransmissão para respostas e solicitações INVITE; esses timers são definidos com um valor igual a 64*T1 milissegundos. Consulte a Especificação SIP para obter mais informações sobre timers SIP. Consulte também "Configurando NTP para Timers SIP Precisos" no guia de configuração.
Se o valor de timeout T1 não estiver configurado, o WebLogic Communications Server usará o valor default do protocolo SIP que é de 500 milissegundos.
Atributo MBean:
SipServerBean.T1TimeoutIntervalAs alterações entram em vigor após a reimplantação do módulo ou a reinicialização do servidor.
Intervalo de Timeout T2 A duração do timer T2 do protocolo SIP, em milissegundos.
O Timer T2 define o intervalo de retransmissão para respostas INVITE e solicitações não INVITE. Consulte a Especificação SIP para obter mais informações sobre timers SIP. Consulte também "Configurando o NTP para Timers SIP Precisos" na configuração.
Se o valor de timeout T2 não estiver configurado, o WebLogic Communications Server usará o valor default do protocolo SIP que é de 4 segundos.
Atributo MBean:
SipServerBean.T2TimeoutIntervalAs alterações entram em vigor após a reimplantação do módulo ou a reinicialização do servidor.
Intervalo de Timeout T4 A duração do timer T4 do protocolo SIP, em milissegundos.
O timer T4 especifica o período máximo em que uma mensagem permanece na rede e também especifica os valores iniciais dos Timers I e K, que controlam os tempos de espera para retransmissão de ACKs e respostas por meio do UDP. Consulte a Especificação SIP para obter mais informações sobre timers SIP. Consulte também "Configurando o NTP para Timers SIP Precisos" no guia de configuração.
Se o valor de timeout T4 não estiver configurado, o WebLogic Communications Server usará o valor default do protocolo SIP que é de 5 segundos.
Atributo MBean:
SipServerBean.T4TimeoutIntervalAs alterações entram em vigor após a reimplantação do módulo ou a reinicialização do servidor.
Intervalo de Timeout do Timer B A duração do Timer B do protocolo SIP, em milissegundos.
O timer B especifica o período em que uma transação do cliente tenta novamente enviar uma solicitação. Consulte a Especificação SIP para obter mais informações sobre timers SIP. Consulte também "Configurando o NTP para Timers SIP Precisos".
Se o valor do Timer B não estiver configurado, o servidor derivará um valor do timer T1 (64*T1, ou 32.000 milissegundos por default).
Atributo MBean:
SipServerBean.TimerBTimeoutIntervalAs alterações entram em vigor após a reimplantação do módulo ou a reinicialização do servidor.
Intervalo de Timeout do Timer F A duração do Timer F do protocolo SIP, em milissegundos.
O timer F especifica o intervalo de timeout para a retransmissão de solicitações não INVITE. Consulte a Especificação SIP para obter mais informações sobre timers SIP. Consulte também "Configurando o NTP para Timers SIP Precisos" no guia de configuração.
Se o valor do Timer F não estiver configurado, o servidor derivará um valor do timer T1 (64*T1, ou 32.000 milissegundos por default).
Atributo MBean:
SipServerBean.TimerFTimeoutIntervalAs alterações entram em vigor após a reimplantação do módulo ou a reinicialização do servidor.
Tempo de Vida Máximo da Sessão da Aplicação O tempo máximo, em minutos, em que uma sessão da aplicação SIP pode existir antes de ser invalidada pelo WebLogic Communications Server. Esse valor deve ser igual ou maior que o tamanho da sessão default de cada aplicação implantada.
Um valor igual a -1 (o default) indica que não há limite para tempo de vida da sessão SIP.
Atributo MBean:
SipServerBean.MaxApplicationSessionLifetimeAs alterações entram em vigor após a reimplantação do módulo ou a reinicialização do servidor.
Ativar distribuição local Ativa uma otimização do servidor que ajuda a evitar tráfego de rede desnecessário ao enviar e encaminhar mensagens.
Quando ativada, se uma instância do servidor precisar enviar ou encaminhar uma mensagem e o destino da mensagem for o endereço do cluster da camada de mecanismo ou o endereço do servidor local, a mensagem será roteada internamente para o servidor local, em vez de ser enviada pela rede.
Atributo MBean:
SipServerBean.EnableLocalDispatchAs alterações entram em vigor após a reimplantação do módulo ou a reinicialização do servidor.
Comportamento Default do Servidor SIP O comportamento default da instância do WebLogic Communications Server se o servidor não puder igualar uma solicitação SIP de entrada a um Servlet SIP implantado, ou o Servlet correspondente tiver sido invalidado ou atingido o timeout.
Os valores válidos são:
proxy: Agir como servidor proxy sem estado.
ua: Agir como Agente do Usuário.
"proxy" será usado como default se você não especificar um valor.
Ao agir como Agente do Usuário, o WebLogic Communications Server age da seguinte maneira em resposta às solicitações SIP:
As solicitações ACK são descartadas sem aviso.
As solicitações CANCEL ou BYE recebem o código de resposta 481 - A transação não existe.
Todas as demais solicitações recebem o código de resposta 500 - Erro interno do servidor.
Ao agir como proxy sem estado, as solicitações de proxy serão encaminhadas automaticamente a um proxy de saída, se um estiver configurado. Se nenhum proxy estiver definido, o Weblogic Communications Server só agirá como proxy para um URI de Solicitação especificado se o URI de Solicitação não corresponder ao IP e número de porta de um endereço local conhecido para um contêiner de Servlet SIP, ou um endereço de balanceador de carga configurado para o servidor. Isso assegura que a solicitação não entre em loop constantemente nos mesmos servidores. Quando o URI de Solicitação corresponde a um endereço de contêiner local ou de balanceador de carga, o WebLogic Communications Server age como UA.
Atributo MBean:
SipServerBean.DefaultBehaviorAs alterações entram em vigor após a reimplantação do módulo ou a reinicialização do servidor.
Inserção de Cabeçalho do Servidor Especifica as condições para inserção de um cabeçalho do Servidor nas mensagens SIP.
Use esse atributo para limitar ou eliminar cabeçalhos do Servidor visando reduzir o tamanho da mensagem para redes móveis ou aumentar a segurança. Selecione um dos seguintes valores de string para configurar o comportamento:
none (o default): Não insere cabeçalho do Servidor.
request: Só insere o cabeçalho do Servidor para solicitações SIP geradas pelo servidor.
response: Só insere o cabeçalho do Servidor para respostas SIP geradas pelo servidor.
all: Insere o cabeçalho do Servidor para todas as solicitações e respostas SIP.
Por default, o WebLogic Communications Server não insere o cabeçalho do Servidor nas mensagens SIP.
Atributo MBean:
SipServerBean.ServerHeaderValor do Cabeçalho do Servidor O valor do cabeçalho do Servidor inserido nas mensagens SIP.
O WebLogic Communications Server permite que você controle o texto inserido no cabeçalho do Servidor de mensagens geradas. Isso disponibiliza controle adicional sobre o tamanho de mensagens SIP, além de permitir que você mascare a entidade do servidor por razões de segurança. Para configurar o conteúdo do cabeçalho, informe um valor de string.
Por default, o WebLogic Communications Server não insere um cabeçalho do Servidor nas mensagens SIP geradas. Se Inserção de Cabeçalho do Servidor estiver ativado, mas nenhum valor de Cabeçalho do Servidor for especificado, o WebLogic Communications Server inserirá o valor "WebLogic SIP Server".
Atributo MBean:
SipServerBean.ServerHeaderValueForm Default para Inserção de Cabeçalho Especifica como o servidor aplica regras para compactar cabeçalhos de mensagens SIP.
Esse elemento configura o comportamento default geral do servidor quanto ao uso ou preservação de cabeçalhos compactos nas mensagens SIP. Você pode definir esse elemento com um dos seguintes valores:
compact: O WebLogic Communications Server usa o form compacto para todos os cabeçalhos gerados pelo sistema. Entretanto, qualquer cabeçalho que for copiado de uma mensagem de origem (em vez de gerado) usará seu form original.
force compact: O WebLogic Communications Server usa o form compacto para todos os cabeçalhos, convertendo cabeçalhos longos das mensagens existentes em cabeçalhos compactos, conforme necessário.
long: O WebLogic Communications Server usa o form longo para todos os cabeçalhos gerados pelo sistema. Entretanto, qualquer cabeçalho que for copiado de uma mensagem de origem (em vez de gerado) usará seu form original.
force long: O WebLogic Communications Server usa o form longo para todos os cabeçalhos, convertendo cabeçalhos compactos das mensagens existentes em cabeçalhos longos, conforme necessário.
Atributo MBean:
SipServerBean.UseHeaderFormAtivar Pesquisa do Servidor DNS Especifica se o servidor executa pesquisa de DNS.
Se você definir esse atributo como "true", o servidor poderá usar DNS para:
Descobrir transporte, endereço IP e número de porta de um servidor proxy quando uma solicitação for enviada a um URI SIP.
Resolver um endereço IP e/ou número de porta durante o roteamento de resposta, dependendo do conteúdo do campo Enviado por.
Para descoberta de proxy, o WebLogic Communications Server usa resolução de DNS apenas uma vez por transação SIP para determinar as informações de transporte, IP e número de porta. Todas as solicitações de retransmissão, ACKs ou CANCEL são entregues no mesmo endereço e porta usando o mesmo transporte. Para obter detalhes sobre como a resolução de DNS ocorre, consulte RFC 3263: SIP (Session Initiation Protocol): Localizando Servidores SIP.
Quando um proxy precisa enviar uma mensagem de resposta, o WebLogic Communications Server usa a pesquisa de DNS para determinar o endereço IP e/ou número de porta do destino, dependendo das informações especificadas no campo Enviado por e via cabeçalho.
Por default, a resolução de DNS não é usada ("false").
Observação: Como a resolução de DNS é executada no contexto de processamento de mensagens SIP, qualquer problema de desempenho de DNS resulta no aumento do desempenho de latência. A Oracle recomenda o uso de um servidor DNS de cache em um ambiente de produção para minimizar possíveis problemas de desempenho.
Atributo MBean:
SipServerBean.EnableDnsSrvLookupAtivar Cache de Estado de Chamada Especifica se os mecanismos armazenam no cache parte dos dados de estado de chamada localmente.
Atributo MBean:
SipServerBean.EngineCallStateCacheEnabledAs alterações entram em vigor após a reimplantação do módulo ou a reinicialização do servidor.
Ativar Cabeçalho do Contato para Resposta Provisional Não Confiável (1xx) Especifica se o servidor coloca o Cabeçalho do Contato na resposta provisional não confiável (1xx) que tem a tag Para.
Isso não se aplica a 100 e os valores possíveis são true e false.
Se você definir esse atributo como "true", o servidor colocará o cabeçalho do Contato; caso contrário, o ignorará.
Atributo MBean:
SipServerBean.EnableContactProvisionalResponseURI Globalmente Roteável Um GRUU (Globally-Routable User Agent URI) que o WebLogic Communications Server insere automaticamente nos cabeçalhos Contact e Route-Set ao comunicar-se com os elementos da rede.
O URI especificado nesse elemento deve ser o GRUU em todo do cluster do WebLogic Communications Server. Em um domínio de servidor único, especifique um GRUU para o próprio servidor.
Observe que os UAs (User Agents) implantados no WebLogic Communications Server normalmente obtêm GRUUs por meio de uma solicitação de registro. Nesse caso, o código da aplicação é responsável por solicitar e subsequentemente identificar o GRUU. Para solicitar um GRUU, o UA incluiria o parâmetro "+sip.instance" do campo de cabeçalho do Contato em cada Contato cujo GRUU é obrigatório. No recebimento de um GRUU, o UA o usaria como URI para o campo de cabeçalho do contato ao gerar novas solicitações.
Atributo MBean:
SipServerBean.GloballyRoutableUriAs alterações entram em vigor após a reimplantação do módulo ou a reinicialização do servidor.
Ativar Afinidade de Timer Especifica se cada timer é processado no mecanismo onde ele foi definido.
Se esse atributo for definido como "true", os timers serão processados no mecanismo onde foram criados. Isso é importante em algumas aplicações. Se definido como "false", os timers poderão ser processados em qualquer mecanismo.
Atributo MBean:
SipServerBean.EnableTimerAffinityRepetir Após Valor O tempo em segundos usado no cabeçalho Repetir Após para respostas 5xx. Esse valor também inclui um parâmetro ou uma razão, como "Repetir Apos: 18000;duração=3600" ou "Repetir Após: 120 (Estou em uma reunião)".
Se esse valor não for configurado, o WebLogic Communications Server usará o valor default de 180 segundos
Atributo MBean:
SipServerBean.RetryAfterValueAs alterações entram em vigor após a reimplantação do módulo ou a reinicialização do servidor.
Apelidos de Domínio A lista de nomes de domínio pelos quais o servidor é responsável.
As mensagens para os domínios dessa lista são processadas localmente, em vez de encaminhadas. Você pode incluir nomes completos de domínio na lista, ou nomes de domínio que começam com um caractere curinga, como *.mycompany.com.
Atributo MBean:
SipServerBean.DomainAliasNamesRoteamento Simétrico de Resposta Especifica se o roteamento simétrico de resposta é solicitado (por meio do parâmetro rport) para solicitações geradas pelo WebLogic Communications Server.
Quando essa opção está ativada, o roteamento simétrico de resposta conforme definido em RFC3581 permanece em vigor.
Atributo MBean:
SipServerBean.EnableRportNível de Dump de Imagem de Diagnóstico Especifica o nível de detalhes a ser gravado em arquivos de imagem de diagnóstico.
"basic" grava todos os dados possíveis, exceto dados de estado de chamada.
"full" grava todos os dados, incluindo dados de estado de chamada.
Atributo MBean:
SipServerBean.ImageDumpLevelTratamento de Sessão Desatualizada A ação a ser executada quando uma mensagem de entrada contém identificadores de sessão incorretos.
O WebLogic Communications Server codifica os IDs de sessão e estado de chamada em URLs de saída para ajudar a identificar a sessão correta nas mensagens de retorno. Os valores a seguir determinam uma ação a ser tomada se uma mensagem de entrada contiver identificadores de sessão incorretos:
error: Responder com um erro 481 ou 404.
continue: Ignorar os identificadores codificados e continuar processando a mensagem.
drop: Eliminar a mensagem silenciosamente.
A ação default é "error".
Atributo MBean:
SipServerBean.StaleSessionHandling