Commit ea19bc3b539a4bf60d980ad690e0fd3e30070e8b

Authored by Lucas Kanashiro
1 parent 24e9619e

Versão final do manual de instalação do LabSEI

installDoc/gitlab-sei.tex
1 -\section{Gitlab}\label{gitlab} 1 +\section{Gitlab}
  2 +\label{gitlab}
2 3
3 -\subsection{Configurações de Porta}  
4 -É essencial a configuração das seguintes portas para o funcionamento correto do Gitlab: \\  
5 -* Abrir porta 22 para uso do git \\  
6 -* Abrir porta 25 para uso do servidor de email postfix \\ 4 +Recomenda-se que o serviço do Gitlab esteja executando em um servidor diferente dos outros serviços.
7 5
8 -\subsection{Instalação Gitlab e Integração com Redmine} 6 +\subsection{Pré-requisitos}
9 7
10 -Baixar o script de instalação do Gitlab. 8 +Para a execução da ferramenta nesse ambiente as seguintes portas devem estar liberadas:
11 9
12 -\fbox{\parbox{\textwidth}{  
13 -\texttt{sudo yum install wget -y}}} 10 +\begin{itemize}
  11 +\item 80
  12 +\item 22
  13 +\item 25
  14 +\end{itemize}
  15 +
  16 +
  17 +
  18 +
  19 +\subsection{Dar permissão de leitura, escrita e execução para o usuário corrente no diretório /opt}
  20 +
  21 +O usuário corrente deve está no grupo de sudo.
14 22
15 \fbox{\parbox{\textwidth}{ 23 \fbox{\parbox{\textwidth}{
16 -\texttt{sudo wget \textbackslash 24 +\texttt{
  25 +sudo chown \$USER:\$GROUP -R /opt
17 \\ 26 \\
18 -https://gitlab.com/softwarepublico/labsei/raw/master/script/instalacaoGitlab.sh}}} 27 +cd /opt
  28 +}}}
  29 +
  30 +
  31 +
  32 +\subsection{Instalação do pacote wget}
  33 +
  34 +\fbox{\parbox{\textwidth}{
  35 +\texttt{
  36 +sudo yum install -y wget
  37 +}}}
  38 +
  39 +
  40 +
  41 +\subsection{Download do script de instalação}
  42 +
  43 +\fbox{\parbox{\textwidth}{
  44 +\texttt{
  45 +wget https://gitlab.com/softwarepublico/labsei/raw/master/script/gitlab.sh
  46 +}}}
  47 +
  48 +
  49 +
  50 +
  51 +\subsubsection{Dar permissão de execução para o script}
19 52
20 \fbox{\parbox{\textwidth}{ 53 \fbox{\parbox{\textwidth}{
21 -\texttt{sudo chmod +x instalacaoGitlab.sh}}} 54 +\texttt{
  55 +chmod +x gitlab.sh
  56 +}}}
  57 +
  58 +
  59 +
  60 +\subsection{Observação Importante para execução do script}
  61 +
  62 +Ao executar os scripts adicione a senha do usuário quando solicitado!
  63 +
  64 +
  65 +
  66 +\subsection{Executar script de instalação do Gitlab}
  67 +
  68 +Para executar o script de instalação do Gitlab não é necessário passar nenhuma parâmetro.
22 69
23 \fbox{\parbox{\textwidth}{ 70 \fbox{\parbox{\textwidth}{
24 -\texttt{sudo ./instalacaoGitlab.sh}}} 71 +\texttt{
  72 +sudo /opt/gitlab.sh
  73 +}}}
  74 +
  75 +
  76 +
25 77
26 \emph{NOTA:} 78 \emph{NOTA:}
27 79
28 \fbox{\parbox{\textwidth}{ 80 \fbox{\parbox{\textwidth}{
29 \texttt{ 81 \texttt{
30 -Você pode acessar o gitlab usando a url: http://<IP\_GITLAB> \\  
31 -Usuario: root \\  
32 -Senha 5iveL!fe \\ 82 +O Gitlab pode ser acessado usando a url: http://<IP\_GITLAB> \\
  83 +O usuário e senha abaixo são referentes a instalação realizada no ambiente homologação disponibilizado pelo MPOG: \\
  84 +Usuário: root \\
  85 +Senha: sei12345 \\
33 }}} 86 }}}
  87 +
  88 +
installDoc/redmine-sei.tex
1 -\section{Redmine} 1 +\section{LDAP + Redmine + Aplicação para cadastro no LDAP}
2 \label{redmine} 2 \label{redmine}
3 3
4 -\subsection{Instalação do Epel} 4 +Recomenda-se que todas as aplicações listadas estejam no mesmo servidor (LDAP + Redmine + Aplicação para cadastro no LDAP).
5 5
6 -\fbox{\parbox{\textwidth}{  
7 -\texttt{  
8 -rpm -Uvh http://fedora.uib.no/epel/6/x86\_64/epel-release-6-8.noarch.rpm  
9 -}}} 6 +\subsection{Pré-requisitos}
10 7
11 -\subsection{Instalação de pacotes}  
12 -\fbox{\parbox{\textwidth}{  
13 -\texttt{sudo yum -y install zlib-devel curl-devel openssl-devel httpd-devel apr-devel \textbackslash  
14 -\\  
15 -apr-util-devel subversion git postgresql-devel wget vim}  
16 -}} 8 +Para a execução das ferramentas nesse ambiente as seguintes portas devem estar liberadas:
  9 +
  10 +\begin{itemize}
  11 +\item 80
  12 +\item 3000
  13 +\item 389
  14 +\item 21
  15 +\end{itemize}
17 16
18 -\subsection{Instalação Postgresql}  
19 17
20 -\fbox{\parbox{\textwidth}{  
21 -\texttt{  
22 -\scriptsize{  
23 -sudo yum localinstall http://yum.postgresql.org/9.3/redhat/rhel-6-x86\_64/pgdg-centos93-9.3-1.noarch.rpm -y  
24 -\\  
25 -sudo yum install postgresql93 postgresql93-devel postgresql93-libs postgresql93-server -y  
26 -}}}}  
27 18
28 -\subsubsection{Reiniciar Postgresql} 19 +\subsection{Dar permissão de leitura, escrita e execução para o usuário corrente no diretório /opt}
  20 +
  21 +O usuário corrente deve está no grupo de sudo.
29 22
30 \fbox{\parbox{\textwidth}{ 23 \fbox{\parbox{\textwidth}{
31 \texttt{ 24 \texttt{
32 -sudo /etc/init.d/postgresql-9.3 initdb 25 +sudo chown \$USER:\$GROUP -R /opt
33 \\ 26 \\
34 -sudo /etc/init.d/postgresql-9.3 restart 27 +cd /opt
35 }}} 28 }}}
36 29
37 -\subsubsection{Modificar senha do Postgres}  
38 30
39 -%Corrigindo aspas  
40 -\fbox{\parbox{\textwidth}{  
41 -\texttt{sudo -u postgres psql template1 -c \textbackslash  
42 -\\  
43 -"ALTER USER postgres with encrypted password 'postgres';"  
44 -}}}  
45 31
46 -\subsubsection{Configurando o Postgres} 32 +
  33 +\subsection{Instalação do pacote wget}
47 34
48 \fbox{\parbox{\textwidth}{ 35 \fbox{\parbox{\textwidth}{
49 \texttt{ 36 \texttt{
50 -sudo vim /var/lib/pgsql/9.3/data/postgresql.conf  
51 -\\  
52 -descomentar: \# listen\_addresses = 'localhost' 37 +sudo yum install -y wget
53 }}} 38 }}}
54 39
55 40
56 -\subsubsection{Usar a permissão certa de usuário do Redmine no banco de dados do Redmine}  
57 41
58 -\fbox{\parbox{\textwidth}{  
59 -\texttt{sudo vim /var/lib/pgsql/9.3/data/pg\_hba.conf}}}  
60 42
61 -O arquivo deve ficar desta forma: 43 +\subsection{Download dos scripts de instalação}
62 44
63 -%Atualizando permissão dos usuários  
64 \fbox{\parbox{\textwidth}{ 45 \fbox{\parbox{\textwidth}{
65 \texttt{ 46 \texttt{
66 -\# TYPE DATABASE USER ADDRESS METHOD  
67 -\\  
68 -\# local is for Unix domain socket connections only  
69 -\\  
70 -local all redmine md5  
71 -\\  
72 -local all all peer  
73 -\\  
74 -\# IPv4 local connections: 47 +wget https://gitlab.com/softwarepublico/labsei/raw/master/script/ldap.sh
75 \\ 48 \\
76 -host all redmine 127.0.0.1/32 md5 49 +wget https://gitlab.com/softwarepublico/labsei/raw/master/script/postgresql.sh
77 \\ 50 \\
78 -host all all 127.0.0.1/32 ident 51 +wget https://gitlab.com/softwarepublico/labsei/raw/master/script/redmine.sh
79 \\ 52 \\
80 -\# IPv6 local connections:  
81 -\\  
82 -host all redmine ::1/128 md5  
83 -\\  
84 -host all all ::1/128 ident 53 +wget https://gitlab.com/softwarepublico/labsei/raw/master/script/ldap\_register.sh
85 }}} 54 }}}
86 55
87 -\subsubsection{Reiniciar Postgresql}  
88 -  
89 -\fbox{\parbox{\textwidth}{  
90 -\texttt{sudo /etc/init.d/postgresql-9.3 restart}}}  
91 56
92 -\subsection{Instalar Requisitos das Gems}  
93 57
94 -\fbox{\parbox{\textwidth}{  
95 -\texttt{  
96 -sudo yum install gcc gcc-c++.x86\_64 make automake autoconf curl-devel \textbackslash  
97 -\\  
98 -openssl-devel zlib-devel httpd-devel apr-devel apr-util-devel \textbackslash  
99 -\\  
100 -sqlite-devel ruby-rdoc ruby-devel rubygems libxslt-devel libxml2-devel.x86\_64 -y}}}  
101 58
102 -\subsection{Atualizar para a Gem 1.4.2} 59 +\subsubsection{Dar permissão de execução para os scripts}
103 60
104 \fbox{\parbox{\textwidth}{ 61 \fbox{\parbox{\textwidth}{
105 \texttt{ 62 \texttt{
106 -wget http://production.cf.rubygems.org/rubygems/rubygems-1.4.2.tgz  
107 -\\  
108 -tar zxvf rubygems-1.4.2.tgz  
109 -\\  
110 -cd rubygems-1.4.2  
111 -\\  
112 -ruby setup.rb  
113 -\\  
114 -gem -v 63 +chmod +x /opt/*.sh
115 }}} 64 }}}
116 65
117 66
118 -\subsection{Instalar ImageMagick}  
119 67
120 -\fbox{\parbox{\textwidth}{  
121 -\texttt{  
122 -sudo yum install php-pear ImageMagick ImageMagick-devel ImageMagick-perl -y  
123 -}}} 68 +\subsection{Observação Importante para execução dos scripts}
  69 +
  70 +Ao executar os scripts adicione a senha do usuário quando solicitado!
124 71
125 -\subsection{Instalar Gem Bundle}  
126 72
127 -\fbox{\parbox{\textwidth}{  
128 -\texttt{  
129 -sudo gem install bundle -\--no-ri -\--no-rdoc  
130 -}}}  
131 73
132 -\subsection{Instalar Redmine 2.5.1}  
133 74
134 -\fbox{\parbox{\textwidth}{  
135 -\texttt{  
136 -cd /opt  
137 -\\  
138 -svn co http://svn.redmine.org/redmine/branches/2.5-stable redmine  
139 -\\  
140 -sudo mkdir -p tmp/pdf public/plugin\_assets  
141 -}}}  
142 75
143 -\subsection{Instalar requisitos da Gem} 76 +\subsubsection{Executar script de instalação do LDAP}
  77 +
  78 +Como parâmetro desse script deve ser passada a senha de admin do LDAP.
144 79
145 \fbox{\parbox{\textwidth}{ 80 \fbox{\parbox{\textwidth}{
146 \texttt{ 81 \texttt{
147 -cd /opt/redmine  
148 -\\  
149 -bundle install --without mysql sqlite 82 +sudo /opt/ldap.sh <senha\_admin>
150 }}} 83 }}}
151 84
152 85
153 -\subsection{Configurar postgresql}  
154 86
155 -\fbox{\parbox{\textwidth}{  
156 -\texttt{  
157 -sudo -u postgres psql  
158 -}}} 87 +\subsubsection{Executar script de instalação do Postgres (banco de dados)}
159 88
160 -Execute: 89 +Este script não possui nenhum valor como parâmetro.
161 90
162 -%Corrigindo  
163 \fbox{\parbox{\textwidth}{ 91 \fbox{\parbox{\textwidth}{
164 \texttt{ 92 \texttt{
165 -CREATE ROLE redmine LOGIN ENCRYPTED PASSWORD 'redmine' NOINHERIT VALID UNTIL 'infinity';  
166 -\\  
167 -CREATE DATABASE redmine WITH ENCODING='UTF8' OWNER=redmine;  
168 -\\  
169 -\textbackslash q 93 +/opt/postgresql.sh
170 }}} 94 }}}
171 95
172 96
173 -\subsection{Instalando Gems} 97 +
  98 +\subsubsection{Executar script de instalação do Redmine}
  99 +
  100 +Como parâmetro desse script deve ser passado o endereço IP da máquina provedora do serviço de banco de dados.
174 101
175 \fbox{\parbox{\textwidth}{ 102 \fbox{\parbox{\textwidth}{
176 \texttt{ 103 \texttt{
177 -sudo gem install pg -v '0.17.1' -\--no-ri -\--no-rdoc  
178 -\\  
179 -sudo gem install unicorn -\--no-ri -\--no-rdoc 104 +/opt/redmine.sh <ip\_banco\_de\_dados>
180 }}} 105 }}}
181 106
182 107
183 -\subsection{Configurar database.yml na pasta do Redmine}  
184 108
185 109
186 -\fbox{\parbox{\textwidth}{  
187 -\texttt{  
188 -cd config  
189 -\\  
190 -mv database.yml.example database.yml  
191 -\\  
192 -vim database.yml  
193 -}}} 110 +\subsubsection{Configurando Redmine para utilizar o LDAP}
194 111
195 -Comentar todas as linhas e descomentar estas baixo: 112 +A configuração do Redmine para a utilização do LDAP deverá ser feita via inteface gráfica, seguindo os passos abaixo:
196 113
197 -\fbox{\parbox{\textwidth}{  
198 -\texttt{  
199 -production:  
200 -\\  
201 -adapter: postgresql  
202 -\\  
203 -database: redmine  
204 -\\  
205 -host: <ip-banco-de-dados>  
206 -\\  
207 -username: redmine  
208 -\\  
209 -password: redmine  
210 -\\  
211 -encoding: utf8  
212 -}}} 114 +\begin{itemize}
  115 + \item Logar como administrador (Login: admin; Password: admin)
  116 + \item Clicar em "Administration" (barra superior esquerda)
  117 + \item Clicar em "LDAP authentication"
  118 + \item Clicar em "New authentication mode" (canto superior direito)
  119 + \item Deverá ser preenchido o formulário apresentado. Os campos devem ser preenchidos da seguinte forma (podendo ser alterados):
213 120
  121 + \begin{itemize}
  122 + \item Configuração:
  123 + \begin{itemize}
  124 + \item Name: ldapsei
  125 + \item Host: localhost (endereço IP da máquina referente ao LDAP)
  126 + \item Port: 389
  127 + \item Account: cn=admin,dc=sei,dc=com
  128 + \item Password: <senha\_admin\_ldap> (Senha passada como parâmetro no script de instalação do LDAP)
  129 + \item Base DN: dc=sei,dc=com
  130 + \item O checkbox "On-the-fly user creation" deverá ficar marcado
  131 + \end{itemize}
  132 + \item Atributos:
  133 + \begin{itemize}
  134 + \item Login attribute: uid
  135 + \item Firstname attribute: givenName
  136 + \item Lastname attribute: sn
  137 + \item Email attribute: mail
  138 + \end{itemize}
  139 + \end{itemize}
214 140
215 -\subsection{Popular Redmine} 141 + \item Clicar em "Save"
  142 +\end{itemize}
216 143
217 144
218 -\fbox{\parbox{\textwidth}{  
219 -\texttt{  
220 -rake generate\_secret\_token RAILS\_ENV=production  
221 -\\  
222 -rake db:migrate RAILS\_ENV=production  
223 -\\  
224 -rake redmine:load\_default\_data RAILS\_ENV=production  
225 -\\  
226 -(\emph{escolher pt-BR})  
227 -}}} 145 +\subsection{Desabilitar cadastro de usuário}
228 146
  147 +Ainda logado como administrador do sistema siga os passos abaixo para desabilitar o cadastro dos usuários.
229 148
230 -\subsection{Configurar Unicorn} 149 +\begin{itemize}
  150 + \item Clicar em "Administration" (barra superior esquerda)
  151 + \item Clicar em "Settings"
  152 + \item Clicar na aba "Authentication"
  153 + \item Selecionar a opção "disable" no campo "Self-registration"
  154 + \item Clicar em "Save"
  155 +\end{itemize}
231 156
232 157
233 -\fbox{\parbox{\textwidth}{  
234 -\texttt{  
235 -cd /opt/redmine  
236 -\\  
237 -mkdir pids  
238 -\\  
239 -vim config/unicorn.rb  
240 -}}}  
241 158
242 -Copie as linhas abaixo para unicorn.rb: 159 +\subsection{Instalando aplicação para criar usuário no LDAP}
243 160
244 -\fbox{\parbox{\textwidth}{  
245 -\texttt{  
246 -\#------------------------------------  
247 -\\  
248 -\# Set the working application directory  
249 -\\  
250 -\# working\_directory ``/path/to/your/app''  
251 -\\  
252 -working\_directory ``/opt/redmine''  
253 -\\  
254 -\# Unicorn PID file location  
255 -\\  
256 -\# pid ``/path/to/pids/unicorn.pid''  
257 -\\  
258 -pid ``/opt/redmine/pids/unicorn.pid''  
259 -\\  
260 -\# Path to logs  
261 -\\  
262 -\# stderr\_path ``/path/to/log/unicorn.log''  
263 -\\  
264 -\# stdout\_path ``/path/to/log/unicorn.log''  
265 -\\  
266 -stderr\_path ``/opt/redmine/log/unicorn.log''  
267 -\\  
268 -stdout\_path ``/opt/redmine/log/unicorn.log''  
269 -\\  
270 -\# Unicorn socket  
271 -\\  
272 -\#listen ``/tmp/unicorn.redmine.sock''  
273 -\\  
274 -listen ``/tmp/unicorn.redmine.sock''  
275 -\\  
276 -\# Number of processes  
277 -\\  
278 -\# worker\_processes 4  
279 -\\  
280 -worker\_processes 2  
281 -\\  
282 -\# Time-out  
283 -\\  
284 -timeout 30  
285 -\\  
286 -\#-------------------------------------  
287 -}}} 161 +Devido a grande quantidade de valores que devem ser passadas como parâmetro, os mesmos devem ser passados diretamente
  162 +dentro do script de instalação "ldap\_register.sh" na área de "Configuração" demarcada. O mesmo deve possuir os seguintes
  163 +dados:
  164 +
  165 +Abra o arquivo do script "ldap\_register.sh":
288 166
  167 +\begin{itemize}
  168 + \item Endereço IP da máquina do Redmine (Ex.: ADDRESS\_REDMINE="localhost/redmine")
  169 + \item Endereço IP da máquina do Gitlab (Ex.: ADDRESS\_GITLAB="192.168.1.114")
  170 + \item Dados de configuração do LDAP
289 171
290 -\subsection{Reiniciar Postgresql} 172 + \begin{itemize}
  173 + \item Endereço IP da máquina do LDAP (HOST="localhost")
  174 + \item Porta utilizada (PORT="389")
  175 + \item Nome do usuário admin do LDAP (USERNAME="cn=admin,dc=sei,dc=com")
  176 + \item Base (BASE="dc=sei,dc=com")
  177 + \item Senha de admin do LDAP (Senha passada como parâmetro no sript de instalação do LDAP. Ex.: 123456)
  178 + \end{itemize}
  179 +\end{itemize}
  180 +
  181 +Feche o arquivo do script.
  182 +
  183 +Executando o script sem passar nenhum parâmetro:
291 184
292 \fbox{\parbox{\textwidth}{ 185 \fbox{\parbox{\textwidth}{
293 \texttt{ 186 \texttt{
294 -sudo /etc/init.d/postgresql-9.3 restart 187 +/opt/ldap\_register.sh
295 }}} 188 }}}
296 189
297 190
298 -\subsection{Rodar Redmine usando Unicorn} 191 +\emph{NOTA:}
299 192
300 \fbox{\parbox{\textwidth}{ 193 \fbox{\parbox{\textwidth}{
301 -\texttt{  
302 -\small{sudo unicorn\_rails -c /opt/redmine/config/unicorn.rb -E production -l  
303 -0.0.0.0:80 -D} 194 +\texttt{
  195 +O Redmine pode ser acessado pela url: http://<IP\_REDMINE>/redmine
  196 +\\
  197 +O usuário e senha abaixo são referentes a instalação realizada no ambiente homologação disponibilizado pelo MPOG:
304 \\ 198 \\
305 -(\emph{subir na porta 80 porque está em uma máquina diferente do GitLab.  
306 - O padrão do Redmine é a porta 3000.}) 199 +Usuário: admin
  200 +\\
  201 +Senha: sei1234
  202 +\\
  203 +A aplicação de cadastro no LDAP pode ser acessado pela url: http://<IP\_LDAP\_REGISTER>:3000
307 }}} 204 }}}
308 -