Manual do usuário CLI AG561

From Aligera Docs
Jump to navigation Jump to search


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.

Acesso e menu de ajuda


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