manual manutencao Page History

Manutenção

Sumário

Mantendo o Sistema Atualizado

É importante que não apenas os software relacionados ao Portal do SPB sejam mantidos atualizados, mas também outros pacotes do sistema provenientes dos repositórios oficiais da distribuição utilizada. Tais atualizações são tratadas pelos scripts de gestão de configuração do ambiente, de modo que para que se mantenha todo o sistema atualizado, basta seguir os passos de atualização do Portal do SPB na seção de Implantação, ou seja:

$ git pull
$ rake converge SPB_ENV=local

Modificando Configurações

Como descrito na seção de Implantação, as configurações específicas de um determinado ambiente se encontram centralizadas nos arquivos presentes em config/${ambiente}/, de modo que em caso de necessidade de alterações nas configurações, deve-se recorrer a tais arquivos.

  • config.yaml
    • Administradores do sistema
    • Nome dos domínios (Portal, relay e mailman)
    • IP’s externos para reverseproxy e relay
    • Porta de SSH para conexão interna à reverseproxy
    • Outras configurações relevantes para o sistema
  • ips.yaml
    • IP’s (rede local) das máquinas descritas na seção de Arquitetura
  • ssh_config
    • Arquivo de configuração para conexões SSH.

Ao se modificarem configurações do ambiente que sejam permanentes, é interessante que as mesmas sejam refletidas também nos repositórios de gestão de configuração, para tal, contate os mantenedores do portal em spb-dev@listas.softwarepublico.gov.br.

Obtendo logs

Os seguintes arquivos a seguir contém logs relevantes para o Portal do SPB, de modo que é interessante monitorá-los, note que os arquivos estão organizados por máquinas.

  • social
    • /var/log/nginx/noosfero.access.log
    • /var/log/nginx/noosfero.error.log
    • /var/log/noosfero/*
    • /var/log/rsnapshot
  • integration
    • /var/log/nginx/colab.access.log
    • /var/log/nginx/colab.error.log
    • /var/log/nginx/mailman.access.log
    • /var/log/nginx/mailman.error.log
    • /var/log/nginx/gitlab.access.log
    • /var/log/nginx/gitlab.error.log
    • /var/log/colab/colab.log
    • /var/log/gitlab-shell/gitlab-shell.log
    • /var/log/gitlab/unicorn.stderr.log
    • /var/log/gitlab/unicorn.stdout.log
    • /var/log/gitlab/application.log
    • /var/log/gitlab/production.log
    • /var/log/gitlab/sidekiq.log
    • /var/log/mailman/smtp
    • /var/log/mailman/qrunner
    • /var/log/mailman/error
    • /var/log/rsnapshot
  • database
    • /var/log/redis/redis.log
    • /var/lib/pgsql/data/pg_log/*
  • reverseproxy
    • /var/log/nginx/ssl-*.access.log
    • /var/log/nginx/ssl-*.error.log
Last edited by Paulo Tada