Mudanças entre as edições de "Compilando e instalando o OpenSIPS"
(19 revisões intermediárias pelo mesmo usuário não estão sendo mostradas) | |||
Linha 1: | Linha 1: | ||
A página a seguir deste manual, esta direcionada a usuários que desejam compilar o OpenSIPS 1.9 a partir do código fonte. | A página a seguir deste manual, esta direcionada a usuários que desejam compilar o OpenSIPS 1.9 a partir do código fonte. | ||
− | Vá para [http://opensips.svn.sourceforge.net/viewvc/opensips/branches/1.9/INSTALL instruções de instalação] do OpenSIPS - este é um link direcionado a INSTALAR a partir do repositório SVN, que contém a versão atualizada. | + | Vá para '''[http://opensips.svn.sourceforge.net/viewvc/opensips/branches/1.9/INSTALL instruções de instalação]''' do OpenSIPS - este é um link direcionado a INSTALAR a partir do repositório SVN, que contém a versão atualizada. |
+ | |||
+ | O arquivo de instalação fornece informações sobre: | ||
+ | |||
+ | # Arquiteturas suportadas e requisitos | ||
+ | # Como compilar o OpenSIPS a partir do código fonte | ||
+ | # Guia rápido de instalação | ||
+ | ## Obtendo ajuda | ||
+ | ## Retratação | ||
+ | ## Guia rápido | ||
+ | ## OpenSIPS com armazenamento de dados persistente | ||
+ | # Solução de problemas | ||
+ | |||
+ | |||
+ | ---- | ||
+ | |||
+ | == Video Tutorial == | ||
+ | |||
+ | O time do OpenSIPS realizou um webinar, que irá guiá-lo através do processo de como se fazer uma instalação rápida de OpenSIPS ( downloading dos fontes, compilação, instalação, etc ) e o OpenSIPS Control Panel ( instalando, provisionando usuários ), iremos mostra-ló o que você tem que fazer para transforma-ló em uma plataforma totalmente funcional em gerenciamento de minutos. Se você encontrar tutoriais em vídeo mais fácil que baseados em texto, por favor fique a vontade para ir a '''[http://www.opensips.org/Documentation/Tutorials-GettingStarted Webinar - Instalação OpenSIPS]''' e realizar o download do vídeo. | ||
+ | |||
+ | ==Compile== | ||
+ | Navegue até a pasta do código fonte do OpenSIPS, e a partir desta pasta você pode executar: | ||
+ | |||
+ | <pre> | ||
+ | make all | ||
+ | </pre> | ||
+ | |||
+ | e o núcleo do OpenSIPS, juntamente com todos os módulos será configurado e compilado. | ||
+ | |||
+ | ===Configuring compilation Flags=== | ||
+ | |||
+ | O OppenSIPS tem varias opção de tempo de compilação, que afetam as suas capacidades. Por exemplo, você pode optar por habilitar o debug de memória alocada, ou habilitar o TLS ( por padrão é desabilitado ), etc. | ||
+ | |||
+ | Para alterar essas opções em tempo de compilação, você deve usar a ferramenta '''menuconfig'''. A ferramenta '''menuconfig''' é baseada em curses. Antes de tentar executá-lo, você deve instalar a biblioteca de desenvolvimento ncurses. | ||
+ | Em sistemas baseados em Debian, normalmente você pode fazer isso executando: | ||
+ | <pre> | ||
+ | apt-get install libncurses5-dev | ||
+ | </pre> | ||
+ | |||
+ | Após isso, você pode ir pasta do código fonte do OpenSIPS, e executar: | ||
+ | |||
+ | <pre> | ||
+ | make menuconfig | ||
+ | </pre> | ||
+ | |||
+ | Navegue até o menu '''Configure Compile Options''', aqui você pode simplesmente usar as setas ( A CIMA + A BAIXO ) para navegar através das opções ( elas são explicadas brevemente na parte inferior do console ). Habilitar ou desabilitar uma opção com a barra de espaço. Após finalizar suas configurações, você pode retornar pressionando a tecla '''q''' e em seguida clique em '''Save Changes'''. | ||
+ | |||
+ | Depois que qualquer mudança no Compilation Flags, você deverá recompilar e reinstalar seus OpenSIPS. | ||
+ | |||
+ | ===Compilando módulos com dependências externas=== | ||
+ | |||
+ | Existem alguns módulos do OpenSIPS que não são compilados por padrão, estes módulos exigem dependências externas que pode ou não vir por padrão no sistema. Assim, esses módulos exigem sua atenção quando se faz uma instalação a partir do código fonte. Alguns exemplos de módulos são '''DB_MYSQL''' (depende da biblioteca de desenvolvimento do mysql), '''JSON''' (depende de um analisador JSON externo), etc. | ||
+ | |||
+ | Para permitir a compilação de tais módulos, você deve usar a ferramenta menuconfig também. | ||
+ | Execute '''make menuconfig''' na pasta raiz do código fonte do OpenSIPS e, em seguida, vá para '''Configure Excluded Modules'''. Nesta seção, você verá a lista de todos os módulos que não estão habilitadas por padrão, juntamente com uma breve explicação sobre a funcionalidade de cada módulo que é mostrada na parte inferior do console. | ||
+ | |||
+ | Ativar / desativar um módulo específico é feito com a tecla barra de espaço. Depois de ter selecionado todos os seus módulos necessários, você deve pressionar a tecla '''q''', a fim de voltar ao menu anterior, e, em seguida, clique em '''Save Changes'''. A ferramenta irá mostrar os módulos selecionados, e irá dizer as dependências que você precisa instalar para compilar com sucesso os módulos. | ||
+ | |||
+ | Depois que qualquer mudança no Compilation Flags, você deverá recompilar e reinstalar seus OpenSIPS. | ||
+ | |||
+ | ==Instalando== | ||
+ | |||
+ | Para instalar o OpenSIPS, vá para as pasta que contém o código fonte, e execute: | ||
+ | |||
+ | <pre> | ||
+ | make install | ||
+ | </pre> | ||
+ | |||
+ | Por padrão, o OpenSIPS irá ser instala no diretório '''/'''. | ||
+ | |||
+ | ===Configurando o caminho de instalação=== | ||
+ | |||
+ | Às vezes, você pode querer alterar o caminho de instalação do OpenSIPS, devido a várias razões (como a necessidade de implantar duas instâncias OpenSIPS na mesma máquina). | ||
+ | |||
+ | Para fazer isso, você deve usar a ferramenta '''menuconfig'''. | ||
+ | |||
+ | Execute '''make menuconfig''' e vá para '''Configure Install Prefix''''. Em seguida, digite o seu diretório de instalação personalizado para o OpenSIPS, e pressione '''enter'''. Em seguida, navegue até "'''Save Changes''', e pressione '''enter'''. | ||
+ | |||
+ | Depois, você pode executar '''make install''' novamente e o OpenSIPS será instalado em seu diretório recém-configurado. |
Edição atual tal como às 20h09min de 30 de julho de 2013
A página a seguir deste manual, esta direcionada a usuários que desejam compilar o OpenSIPS 1.9 a partir do código fonte.
Vá para instruções de instalação do OpenSIPS - este é um link direcionado a INSTALAR a partir do repositório SVN, que contém a versão atualizada.
O arquivo de instalação fornece informações sobre:
- Arquiteturas suportadas e requisitos
- Como compilar o OpenSIPS a partir do código fonte
- Guia rápido de instalação
- Obtendo ajuda
- Retratação
- Guia rápido
- OpenSIPS com armazenamento de dados persistente
- Solução de problemas
Índice
Video Tutorial
O time do OpenSIPS realizou um webinar, que irá guiá-lo através do processo de como se fazer uma instalação rápida de OpenSIPS ( downloading dos fontes, compilação, instalação, etc ) e o OpenSIPS Control Panel ( instalando, provisionando usuários ), iremos mostra-ló o que você tem que fazer para transforma-ló em uma plataforma totalmente funcional em gerenciamento de minutos. Se você encontrar tutoriais em vídeo mais fácil que baseados em texto, por favor fique a vontade para ir a Webinar - Instalação OpenSIPS e realizar o download do vídeo.
Compile
Navegue até a pasta do código fonte do OpenSIPS, e a partir desta pasta você pode executar:
make all
e o núcleo do OpenSIPS, juntamente com todos os módulos será configurado e compilado.
Configuring compilation Flags
O OppenSIPS tem varias opção de tempo de compilação, que afetam as suas capacidades. Por exemplo, você pode optar por habilitar o debug de memória alocada, ou habilitar o TLS ( por padrão é desabilitado ), etc.
Para alterar essas opções em tempo de compilação, você deve usar a ferramenta menuconfig. A ferramenta menuconfig é baseada em curses. Antes de tentar executá-lo, você deve instalar a biblioteca de desenvolvimento ncurses. Em sistemas baseados em Debian, normalmente você pode fazer isso executando:
apt-get install libncurses5-dev
Após isso, você pode ir pasta do código fonte do OpenSIPS, e executar:
make menuconfig
Navegue até o menu Configure Compile Options, aqui você pode simplesmente usar as setas ( A CIMA + A BAIXO ) para navegar através das opções ( elas são explicadas brevemente na parte inferior do console ). Habilitar ou desabilitar uma opção com a barra de espaço. Após finalizar suas configurações, você pode retornar pressionando a tecla q e em seguida clique em Save Changes.
Depois que qualquer mudança no Compilation Flags, você deverá recompilar e reinstalar seus OpenSIPS.
Compilando módulos com dependências externas
Existem alguns módulos do OpenSIPS que não são compilados por padrão, estes módulos exigem dependências externas que pode ou não vir por padrão no sistema. Assim, esses módulos exigem sua atenção quando se faz uma instalação a partir do código fonte. Alguns exemplos de módulos são DB_MYSQL (depende da biblioteca de desenvolvimento do mysql), JSON (depende de um analisador JSON externo), etc.
Para permitir a compilação de tais módulos, você deve usar a ferramenta menuconfig também. Execute make menuconfig na pasta raiz do código fonte do OpenSIPS e, em seguida, vá para Configure Excluded Modules. Nesta seção, você verá a lista de todos os módulos que não estão habilitadas por padrão, juntamente com uma breve explicação sobre a funcionalidade de cada módulo que é mostrada na parte inferior do console.
Ativar / desativar um módulo específico é feito com a tecla barra de espaço. Depois de ter selecionado todos os seus módulos necessários, você deve pressionar a tecla q, a fim de voltar ao menu anterior, e, em seguida, clique em Save Changes. A ferramenta irá mostrar os módulos selecionados, e irá dizer as dependências que você precisa instalar para compilar com sucesso os módulos.
Depois que qualquer mudança no Compilation Flags, você deverá recompilar e reinstalar seus OpenSIPS.
Instalando
Para instalar o OpenSIPS, vá para as pasta que contém o código fonte, e execute:
make install
Por padrão, o OpenSIPS irá ser instala no diretório /.
Configurando o caminho de instalação
Às vezes, você pode querer alterar o caminho de instalação do OpenSIPS, devido a várias razões (como a necessidade de implantar duas instâncias OpenSIPS na mesma máquina).
Para fazer isso, você deve usar a ferramenta menuconfig.
Execute make menuconfig e vá para Configure Install Prefix'. Em seguida, digite o seu diretório de instalação personalizado para o OpenSIPS, e pressione enter. Em seguida, navegue até "Save Changes, e pressione enter.
Depois, você pode executar make install novamente e o OpenSIPS será instalado em seu diretório recém-configurado.