Download as
Browse Code »

Commit ea19bc3b539a4bf60d980ad690e0fd3e30070e8b

Authored by Lucas Kanashiro
1 parent 24e9619e
Exists in master and in 1 other branch backuprestauracao

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

Showing 2 changed files with 183 additions and 232 deletions   Show diff stats
installDoc/gitlab-sei.tex
  Diff comments   View file @ea19bc3
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 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 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 70 \fbox{\parbox{\textwidth}{
24   -\texttt{sudo ./instalacaoGitlab.sh}}}
  71 +\texttt{
  72 +sudo /opt/gitlab.sh
  73 +}}}
  74 +
  75 +
  76 +
25 77  
26 78 \emph{NOTA:}
27 79  
28 80 \fbox{\parbox{\textwidth}{
29 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
  Diff comments   View file @ea19bc3
1   -\section{Redmine}
  1 +\section{LDAP + Redmine + Aplicação para cadastro no LDAP}
2 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 23 \fbox{\parbox{\textwidth}{
31 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 35 \fbox{\parbox{\textwidth}{
49 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 45 \fbox{\parbox{\textwidth}{
65 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 61 \fbox{\parbox{\textwidth}{
105 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 80 \fbox{\parbox{\textwidth}{
146 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 91 \fbox{\parbox{\textwidth}{
164 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 102 \fbox{\parbox{\textwidth}{
176 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 185 \fbox{\parbox{\textwidth}{
293 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 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   -
... ...