Acesso via console

Palavras-chave

Console, SSH, terminal, comandos, administração, rede, diagnóstico, SaperX.

Objetivo

Fornecer uma visão geral do acesso à console SSH personalizada da SaperX e apresentar os comandos disponíveis para administração, diagnóstico e monitoramento do sistema.

Conteúdo

Acesso e Autenticação

O acesso ao Console SaperX é feito por SSH e utiliza um terminal personalizado.

Por questões de segurança, a conta de administrador é destinada apenas a operações avançadas e não deve ser compartilhada.
Para ter acesso, solicite ao time de suporte as credenciais e a porta de conexão.

Navegação de Diretórios e Comandos

A navegação dentro do Console SaperX é feita por comandos simples, semelhantes a um menu em árvore:

Acessar um diretório: digite o nome da seção desejada.
Exemplo: network leva você para o menu de rede.
Voltar ao nível anterior: use .. para retornar ao diretório pai.
Listar comandos ou subdiretórios disponíveis: digite ? para exibir todos os comandos e opções da seção atual.

network

A sessão Network do Console SaperX reúne comandos para diagnóstico e monitoramento de rede, permitindo verificar conectividade, interfaces, rotas e realizar testes.

dump – Captura e exibe todo o tráfego de rede de ou para um host específico.
listdump – Lista todos os arquivos de captura (.pcap) já gerados.
mtr – Executa um rastreamento MTR para um endereço IP, combinando ping e traceroute.
ifconfig – Mostra os endereços IP e as interfaces de rede configuradas.
ping – Envia pacotes ICMP para verificar conectividade com um IP.
pingcount – Faz o mesmo que o ping, mas permite definir a quantidade de pacotes.
pingmysql – Testa a conectividade com o servidor DBS principal.
routeshow – Exibe todas as rotas de rede configuradas.
traceroute – Realiza um rastreamento de rota até um endereço IP.
exit – Sai da sessão Network e retorna ao nível anterior.

Para consultar rapidamente os comandos disponíveis dentro de Network, basta digitar ?.

firewall

A sessão Firewall do Console SaperX reúne comandos para gerenciamento do firewall e do serviço Fail2ban, permitindo iniciar, parar, recarregar e visualizar o status da proteção.

fail2ban-reset – desbloqueia TODOS os IPs bloqueados pelas regras de segurança do fail2ban.
fail2ban-stop – interrompe o serviço Fail2ban, desativando bloqueios automáticos temporariamente.
fail2ban-start – inicia o Fail2ban, habilitando a proteção contra tentativas de acesso indevido.
reload – Recarrega e re-aplica as regras de firewall.
stop – Para completamente o firewall.
start – Inicia o firewall.
show – Exibe todas as regras ativas do firewall.
exit – Sai da sessão Network e retorna ao nível anterior.

Para consultar rapidamente os comandos disponíveis dentro de firewall, basta digitar ?.

serverstatus

A sessão serverstatus do Console SaperX exibe informações em tempo real sobre o desempenho e a saúde do servidor, permitindo monitorar componentes essenciais do sistema.

Comandos disponíveis:

asterisk – Mostra o uptime e último reload do serviço Asterisk.
disk – Exibe o uso atual de disco.
htop – Abre o monitor interativo de processos em tempo real.
load – Exibe a carga atual do servidor.
memory – Mostra o uso de memória RAM.
mysql – Apresenta o status do banco de dados MySQL.
mysqlreplication – Mostra em tempo real status da replicação com o bando de dados.
uptime – Mostra há quanto tempo o servidor está em execução.
exit – Sai da sessão serverstatus e retorna ao nível anterior.

Para consultar rapidamente os comandos disponíveis dentro de serverstatus, basta digitar ?.

sip

A sessão sip do Console SaperX concentra comandos para monitorar e diagnosticar o funcionamento do protocolo SIP, permitindo visualizar registros, peers, chamadas e fluxos em tempo real.

Comandos disponíveis:

prune – Remove o registro de um circuito específico.
registerfailed – Pesquisa na quantidade de linhas informada tentativas de registro com falha.
showpeers – Lista todos os circuito e troncos online ou não monitorados.
showpeer – Exibe detalhes de um circuito ou tronco específico.
showcalls – Lista todas as chamadas ativas.
sipdump – Captura todo o tráfego na porta 5060.
realtime – Exibe as hamadas em tempo real no formato do painel de ligações em tempo real da web.
sngrep – Mostra fluxo SIP em tempo real com até 1.000 diálogos.
sngreprtp – Mostra fluxo SIP + RTP em tempo real com até 1.000 diálogos.
sngrepfull – Mostra fluxo SIP + RTP em tempo real com até 20.000 diálogos.
exit – Sai da sessão sip e retorna ao nível anterior.

Para consultar rapidamente os comandos disponíveis dentro de sip, basta digitar ?.

version

Apresenta a versão de software saperx aplicada no servidor core.

shutdown

Desliga o servidor dentro de 2 minutos.

abort-shutdown

Cancela a solicitação de desligamento do servidor.

exit

Encerra a sessão e sai da console.

FAQ – Perguntas Frequentes

1. O que é o Console SaperX?
É um terminal SSH personalizado que permite executar comandos de administração, diagnóstico e monitoramento diretamente no servidor SaperX.

2. Como obtenho acesso ao Console SaperX?
O acesso de administrador é desabilitado por padrão. Solicite ao time de suporte SaperX a liberação e as credenciais necessárias, incluindo usuário, senha e porta de conexão.

3. Quais são os comandos básicos de navegação?

Para entrar em uma sessão, digite o nome do diretório (ex.: network).
Para voltar, use ...
Para listar comandos disponíveis, use ?.

4. Para que serve a sessão network?
Permite diagnosticar a rede: testar conectividade (ping, pingcount), exibir rotas (routeshow), ver interfaces (ifconfig) e rastrear rotas (traceroute).

5. O que posso fazer na sessão firewall?
Gerenciar o firewall e o Fail2ban: iniciar/parar, recarregar regras, exibir regras ativas ou resetar bloqueios.

6. Como monitorar o status do servidor em tempo real?
Use a sessão serverstatus para ver CPU (load), memória, uso de disco, uptime, status do MySQL e do Asterisk.

7. Quais comandos ajudam a acompanhar chamadas SIP?
Na sessão sip é possível listar registros e peers, ver chamadas em tempo real (realtime), capturar tráfego (sipdump) e analisar fluxos com sngrep, sngreprtp e sngrepfull.

8. Posso verificar a versão do sistema?
Sim. O comando version exibe a versão atual do software SaperX em execução.

9. Como desligar ou cancelar o desligamento do servidor?

Para agendar desligamento em 2 minutos, use shutdown.
Para cancelar um desligamento agendado, use abort-shutdown.

10. Como encerrar a sessão do Console?
Digite exit em qualquer nível para retornar ou encerrar completamente a conexão SSH.