Mudanças entre as edições de "Gerando os arquivos de configuração"

De opensipsbrasil - wiki
Ir para navegação Ir para pesquisar
(Criou página com ' (:title Generating Config Files - ver 1.9 :) ---- \\ || %color=#185662%[+'''Generating Config Files 1.9'''+]%% || ||Prev || Script-Format-1-9|Nex...')
 
Linha 1: Linha 1:
 +
A geração de arquivos de configuração é feita através da ferramenta menuconfig, devido a interface utilizada ser baseada em ncurses por favor tneha certeza de primeiro instalar as bibliotecas de desenvolvimento (normalmente libncurses5-dev)
  
−
(:title Generating Config Files - ver 1.9 :)
+
−
----
 
  
 +
==Usando a ferramenta Menuconfig==
  
−
\\
+
O menuconfig pode ser executado diretamente apartir dos sources do opensips ou depois da instalação apartir do diretorio de instalação:
  
−
|| %color=#185662%[+'''Generating Config Files 1.9'''+]%% ||
+
* Apartir do código você executa
 +
make menuconfig
  
−
||[[Configure-File-1-9|Prev]] || [[Script-Format-1-9|Next]]||
+
* Após a instalação, você pode utilizar o comando abaixo
−
----
+
[install_path]/sbin/osipsconfig
  
−
(:toc-float Table of Content:)
 
  
−
Generating OpenSIPS config files is accomplished by using the menuconfig tool. Because the graphical interface is ncurses based, please make sure to first install the ncurses development library ( typically libncurses5-dev ).  
+
Uma vez na ferramente, localize a opção 'Generate OpenSIPS Script', e então selecione a opção desejada, uma vez feita a escolha do tipo de script que você está gerando você poderá configurar várias opções para este script (descrito a seguir). A ativação das opções é feita pressionando a barra de espaço de seu teclado, uma vez configurada as opções desejadas você pode pressionar a tecla 'q' para voltar ao menu anterior e então selecionar 'Save Changes', finalmente você poderá gerar seu arquivo de configuração. No fim do processo a interface irá lhe fornecer o caminho para seu novo arquivo de cofniguração, veja abaixo um exemplo:
 +
Config generated : /usr/local/opensips_proxy_1.9/etc/opensips/opensips_residential_2013-5-21_11:39:48.cfg
  
−
!!! Using the Menuconfig Tool
 
  
−
The menuconfig can be ran either directly from the OpenSIPS sources, or post installation, from the installation path :
 
  
−
* From sources, you can run
+
==Tipos de Configuração==
  
−
    make menuconfig
+
No momento o gerador de script do OpenSIPS (versao 1.9) suporta 3 tipos de scripts, abaixo temos os tipos e as opções disponiveis por script:
  
−
* After installation, you can run menuconfig directly from the installation path, by running
+
===Script Residencial===
  
−
    [install_path]/sbin/osipsconfig
+
** ENABLE_TCP : OpenSIPS irá ativar funcionalidade para requisições SIP sobre TCP
 +
** ENABLE_TLS : OpenSIPS irá aceitar requisições utilizando TLS
 +
** USE_ALIASES : OpenSIPS irá permitir a utilização de Aliases para os usuários
 +
** USE_AUTH : OpenSIPS irá autenticar requisições de REGISTER e INVITE
 +
** USE_DBACC : OpenSIPS irá salvar as entradas de ACC (accounting) no banco de dados
 +
** USE_DBUSRLOC : OpenSIPS irá armazenar de forma persistente as entradas de Localização de usuário no banco de dados
 +
** USE_DIALOG : OpenSIPS irá manter um rastro de todos os dialogos ativos
 +
** USE_MULTIDOMAIN : OpenSIPS irá aceitar assinantes de dominios diferentes
 +
** USE_NAT : OpenSIPS irá tentar tratar o NAT corrigindo os dialogos SIP e ativando o RTPProy
 +
** USE_PRESENCE : OpenSIPS irá agir como um servidor de Presence
 +
** USE_DIALPLAN : OpenSIPS irá utilizar o modulo '''dialplan''' para transformação de números (usuario disca 1234 1234 e ele transofrma para 55 11 1234 1234 por exemplo)
 +
** VM_DIVERSION : OpenSIPS irá redicionar chamadas para voicemail chamadas que não seja possivel entregar ao assinante
 +
** HAVE_INBOUND_PSTN : OpenSIPS irá aceitar chamadas de gateways PSTN (com autenticação estatica por IP)
 +
** HAVE_OUTBOUND_PSTN : OpenSIPS irá enviar chamadas númericas para o gateway PSTN (também de finido de forma statica por IP)
 +
** USE_DR_PSTN : OpenSIPS irá utilizar o suporte a rotas dinamicas ( LCR ) para enviar chamadas para PSTN
  
−
Once in the menuconfig tool, navigate to the 'Generate OpenSIPS Script' option, and then choose your desired script type.
+
===Script para Trunking===
−
Once you have chosen you script type, you will be able to go to configure the various available options for that script ( described below ). Enabling certain options per script is done by using the spacebar key. Once you have configured your desired options, you can hit the 'q' key to go to the previous menu, and hit 'Save Changes'. Then, you can generate the OpenSIPS script with your configurations. At the end, the graphical tool will give you the path for your newly generated config file ( eg : Config generated : /usr/local/opensips_proxy_1.9/etc/opensips/opensips_residential_2013-5-21_11:39:48.cfg )
 
  
−
%rfloat width=400px % http://opensips.org/images/menuconfig_snapshot.png | ''' '''
+
** ENABLE_TCP : OpenSIPS irá ativar funcionalidade para requisições SIP sobre TCP
 +
** ENABLE_TLS : OpenSIPS irá aceitar requisições utilizando TLS
 +
** USE_DBACC : OpenSIPS irá salvar as entradas de ACC (accounting) no banco de dados
 +
** USE_DIALPLAN : OpenSIPS irá utilizar o modulo '''dialplan''' para transformação de números (usuario disca 1234 1234 e ele transofrma para 55 11 1234 1234 por exemplo)
 +
** USE_DIALOG : OpenSIPS irá manter um rastro de todos os dialogos ativos
 +
** DO_CALL_LIMITATION : OpenSIPS irá realizar limitação por numero de chamadas paralelas por tronco
  
−
!!! Types of Configs
+
===Script para Load-Balancer===
  
−
So far, the OpenSIPS 1.9 menuconfig automated script generator supports 3 types of scripts. Here are the types of scripts, along with the available options per script :
+
** ENABLE_TCP : OpenSIPS irá ativar funcionalidade para requisições SIP sobre TCP
 +
** ENABLE_TLS : OpenSIPS irá aceitar requisições utilizando TLS
 +
** USE_DBACC : OpenSIPS irá salvar as entradas de ACC (accounting) no banco de dados
 +
** USE_DISPATCHER : OpenSIPS irá utilizar o DISPATCHER (modulo) invés do Load-Balancer (modulo) para realizar a distribuição de tráfego
 +
** DISABLE_PINGING : OpenSIPS não irá testar conectividade com todos os destinos (gateways) , porém ele irá realizar este teste quando for detectado falha
  
−
* Residential Script
+
==Editando o script gerado==
  
−
** ENABLE_TCP : OpenSIPS will listen on TCP for SIP requests
+
Após a geração de seu script através do menuconfig você precisa abrir seu script com um editor de texto e localizar todas as entradas que contenham '# CUSTOMIZE ME' , estes comentários marcam os locais onde sua atenção é necessária e normalmente refere-se ao endereços do servidor ou configurações de banco de dados.
−
** ENABLE_TLS : OpenSIPS will listen on TCP for SIP requests
 
−
** USE_ALIASES : OpenSIPS will allow the use of Aliases for SIP users
 
−
** USE_AUTH : OpenSIPS will authenticate Register & Invite requests
 
−
** USE_DBACC : OpenSIPS will save ACC entries in DB for all calls
 
−
** USE_DBUSRLOC : OpenSIPS will persistently store User Location entries in the DB
 
−
** USE_DIALOG : OpenSIPS will keep track of active dialogs
 
−
** USE_MULTIDOMAIN : OpenSIPS will handle multiple domains for subscribers
 
−
** USE_NAT : OpenSIPS will try to cope with NAT by fixing SIP msgs and engaging RTPProxy
 
−
** USE_PRESENCE : OpenSIPS will act as a Presence server
 
−
** USE_DIALPLAN : OpenSIPS will use dialplan for transformation of local numbers
 
−
** VM_DIVERSION : OpenSIPS will redirect to VM calls not reaching the subscribers
 
−
** HAVE_INBOUND_PSTN : OpenSIPS will accept calls from PSTN gateways (with static IP authentication)
 
−
** HAVE_OUTBOUND_PSTN : OpenSIPS will send numerical dials to PSTN gateways (with static IP definition)
 
−
** USE_DR_PSTN : OpenSIPS will use Dynamic Routing Support ( LCR ) for PSTN interconnection
 
  
−
* Trunking Script
+
Após realizar as devidas modificações você pode salvar o seu script e leva-lo para um test drive
−
 
 
−
** ENABLE_TCP : OpenSIPS will listen on TCP for SIP requests
 
−
** ENABLE_TLS : OpenSIPS will listen on TCP for SIP requests
 
−
** USE_DBACC : OpenSIPS will save ACC entries in DB for all calls
 
−
** USE_DIALPLAN : OpenSIPS will use dialplan for transformation of local numbers
 
−
** USE_DIALOG : OpenSIPS will keep track of active dialogs
 
−
** DO_CALL_LIMITATION : OpenSIPS will limit the number of parallel calls per trunk
 
−
 
 
−
* Load-Balancer Script
 
−
 
 
−
** ENABLE_TCP : OpenSIPS will listen on TCP for SIP requests
 
−
** ENABLE_TLS : OpenSIPS will listen on TCP for SIP requests
 
−
** USE_DBACC : OpenSIPS will save ACC entries in DB for all calls
 
−
** USE_DISPATCHER : OpenSIPS will use DISPATCHER instead of Load-Balancer for distributing the traffic
 
−
** DISABLE_PINGING : OpenSIPS will not ping at all the destinations (otherwise it will ping when detected as failed)
 
−
 
 
−
!!! Post-Generation Script editing
 
−
 
 
−
After generating your OpenSIPS script with the menuconfig tool, you need to open the script with your favorite editor, and go through all the '# CUSTOMIZE ME' comments in the script. Those comments mark the places where user attention is needed, and usually refer to customizing the OpenSIPS listening address or setting the proper database URL.
 
−
 
 
−
Upon making the appropriate '# CUSTOMIZE ME' changes, you can save your script and take it for a test drive.
 

Edição das 18h12min de 5 de outubro de 2013

A geração de arquivos de configuração é feita através da ferramenta menuconfig, devido a interface utilizada ser baseada em ncurses por favor tneha certeza de primeiro instalar as bibliotecas de desenvolvimento (normalmente libncurses5-dev)


Usando a ferramenta Menuconfig

O menuconfig pode ser executado diretamente apartir dos sources do opensips ou depois da instalação apartir do diretorio de instalação:

  • Apartir do código você executa
make menuconfig
  • Após a instalação, você pode utilizar o comando abaixo
[install_path]/sbin/osipsconfig


Uma vez na ferramente, localize a opção 'Generate OpenSIPS Script', e então selecione a opção desejada, uma vez feita a escolha do tipo de script que você está gerando você poderá configurar várias opções para este script (descrito a seguir). A ativação das opções é feita pressionando a barra de espaço de seu teclado, uma vez configurada as opções desejadas você pode pressionar a tecla 'q' para voltar ao menu anterior e então selecionar 'Save Changes', finalmente você poderá gerar seu arquivo de configuração. No fim do processo a interface irá lhe fornecer o caminho para seu novo arquivo de cofniguração, veja abaixo um exemplo: 

Config generated : /usr/local/opensips_proxy_1.9/etc/opensips/opensips_residential_2013-5-21_11:39:48.cfg


Tipos de Configuração

No momento o gerador de script do OpenSIPS (versao 1.9) suporta 3 tipos de scripts, abaixo temos os tipos e as opções disponiveis por script:

Script Residencial

    • ENABLE_TCP : OpenSIPS irá ativar funcionalidade para requisições SIP sobre TCP
    • ENABLE_TLS : OpenSIPS irá aceitar requisições utilizando TLS
    • USE_ALIASES : OpenSIPS irá permitir a utilização de Aliases para os usuários
    • USE_AUTH : OpenSIPS irá autenticar requisições de REGISTER e INVITE
    • USE_DBACC : OpenSIPS irá salvar as entradas de ACC (accounting) no banco de dados
    • USE_DBUSRLOC : OpenSIPS irá armazenar de forma persistente as entradas de Localização de usuário no banco de dados
    • USE_DIALOG : OpenSIPS irá manter um rastro de todos os dialogos ativos
    • USE_MULTIDOMAIN : OpenSIPS irá aceitar assinantes de dominios diferentes
    • USE_NAT : OpenSIPS irá tentar tratar o NAT corrigindo os dialogos SIP e ativando o RTPProy
    • USE_PRESENCE : OpenSIPS irá agir como um servidor de Presence
    • USE_DIALPLAN : OpenSIPS irá utilizar o modulo dialplan para transformação de números (usuario disca 1234 1234 e ele transofrma para 55 11 1234 1234 por exemplo)
    • VM_DIVERSION : OpenSIPS irá redicionar chamadas para voicemail chamadas que não seja possivel entregar ao assinante
    • HAVE_INBOUND_PSTN : OpenSIPS irá aceitar chamadas de gateways PSTN (com autenticação estatica por IP)
    • HAVE_OUTBOUND_PSTN : OpenSIPS irá enviar chamadas númericas para o gateway PSTN (também de finido de forma statica por IP)
    • USE_DR_PSTN : OpenSIPS irá utilizar o suporte a rotas dinamicas ( LCR ) para enviar chamadas para PSTN

Script para Trunking

    • ENABLE_TCP : OpenSIPS irá ativar funcionalidade para requisições SIP sobre TCP
    • ENABLE_TLS : OpenSIPS irá aceitar requisições utilizando TLS
    • USE_DBACC : OpenSIPS irá salvar as entradas de ACC (accounting) no banco de dados
    • USE_DIALPLAN : OpenSIPS irá utilizar o modulo dialplan para transformação de números (usuario disca 1234 1234 e ele transofrma para 55 11 1234 1234 por exemplo)
    • USE_DIALOG : OpenSIPS irá manter um rastro de todos os dialogos ativos
    • DO_CALL_LIMITATION : OpenSIPS irá realizar limitação por numero de chamadas paralelas por tronco

Script para Load-Balancer

    • ENABLE_TCP : OpenSIPS irá ativar funcionalidade para requisições SIP sobre TCP
    • ENABLE_TLS : OpenSIPS irá aceitar requisições utilizando TLS
    • USE_DBACC : OpenSIPS irá salvar as entradas de ACC (accounting) no banco de dados
    • USE_DISPATCHER : OpenSIPS irá utilizar o DISPATCHER (modulo) invés do Load-Balancer (modulo) para realizar a distribuição de tráfego
    • DISABLE_PINGING : OpenSIPS não irá testar conectividade com todos os destinos (gateways) , porém ele irá realizar este teste quando for detectado falha

Editando o script gerado

Após a geração de seu script através do menuconfig você precisa abrir seu script com um editor de texto e localizar todas as entradas que contenham '# CUSTOMIZE ME' , estes comentários marcam os locais onde sua atenção é necessária e normalmente refere-se ao endereços do servidor ou configurações de banco de dados.

Após realizar as devidas modificações você pode salvar o seu script e leva-lo para um test drive

Disponível em “http://opensips.com.br/wiki/index.php?title=Gerando_os_arquivos_de_configuração&oldid=1436”