Ir para o conteúdo

Manutenção do PEER

Disponibilizamos o utilitário bcadastros-cli que é responsável pela implantação do peer e por diversas rotinas que ajudam em sua operação e manutenção.

[root@peer ~]# bcadastros-cli --help

Usage: bcadastros-cli [OPTION]
Options:
    --debug                         Coleta arquivos de log para solicitação de suporte
    --healthcheck                   Faz verificações básicas de saúde do peer
    --install                       Instala peer e canais. Necessita contrato prévio com SERPRO, verifique a documentação
    --restart                       Reinicia os serviços
    --start                         Inicia os serviços do peer
    --stop                          Para os serviços do peer
    --update                        Atualiza diversos componentes do peer
    --update-cli                    Atualiza o utilitário bcadastros-cli
    --update-tls                    Troca certificado de TLS do peer

    --help                          Exibe esta mensagem de ajuda
    --version                       Mostra a versão do bcadastros-cli

Atenção! Antes de utilizar o bcadastros-cli, sempre execute a atualização do utilitário para garantir que está usando a última versão disponível:

bcadastros-cli --update-cli

A seguir, detalhes de cada opção disponível no utilitário:

bcadastros-cli --debug

  Esta opção é utilizada para coletar diversas logs e informações do peer para abertura de pedido de suporte

bcadastros-cli --healthcheck

  Esta opção irá realizar alguns testes para validar a saúde do peer. Verifica se os serviços estão no ar, se existe conectividade com a rede b-Cadastros, se os canais contratados estão em sincronia com a rede e verifica a validade do certificado de TLS.

bcadastros-cli --install

  Função responsável por instalar um peer e por incluir novos canais em um peer existente. Atenção: é necessário ter autorização da RFB e contrato prévio com o SERPRO.

bcadastros-cli --restart

  Função para reiniciar os serviços.

bcadastros-cli --update

  Função responsável por atualizar alguns componentes do peer como configurações e novas imagens docker.

bcadastros-cli --update-cli

  Esta opção atualiza o utilitário para a última versão disponível.

bcadastros-cli --update-tls

  Opção responsável por trocar/atualizar o certificado do peer. Para ser possível esta troca, o certificado atual não pode estar vencido!

Atenção! Se receber o erro requests.exceptions.InvalidURL: Not supported URL scheme http+docker ao tentar parar ou iniciar o peer, execute o seguinte procedimento:

Atualizar o cli para a última versão:

bcadastros-cli --update-cli

Atualizar componentes do peer: (atenção: este comando irá reiniciar os containers)

bcadastros-cli --update