Download - Manual de Instalacao Linux
-
INSTALL 2010-05-20
==================================================Instalando e Executando o Siprev em Ambiente Linux
ATENO: Este manual foi feito para usurios que tenham conhecimentos de administrador Linux.
As instrues que se seguem foram executadas em um ambiente Linux (Ubuntu 9.10 Karmic Koala)[7], porm acredita-se no haver diferena na sintaxe dos comandos utilizados, uma vez que o interpretador de linha de comando seja o GNU Bash[1] (/bin/bash).
Sugerimos que toda a instalao seja por meio dos cdigos fonte e binrios indicados por esse manual, uma vez que a soluo proposta fazer com que o Siprev possa ser executado em qualquer distribuio GNU/Linux, independente daforma como as distribuio empacotam e distribuem seus pacotes/programas.
=============================Introduo e Pr-dependncias=============================
Antes de iniciar a instalao, assumiremos que os seguintes arquivos esto no endereo /home/siprev/, quando referenciarmos esse endereo, utilize o endereo onde esses arquivos se encontram em seu computador:
- SIPREV.war- spring-agent.jar- Cria_Banco_PostgreSQL.sql
Iremos primeiro instalar o Sun Java JRE[2] Verso 1.6.0_20, configura-lo e o deixar funcionando em seu sistema operacional. Iremos configurar os 'paths' que sero exportados para o ambiente de execuo de comandos.
Sun Java JRE(1) Caso voc j possua o arquivo do instalador binrio (.bin), copie-o para seu diretrio 'home'. Se no possuir, realize o download do instalador binrio (.bin) do Sun Java JRE:
-
- Visite http://java.com para fazer esse download
Salve o arquivo em seu diretorio 'home'.
(2) A seguir d permisso de execuo ao arquivo:$ chmod +x jre-6u20-linux-i586.bin
(3) Execute o arquivo para que ele seja automaticamente descompactado no diretrio onde voc est.
-
$ ./jre-6u20-linux-i586.bin
necessrio aceitar uma licena de uso para que a descompresso seja realizada e que voc possa utilizar o Sun Java JRE.Para isso v at o fim do texto da licena, para facilitar pressione a tecla 'SPACE' e digite 'yes', sem as aspas.
-
(4) Copiar o Sun Java JRE para outra pasta$ sudo cp -r jre1.6.0_20 /opt/jre6
-
(5) Permitir que o 'path' do Sun Java JRE seja exportado para o ambiente de execuo de comandos.
$ sudo pico /etc/profile.d/java.sh
E coloque dentro do arquivo o seguinte contedo:
#!/bin/shexport JAVA_HOME=/opt/jre6export JRE_HOME=/opt/jre6export PATH=$PATH:$JRE_HOME/bin
Pressione Control + O para salvar, em seguida enter para confirmar e, por ltimo, Control + X para sair.
-
- Atribua permisso de execuo ao arquivo
$ sudo chmod +x /etc/profile.d/java.sh
-
(6) Reinicie sua sesso de usurio e verifique se o 'path' foi configuradocom sucesso.
Para ter certeza disso por favor verifique se o comando:
$ echo $JAVA_HOME
ir retorna o valor esperado, ou seja, o diretrio onde sua mquina virtual Sun Java est instalada. Esse passo de extrema importncia, uma vez que a mquina virtual Sun Java necessria tanto para a execuo do Apache Tomcat[3] quanto do Siprev.
As outras pr-dependncias desse tutorial so: GNU Wget[5], GNU Make[6], GNU Tar[8].
Qualquer editor de textos pode ser usado durante a instalao, para realizao de edio de arquivos texto puro, porm usamos o 'pico' por j ser padro de muitas distribuies GNU Linux. Voc pode substituir as linhas de comando que contm 'pico' por outro editor de sua preferncia, tais como: 'emacs', 'vi', 'vim', 'gedit', 'kate' e etc.
============Dependncias ============A instalao do Siprev exige duas dependncias primrias, so elas: - Apache Tomcat 6.0.14 [3]- PostgreSQL 8.4.2 [4]
Iremos transcorrer a instalao passo-a-passo de todas a dependncias.
********************Apache Tomcat 6.0.14********************
-
(1) Caso voc j possua os binrios, copie-os para seu diretrio 'home'. Se no possuir, realize o download dos binrios:$ wget -c http://archive.apache.org/dist/tomcat/tomcat-6/v6.0.14/bin/apache-tomcat-6.0.14.tar.gz
(2) Descompacte o arquivo:$ tar xzvf apache-tomcat-6.0.14.tar.gz
-
Aps isso um diretrio ser criado, com o nome: apache-tomcat-6.0.14
(3) Mova o diretrio descompactado para a pasta de destino:$ sudo mv apache-tomcat-6.0.14 /opt/tomcat6
-
Lembramos que para realizar esse procedimento necessrio permisso de super-usurio, ou seja, que voc seja 'root', ou use o 'sudo' para executaro comando. Iremos a partir daqui usar sempre o 'sudo' para permitir acesso a recursos de super-usurio.
(4) Adicionar o ambiente de execuo o 'path' do Apache Tomcat:Primeiro criamos um arquivo para conter as instrues que iro colocar no 'path' o diretrio do Apache Tomcat.
$ sudo pico /etc/profile.d/tomcat.sh
Coloque o seguinte contedo dentro do arquivo:
#!/bin/bashexport TOMCAT_HOME=/opt/tomcat6export CATALINA_HOME=/opt/tomcat6
Pressione Control + O para salvar, em seguida enter para confirmar e, por ltimo, Control + X para sair.
-
Ainda necessrio executar outro comando para permitir a execuo do arquivo:$ sudo chmod +x /etc/profile.d/tomcat.sh
-
Isso ir fazer com que o arquivo seja executado toda vez que o sistema for iniciado e assim fazer com que o 'path' do Apache Tomcat seja carregado.
(5) Altere a porta tcp do Apache Tomcat$ sudo pico /opt/tomcat6/conf/server.xml
Apague a 'TAG' que existe nas linhas 49-51:
Substituia por:
Pressione Control + O para salvar, em seguida enter para confirmar e, por ltimo, Control + X para sair.
-
(6) Tambm necessrio alterar o 'server.xml' para permitir que as configuraes de autenticao funcionem:
Inclua as linhas abaixo aps a linha 128 do arquivo 'server.xml'.
$ sudo pico /opt/tomcat6/conf/server.xml
Pressione Control + O para salvar, em seguida enter para confirmar e, por ltimo, Control + X para sair.
-
(7) Adicionar o arquivo "siprev_jaas.config" ao Apache Tomcat
$ sudo pico /opt/tomcat6/conf/siprev_jaas.config
-
Coloque o seguinte contedo dentro do arquivo:
Siprev{ br.gov.dataprev.siprev.seguranca.jaas.SiprevLoginModule required debug=true;};
Pressione Control + O para salvar, em seguida enter para confirmar e, por ltimo, Control + X para sair.
-
(8) Copiar a biblioteca 'spring-agent.jar' para o Apache Tomcat$ sudo cp spring-agent.jar /opt/tomcat6/lib/
-
(9) Crie um arquivo para permitir que o Apache Tomcat seja executado a cada inicializao do sistema.$ sudo pico /etc/init.d/tomcat
E coloque o seguinte contedo dentro arquivo:
#!/bin/sh -e# Tomcat auto-start## description: Auto-starts tomcat# processname: tomcat# pidfile: /var/run/tomcat.pid
export JAVA_HOME=/opt/jre6export JAVA_OPTS="-javaagent:/opt/tomcat6/lib/spring-agent.jar -Djava.security.auth.login.config=/opt/tomcat6/conf/siprev_jaas.config"
case $1 instart) sh /opt/tomcat6/bin/startup.sh;;stop) sh /opt/tomcat6/bin/shutdown.sh;;restart) sh /opt/tomcat6/bin/shutdown.sh sh /opt/tomcat6/bin/startup.sh;;esacexit 0
-
Pressione Control + O para salvar, em seguida enter para confirmar e, por ltimo, Control + X para sair.
ATENO: No esquea de alterar a varivel JAVA_HOME dentro desse arquivo, e aponta-la para onde est instalada a mquina virtual Sun Java.
Ainda necessrio executar outros comandos para permitir a execuo do arquivo:
$ sudo ln -s /etc/init.d/tomcat /etc/rc2.d/S99tomcat$ sudo ln -s /etc/init.d/tomcat /etc/rc3.d/S99tomcat$ sudo ln -s /etc/init.d/tomcat /etc/rc4.d/S99tomcat$ sudo ln -s /etc/init.d/tomcat /etc/rc5.d/S99tomcat$ sudo chmod +x /etc/init.d/tomcat
-
(10) Aumentar timeout do Apache Tomcat
$ sudo pico /opt/tomcat6/conf/web.xml
V at a linha 465 e altere o timeout para:
-
1440
(11) Executar o Apache TomcatRecomenda-se fortemente que antes desse passo voc encerre sua sesso no sistema, e a inicie novamente, ou se puder reinicie o sistema.
$ sudo /etc/init.d/tomcat start
-
Isso ir fazer com que o Apache Tomcat seja iniciado e fique em estado de escuta, esperando conexo.
(12) Teste se o Apache Tomcat est funcional.Abra seu browser e acesse o link:http://localhost:8089/
-
Caso voc veja tela de apresentao o Apache Tomcat est funcionando.
(13) Copie o 'WAR' do Siprev para o Apache Tomcat$ sudo cp SIPREV.war /opt/tomcat6/webapps/
-
****************PostgreSQL 8.4.2****************(1) Caso voc j possua o cdigo-fonte, copie-o para seu diretrio 'home'. Se no possuir, realize o download do cdigo fonte:$ wget -c http://ftp2.uk.postgresql.org/sites/ftp.postgresql.org/source/v8.4.2/postgresql-8.4.2.tar.gz
-
(2) Descompacte o arquivo:$ tar xzvf postgresql-8.4.2.tar.gz
-
(3) Mova o diretorio descompactado para a pasta de destino:$ sudo mv postgresql-8.4.2 /opt/postgresql
-
(4) Compilar os cdigo fonte do PostgreSQL$ cd /opt/postgresql$ ./configure --without-readline -without-zlib
$ make
-
$ sudo make install
-
Aps isso o PostgreSQL estar compilado e instalado em seu sistema.
(5) Configurar o PostgreSQL
- Adicionar o usurio 'postgres' ao sistema operacional (definir senha "siprev123")$ sudo adduser postgres
- Criar o diretrio onde ficar os dados fsicos do PostgreSQL$ sudo mkdir /usr/local/pgsql/data
-
- Modificar o proprietrio da pasta de dados para o usurio 'postgres'$ sudo chown postgres /usr/local/pgsql/data
-
- Modificar o proprietrio do script de gerao do banco de dados para o usurio 'postgres'$ sudo chown postgres /home/siprev/Cria_Banco_PostgreSQL.sql
(6) Permitir a execuo automtica do servio PostgreSQL
$ sudo cp /opt/postgresql/contrib/start-scripts/linux /etc/init.d/postgresql$ sudo chmod +x /etc/init.d/postgresql$ sudo ln -s /etc/init.d/postgresql /etc/rc2.d/S98postgresql$ sudo ln -s /etc/init.d/postgresql /etc/rc3.d/S98postgresql$ sudo ln -s /etc/init.d/postgresql /etc/rc4.d/S98postgresql$ sudo ln -s /etc/init.d/postgresql /etc/rc5.d/S98postgresql
-
(7) Iniciar o PostgreSQL- Acessar o sistema operacional como usurio 'postgres'$ su - postgres
-
- Iniciar o PostgreSQL$ /usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data
-
- Altera a porta tcp do PostgreSQL$ pico /usr/local/pgsql/data/postgresql.conf
Altere o parmetro da linha 63 e remova a cerquilha (#), para:port = 5433
Pressione Control + O para salvar, em seguida enter para confirmar e, por ltimo, Control + X para sair.
-
- Iniciar o gerenciador de conexes do PostgreSQL$ /usr/local/pgsql/bin/postmaster -D /usr/local/pgsql/data >logfile 2>&1 &
-
(8) Testar o PostgreSQL
- Criando um banco de dados de teste$ /usr/local/pgsql/bin/createdb -p 5433 test
- Conectando-se ao banco de dados de teste$ /usr/local/pgsql/bin/psql -p 5433 test
-
Realizado os passos anteriores o PostgreSQL estar pronto para receber conexes.
==============Ps-instalao==============
Ainda necessrio fazermos algumas configuraes simples para que o Siprevpossa ser usado.
(1) Executar o script 'sql' que ir criar a estrutura bsica de dados no PostgreSQL. Caso o PostgreSQL j esteja sendo executado, o segundo comando retornar uma mensagem de erro. Prossiga com os demais passos.$ su - postgres$ /usr/local/pgsql/bin/pg_ctl start -l logfile -D /usr/local/pgsql/data$ /usr/local/pgsql/bin/createdb -p 5433 siprev_gestao$ /usr/local/pgsql/bin/psql siprev_gestao -p 5433 -f /home/siprev/Cria_Banco_PostgreSQL.sql
-
(2) Abra seu browser e acesse o link: http://localhost:8089/SIPREV
-
==================================================Atualizando o Siprev em Ambiente Linux
Antes de iniciar a atualizao, assumiremos que os seguintes arquivos esto no endereo /home/siprev/, quando referenciarmos esse endereo, utilize o endereo onde esses arquivos se encontram em seu computador:
- SIPREV.war- Atualiza_Banco_PostgreSQL.sql
Para atualizar o Siprev em ambiente Linux necessrio apenas copiar o WAR para o Apache Tomcat e/ou executar o script de atualizao do banco de dados.
(1) Copie o 'WAR' do Siprev para o Apache Tomcat$ sudo cp SIPREV.war /opt/tomcat6/webapps/
-
(2) Reinicie o Apache Tomcat$ sudo /etc/init.d/tomcat restart
-
(3) Executar o script 'sql' que ir atualizar o banco de dados no PostgreSQL. Caso o PostgreSQL j esteja sendo executado, o segundo comando retornar uma mensagem de erro. Prossiga com o passo 3.
$ su - postgres$ /usr/local/pgsql/bin/pg_ctl start -l logfile -D /usr/local/pgsql/data$ /usr/local/pgsql/bin/psql siprev_gestao -p 5433 -f /home/siprev/Atualiza_Banco_PostgreSQL.sql
-
(4) Abra seu browser e acesse o link: http://localhost:8089/SIPREV
-
==================================================Desinstalando o Siprev em Ambiente Linux
Para desinstalar o Siprev basta remover o arquivo SIPREV.war da pasta /opt/tomcat6/webapps/:
$ sudo rm /opt/tomcat6/webapps/SIPREV.war
Caso tambm queira desinstalar as aplicaes Java, Tomcat e PostgreSQL siga os prximos passos (tenha a certeza de que nenhum outro sistema est utilizando essas aplicaes, no nos responsabilizamos por problemas ocorridos em outros sistemas por conta dessa desinstalao).
(3) Desinstalando o PostgreSQL
$ sudo rm /etc/init.d/postgresql
-
$ sudo rm -r /usr/local/pgsql/
-
$ sudo userdel -r postgres
$ sudo rm r /opt/postgresql/
-
(2) Desinstalando o Tomcat
$ sudo rm /etc/init.d/tomcat
$ sudo rm /etc/profile.d/tomcat.sh
-
$ sudo rm -r /opt/tomcat6/
-
(3) Desinstalando o Java
$ sudo rm /etc/profile.d/java.sh
$ sudo rm -r /opt/jre6/
-
Referncias:[1] http://www.gnu.org/software/bash/[2] http://java.sun.com/javase/downloads/widget/jdk6.jsp[3] http://tomcat.apache.org/[4] http://www.postgresql.org/[5] http://www.gnu.org/software/wget/[6] http://www.gnu.org/software/make/[7] http://releases.ubuntu.com/karmic/ [8] http://www.gnu.org/software/tar/