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) e foi elaborado utilizando a versão de firmware 9.2, versões anteriores de firmware podem haver divergências.
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.
O IP padrão do equipamento é 192.168.1.10 com máscara de rede 255.255.255.0.
Credenciais padrões de fábrica:
Login: admin
Password: aligera
Recomendamos por motivos de segurança que altere o password após o primeiro acesso.
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
quit ou 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
quit ou 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 vlan <vlan>
Criar ou configurar IP VLAN
config network ip route <route_name>
Criar ou remover rotas estáticas
config network ip route <route_name> destination <x.x.x.x/y>
Associar um endereço de destino a rota estática <route_name>
config network ip route <route_name> gateway <x.x.x.x>
Associar um endereço de gateway a rota estática <route_name>
config network ip route <route_name> device <device>
Associar um device a rota estática <route_name>
config network ip route <route_name> delete
Remover a rota estática <route_name>
config network ip route <route_name> show
Exibir a configuração da rota estática <route_name>
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 variant {itu|br|ar|cn|cz|co|ec|mx|ph|ve}
Configurar a variação do protocolo MFCR2 de acordo com o país. Valor padrão: br (Brasil).
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 allow_collect_calls {yes|no}
Configurar o recebimento de chamadas com a categoria de chamada a cobrar
config tdm port1 mfcr2 double_answer {yes|no}
Executar duplo atendimento para bloquear chamadas a cobrar recebidas
config tdm port1 mfcr2 reanswer_timeout <reanswer_timeout>
Configurar o timeout de R2 reanswer, deve ser um inteiro (mín.: 0, máx.: 120000). Valor padrão: 5000 ms
config tdm port1 mfcr2 mfback_timeout <mfback_timeout>
Configurar o timeout de mfback, deve ser um inteiro (mín.: 0, máx.: 120000). Valor padrão: 5000 ms
config tdm port1 mfcr2 forced_release {yes|no}
Configurar o envio CAS de liberação forçada para desligar a chamada
config tdm port1 mfcr2 accept_on_offer {yes|no}
Aceitar chamadas MFC/R2 antes da resposta do peer de destino. valor padrão: no
config tdm port1 mfcr2 tone_amp <tone_amp>
Definir a amplitude dos tons MFC em passos de -0,1dBm0
exemplos:
80 -8.0 dBm0 (Valor padrão)
110 -11.0 dBm0
150 -15.0 dBm0
200 -20.0 dBm0
config tdm port1 mfcr2 tone_debounce <tone_debounce>
Definir tempo de debounce do tom MFC Rx em ms (min: 0, max: 500). Valor padrão: 0
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> contactuser <contactuser>
Configurar o cabeçalho contactuser atrelado ao peer.
config sip peer <peer_name> ppiuser <ppiuser>
Configurar o cabeçalho ppiuser atrelado ao 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> transport {udp|tcp|tls}
Configurar o tipo de transporte UDP,TCP ou TLS
config sip peer <peer_name> codecs [codec1] ... [codecN]
Configurar codecs habilitados para o peer
config sip peer <peer_name> options_keepalive {yes|no}
Configurar o monitor de mensagens SIP OPTIONS enviadas periodicamente.
config sip peer <peer_name> outboundproxy <outboundproxy>
Configurar proxy SIP de saída
config sip peer <peer_name> pref_codec_only <yes,no>
Responder invite somente com o codec preferencial
config sip peer <peer_name> codec_preference {local|remote}
Configurar a prioridade do codec ao responder uma oferta SDP
- local Usar prioridade de codec da configuração local (padrão)
- remote Usar prioridade de codec da oferta SDP do peer remoto
config sip peer <peer_name> send_pai <yes,no>
Enviar o código de identificação privado (P-Assert-Identity) em cabeçalho SIP
config sip peer <peer_name> send_ppi {yes|no}
Configurar o envio do P-Preferred-Identity em cabeçalho SIP
config sip peer <peer_name> trustrpid {yes|no}
Aceita o cabeçalho SIP Remote-Party-ID e usa como identificador de chamada
config sip peer <peer_name> sessionprogress {yes|no}
Configura o envio da mensagem SIP 183 Session Progress e ativa a mídia quando adequado
config sip peer <peer_name> force180sdp {yes|no}
Configurar o envio da mensagem SIP 180 com SDP
config sip peer <peer_name> use183as180 {yes|no}
Configurar o tratamento das mensagens SIP 183 como SIP 180
config sip peer <peer_name> use183as200 {yes|no}
Configurar o tratamento das mensagens SIP 183 como SIP 200
config sip peer <peer_name> use180as183 {yes|no}
Configurar o tratamento das mensagens SIP 180 como SIP 183
config sip peer <peer_name> nat {no|yes}
Configurar suporte a NAT
config sip peer <peer_name> rtptimeout <rtptimeout>
Configurar o tempo limite de RTP em segundos
config sip peer <peer_name> rename <new_name>
Renomar o peer <peer_name>
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>
Configurar/incluir usuários
config login user <user> password
Configurar senha de usuário
config login user <user> pwhash
Configurar senha de usuário no formato hash
config login user <user> privilege_level {user|admin}
Configurar o nível de privilégio do usuário
- user Usuário com permissão apenas de leitura (Valor padrão)
- admin Usuário com permissão de administrador
config login user teste concurrent_login {yes|no}
Configurar a utilização concomitante do usuário em mais de uma sessão.
- yes Habilitar o uso concomitante (Valor padrão)
- no Desabilitar o uso concomitante do usuário
config login user <user> delete
Excluir usuário
config login policies
Configurar as políticas de acesso
config login policies access_attempts <access_attempts>
Configura o número de tentativas de login aceitas antes de bloquear os usuários por erros de senhas (min: 0, max: 50, padrão: 0 (desabilitado))
config login policies block_time <block_time>
Configura o tempo de bloqueio para o usuários, após tentativas de login com senhas incorretas (min: 60, max: 86400, padrão: 3600 segundos)
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 route
Exibir a tabela de rotas ativa no sistema
status arp
Exibir tabela ARP
status login
Exibir a lista de usuários conectados ao sistema
status dialplan show
Exibir de forma resumida as regras de dialplan carregadas no sistema
status dialplan test {sip <peer> |tdm <group>|local <peer>} <called number> [callerid]
Exibir o resultado do teste de diaplan, informando qual a regra utilizada com os parâmetros informados no comando.
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 log
Exibir conteúdo do log de sistema
system date
Exibir data e hora do sistema
system date [MMDDhhmm[[CC]YY][.ss]]
Configurar data e hora do sistema
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
system configreset
Reset para os padrões de fábrica, mantendo as configurações de rede e login
Ferramentas
tools ping <[options]> <host>
Teste de ping
tools traceroute <host>
Teste de tracert
tools telnet [-l USER] HOST [PORT]
Cliente Telnet
tools ssh [-l login_name] [-p port] destination
Cliente SSH
Debug
debug
Habilitar o debug terminal
debug {mfcr2|isdn|sip|full}
- mfcr2
Habilitar debug MFC/R2
- isdn
Habilitar debug ISDN
- sip
Habilitar debug SIP
- full
Habilitar debug de todas sinalizações
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