diff --git a/installDoc/gitlab-sei.tex b/installDoc/gitlab-sei.tex index 170de17..bb7edf5 100644 --- a/installDoc/gitlab-sei.tex +++ b/installDoc/gitlab-sei.tex @@ -1,33 +1,88 @@ -\section{Gitlab}\label{gitlab} +\section{Gitlab} +\label{gitlab} -\subsection{Configurações de Porta} -É essencial a configuração das seguintes portas para o funcionamento correto do Gitlab: \\ -* Abrir porta 22 para uso do git \\ -* Abrir porta 25 para uso do servidor de email postfix \\ +Recomenda-se que o serviço do Gitlab esteja executando em um servidor diferente dos outros serviços. -\subsection{Instalação Gitlab e Integração com Redmine} +\subsection{Pré-requisitos} -Baixar o script de instalação do Gitlab. +Para a execução da ferramenta nesse ambiente as seguintes portas devem estar liberadas: -\fbox{\parbox{\textwidth}{ -\texttt{sudo yum install wget -y}}} +\begin{itemize} +\item 80 +\item 22 +\item 25 +\end{itemize} + + + + +\subsection{Dar permissão de leitura, escrita e execução para o usuário corrente no diretório /opt} + +O usuário corrente deve está no grupo de sudo. \fbox{\parbox{\textwidth}{ -\texttt{sudo wget \textbackslash +\texttt{ +sudo chown \$USER:\$GROUP -R /opt \\ -https://gitlab.com/softwarepublico/labsei/raw/master/script/instalacaoGitlab.sh}}} +cd /opt +}}} + + + +\subsection{Instalação do pacote wget} + +\fbox{\parbox{\textwidth}{ +\texttt{ +sudo yum install -y wget +}}} + + + +\subsection{Download do script de instalação} + +\fbox{\parbox{\textwidth}{ +\texttt{ +wget https://gitlab.com/softwarepublico/labsei/raw/master/script/gitlab.sh +}}} + + + + +\subsubsection{Dar permissão de execução para o script} \fbox{\parbox{\textwidth}{ -\texttt{sudo chmod +x instalacaoGitlab.sh}}} +\texttt{ +chmod +x gitlab.sh +}}} + + + +\subsection{Observação Importante para execução do script} + +Ao executar os scripts adicione a senha do usuário quando solicitado! + + + +\subsection{Executar script de instalação do Gitlab} + +Para executar o script de instalação do Gitlab não é necessário passar nenhuma parâmetro. \fbox{\parbox{\textwidth}{ -\texttt{sudo ./instalacaoGitlab.sh}}} +\texttt{ +sudo /opt/gitlab.sh +}}} + + + \emph{NOTA:} \fbox{\parbox{\textwidth}{ \texttt{ -Você pode acessar o gitlab usando a url: http:// \\ -Usuario: root \\ -Senha 5iveL!fe \\ +O Gitlab pode ser acessado usando a url: http:// \\ +O usuário e senha abaixo são referentes a instalação realizada no ambiente homologação disponibilizado pelo MPOG: \\ +Usuário: root \\ +Senha: sei12345 \\ }}} + + diff --git a/installDoc/redmine-sei.tex b/installDoc/redmine-sei.tex index 630381c..4c7f5aa 100644 --- a/installDoc/redmine-sei.tex +++ b/installDoc/redmine-sei.tex @@ -1,308 +1,204 @@ -\section{Redmine} +\section{LDAP + Redmine + Aplicação para cadastro no LDAP} \label{redmine} -\subsection{Instalação do Epel} +Recomenda-se que todas as aplicações listadas estejam no mesmo servidor (LDAP + Redmine + Aplicação para cadastro no LDAP). -\fbox{\parbox{\textwidth}{ -\texttt{ -rpm -Uvh http://fedora.uib.no/epel/6/x86\_64/epel-release-6-8.noarch.rpm -}}} +\subsection{Pré-requisitos} -\subsection{Instalação de pacotes} -\fbox{\parbox{\textwidth}{ -\texttt{sudo yum -y install zlib-devel curl-devel openssl-devel httpd-devel apr-devel \textbackslash -\\ -apr-util-devel subversion git postgresql-devel wget vim} -}} +Para a execução das ferramentas nesse ambiente as seguintes portas devem estar liberadas: + +\begin{itemize} +\item 80 +\item 3000 +\item 389 +\item 21 +\end{itemize} -\subsection{Instalação Postgresql} -\fbox{\parbox{\textwidth}{ -\texttt{ -\scriptsize{ -sudo yum localinstall http://yum.postgresql.org/9.3/redhat/rhel-6-x86\_64/pgdg-centos93-9.3-1.noarch.rpm -y -\\ -sudo yum install postgresql93 postgresql93-devel postgresql93-libs postgresql93-server -y -}}}} -\subsubsection{Reiniciar Postgresql} +\subsection{Dar permissão de leitura, escrita e execução para o usuário corrente no diretório /opt} + +O usuário corrente deve está no grupo de sudo. \fbox{\parbox{\textwidth}{ \texttt{ -sudo /etc/init.d/postgresql-9.3 initdb +sudo chown \$USER:\$GROUP -R /opt \\ -sudo /etc/init.d/postgresql-9.3 restart +cd /opt }}} -\subsubsection{Modificar senha do Postgres} -%Corrigindo aspas -\fbox{\parbox{\textwidth}{ -\texttt{sudo -u postgres psql template1 -c \textbackslash -\\ -"ALTER USER postgres with encrypted password 'postgres';" -}}} -\subsubsection{Configurando o Postgres} + +\subsection{Instalação do pacote wget} \fbox{\parbox{\textwidth}{ \texttt{ -sudo vim /var/lib/pgsql/9.3/data/postgresql.conf -\\ -descomentar: \# listen\_addresses = 'localhost' +sudo yum install -y wget }}} -\subsubsection{Usar a permissão certa de usuário do Redmine no banco de dados do Redmine} -\fbox{\parbox{\textwidth}{ -\texttt{sudo vim /var/lib/pgsql/9.3/data/pg\_hba.conf}}} -O arquivo deve ficar desta forma: +\subsection{Download dos scripts de instalação} -%Atualizando permissão dos usuários \fbox{\parbox{\textwidth}{ \texttt{ -\# TYPE DATABASE USER ADDRESS METHOD -\\ -\# local is for Unix domain socket connections only -\\ -local all redmine md5 -\\ -local all all peer -\\ -\# IPv4 local connections: +wget https://gitlab.com/softwarepublico/labsei/raw/master/script/ldap.sh \\ -host all redmine 127.0.0.1/32 md5 +wget https://gitlab.com/softwarepublico/labsei/raw/master/script/postgresql.sh \\ -host all all 127.0.0.1/32 ident +wget https://gitlab.com/softwarepublico/labsei/raw/master/script/redmine.sh \\ -\# IPv6 local connections: -\\ -host all redmine ::1/128 md5 -\\ -host all all ::1/128 ident +wget https://gitlab.com/softwarepublico/labsei/raw/master/script/ldap\_register.sh }}} -\subsubsection{Reiniciar Postgresql} - -\fbox{\parbox{\textwidth}{ -\texttt{sudo /etc/init.d/postgresql-9.3 restart}}} -\subsection{Instalar Requisitos das Gems} -\fbox{\parbox{\textwidth}{ -\texttt{ -sudo yum install gcc gcc-c++.x86\_64 make automake autoconf curl-devel \textbackslash -\\ -openssl-devel zlib-devel httpd-devel apr-devel apr-util-devel \textbackslash -\\ -sqlite-devel ruby-rdoc ruby-devel rubygems libxslt-devel libxml2-devel.x86\_64 -y}}} -\subsection{Atualizar para a Gem 1.4.2} +\subsubsection{Dar permissão de execução para os scripts} \fbox{\parbox{\textwidth}{ \texttt{ -wget http://production.cf.rubygems.org/rubygems/rubygems-1.4.2.tgz -\\ -tar zxvf rubygems-1.4.2.tgz -\\ -cd rubygems-1.4.2 -\\ -ruby setup.rb -\\ -gem -v +chmod +x /opt/*.sh }}} -\subsection{Instalar ImageMagick} -\fbox{\parbox{\textwidth}{ -\texttt{ -sudo yum install php-pear ImageMagick ImageMagick-devel ImageMagick-perl -y -}}} +\subsection{Observação Importante para execução dos scripts} + +Ao executar os scripts adicione a senha do usuário quando solicitado! -\subsection{Instalar Gem Bundle} -\fbox{\parbox{\textwidth}{ -\texttt{ -sudo gem install bundle -\--no-ri -\--no-rdoc -}}} -\subsection{Instalar Redmine 2.5.1} -\fbox{\parbox{\textwidth}{ -\texttt{ -cd /opt -\\ -svn co http://svn.redmine.org/redmine/branches/2.5-stable redmine -\\ -sudo mkdir -p tmp/pdf public/plugin\_assets -}}} -\subsection{Instalar requisitos da Gem} +\subsubsection{Executar script de instalação do LDAP} + +Como parâmetro desse script deve ser passada a senha de admin do LDAP. \fbox{\parbox{\textwidth}{ \texttt{ -cd /opt/redmine -\\ -bundle install --without mysql sqlite +sudo /opt/ldap.sh }}} -\subsection{Configurar postgresql} -\fbox{\parbox{\textwidth}{ -\texttt{ -sudo -u postgres psql -}}} +\subsubsection{Executar script de instalação do Postgres (banco de dados)} -Execute: +Este script não possui nenhum valor como parâmetro. -%Corrigindo \fbox{\parbox{\textwidth}{ \texttt{ -CREATE ROLE redmine LOGIN ENCRYPTED PASSWORD 'redmine' NOINHERIT VALID UNTIL 'infinity'; -\\ -CREATE DATABASE redmine WITH ENCODING='UTF8' OWNER=redmine; -\\ -\textbackslash q +/opt/postgresql.sh }}} -\subsection{Instalando Gems} + +\subsubsection{Executar script de instalação do Redmine} + +Como parâmetro desse script deve ser passado o endereço IP da máquina provedora do serviço de banco de dados. \fbox{\parbox{\textwidth}{ \texttt{ -sudo gem install pg -v '0.17.1' -\--no-ri -\--no-rdoc -\\ -sudo gem install unicorn -\--no-ri -\--no-rdoc +/opt/redmine.sh }}} -\subsection{Configurar database.yml na pasta do Redmine} -\fbox{\parbox{\textwidth}{ -\texttt{ -cd config -\\ -mv database.yml.example database.yml -\\ -vim database.yml -}}} +\subsubsection{Configurando Redmine para utilizar o LDAP} -Comentar todas as linhas e descomentar estas baixo: +A configuração do Redmine para a utilização do LDAP deverá ser feita via inteface gráfica, seguindo os passos abaixo: -\fbox{\parbox{\textwidth}{ -\texttt{ -production: -\\ -adapter: postgresql -\\ -database: redmine -\\ -host: -\\ -username: redmine -\\ -password: redmine -\\ -encoding: utf8 -}}} +\begin{itemize} + \item Logar como administrador (Login: admin; Password: admin) + \item Clicar em "Administration" (barra superior esquerda) + \item Clicar em "LDAP authentication" + \item Clicar em "New authentication mode" (canto superior direito) + \item Deverá ser preenchido o formulário apresentado. Os campos devem ser preenchidos da seguinte forma (podendo ser alterados): + \begin{itemize} + \item Configuração: + \begin{itemize} + \item Name: ldapsei + \item Host: localhost (endereço IP da máquina referente ao LDAP) + \item Port: 389 + \item Account: cn=admin,dc=sei,dc=com + \item Password: (Senha passada como parâmetro no script de instalação do LDAP) + \item Base DN: dc=sei,dc=com + \item O checkbox "On-the-fly user creation" deverá ficar marcado + \end{itemize} + \item Atributos: + \begin{itemize} + \item Login attribute: uid + \item Firstname attribute: givenName + \item Lastname attribute: sn + \item Email attribute: mail + \end{itemize} + \end{itemize} -\subsection{Popular Redmine} + \item Clicar em "Save" +\end{itemize} -\fbox{\parbox{\textwidth}{ -\texttt{ -rake generate\_secret\_token RAILS\_ENV=production -\\ -rake db:migrate RAILS\_ENV=production -\\ -rake redmine:load\_default\_data RAILS\_ENV=production -\\ -(\emph{escolher pt-BR}) -}}} +\subsection{Desabilitar cadastro de usuário} +Ainda logado como administrador do sistema siga os passos abaixo para desabilitar o cadastro dos usuários. -\subsection{Configurar Unicorn} +\begin{itemize} + \item Clicar em "Administration" (barra superior esquerda) + \item Clicar em "Settings" + \item Clicar na aba "Authentication" + \item Selecionar a opção "disable" no campo "Self-registration" + \item Clicar em "Save" +\end{itemize} -\fbox{\parbox{\textwidth}{ -\texttt{ -cd /opt/redmine -\\ -mkdir pids -\\ -vim config/unicorn.rb -}}} -Copie as linhas abaixo para unicorn.rb: +\subsection{Instalando aplicação para criar usuário no LDAP} -\fbox{\parbox{\textwidth}{ -\texttt{ -\#------------------------------------ -\\ -\# Set the working application directory -\\ -\# working\_directory ``/path/to/your/app'' -\\ -working\_directory ``/opt/redmine'' -\\ -\# Unicorn PID file location -\\ -\# pid ``/path/to/pids/unicorn.pid'' -\\ -pid ``/opt/redmine/pids/unicorn.pid'' -\\ -\# Path to logs -\\ -\# stderr\_path ``/path/to/log/unicorn.log'' -\\ -\# stdout\_path ``/path/to/log/unicorn.log'' -\\ -stderr\_path ``/opt/redmine/log/unicorn.log'' -\\ -stdout\_path ``/opt/redmine/log/unicorn.log'' -\\ -\# Unicorn socket -\\ -\#listen ``/tmp/unicorn.redmine.sock'' -\\ -listen ``/tmp/unicorn.redmine.sock'' -\\ -\# Number of processes -\\ -\# worker\_processes 4 -\\ -worker\_processes 2 -\\ -\# Time-out -\\ -timeout 30 -\\ -\#------------------------------------- -}}} +Devido a grande quantidade de valores que devem ser passadas como parâmetro, os mesmos devem ser passados diretamente +dentro do script de instalação "ldap\_register.sh" na área de "Configuração" demarcada. O mesmo deve possuir os seguintes +dados: + +Abra o arquivo do script "ldap\_register.sh": +\begin{itemize} + \item Endereço IP da máquina do Redmine (Ex.: ADDRESS\_REDMINE="localhost/redmine") + \item Endereço IP da máquina do Gitlab (Ex.: ADDRESS\_GITLAB="192.168.1.114") + \item Dados de configuração do LDAP -\subsection{Reiniciar Postgresql} + \begin{itemize} + \item Endereço IP da máquina do LDAP (HOST="localhost") + \item Porta utilizada (PORT="389") + \item Nome do usuário admin do LDAP (USERNAME="cn=admin,dc=sei,dc=com") + \item Base (BASE="dc=sei,dc=com") + \item Senha de admin do LDAP (Senha passada como parâmetro no sript de instalação do LDAP. Ex.: 123456) + \end{itemize} +\end{itemize} + +Feche o arquivo do script. + +Executando o script sem passar nenhum parâmetro: \fbox{\parbox{\textwidth}{ \texttt{ -sudo /etc/init.d/postgresql-9.3 restart +/opt/ldap\_register.sh }}} -\subsection{Rodar Redmine usando Unicorn} +\emph{NOTA:} \fbox{\parbox{\textwidth}{ -\texttt{ -\small{sudo unicorn\_rails -c /opt/redmine/config/unicorn.rb -E production -l -0.0.0.0:80 -D} +\texttt{ +O Redmine pode ser acessado pela url: http:///redmine +\\ +O usuário e senha abaixo são referentes a instalação realizada no ambiente homologação disponibilizado pelo MPOG: \\ -(\emph{subir na porta 80 porque está em uma máquina diferente do GitLab. - O padrão do Redmine é a porta 3000.}) +Usuário: admin +\\ +Senha: sei1234 +\\ +A aplicação de cadastro no LDAP pode ser acessado pela url: http://:3000 }}} - -- libgit2 0.21.2