Pular para conteúdo
Logo CEPTRO.br

Medições NIC.br

Controle do medidor SIMET#

As medições ocorrem em segundo plano e seus resultados são enviados pelo medidor aos sistemas centrais do NIC.br, onde são processados.

O medidor disponibiliza uma API de linha de comando que pode ser utilizada para interagir com este. Esta API é sujeita a ajustes em novas versões, mas a compatibilidade com versões antigas é mantida.

O medidor envia mensagens para o syslog. O sistema operacional DEVE ter alguma solução de syslog instalada. Por padrão, Debian/Ubuntu instalam o journald (comando journalctl). Algumas variantes usam o syslog (arquivos de texto em /var/log). OpenWRT usa o comando readlog.

Em sistemas Linux, a maior parte do medidor é instalada em /opt/simet.

Em OpenWRT (SIMETBox-openwrt), existe uma outra camada API, acessível via ubus, mais estável e que DEVE ser utilizada no lugar da API direta do motor de medição. A API é descrita em outro documento. Em OpenWRT, o medidor é instalado junto com outros arquivos do sistema, e não em um local separado.

Visualizar medições#

O pacote Debian/Ubuntu instala uma entrada no menu do ambiente desktop, que roda o navegador web padrão do sistema operacional e abre a página do resultado de medições daquele medidor SIMET. Essa entrada de menu fica na área de “Internet”.

Via CLI, o comando abaixo mostra a URL de acesso à página de resultado do medidor. DEVE-SE rodar esse comando sempre que for necessário acessar a página:

/opt/simet/bin/simet_view_results.sh --url

Omita o parâmetro “--url” caso queira abrir a página no navegador padrão.

Iniciar uma medição#

É possível disparar uma medição sob demanda. Caso uma medição de segundo plano esteja em andamento, a medição sob demanda não será iniciada. O contrário também é válido.

Nota

O medidor não permite duas medições SIMET executando simultaneamente.

A medição DEVE ser executada com o “usuário de sistema do medidor”, que é nicbr-simet.

Para trocar para modo superusuário, escolha um dos modos a seguir:

sudo su -

su -

Para disparar a medição, escolha um dos modos a seguir:

sudo -u nicbr-simet /opt/simet/bin/simet-ma_run.sh -v

su -s /bin/bash - nicbr-simet -- /opt/simet/bin/simet-ma_run.sh -v

O parâmetro “-v” é opcional, e mostra mais da atividade de medição. Pode ser substituído por um parâmetro “-q” para ser ainda mais silencioso.

Registrar o medidor#

O medidor precisa contatar os sistemas centrais pelo menos uma vez a cada três dias durante o funcionamento normal e, caso esteja desligado/desativado, pelo menos uma vez por ano para garantir que seu registro não irá expirar.

Caso o registro expire, o acesso à medições antigas desse mesmo medidor será perdido, a menos que o mesmo tenha sido ativado em um dos portais específicos do NIC.br.

O medidor tenta registrar e atualizar seu registro nas seguintes situações:

  • ao ser instalado;
  • ao ser atualizado;
  • durante o boot (antes de iniciar os serviços de medição);
  • periodicamente, via serviço do sistema operacional.

O processo de registro fornece um token ao medidor, informação secreta exclusiva para esse medidor, que permite o acesso do mesmo aos sistemas centrais. A atualização do registro renova esse token.

O registro do medidor DEVE ser executado com o “usuário de sistema do medidor” (nicbr-simet).

Para trocar para modo superusuário, escolha um dos modos a seguir:

sudo su -

su -

Para registrar (ou atualizar o registro), utilize:

sudo -u nicbr-simet /opt/simet/bin/simet_register_ma.sh

su -s /bin/bash - nicbr-simet -- /opt/simet/bin/simet_register_ma.sh

O comando “simet_register_ma.sh” exibe o identificador único do medidor, caso tenha sucesso.

Atenção

Este comando invalida a URL retornada pelo comando “simet_view_results.sh”. Acesse Visualizando Medições para mais detalhes.

Iniciar, reiniciar e parar o medidor#

O motor de medição utiliza os serviços de sistema “simet-ma” e “simet-lmapd”.

O serviço “simet-ma” DEVE ser iniciado para garantir o registro e funcionamento do motor de medição antes de tentar utilizar qualquer parte do motor de medição. Ele é responsável pela medição de disponibilidade de conexão à Internet, que é contínua e permanente.

O serviço “simet-lmapd” é responsável por todas as tarefas de medição em segundo plano. DEVE ser parado apenas em situações “de laboratório” onde, por exemplo, vão ser disparadas medições apenas sob demanda.

Para trocar para modo superusuário, escolha um dos modos a seguir:

sudo su -

su -

Serviço “simet-ma”#

systemctl start simet-ma
systemctl restart simet-ma
systemctl stop simet-ma
systemctl status simet-ma

/etc/init.d/simet-ma start
/etc/init.d/simet-ma restart
/etc/init.d/simet-ma stop
/etc/init.d/simet-ma status

Serviço “simet-lmapd”#

Atenção

Não inicie esse serviço sem antes ter iniciado o serviço “simet-ma”.

systemctl start simet-lmapd
systemctl restart simet-lmapd
systemctl stop simet-lmapd
systemctl status simet-lmapd

/etc/init.d/simet-lmapd start
/etc/init.d/simet-lmapd restart
/etc/init.d/simet-lmapd stop
/etc/init.d/simet-lmapd status