Tutorial de Instalao do Biblivre 3 em ambiente Linux

(Distribuies Ubuntu, Debian, Fedora, CentOS e Slackware)

1 Introduo
Este tutorial objetiva atender aos usurios que querem utilizar o sistema Biblivre 3 em
ambiente Linux nas distribuies Ubuntu/Debian(Via grfico e terminal) e para as
distribuies Fedora/CentOS/Slackware(Via terminal).
Este tutorial foi desenvolvido graas a colaborao usurios entusiastas do sistema
Biblivre e desenvolvedores que acreditam nos benefcios do uso de software livre como
fonte de conhecimento. Nossos agradecimentos so para:
Andria de Oliveira Costa Gaspar (Andria Noibe)
Alessander Alves Novaes colaborou com parte do desenvolvimento do tutorial,
orientando o processo e fornecendo scripts de grande ajuda;
Dennys Sobrinho colaborou com partes de processo do tutorial, orientando em
tpicos do Frum;
Hermes Pereira Jnior Especialista em Linux da UFV (Viosa-MG) - colaborou
orientando na ordem correta de instalao dos pacotes de apoio ao sistema;
Ana Paula Vieira e Victor Laurie colaboraram testando online todo o processo de
instalao do aplicativo em outros ambientes Linux;
2 Instalao JAVA
2.1 Acesse ao Gerenciador de Pacotes Synaptic;
2.2 - Faa a busca pelo pacote Java;
2.3 Verifique se os principais pacotes Java 6 esto instalados no sistema.
2.4 - Caso queira usar o terminal, acesse ao o aplicativo e escreva os seguintes
comandos, confirmando com a tecla ENTER a cada linha digitada e aguarde a
concluso da instalao:
sudo add-apt-repository ppa:ferramroberto/java
sudo apt-get update
sudo apt-get install sun-java6-jre sun-java6-plugin sun-java6-fonts
2.5 - Aps o processo, ser visualizada a seguinte tela para configurao em formato
grfico. Tecle na tecla TAB para marcar o comando <OK> e tecle ENTER.
2.6 - Para aceitar os termos de instalao, selecione a opo <Sim> com o TAB e
confirme com a tecla ENTER. Aps a confirmao, aguarde a finalizao do processo
de instalao.
3 Postgres 9.0

3.1 Para instalar o PostgreSQL 9 atravs do Synaptic, acesse ao aplicativo e insira a

sua senha para confirmar a ativao do mesmo.
3.2 Digite na opo de busca a descrio PostgreSQL 9.
3.3 Caso o pacote no esteja instalado, marque-o no lado esquerdo dos pacotes e
confirme a instalao.
3.4 - Caso queira instalar atravs do aplicativo Terminal, acesse-o e digite os seguintes
comandos:
sudo add-apt-repository ppa:pitti/postgresql
sudo apt-get update
sudo apt-get install postgresql
3.5 Concluindo a instalao, se foi instalado com sucesso, o Postgresql ser ativado
automaticamente.
3.6 Depois da instalao, confira a verso colocada com o seguinte comando
psql -V
3.7 - Verifique se o usurio postgres foi criado com o seguinte comando:
finger postgresql
3.8 - Mude a senha do Postgresql para abracadabra com o seguinte comando:
sudo passwd postgres
3.9 - O prximo passo mudar para o usurio postgres e setar uma senha PostgreSQL.
Para isto basta trocar para o usurio postgres com o comando su postgres, digitar psql
para entrar no console do PostgreSQL e rodar o comando alter user postgres with
password abracadabra. Aps sair do console e, selecionar exit para sair do usurio
UNIX postgres.
3.10 Para configurar o Postgresql usando seguintes comandos:
su postgres
cd /etc/postgresql/9.1/main
ls -la
3.11 - Para listar o contedo, execute os seguintes comandos:
cp pg_hba.conf pg_hba.conf.bak.original
cp postgresql.conf postgresql.conf.bak.original

3.12 Terminando o processo, desconecta do usurio postgres.

3.13 Instale o pgadmin3, caso precise fazer backup dos dados sem usar o Biblivre3,
usando o seguinte comando:
sudo apt-get install pgadmin3
3.14 Terminando a instalao, digite o comando pgadmin3 no terminal ou acesse
atravs do menu grfico do ambiente de trabalho do Ubuntu, que ver o pgadmin3
instalado, concluindo o processo de instalao do PostgreSQL.
4 Tomcat 6.0
4.1 Acesse ao Gerenciador de pacotes Synaptic;
4.2 - Faa a busca do aplicativo Tomcat;
4.3 - Verifique se a verso 6 est instalada, seno faa a instalao dela.
4.4 Mas para fazer a instalao via terminal, acesse o aplicativo e escreva o seguinte
comando para fazer o download do Tomcat:
wget http://linorg.usp.br/apache/tomcat/tomcat-6/v6.0.35/bin/apache-tomcat6.0.35.tar.gz
4.5 Mova o arquivo copiado para a pasta opt
sudo mv apache-tomcat-6.0.35.tar.gz /opt
4.6 Verifique se o arquivo foi corretamente copiado para a pasta com este comando:
cd/ opt
ls -la
4.7 - Descompacte o arquivo com seguinte comando:
sudo tar -xvzf apache-tomcat-6.0.35.tar.gz
4.8 Se quiser, renomeie a pasta para facilitar a identificao com o este comando:
sudo mv apache-tomcat-6.0.35 tomcat
4.9 - Terminando o processo, acesse o brownser e execute o endereo
http://localhost:8080/.
5 Apache 2.2
5.1 Acesse ao Gerenciador de Pacotes Synaptic;

5.2 - Faa a busca pelo Apache2;

5.3 - Verifique se os principais pacotes esto instalados.
5.4 Caso no se encontrem instalados, marque o Apache2 e faa a instalao.
5.5 - Caso queira usar o terminal, use o seguinte comando para instalar o Apache2:
sudo apt-get install apache2
5.6 Quando for exibida a mensagem Starting Web Server Apache2 e no final da
linha exibir o status de [OK], significa que o Apache foi instalado e ativo com sucesso.
6 Instalar o Biblivre 3
6.1 Acesse ao portal Biblivre http://www.biblivre.org.br e faa o download da
ltima verso.
6.2 Baixe o instalador do Biblivre 3 para a pasta downloads.
6.3 - Acesse a pasta downloads, localize o arquivo e renomeie para biblivre3.7zip.
6.4 Execute o arquivo para extrair os arquivos compactados, clicando com o lado
direito do mouse encima do arquivo e escolhendo a opo Abrir com gerenciador de
pacotes.
6.5 - Ser aberta uma nova tela com o contedo do arquivo.
6.6 - Efetue a extrao dos arquivos.
6.7 Aguarde o processo de extrao e visualize os arquivos descompactados.
6.8 Localize os arquivos biblivre3.war, createdatabase.sql e o biblivre3.sql e copieos para a Pasta Pessoal. Delete o restante do Biblivre 3 que ficou na pasta Downloads.
6.9 - Caso a sua distribuio no seja Ubuntu/Debian, faa o mesmo procedimento do
item 6.1. Sendo que, copie o arquivo para uma pasta temporria e de l, renomeie o
arquivo para biblivre3.7zip. Acesse ao terminal e descompacte-o dentro da pasta
temporria, e guarde somente os arquivos biblivre3.war, createdatabase.sql e o
biblivre3.sql, excluindo os outros arquivos da pasta.
7 Posio dos arquivos no sistema
7.1 - Ative o Tomcat usando o seguinte comando:
sudo sh /opt/apache-tomcat-6.0.35/bin/startup.sh
7.2 - Copie o arquivo biblivre3.war para a pasta webapps do Tomcat usando o seguinte
comando:

sudo cp biblivre3.war /opt/apache-tomcat-6.0.35/webapps/

7.3 Faa um deploy (reinicie o Tomcat) para extrair o arquivo biblivre3.war, e em
seguida, acesse a pasta webapps e verifique se o arquivo foi extrado com sucesso.
7.4 Copie os arquivos createdatabase.sql e biblivre3.sql para a pasta principal de
dados do Postgres com o seguinte comando:
sudo cp biblivre3.sql /var/lib/postgresql/9.1/main/base/
(Para servidores Linux Ubuntu e Debian)
sudo cp biblivre3.sql/var/lib/pgsql/data/
(Para servidores Linux Fedora, CentoOS e Slackware)
7.5 - Crie o usurio Biblivre e usando estes comandos:
su postgres
psql
CREATE USER biblivre PASSWORD 'abracadabra'
7.6 Crie o banco de dados em branco para armazenar os dados do arquivo
biblivre3.sql.
createdb -O biblivre biblivre3
Observao: Caso tenha mais experincia com o Postgres, use o arquivo
createbatabase.sql para criar o banco de dados Biblivre 3.
7.7 Entre na pasta onde copiou o arquivo biblivre3.sql (acesse as pastas informadas
no item 7.4) e restaure o contedo do mesmo no banco criado em branco no Postgres.
psql e biblivre3 < biblivre3.sql
8 Configuraes
8.1 Para o funcionamento pleno do Biblivre3, imprescindvel verificar os arquivos
de configuraes dos aplicativos associados. Antes de usar o sistema, verifique
primeiramente o contedo do arquivo context.xml que se encontra dentro da pasta
biblivre3 no aplicativo Tomcat
sudo vi /opt/apache-tomcat-6.0.35/webapps/biblivre3/META-INF/context.xml
Ao acessar o arquivo, substitua o IP informado para o IP ou o DNS do servidor,
colocando o contedo de forma parecida com o texto abaixo. Aps a alterao, reinicie
o Tomcat:

<?xml version="1.0" encoding="UTF-8"?>

<Context displayName="Biblivre 3" path="/biblivre3">
<Resource auth="Container"
driverClassName="org.postgresql.Driver"
logAbandoned="false"
maxActive="20"
maxIdle="10"
maxWait="-1"
removeAbandoned="true"
removeAbandonedTimeout="60"
type="javax.sql.DataSource"
name="jdbc/biblivre3"
username="biblivre"
password="abracadabra"
url="jdbc:postgresql://192.168.12.9:5432/biblivre3"/>
</Context>
8.2 Localize o arquivo biblivre.xml e verifique se o endereo IP est igual ao que
colocou no arquivo context.xml.
sudo vi /opt/apache-tomcat-6.0.35/webapps/biblivre3/.../biblivre.xml
Localize o IP no campo url="jdbc:postgresql. do arquivo biblivre.xml e mude para o IP
correto.
8.3 - Acesse ao Postgres e localize o arquivo pg_hba.conf para fazer algumas
alteraes.
sudo vi /var/.../pg_hba.conf
Neste arquivo, feita a liberao da rede que ficar conectada ao Biblivre 3. Se por
exemplo, o endereo da rede 10.1.0.0, insira a seguinte linha:
host all all 10.1.0.0/16 md5

Caso queria limitar por usurio e por banco, insira a seguinte linha, por exemplo:
host biblivre3 biblivre 10.1.0.0/16 md5
8.4 Por ltimo, acesse ao arquivo postgresql.conf para liberar as conexes para a
porta padro do postgres.
sudo vi /var/.../ postgresql.conf
Acessando ao arquivo, descomente a linha port = 5432 e insira a seguinte linha:
listen_addresses = '*'
8.5 Concluindo os processos acima, reinicie o Postgres e acesse ao Biblivre 3,
acessando pelo browser do servidor, por exemplo: http://servidor:8080/biblivre3
9 Backup Dirio do Banco de Dados do Biblivre 3
Para facilitar a vida do usurio Biblivre 3 em ambiente Linux, o colaborador Alessander
Alves Novaes, disponibilizou um script para que o Postgres faa um backup dirio dos
dados do Biblivre 3 com sobreposio a cada semana:
#!/bin/bash
# Script automatizado de backup do Biblivre3 em Linux
# Autor: Alessander Alves Novaes
# Data de criacao: 12/03/2012
# Declaracao das variaveis
DATA=`/bin/date +%a%d%m%Y` # Variavel para armazenar a data atual do sistema
em formato utilizavel para o nome do backup
DATA2=`/bin/date +%a` # Variavel para armazenar a data atual do sistema em formato
reduzido para remoo do ltimo backup
# Removendo o backup da semana anterior
rm -Rf $DATA2*
# Gerando DUMP
pg_dump biblivre3 > biblivre3.sql
# Compactando o Dump e renomeando para formato universal
tar zcvf $DATA.tar.gz biblivre3.sql

# Excluindo o Dump
rm -Rf biblivre3.sql
Para funcionar, inserir o contedo no crontab do usurio postgres para execuo diria.
http://www.biblivre.org.br/forum