GT-VOIP Documentação Técnica: Instalação e Configuração do ambiente VoIP4ALL em máquina Dell. v2.5 As telas mostradas neste documento refletem o tamanho do disco visto por uma máquina virtual por facilidade de captura de telas. Na instalação, as mensagens refletirão o tamanho e tipo do disco instalado na máquina virtual. Este documento descreve os passos de instalação do sistema operacional Debian para utilização no serviço fone@RNP e os passos adicionais para instalação do pacote adicional voip4all contendo todos os softwares necessários para a configuração do ambiente. RNP/REF/0204 1. Instalação Acesse o site http://www.voip.nce.ufrj.br/download_pt.htm e baixe a imagem do Debian Sarge; em seguida, grave um cdrom com esta imagem. Essa distribuição do Linux será utilizada na instalação do ambiente VoIP do projeto VoIP4ALL no computador Dell. Ao ligar o computador, insira o cdrom com a imagem do Debian Sarge gravado no drive de CDROM, e assim que aparecer na tela o logotipo da DEL apertar a tecla F12 e escolher a opção de boot a partir do drive de CD. Após iniciar a máquina com o cd de instalação do Debian, abre-se a tela de boot. Digite linux26 e tecle a tecla <enter> para iniciar a instalação. O próximo passo é escolher o idioma que será usado no processo de instalação. Na tela de opções selecione a lingua inglesa. GT-VoIP Documentação Técnica 2 O próximo passo da instalação é a escolha do país. Para que o Brasil apareça na listagem selecione a opção other e em seguida aperte o botão <enter>. Direcione o cursor para o Brazil e aperte o botão <enter>. GT-VoIP Documentação Técnica 3 A próxima etapa da instalação refere-se à configuração do teclado USB. Selecione a opção American English e pressione <enter>. No passo seguinte, o instalador apresentará a evolução de detecção dos componentes de hardware da máquina. Este é um processo automático, apenas informativo e não há necessidade de entrada de informação. A próxima etapa da instalação refere-se à configuração da placa de rede caso não seja detectado um servidor DHCP. Se for localizado um servidor DHCP as configurações de IP address, Netmask, DNS, Gateway não serão solicitadas, e apenas será pedido o nome (hostname) deste servidor que está sendo instalado. GT-VoIP Documentação Técnica 4 Em seguida selecione <configure network manually>. As configurações de rede serão editadas manualmente, sendo necessário selecionar um endereço IP para este servidor. Nota: se o servidor DHCP for localizado, esta tela não será mostrada. Digite o endereço IP selecionado do servidor de acordo com a política da instituição, e pressione <enter>. Neste exemplo, está sendo utilizado o endereço IP 146.164.247.233. Nota: se o servidor DHCP for localizado, esta tela não será mostrada. Digite a máscara de rede, nesse exemplo mostrado será utilizada a máscara 255.255.255.192. Nota: se o servidor DHCP for localizado, esta tela não será mostrada. GT-VoIP Documentação Técnica 5 Digite o endereço IP do gateway da rede onde o servidor estará operando, e pressione <enter>. Nesse exemplo o endereço IP é 146.164.247.193. Nota: se o servidor DHCP for localizado, esta tela não será mostrada. Digite o endereço IP do servidor DNS da instituição e pressione <enter>. Nesse exemplo mostrado foi utilizado o endereço IP do servidor DNS 146.164.247.193. Nota: se o servidor DHCP for localizado, esta tela não será mostrada. Entre com o nome do servidor, hostname, e pressione <enter>. Nesse exemplo, o nome escolhido para o servidor é servidorvoip.voip.nce.ufrj.br. Nota: se o servidor DHCP for localizado, esta será a única configuração de rede solicitada. GT-VoIP Documentação Técnica 6 A próxima etapa da instalação refere-se às partições do disco. O particionamento será feito manualmente. Selecione a opção <Manually edit particition table> e pressione <enter>. Atenção: As partições serão criadas no disco SDA (/dev/sda) do computador Dell Optiplex GX620 do projeto VoIP4ALL, mas observe que no exemplo mostrado a instalação será mostrada no disco HDA (/dev/hda), que é um disco IDE. O disco no computador Dell deverá ser particionado segundo a recomendação abaixo: Tabela 1: distribuição e configuração das partições Partição Tamanho Tipo Primaria/Logica ---- 82.2 MB Fat 16 Primaria ---- 2.1GB Fat 16 Primaria / 20 GB ReiseFS Primaria /usr 30 GB ReiseFS Lógica /var 60 GB ReiseFS Lógica GT-VoIP Documentação Técnica 7 Partição Tamanho Tipo Primaria/Logica swap 3 GB SWAP Lógica /tmp 3 GB ReiseFS Lógica /home 30 GB ReiseFs Lógica Free 11.8GB ---- Lógica Atenção: Observe que o disco rígido deste manual não possui os 160 GB do servidor do projeto VoIP4ALL (Dell Optiplex Gx620), então lembre de utilizar as informações da Tabela 1 em vez daquelas que estão sendo mostradas nas figuras. Observe que as partições FAT16 pré instaladas no computador Dell foram mantidas. Neste manual apenas será mostrado como criar as partições “/” e SWAP, e as outras devem ser criadas de acordo com as informações da Tabela 1. Para iniciar a criação das partições escolha a opção <YES>. Selecione a opção com espaço livre para criação de novas partições, ela está em <pri/log 4.2 GB FREE SPACE> (no caso de uma instalação real deveria aparecer em torno de 160 GB). Em seguida o processo de criação da partição “/” será iniciado. GT-VoIP Documentação Técnica 8 Para iniciar a criação da partição “/”, selecione a opção criar nova partição <create new partition>. Como foi mostrado na Tabela 1, a partição “/” tem 30 GB, assim será necessário editar o tamanho como mostrado na figura a seguir. A partição “/” será do tipo primária, e por isso a opção <primary> será selecionada. A partição “/” será criada no começo do espaço disponível. GT-VoIP Documentação Técnica 9 Pressione <enter> em “Use as” para escolher o tipo de partição ReiserFS, e depois selecione o tipo de partição “ReiseFS”. Selecione <done ...> para finalizar a configuração da partição “/”. NOTA: Seguindo o exemplo da criação da partição “/”, crie as outras partições mostradas na Tabela 1, exceto a partição SWAP que será mostrada a seguir. Observe que na criação das outras partições os GT-VoIP Documentação Técnica 10 nomes das partições, tipo lógica/primária e tamanho da partição serão diferentes do exemplo mostrado com a partição “/”. Para iniciar a criação da partição SWAP, conforme a Tabela 1 selecione a opção que indica a existência de espaço livre <pri/log 16 GB FREE SPACE>. Observe que quando for iniciada a criação da SWAP as partições “/usr” e “/var” já existirão, porque o correto será seguir a criação das partições na seqüência mostrada na Tabela 1. Para criar a partição de SWAP, selecione <Create new parttion>. Edite o tamanho da partição SWAP confirme a Tabela 1, ou seja, utilize 3 Gb conforme mostrado na Tabela 1. GT-VoIP Documentação Técnica 11 A partição SWAP será lógica, como mostrado a seguir. Ela ficará no início do espaço livre, então selecione <Beginning>. Para modificar o tipo de partição utilizada pela partição SWAP selecione “Use as”. A partição SWAP será do tipo “SWAP area” como é mostrado a seguir. GT-VoIP Documentação Técnica 12 Selecione <done...>, assim as modificações para a partição SWAP serão efetivadas. Ao final do processo de criação das partições aparecerá uma tela mostrando como elas estão distribuídas no disco rígido, e, além disso, as suas configurações e tamanho. Selecione <Finish> terminar o particionamento do disco rígido. Para gravar no disco rígido as partições criadas selecione <YES>. GT-VoIP Documentação Técnica 13 A seguir, serão instalados vários softwares do Debian, o que irá demorar um pouco para terminar. O próximo passo da instalação é a configuração do GRUB. Quando for perguntado se deseja que o GRUB seja instalado no MBR, selecione <Yes>. Retire o CDROM e reinicie o computador, assim caso nada tenha dado errado o LILO será mostrado, e em seguida o Linux Debian será carregado. Nessa fase será configurado o time zone do Debian e para isso selecione <OK>. GT-VoIP Documentação Técnica 14 Mesmo que a hora esteja correta, selecione <NO>. Caso estejam erradas a data ou o horário será possível configurar este computador para a sua localização de acordo com Greenwich. Como o Brasil tem mais de um fuso horário, diversas opções são oferecidas. Escolha a sua. Escolha uma boa senha para seu super usuário (root) e a confirme, digitando pela segunda vez. Cuidado para não usar uma senha 'fraca'. GT-VoIP Documentação Técnica 15 É uma boa idéia criar um usuário para executar funções cotidianas e deixar o root apenas para a administração do sistema. A seguir, esse usuário será criado. Este é o nome que será usado para efetuar log in no seu sistema Sarge. O instalador já oferece uma opção padrão, que é o primeiro nome do usuário, em letras minúsculas. Assim como o usuário root, este usuário terá uma senha, que deverá ser fornecida e confirmada em segunda digitação. Será selecionado de onde se deseja obter informações sobre os pacotes APT. As informações sobre os pacotes APT poderão ser obtidas a partir do CDROM ou utilizando algum dos protocolos listados. No exemplo, mostrado a seguir, foi selecionada a opção HTTP. GT-VoIP Documentação Técnica 16 Selecione um país onde se deseja obter as informações sobre os pacotes APTs do Debian. As informações sobre o APT serão obtidas no endereço HTTP www.las.ic.unicamp.br. NOTA: Caso o repositório da Unicamp não esteja disponível, pode ser selecionado outro repositório a sua escolha. O endereço www.las.ic.unicamp.br é apenas uma sugestão. GT-VoIP Documentação Técnica 17 O programa de instalação irá acessar o site escolhido e baixar alguns pacotes APT. Neste item desmarque todas as opções e selecione <OK>, assim apenas a instalação básica será realizada. Atenção: Nesta parte da instalação desmarque todos os itens para que somente a instalação básica do sistema seja realizada. Será iniciada a configuração do EXIM. Mova o cursor até a opção <local delivery ony; not on network>, e depois pressione <enter>. GT-VoIP Documentação Técnica 18 Selecione <Yes> e pressione <enter>, deixando não configurado o sistema de correio. Em seguida será solicitada a configuração do EXIM, e será necessário fornecer um usuário como postmaster. A sugestão é não informar usuário ou informar o root como usuário postmaster. Finalize a instalação e retire o CDROM do driver. Em seguida aparecerá um prompt, e a partir deste ponto a instalação continuará. GT-VoIP Documentação Técnica 19 Edite o arquivo /etc/apt/sources.list para acrescentar a seguinte linha: deb http://www.voip.nce.ufrj.br/voipix binary/ Em seguida digite os seguintes comandos: apt-get update apt-get install voip4all Será solicitado que o download dos pacotes seja confirmado. 0 upgraded, 196 newly installed, 0 to remove and 0 not upgraded. Need to get 162MB of archives. After unpacking 434MB of additional disk space will be used. Do you want to continue? [Y/n] y Será iniciada a configuração do banco de dados, em seguida selecione <OK> e pressione <enter>. Selecione <No>. GT-VoIP Documentação Técnica 20 Selecione <en_US>. Selecione European. Selecione <Yes>. GT-VoIP Documentação Técnica 21 Selecione A4, e com a tecla <TAB> mova o cursor até a opção <OK>. Não utilize a detecção automática, assim será necessário selecionar <No> e pressionar <enter>. Será iniciada a configuração do xserver-xfree86, selecione a opção vesa. GT-VoIP Documentação Técnica 22 Selecione <Ok> e pressione <enter>. Na próxima tela com o título “Configuring xserver-xfree86”, após ler as informações, pressione <enter>. Na configuração do teclado digite br GT-VoIP Documentação Técnica 23 Nesta configuração, digite <enter>. Nesta configuração, digite <enter>. Nesta configuração, pressione <enter>. GT-VoIP Documentação Técnica 24 Depois, selecione /dev/input/mice. Selecione <No> se o monitor não for do tipo LCD (Liquid Crystal Display). Escolha a opção <Advanced>. GT-VoIP Documentação Técnica 25 Confirme o valor <28-50>. Confirme o valor <43-75>. Escolha a maior relação resolução/freqüência que o seu monitor suporta, mas cuidado, porque se o seu monitor for antigo, ele poderá até “queimar” se você selecionar valores mais altos que o suportado. Se seu monitor é mais moderno, ele não vai “queimar” e mostrará algo como ‘Out of Sync’ ou ‘Fora de sincronia’. Uma sugestão para o vídeo é a escolha da resolução 1024x768. Selecione 24-bit de cor na opção <24>. GT-VoIP Documentação Técnica 26 Resolução de impressão para 600 dpi. Selecione Apache2, que é a última opção, e pressione <enter>. Indique o endereço IP do seu servidor LDAP e confirme. Selecione <No>, assim não será utilizado LDAP com TLS. Preencha com o caminho da árvore utilizado pela sua instituição. GT-VoIP Documentação Técnica 27 Selecione a opção <session> e pressione <enter>. Coloque o caminho do administrador do LDAP e pressione <enter>. Marque apenas Apache2 e confirme pressionando <enter>. GT-VoIP Documentação Técnica 28 Confirme o reinício do sistema e aguarde o reinício. No prompt, execute o comando abaixo para configuração do ambiente instalado: apt-get install voip4all-config Escolha a opção <Select Keymap from arch list> e confirme. Mova o curso e escolha a quarta opção, que é qwerty, e em seguida confirme pressionando <enter>. GT-VoIP Documentação Técnica 29 Escolha a opção Brazilian. Para o layout do teclado, escolha a opção standard. GT-VoIP Documentação Técnica 30 Aguarde, enquanto os serviços são reiniciados. Em seguida serão descritos alguns passos necessários para a configuração final do ambiente VoIP do projeto VoIP4ALL: Caso o teclado não esteja corretamente configurado, execute o comando abaixo: setxkbmap –model abnt2 –layout br –variant abnt2 Os passos a seguir devem ser executados apenas na máquina 1 Via browser acesse a URL http://127.0.0.1/voipixconf . Clique em Alterar configuração atual preencha o formulário segundo as informações de sua instituição. Obs. 1: Deixe o campo Prefixos de outras instituições com o mesmo código de área em branco. Estas informações serão configuradas no futuro. Obs. 2: Nos campos relativos a Usuários/Senhas, use voipix como a senha padrão em todos campos. Estas senhas só poderão ser alteradas após o procedimento de homologação. Em Usuário openser do SQL utilize openser e em Usuário radius do SQL utilize radius. Obs. 3: Em Portas Asterisk utilize 5070 para SIP e 1730 para H323. Obs. 4: Em Prefixo fornecido pela RNP utilize o número com 4 dígitos. Lembre-se que todo prefixo é iniciado com 1. Ex.: para 100, use 1100. Após preencher e confirmar o formulário, clique em Efetuar configuração. GT-VoIP Documentação Técnica 31 Copie os arquivos que estão em /etc/voipixconf/novo/ para os seus respectivos locais utilizando o comando abaixo: bash /usr/local/voip4all/copia.sh Copie os arquivos da máquina 1 que estão no diretório /etc/voipixconf/novo/ para a máquina2. Siga o exemplo abaixo: cd /etc/voipixconf/novo tar zcvf configuracoes.tar.gz * scp configuracoes.tar.gz root@ <IP da maq. 2>:/etc/voipixconf/novo/. <entre com a senha de root da máquina 2> Obs.: Substitua <ip maq. 2> pelo IP da máquina 2 Siga os comandos abaixo para criar uma configuração padrão do media-proxy: cd /usr/local/mediaproxy cp mediaproxy.ini.sample mediaproxy.ini Agora altere a configuração padrão do media-proxy: o Localize a linha “start = yes” e descomente-a retirando o ponto e vírgula “;”; o Localize a linha “portRange = 35000:65000” e descomente-a retirando o ponto e vírgula “;”. Em seguida alterando-a para ““portRange = 50000:50999”; o Localize a linha “proxyIP = 10.0.0.1” e descomente-a retirando o ponto e vírgula “;”. Em seguida alterando-a para ““proxyIP = <IP maq. 1>”. Onde <IP maq. 1> é o endereço IP de sua máquina 1. As linhas alteradas devem como o exemplo abaixo: start = yes portRange = 50000:50998 proxyIP = <IP máq. 1> Obs.: Substitua <ip maq. 1> pelo IP da máquina 1 Altere o arquivo /etc/gnugk.ini adicionado a linha abaixo na seção [RoutedMode] H245PortRange=30000-30999 GT-VoIP Documentação Técnica 32 Esta linha deve ser incluída para limitar a abertura de portas TCP dinâmicas da sinalização H.245 entre o intervalo de 30000 e 30999. Esta linha é necessária, pois a versão do canal oh323 utilizada no Asterisk operando como gateway SIP/H.323 não faz tunneling H.245, mesmo estando configurado para isso. IMPORTANTE: Lembre-se de abrir também estas portas no firewall. A regra no firewall deve conter o destino como o IP da máquina 1 e a origem como qualquer IP. Edite o arquivo /etc/gnugk.ini e altere na seção GKStatus::Auth] a linha abaixo, acrescentando o IP de sua rede. Isso permitirá que as máquinas de sua rede tenham acesso a porta de gerência do gnugk. regex=^146\.164\.247\.(19[3-9]|2[0-5][0-9])|^127\.0\.0\.1|^200\.130\.25\.170$ |^200\.143\.193\.131$ # Alterar para a sua rede Os passos a seguir devem ser executados apenas na máquina 2 Extraia os arquivos copiados a partir da máquina 1: cd /etc/voipixconf/novo tar zxvf configuracoes.tar.gz Execute o comando abaixo para copiá-los para o local correto: bash /usr/local/voip4all/copia.sh Altere o arquivo /etc/postgresql/pg_hba.conf adicionando as seguintes linhas do quadro a seguir entre a linha “#All Ipv4 connections from localhost” e a linha “host all all 127.0.0.1 255.255.255.255 md5”. host all all <ip maq. 1> 255.255.255.255 md5 host all all <ip maq. 2> 255.255.255.255 md5 Obs.: Substitua <ip maq. 1> pelo IP da máquina 1 e <ip maq. 2> pelo IP da máquina 2. Reiniciar o servidor postgres: /etc/init.d/postgresql restart Inserir na tabela domain o domínio da instituição e na tabela trusted o endereço IP do Asterisk atuando como gateway H.323 / SIP; GT-VoIP Documentação Técnica 33 psql –d openser –U openser <entre com a senha do openser, que é voipix> openser=>INSERT INTO domain VALUES (‘<realm_da_instituição>’ , now()); openser=>INSERT INTO trusted VALUES (‘<ip maq. 1>’, ‘udp‘, ‘^sip:.*’ ); openser=>\q Obs. 1: Substitua <realm da instituição> pela informação da instituição.. Obs. 2 Substitua <ip maq. 1> pelo IP da máquina 1 Para criar o banco de dados do LDAP edite o arquivo /usr/local/voip4all/inicial.ldif. As informações que serão editadas nesse arquivo são modificadas de acordo com a instituição; # Coloque no campo "dn" a informacao do no # Exemplo: dc=voip,dc=nce,dc=ufrj,dc=br # nos campos "dc" e "o", utilize o valor do primeiro campo do dn # no exemplo "voip" dn: dc=teste,dc=org objectClass: dcObject objectClass: organization dc: teste o: teste # Inserir users dn: ou=users,dc=teste,dc=org ou: users objectClass: organizationalunit objectClass: top Obs. : Altere as linhas em negrito. Preste atenção para colocar nas linhas dc: e o: o primeiro componente da primeira linha dn:. Inicie o servidor LDAP: /etc/init.d/slapd start Execute o comando abaixo para inserir as /usr/local/voip4all/inicial.ldif no banco de dados do LDAP; informações do arquivo ldapadd -x -D “cn=admin,dc=dominio,dc=br” –f /usr/local/voip4all/inicial.ldif -W GT-VoIP Documentação Técnica 34 Nota: Substitua “dc=dominio,dc=br” pelas informações da instituição. Isto deve ser igual ao que foi definido no arquivo /usr/local/voip4all/inicial.ldif. Inicie os outros serviços que devem operar na máquina 2: update-rc.d slapd defaults 40 update-rc.d radiusd defaults 50 update-rc.d asterisk defaults 50 /etc/init.d/asterisk start /etc/init.d/radiusd start Reinicie o servidor Apache: /etc/init.d/apache2 restart Os passos a seguir devem ser executados na máquina 1 Inicie os serviços que devem operar na máquina 1: update-rc.d gnugk defaults 30 update-rc.d mediaproxy defaults 30 update-rc.d openser defaults 40 update-rc.d asterisk defaults 40 /etc/init.d/gnugk start /etc/init.d/mediaproxy start /etc/init.d/openser start /etc/init.d/asterisk start Os passos a seguir devem ser executados apenas na máquina 2 Utilizando um browser acesse a URL http://127.0.0.1/ger. Clique em Configurações iniciais e preencha o formulário segundo as informações de sua instituição e clique em Aplicar: GT-VoIP Documentação Técnica 35 Caso todos os passos anteriores tenham sido executados com sucesso, já será possível utilizar a opção novo usuário para criar usuários e iniciar os testes de homologação. GT-VoIP Documentação Técnica 36