manutencao.rst.in
2.67 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
Manutenção
==========
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=@@SPB_ENV@@
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