Manual do usuário Web - AGOS
Introdução
AGOS (Aligera Operational System) é a distribuição Linux da Aligera que é embarcada nos Media Gateways.
O presente manual apresenta procedimentos de configuração utilizando sua interface Web. Sua elaboração utilizou a versão de firmware 4.55.8, versões anteriores a esta podem haver divergências, consulte nosso suporte para verificar a possibilidade de atualização. Para versões do AGOS3 (7.3.xx) utilize a versão própria de manual.
Primeiro acesso
O IP padrão do equipamento é 192.168.1.10 com máscara de rede 255.255.255.0. O IP padrão está configurado na interface Ethernet 1.
O PC do usuário deve possuir a configuração de rede que se encontra no mesmo segmento de endereço IP e máscara de rede do equipamento.
Certifique-se que o cabo de rede esteja conectado corretamente. Na barra de endereços do navegador digite https://192.168.1.10 aparecerá a página mostrada na figura abaixo:
Para acessar a interface de configuração entre com o usuário admin e senha aligera. Altere a senha após o primeiro acesso por medida de segurança.
Administration
User
System users
A manutenção dos usuários de acesso ao sistema AGOS é realizada no menu System users disponível em Administration/User, através deste é possível adicionar, alterar e excluir usuários.
O usuário admin é o principal usuário do sistema AGOS, desta forma não é permitido ser removido ou alterado seu nível de privilégio.
Os usuários podem possuir níveis de privilégios diferentes, conforme descrito abaixo:
Privilege Level | Descrição |
---|---|
Admin | Possui os mesmos privilégios do usuário admin. |
User | Possui privilégios limitados, não possui permissão para alterações nas configurações. |
SFTP | Possui privilégio apenas para conexões SFPT. |
Após efetuadas as configurações de usuários, salve as configurações clicando em Save.
System
System Info
Informa os dados sistema: Modelo do hardware, número de série e tempo em que o sistema esta em operação desde o último reinício.
Firmware
Informa a versão de firmware instalada no equipamento, e possibilita sua atualização.
-O processo de atualização deve ser sempre realizado para uma versão posterior à instalada no equipamento, nunca para uma versão anterior. Não nos responsabilizamos por quaisquer efeitos colaterais decorrentes de downgrade não suportado.
-A atualização deve ser sempre realizada para um release da mesma familia, por exemplo, se a versão do gateway for 7.3.xx, o mesmo deve ser sempre atualizado para uma versão 7.3.xx. Se for 4.xx.xx ou 4.xx, deve ser sempre atualizado para uma versão 4.xx.xx.
Atualização:
Acessar o equipamento preferencialmente através da rede principal (aquela com o default gateway)
Realizar o backup de configurações do equipamento através da interface WEB e da CLI:
-Backup através da interface WEB: Administration > Configuration Management
-Backup através da CLI: executar o comando "config show". Copie o texto e salve em um arquivo do bloco de notas
Certifique-se de que o arquivo de backup gerado através da interface WEB esteja íntegro.
Faça a atualização a partir do arquivo *.bundle.
License
Exibe com detalhes as licenças carregadas no sistema. Através deste menu é possível carregar novas licenças ou ampliar a quantidade de licenças existentes de acordo com a capacidade do hardware.
Physical Interfaces
Exibe a quantidade de interfaces presentes no hardware.
Reboot Device
Efetua o reinicio do sistema operacional, neste processo as configurações serão mantidas.
Configuration Management
Exibe o horário configurado no equipamento, e disponibiliza a ferramenta para execução de backups e restores.
Através da função Activate as configurações previamente salvas passam a ser aplicadas no sistema, sempre que for necessário ativar uma configuração salva o sistema irá exibir um ícone "!" (laranja) ao lado no nome do equipemento no topo da tela. Ao ativar as configurações uma mensagem informativa exibirá os serviços afetados, dependendo das alterações efetuadas, esta operação poderá impactar no tráfego de voz momentaneamente, esta interrupção é previamente informada.
Utilizando a função Save Current Configuration as configurações aplicadas do sistema são direcionadas para uma lista de configurações salvas.
Os ítens da lista de configurações salvas podem ser exportados para um arquivo externo a ser salvo no PC do usuário, bem como restaurar para o sistema. A lista armazena uma quantidade limitada de arquivos de configurações, apagando os mais antigos automaticamente ao criar novos. Para evitar a deleção de um arquivo da lista, basta favoritar o mesmo, marcando a estrela ao lado esquerdo do nome.
Logging
Ferramentas destinadas a análise e mapeamento de tráfego e diagnóstico do equipamento, auxiliando no tratamento de anormalidades.
Não é necessário executar Activate ao habilitar ou desabilitar logs e capturas neste equipamento, ao selecionar a opção desejada o equipamento já recebe esta informação instantaneamente
Logging Settings
O início da coleta dos logs é iniciada ao habilitar o respectivo tipo, após alcançado um limite fixo de tamanho do arquivo a coleta é finalizada, caso deseje recomeçar uma nova coleta desabilite e habilite novamente. Os arquivos gerados poderão ser visualizados em editores de texto simples.
Campo | Descrição |
---|---|
SIP Debug | Selecione Enabled para habilitar as mensagens de debug do SIP. Caso contrário, Disabled. |
SS7 Debug | Selecione Enabled para habilitar as mensagens de debug da sinalização SS7. Caso contrário, Disabled. |
Full Debug | Selecione Enabled para habilitar as mensagens de debug de todas as sinalizações. Caso contrário, Disabled. |
Packet Capture Settings
O início da captura é iniciada ao habilitar o respectivo tipo, após alcançado um limite fixo de tamanho do arquivo a captura é finalizada, caso deseje recomeçar uma nova captura desabilite e habilite novamente. Os arquivos gerados poderão ser visualizados em programas de analise de tráfego de rede.
Campo | Descrição |
---|---|
SIP | Selecione Enabled para habilitar a captura das mensagens do tipo SIP. Caso contrário, Disabled. |
RTP | Selecione Enabled para habilitar a captura das mensagens do tipo RTP. Necessário habilitar a captura de mensagens SIP previamente. Caso contrário, Disabled. |
SS7 | Selecione Enabled para habilitar a captura das mensagens do tipo SS7. Esta captura estará disponível apenas em Links com Local Signaling habilitado. Caso
contrário, Disabled. |
M2PA | Selecione Enabled para habilitar a captura das mensagens do tipo M2PA. Caso contrário, Disabled. |
M2UA | Selecione Enabled para habilitar a captura das mensagens do tipo M2UA. Caso contrário, Disabled. |
H.248 | Selecione Enabled para habilitar a captura das mensagens do tipo H.248. Caso contrário, Disabled. |
Other Logs
Campo | Descrição |
---|---|
Authentication Logs | Efetua o download do arquivo de log com os registros de autenticação. |
System Logs | Efetua o download dos arquivos de log do sistema AGOS, utilizados em análises detalhadas de anormalidades. |
sngrep Capture Files
Os arquivos sngrep de captura disponibilizados para download correspondem as capturas efetuadas pela interface CLI, utilizando a ferramenta sngrep. É disponibilizado o último arquivo salvo. É possível efetuar o download ou deleção do arquivo.
Os arquivos gerados poderão ser visualizados em programas de analise de tráfego de rede.
Configuration
A configuração do gateway é feita via interface WEB ou através de uma interface de comandos de linha (CLI). Este manual trata da interface de configuração web.
Network
Configuração das interfaces de rede do equipamento.
Recomendamos o uso da interface ethernet 1 para a gerência de configuração, manutenção do equipamento e acesso a serviços adicionais e a interface ethernet 0 seja utilizada para o tráfego de voz. Esta forma garante um acesso à interface de gerência em um canal separado do tráfego de voz.
Cada uma das interfaces é configurada clicando diretamente sobre o nome a ela atribuído. Ao clicar, a seção da configuração da interface se expande mostrando a tela a seguir:
Configure os campos de acordo com sua necessidade, seguindo as orientações abaixo:
Campo | Descrição |
---|---|
Mode | Modo de funcionamento da interface ethernet N.
DHCP: Selecione esta opção caso deseje que o gateway receba o endereço IP através de um servidor DHCP. Static: Selecione esta opção para atribuir ao gateway um endereço IP. |
IP Address | Endereço IP da interface Ethernet N. |
Network Mask | Máscara de rede da interface Ethernet N. |
Para cada interface de rede no equipamento é possível configurar VLANs e ALIAS (apelido de interface). O equipamento aceita 128 VLANs e 64 ALIAS. Se o usuário realizar uma tentativa de superar estes números, um alerta será exibido, no canto inferior da página:
Para adicionar uma VLAN ou ALIAS na interface, clique nos botões "+add VLAN" ou "+add Alias" . Será adicionada uma nova linha na tabela de VLANs (o mesmo se aplica para ALIAS).
Na seção General Settings é possível configurar os servidores de nome de domínio e gateway padrão. Caso estes endereços sejam atribuídos por DHCP eles serão sobrescritos pelos configurados de forma explícita nesta seção. Para excluir o endereço configurado deixe o campo em branco.
Campo | Descrição |
---|---|
Hostname | Nome atribuído ao equipamento |
Default Gateway | Endereço IP do servidor responsável pelo roteamento |
Primary DNS Server | Endereço IP do servidor de nome de domínios |
Secondary DNS Server | Endereço IP para um segundo servidor de nome de domínios |
Após efetuadas as configurações de rede, salve as configurações clicando em Save.
Static Routes
O equipamento possui duas ou mais interfaces Ethernet independentes. Em alguns cenários pode ser necessária a configuração de rotas estáticas para o direcionamento correto do tráfego.
Tela de configuração das rotas estáticas :
Configure o nome da rota, endereço de rede, gateway e interface de acordo com a tabela abaixo.
Campo | Descrição |
---|---|
Name | Nome para a rota estática |
Address/Mask | Endereço IPv4 com a máscara da rede de origem. Utilize o formato xxx.xxx.xxx.xxx/yy |
Gateway | Endereço IPv4 do gateway no formato xxx.xxx.xxx.xxx |
Device | Interface de saída da rota.
Atenção: Neste campo de seleção serão apresentadas somente as interfaces existentes no equipamento. Estas interfaces podem ser VLANs ou ALIAS. Somente serão exibidas interfaces que estejam em modo estático. |
Metric | Métrica utilizada na rota. Valor padrão: 100 |
Para adicionar uma nova rota clique no símbolo (v), após configurar todos os parâmetros. Se todos os parâmetros estiverem corretos, a nova rota estática será adicionada na tabela. Após finalizar a configuração, clique em Save.
SIP
Nesta seção são realizado as configuração dos parâmetros SIP.
Como a figura acima mostra, a configuração padrão do SIP deste equipamento possui um peer configurado, podemos editar este peer ou configurar um novo. Para editar, expanda a configuração do peer clicando em cima do nome (neste caso, trunk1).
Para adicionar um novo peer no equipamento clique em Add Peer, na parte inferior da página. Porém, ao começar uma nova configuração de peer, os principais botões desta página ficarão bloqueados até o usuário informar um Server Host válido. O nome do novo peer é atribuído dinamicamente podendo ser alterado pelo usuário. Para remover um peer clique em ( X ). A tabela abaixo exibe os valores possíveis de configuração de um peer.
Campo | Descrição |
---|---|
Allow Premature Media | Configura se pacotes RTP são permitidos em uma ligação SIP, antes que a mesma seja estabelecida com 183 session in progress ou 200 ok.
Configuração Padrão: yes |
Listening Port | Porta em que o equipamento irá receber as requisições e respostas SIP. É uma configuração global do SIP. |
Peer name | Nome do peer |
Server Host | Servidor (softswitch ou SBC) no qual o gateway irá se conectar. Este campo aceita as opções de endereço IP ou nome do host. Caracteres especiais não são aceitos. |
Server Port | Porta do servidor que será utilizada para troca dos pacotes SIP. |
Username | Nome da conta SIP no caso de autenticação por usuário e senha. |
Password | Senha da conta SIP no caso de autenticação por usuário e senha. |
Register | Configura o envio de informações de registro a um servidor. Selecione Enabled nos casos em que é necessário o registro da conta SIP. Caso contrário, Disabled.
Configuração Padrão: Disabled |
DTMF Mode | Padrão na geração e detecção DTMF's
RFC2833: Neste modo os tons de DTMFs recebidos pelas interfaces E1 vão ser gerados fora do canal de áudio para o lado SIP. Nas ligações vindas da conta SIP o gateway vai interpretar e gerar o tom para as interfaces E1; Info: Neste modo os tons de DTMFs recebidos pelas interfaces E1 serão gerados fora do canal de áudio para o lado SIP. Nas ligações vindas da conta SIP o gateway vai interpretar e gerar os tons para as interfaces E1 utilizando o método descrito na RFC2976; Inband: Neste modo os tons de DTMF são mantidos in-band também nos pacotes de áudio. Este modo não funciona adequadamente com codec G.729. |
SRTP | Os pacotes são criptografados usando SRTP (Secure Real-Time Transport Protocol). Selecione Enabled para habilitar a criptografia dos pacotes RTP. Caso contrário, Disabled.
Configuração Padrão: Disabled |
T.38 | Suporte a fax. Selecione Enabled se você quer habilitar o suporte ao protocolo T.38 para a transmissão de fax. Caso contrário, selecione Disabled ou Unsupported.
Configuração padrão: Enabled |
Codecs | Os codecs estão classificados em duas colunas. Clique no codec e arraste para coluna Enabled ou Disabled de acordo com a configuração de codecs desejada.
Taxa de utilização de banda: G.711 (alaw e ulaw): 64Kbps G.729: 8Kbps G.722: 64kbps AMR Narrow Band (4.75kbps - 12.2kbps) *Configurável apenas pela interface CLI Codec Habilitado por padrão: alaw |
SIP-i | Configura o Peer para operar em SIP-i. Configuração Padrão: no * Configuração depende de licença SIP-i habilitada. |
Call Limit | Limite de chamadas SIP-i simultâneas para o Peer. Configuração Padrão: 0 ( 0 = valor total da licença). * Configuração depende de licença SIP-i habilitada. |
SIP Transport | Configura o protocolo de transporte utilizado no SIP Peer.
UDP: Utiliza UDP para transporte. TCP: Utiliza TCP para transporte. TLS: Utiliza TLS para transporte. Ao selecionar esta opção, logo abaixo será disponibilizado as opções de Criar ou Importar os certificados TLS e CA. Configuração Padrão: UDP |
Logo abaixo dos codecs, é exibido um submenu para configurações avançadas:
Campo | Descrição |
---|---|
From User | Altera usuário no campo 'From' do cabeçalho SIP. |
From Domain | Altera domínio no campo 'From' do cabeçalho SIP. |
Options Keepalive | Opção utilizada para ativar ou desativar o SIP Option Keepalive. Nesta opção o equipamento será capaz de monitorar o status de um SIP Peer. Selecione no ou yes.
Configuração Padrão: no |
Autoframing | yes: utiliza mesmo ptime do peer sip
no: utiliza ptime configurado localmente (default 20ms) |
Após adicionar ou editar os peers, clique em Save.
E1
Os parâmetros de configuração física da interface e os parâmetros do tipo de sinalização a ser utilizado serão feitos de acordo com a descrição da tabela abaixo
Campo | Descrição |
---|---|
Signalling | Configura a interface E1 para usar a sinalização SS7
Configuração Padrão: SS7 |
Clock recovery | Configuração de relógio da interface E1. Selecione Enable para regenerar o relógio recebido na interface. Caso contrário, Disabled, o gateway usa o relógio interno.
Configuração Padrão: Disabled |
CRC | Configura a interface E1 para calcular o CRC-4 do multiquadro. Selecione Enabled para que o CRC-4 seja calculado e os bits calculados inseridos nos quadros. Caso contrário, Disabled.
Configuração Padrão: Disabled |
Dialplan
RNI: Habilita ou não o repasse do parâmetro (SIP Diversion Header) do SIP para o SS7 - Redirecting number Information (RNI) .
Valor padrão: Desabilitado.
Services
Campo | Descrição |
---|---|
HTTP Port | Porta de acesso ao servidor HTTP. Valores válidos entre 1-65535.
Configuração Padrão: 80 |
HTTPS Port | Porta de acesso ao servidor seguro HTTPS. Valores válidos entre 1-65535.
Configuração Padrão: 443 |
SSH Port | Porta de acesso ao servidor seguro SSH. Valores válidos entre 1-65535.
Configuração Padrão: 22 |
Firewall
Campo | Descrição |
---|---|
Name | Apelido para a regra. Utilize caracteres, números, e subtraço (_) |
In Interface | Interface de entrada dos pacotes que serão analisados pela regra. As opções válidas aparecem disponíveis para a seleção. A escolha da opção Any aplica a regra a todas as interfaces da lista. |
Source | Endereço de rede na forma xxx.xxx.xxx.xxx, sub-rede na forma xxx.xxx.xxx.xxx/yy ou Any. Deixar o campo em branco implica em selecionar a opção Any, ou seja, a regra será aplicada a qualquer endereço IP de origem. |
Protocol | Protocolo que será avaliado pela regra. As opções válidas aparecem disponíveis para seleção. A escolha da opção Any faz com que a regra não olhe para o tipo de protocolo. |
Port Start | Porta inicial da faixa de portas que será analisada para o protocolo especificado na regra. |
Port End | Porta final da faixa de portas que será analisada para o protocolo especificado na regra. |
Observação: O Port Start e Port End não são campos obrigatórios. Na situação em que os dois campos não são preenchidos a regra atuará para qualquer porta. Porém, se configurados, o Port Start não poderá ser maior que o Port End. |
High Availability
SS7 Linksets
Campo | Descrição |
---|---|
Linkset Name | Nome atribuído ao linkset. |
Origin Point Code | Configura o número do Origin Point Code (OPC) do linkset. |
Destination Point Code | Configura o número do Destination Point Code (DPC) do linkset. |
Adjacent Point Code | Este campo somente é utilizado nos casos onde é utilizado um ponto de transferência de sinalização (PTS). O point code do PTS deve ser configurado neste campo. |
Hunting Policy | Configura o política de tomada ou ocupação dos CICs.
even: ocupa os CICs pares odd: ocupa os CICs ímpares seq_up: ocupa os CICs de maneira sequencial do menor para o maior seq_down: ocupa os CICs de maneira sequencial do maior para o menor |
Loadshare | Configura o compartilhamento da sinalização no linkset, entre links ou linksets.
none: sem compartilhamento de sinalização. linkset: o compartilhamento de sinalização é realizado entre os links do linkset. combined: no caso de compartilhamento de sinalização entre linksets. Neste caso é necessário configurar o campo Combined ID de todos os linksets que irão compartilhar a sinalização com o mesmo identificador. |
Combined ID | Identificador (ID) do linkset para compartilhamento de sinalização. O campo só é habilitado se o compartilhamento é configurado como combined. |
SS7 Links
Header text | Header text |
---|---|
Example | Example |
Example | Example |
Example | Example |
Example | Example |
Example | Example |
Example | Example |
Example | Example |
Example | Example |
SS7 Signaling Gateway
SS7 M2UA SG Configuration
H.248
Status
Network
SIP
E1
SS7
H.248
Dialplan
Calls
Calls Records
O equipamento oferece no link "Calls Records" do menu "Status" da interface web uma opção para verificação dos últimos registros de chamadas. Tal facilidade não trata-se de um sistema de bilhetagem ou tarifação, mas sim um relatório básico para consultas da equipe técnica em diagnósticos de problemas.
A visualização dos dados podem ser obtidos na própria interface, ou exportados para um arquivo externo (.csv) para posterior manipulação.
Após alcançado o número máximo de registros configurado, os registros mais antigos serão removidos automaticamente.
Calls Detail Records
Campo | Descrição |
---|---|
Load CDR table with limit | Limite de registros a serem exibidos |
Select columns | Seleção de colunas a serem exibidas |
Exibição da consulta nos registros de chamadas:
Descrição dos campos da tela de consulta dos registros de chamadas:
Campo Web | Descrição |
---|---|
Source | Número de origem da chamada. |
Destination | Número de destino da chamada. |
Source Channel | Canal de origem utilizado na chamada. |
Destination Channel | Canal de destino utilizado na chamada. |
Start | Horário de início da chamada. |
Answer | Horário do atendimento da chamada. |
End | Horário de final da chamada. |
Duration | Duração total da chamada. |
Billsec | Duração da chamada registrada após atendimento. |
Disposition | Estado final da chamada, perspectiva da origem. |
Rule | Regra utilizada no plano de discagem (Dialplan) para a chamada. |
Outgoing Called | Regras de modificação da identificação do número chamado definido na regra de dialplan (Rule). |
Outgoing Callerid | Regras de modificação da identificação do número do chamador definido na regra de dialplan (Rule). |
Hangup Cause | Causa de desconexão da chamada. |
Outgoing Source | Origem da chamada após cursado pelo plano de discagem (Dialplan). |
Outgoing Destination | Destino da chamada de chamada após cursado pelo plano de discagem (Dialplan). |
Origin Point Code | Point Code de origem do elemento de rede envolvido na chamada. |
Destination Point Code | Point Code de destino do elemento de rede envolvido na chamada. |
Release | Código de desconexão da chamada. |
Configurations
Campo | Descrição |
---|---|
Max number of records stored | Quantidade máxima de registros a serem armazenados |
Tools
O arquivo .csv pode ser exportado utilizando a ferramenta "Generate CSV", disponível na interface web, a qual disponibilizará todos os registros contidos no equipamento, podendo ser filtrados por período de tempo no momento da exportação.
Campo | Descrição |
---|---|
Clear CDR | Remove todos os registros armazenados |
Generate CSV | Gera arquivo .csv e disponibiliza para download |
Download | Efetua a cópia do arquivo .csv gerado |
Descrição dos campos da tela de consulta dos registros de chamadas no arquivo .csv :
Campo CSV | Descrição |
---|---|
src | Número de origem da chamada. |
dst | Número de destino da chamada. |
channel | Canal de origem utilizado na chamada. |
dstchannel | Canal de destino utilizado na chamada. |
start | Horário de início da chamada. |
answer | Horário do atendimento da chamada. |
end | Horário de final da chamada. |
duration | Duração total da chamada. |
billsec | Duração da chamada registrada após atendimento. |
disposition | Estado final da chamada, perspectiva da origem. |
rule | Regra utilizada no plano de discagem (Dialplan) para a chamada. |
outgoing_called | Regras de modificação da identificação do número chamado definido na regra de dialplan (Rule). |
outgoing_callerid | Regras de modificação da identificação do número do chamador definido na regra de dialplan (Rule). |
hangupcause | Causa de desconexão da chamada. |
outgoing_src | Origem da chamada após cursado pelo plano de discagem (Dialplan). |
outgoing_dst | Destino da chamada de chamada após cursado pelo plano de discagem (Dialplan). |
ss7_opc | Point Code de origem do elemento de rede envolvido na chamada. |
ss7_dpc | Point Code de destino do elemento de rede envolvido na chamada. |
release | Código de desconexão da chamada. |
SFTP
Outra forma de acessar o conteúdo dos registros de chamadas é através de uma conexão SFTP, diariamente no horário 3:00 am, o equipamento disponibilizará um arquivo .csv com todos os registros de chamadas do dia anterior, ao gerar um novo arquivo o anterior é removido. Para efetuar uma conexão SFTP é necessário que o usuário possua "Privilege Level" SFTP.