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


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:


(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


(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;};


(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


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


- 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/

manual de instalacao linux

Documents