Manual do usuário CLI AG561
Introdução
O AG561 é um gateway de voz de alta performance construído baseado em sistemas Unix, a interface web de gerenciamento é apenas uma parte deste equipamento. O presente manual apresenta procedimentos de configuração via linha de comando (CLI).
O equipamento fornece acesso via SSH e Telnet para a sua administração avançada. As credenciais são as mesmas da interface WEB. Sendo a porta 22 para o acesso SSH e a porta 23 para o serviço Telnet.
Login: admin
Password: aligera
Ao acessar o gateway via telnet ou ssh, o terminal irá abrir diretamente na interface CLI, a partir de então os comandos podem ser executados. Ao pressionar a tecla ? (interrogação) serão apresentados os comandos disponíveis dentro do respectivo menu e a função de cada um.
config
Acesso aos comandos de configuração
status
Acesso aos comandos de status do gateway
system
Acesso às informações de gerenciamento do sistema
debug
Acesso ao terminal de debug
tools
Acesso a ferramentas de diagnóstico de conectividade
shell
Acesso ou envio de comandos ao shell do Linux embarcado no gateway
!,quit,exit
Deixa o a interface CLI ou retorna ao menu anterior
Configurações
config network
Configurações de rede
config tdm
Configurar porta TDM
config sip
Configurar parâmetros e contas SIP
config dialplan
Configurar o plano de discagem
config login
Configurar usuários
config show
Exibir configurações
config apply
Aplicar as configurações e reiniciar os serviços. As alterações não são salvas.
config save
Salvar configurações em memória não volátil
config dump
Exibir os arquivos de configuração
!,quit,exit
Retorna ao menu anterior
Configurações de rede
config network switch
Configurar switch
config network switch monitor_port <none, port1, port2>
Habilitar o espelhamento de portas.
Opções:
- none Desabilita espelhamento de portas
- port1 Todo o tráfego entre a porta 1 e a CPU será espelhado na porta 2
- port2 Todo o tráfego entre a porta 2 e a CPU será espelhado na porta 1
config network switch cpu vlan_default <default_vid>
Configurar ID de VLAN default da CPU
config network switch cpu vlan_allowed [vid1] ... [vidN]
Configurar ID's de VLAN permitidos na porta CPU
config network switch cpu egress_rate_limit
Configura o limite da banda (em kbps) de saída da porta
Opções:
- 0 Desabilita o limite de banda
- 64-960 Configura o limite de banda em passos de 64 kbps
- 1000-100000 Configura o limite de banda em passos de 1000 kbps
config network switch cpu ingress_rate_limit
Configura o limite da banda (em kbps) de entrada da porta
Opções:
- 0 Desabilita o limite de banda
- 64-960 Configura o limite de banda em passos de 64 kbps
- 1000-100000 Configura o limite de banda em passos de 1000 kbps
config network switch <port1, port2> mode <autoneg,100full,100half,10full,10half>
Configurar velocidade da porta
config network switch <port1,port2> vlan_default <default_vid>
Configurar ID de VLAN default da porta
config network switch <port1,port2> vlan_allowed [vid1] ... [vidN]
Configurar ID's de VLAN permitidos na porta
config network switch <port1,port2> vlan_policy <none,insert,remove>
Define a politica de VLAN da porta.
Opções:
- none: preserva pacotes marcados e não marcados.
- insert: insere marcação de VLAN em pacotes não marcados.
- remove: remove marcação de VLAN em pacotes não marcados
config network switch vlan_mode <enable,disable>
Habilita/desabilita modo de operação em VLAN
config network switch show
Exibe as configurações do switch
config network ip
Configurações de IP
config network ip type <dhcp,static>
Configurar o tipo de endereçamento IP
config network ip address <x.x.x.x>
Configurar o endereço IP
config network ip netmask <x.x.x.x>
Configurar a máscara de rede
config network ip defaultgw <x.x.x.x>
Configurar default gateway
config network ip alias <alias_name>
Criar/ configurar alias de IP
config network ip alias <alias_name> address <x.x.x.x>
Configurar endereço IP do alias
config network ip alias <alias_name> netmask <x.x.x.x>
Configurar máscara do alias
config network ip alias <alias_name> show
Exibir configurações do alias
config network ip alias <alias_name> delete
Excluir alias
config network ip show
Exibir as configurações de IP
config network mtu <mtu>
Configura o MTU da interface Ethernet em bytes
config network dns [nameserver1] ... [nameserver3]
Configurar servidores DNS
config network ntp
Configurar servidor ntp
config network syslog
Configurar servidor para remote syslog
config network show
Exibir configurações de rede
Configurações TDM
config tdm port1
Configurar porta 1
config tdm port1 crc <enable,disable>
Habilita/ desabilita CRC4 para a porta 1
config tdm port1 clock <0,1>
Habilita/ desabilita regeneração de clock para a porta 1
config tdm port1 signalling <mfcr2,isdn_cpe,isdn_net>
Configurar sinalização
config tdm port1 timeslots <timeslots>
Definir timeslots
Ex.:
config tdm port1 timeslots 1-15,17-31
config tdm port1 hunt_policy <seq_up,seq_down,round_up,round_down>
Configurar politica de tomada de juntores para a porta 1
config tdm port1 keepalive_host <x.x.x.x>
Configurar o servidor de keepalive
config tdm port1 mfcr2 max_ani < max_ani>
Configurar número máximo de dígitos de entrada de A em sinalização MFCR2 a partir do link E1
config tdm port1 mfcr2 max_dnis < max_dnis>
Configurar número máximo de dígitos de entrada de B em sinalização MFCR2 a partir do link E1
config tdm port1 mfcr2 get_ani_first
Receber ANI antes de DNIS
config tdm port1 mfcr2 reanswer_timeout <reanswer_timeout>
Configura o timeout de R2 reanswer
config tdm port1 isdn switchtype <euroisdn,qsig>
Variante da sinalização ISDN
config tdm port1 isdn overlapdial <yes,no>
Marcação em bloco.
config tdm port1 show
Exibir configurações da porta 1
config tdm show
Exibir configurações TDM
Configurações SIP
config sip bindport <port>
Configurar porta de escuta de requisições SIP
config sip prack <yes,no>
Habilita/ desabilita suporte a PRACK (SIP options 100rel)
config sip tos_sip <tos_sip>
Configurar marcação de pacotes SIP DSCP. Valores: 0 a 255, default 0.
config sip tos_rtp <tos_rtp>
Configurar marcação de pacotes RTP DSCP. Valores: 0 a 255, default 0.
config sip vad <yes,no>
Habilita/ desabilita detecção de atividade de voz
config sip vad_level <level>
Configurar nível de detecção de atividade de voz. 0: menor qualidade, maior economia de banda; 30: maior qualidade, menor economia de banda
config sip cng <yes,no>
Habilita/ desabilita geração de ruído de conforto (quando VAD está habilitado)
config sip jb_type <fixed,adaptative>
Configura o tipo de buffer de jitter
config sip jb_size <jb_size>
Configura o tamanho do buffer de jitter. O tamanho mínimo é 20 e o máximo 200. O valor padrão é 80.
config sip dtmf_rtp_pt <dtmf_rtp_pt>
Configurar tamanho do payload de evento DTMF
config sip modem_tones_outband <yes,no>
Habilita/desabilita os eventos de dos tons de fax e modem fora da banda conforme a RFC 4733
config sip localnet <localnet>
Configurar rede local para uso em NAT traversal
config sip externhost <externhost>
Configurar rede externa para uso em NAT traversal
config sip peer <peer_name>
Configurar/ criar peer SIP
config sip peer <peer_name> register <yes,no>
Habilitar/ desabilitar registro SIP
config sip peer <peer_name> username <username>
Configurar username para o peer
config sip peer <peer_name> secret <password>
Configurar senha para o peer
config sip peer <peer_name> host <host>
Configurar host/ip do peer
config sip peer <peer_name> port <port>
Configurar porta de saída das requisições do peer
config sip peer <peer_name> fromuser <fromuser>
Configurar o usuário de origem para as chamadas realizadas pelo peer
config sip peer <peer_name> fromdomain <fromdomain>
Configurar o domain para a mensagem SIP
config sip peer <peer_name> dtmfmode <rfc2833,inband,info>
Configurar modo de dtmf para o peer
config sip peer <peer_name> t38 <yes,no>
Habilitar/ desabilitar modo T38
config sip peer <peer_name> codecs [codec1] ... [codecN]
Configurar codecs habilitados para o peer
config sip peer <peer_name> pref_codec_only <yes,no>
Responder invite somente com o codec preferencial
config sip peer <peer_name> send_pai <yes,no>
Enviar o código de identificação privado (P-Assert-Identity) no cabeçalho SIP
config sip peer <peer_name> show
Exibir configurações do peer SIP
config sip peer <peer_name> delete
Excluir peer SIP
Plano de discagem
config dialplan rule <rule_name>
Configura regra específica do plano de discagem
config dialplan rule <rule_name> source_peer {tdm <group>|sip <peer>}
Configura o canal/conta de origem da chamada esperado pela regra
config dialplan rule <rule_name> destination_peer {tdm <group>|sip <peer>}
Configura o canal/conta de destino da chamada
config dialplan rule <rule_name> called_pattern
Configura o padrão de entrada de digitos da regra.
- 0-9#* qualquer dígito de 0 a 9, # ou *
- X qualquer dígito de 0 a 9
- [125-9] qualquer dígito entre os colchetes. Ex.: 1, 2 ou qualquer entre 5 e 9
- . qualquer dígito em qualquer quantidade
- ! nenhum ou qualquer dígito imediatamente
Exemplo:
config dialplan rule from_sip called_pattern 051[2-4]XXXXXXX
No exemplo acima a regra irá aceitar um número de entrada que inicie com 051, seja seguido por um dígito entre 2 a 4, seguido de 7 dígitos entre 0 e 9.
config dialplan rule <rule_name> callerid_pattern
Define o padrão de número de 'A' esperado pela regra
- 0-9#* qualquer dígito de 0 a 9, # ou *
- X qualquer dígito de 0 a 9
- [125-9] qualquer dígito entre os colchetes. Ex.: 1, 2 ou qualquer entre 5 e 9
- . qualquer dígito em qualquer quantidade
- ! nenhum ou qualquer dígito imediatamente
Exemplo:
- 1234 Exige o número 1234 na origem
- [7-9]XXX Exige origem de 4 dígitos, sendo o primeiro de 7 a 9
- XXXX Quaisquer 4 dígitos de 0 a 9
- [23]X. Qualquer número iniciado por 2 ou 3, seguido e um dígito de 0 a 9, seguido de quaisquer dígitos em qualquer quantidade
config dialplan rule <rule_name> outgoing_called <prefix>{:<offset>:<length>}<suffix>
Configurar número de saída para a regra.
Exemplos:
- {} Encaminha todos os dígitos (default)
- {:2:4} Encaminha do terceiro ao sexto dígito do número original
- {:-4} Encaminha os 4 últimos dígitos do número
- {:2} Remove os 2 primeiros dígitos do número e encaminha o mesmo
- 012{} Adiciona o prefixo 012 ao número antes de encaminhar
- {}0100 Adicionar o sufixo 0100 ao número antes de encaminhar
config dialplan rule <rule_name> outgoing_callerid <prefix>{:<offset>:<length>}<suffix>
Configura o número de A de saída para a regra
- {} Encaminha todos os dígitos (default)
- {:2:4} Encaminha do terceiro ao sexto dígito do número original
- {:-4} Encaminha os 4 últimos dígitos do número
- {:2} Remove os 2 primeiros dígitos do número e encaminha o mesmo
- 012{} Adiciona o prefixo 012 ao número antes de encaminhar
- {}0100 Adicionar o sufixo 0100 ao número antes de encaminhar
config dialplan rule <rule_name> answer_timeout <answer_timeout>
Configura o tempo em segundos à espera de uma resposta ou hangup. Opções disponíveis: 0-600 segundos ou 0 (timeout desabilitado).
config dialplan rule <rule_name> mfcr2_category
Define a categoria da chamada para sinalização MFCR2
Opções disponíveis:
- national_subscriber National Subscriber (default)
- national_priority_subscriber National Priority Subscriber
- international_subscriber International Subscriber
- international_priority_subscriber International Priority Subscriber
- collect_call Collect Call
config dialplan rule <rule_name> early_ringback {yes|no}
Forçar a geração antecipada do tom de chamada antes da resposta do peer de destino
config dialplan rule <rule_name> show
Exibe a regra
config dialplan rule <rule_name> delete
Exclui a regra
Usuários
config login user <user_name>
Configurar/incluir usuários
config login user <user_name> password
Configurar senha de usuário
config login user <user_name> pwhash
Configurar senha de usuário no formato hash
config login user <user_name> delete
Excluir usuário
config login show
Exibir as configurações de usuários
Status
status cpu
Exibir uso de CPU e memória
status uptime
Uptime do sistema
status network
Exibir status das portas ethernet, endereços IP e modo de operação
status arp
Exibir tabela ARP
status tdm
Exibir status do link E1, contadores de erro e status dos canais
status reset_tdm
Zerar as estatísticas TDM
System
system info
Informações do sistema. Versão de firmware, número de série
system upgrade <url>
Atualização de firmware
system reboot
Reinicializar o sistema
system factoryreset
Reset para os padrões de fábrica, todas as configurações serão perdidas, inclusive IP's configurados
Outros comandos
tools ping <[options]> <host>
Teste de ping
tools traceroute <host>
Teste de tracert
shell
Executar o shell do sistema operacional. Disponível apenas para o usuário admin
Debug
debug
Debug do serviço de voz. Debug do serviço de voz, sinalização SIP, MFCR2 e ISDN
Após executar o comando debug, devem ser executados os comandos que seguem, conforme a necessidade de diagnóstico/ visualização:
Sinalização SIP:
core set debug 3
sip set debug on
Sinalização MFCR2:
core set debug 3
mfcr2 set debug all
Sinalização ISDN:
core set debug 3
pri set debug on span 1
Verbose (exibe execução do plano de discagem):
core set verbose 5
Suporte
Em caso de dificuldade ou caso sejam necessários maiores esclarecimentos sobre as configurações do equipamento utilize nossos canais:
Telefone: (51) 3500-0100
E-mail: suporte@aligera.com.br
Portal: suporte.aligera.com.br
Base de Conhecimento: docs.aligera.com.br
Site: www.aligera.com.br