Tutorial de Instalação do Biblivre 3 em ambiente Linux
(Distribuições Ubuntu, Debian, Fedora, CentOS e Slackware)
1 – Introdução
Este tutorial objetiva atender aos usuários que querem utilizar o sistema Biblivre 3 em
ambiente Linux nas distribuições Ubuntu/Debian(Via gráfico e terminal) e para as
distribuições Fedora/CentOS/Slackware(Via terminal).
Este tutorial foi desenvolvido graças a colaboração usuários entusiastas do sistema
Biblivre e desenvolvedores que acreditam nos benefícios do uso de software livre como
fonte de conhecimento. Nossos agradecimentos são para:
• Andréia de Oliveira Costa Gaspar (Andréia 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
tópicos do Fórum;
• Hermes Pereira Júnior – Especialista em Linux da UFV (Viçosa-MG) - colaborou
orientando na ordem correta de instalação dos pacotes de apoio ao sistema;
• Ana Paula Vieira e Victor Laurie – colaboraram testando online todo o processo de
instalação do aplicativo em outros ambientes Linux;
2 – Instalação JAVA
2.1 – Acesse ao Gerenciador de Pacotes Synaptic;
2.2 - Faça a busca pelo pacote Java;
2.3 – Verifique se os principais pacotes Java 6 estão 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
conclusão da instalação:
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 - Após o processo, será visualizada a seguinte tela para configuração em formato
gráfico. Tecle na tecla TAB para marcar o comando <OK> e tecle ENTER.
2.6 - Para aceitar os termos de instalação, selecione a opção <Sim> com o TAB e
confirme com a tecla ENTER. Após a confirmação, aguarde a finalização do processo
de instalação.
3 – Postgres 9.0
3.1 – Para instalar o PostgreSQL 9 através do Synaptic, acesse ao aplicativo e insira a
sua senha para confirmar a ativação do mesmo.
3.2 – Digite na opção de busca a descrição PostgreSQL 9.
3.3 – Caso o pacote não esteja instalado, marque-o no lado esquerdo dos pacotes e
confirme a instalação.
3.4 - Caso queira instalar através 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 instalação, se foi instalado com sucesso, o Postgresql será ativado
automaticamente.
3.6 – Depois da instalação, confira a versão colocada com o seguinte comando
psql -V
3.7 - Verifique se o usuário 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 próximo passo é mudar para o usuário postgres e setar uma senha PostgreSQL.
Para isto basta trocar para o usuário postgres com o comando su postgres, digitar psql
para entrar no console do PostgreSQL e rodar o comando alter user postgres with
password ‘abracadabra’. Após sair do console e, selecionar exit para sair do usuário
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 conteúdo, 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 usuário 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 instalação, digite o comando pgadmin3 no terminal ou acesse
através do menu gráfico do ambiente de trabalho do Ubuntu, que verá o pgadmin3
instalado, concluindo o processo de instalação do PostgreSQL.
4 – Tomcat 6.0
4.1 – Acesse ao Gerenciador de pacotes Synaptic;
4.2 - Faça a busca do aplicativo Tomcat;
4.3 - Verifique se a versão 6 está instalada, senão faça a instalação dela.
4.4 – Mas para fazer a instalação 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 identificação com o este comando:
sudo mv apache-tomcat-6.0.35 tomcat
4.9 - Terminando o processo, acesse o brownser e execute o endereço
http://localhost:8080/.
5 – Apache 2.2
5.1 – Acesse ao Gerenciador de Pacotes Synaptic;
5.2 - Faça a busca pelo Apache2;
5.3 - Verifique se os principais pacotes estão instalados.
5.4 – Caso não se encontrem instalados, marque o Apache2 e faça a instalação.
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 faça o download da
última versão.
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 opção “Abrir com gerenciador de
pacotes”.
6.5 - Será aberta uma nova tela com o conteúdo do arquivo.
6.6 - Efetue a extração dos arquivos.
6.7 – Aguarde o processo de extração 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 distribuição não seja Ubuntu/Debian, faça o mesmo procedimento do
item 6.1. Sendo que, copie o arquivo para uma pasta temporária e de lá, renomeie o
arquivo para biblivre3.7zip. Acesse ao terminal e descompacte-o dentro da pasta
temporária, e guarde somente os arquivos biblivre3.war, createdatabase.sql e o
biblivre3.sql, excluindo os outros arquivos da pasta.
7 – Posição 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 – Faça um deploy (reinicie o Tomcat) para extrair o arquivo biblivre3.war, e em
seguida, acesse a pasta webapps e verifique se o arquivo foi extraído 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 usuário 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
Observação: Caso tenha mais experiência 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 conteúdo do mesmo no banco criado em branco no Postgres.
psql –e biblivre3 < biblivre3.sql
8 – Configurações
8.1 – Para o funcionamento pleno do Biblivre3, é imprescindível verificar os arquivos
de configurações dos aplicativos associados. Antes de usar o sistema, verifique
primeiramente o conteúdo 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 conteúdo de forma parecida com o texto abaixo. Após a alteração, 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 endereço 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
alterações.
sudo vi /var/.../pg_hba.conf
Neste arquivo, é feita a liberação da rede que ficará conectada ao Biblivre 3. Se por
exemplo, o endereço da rede é 10.1.0.0, insira a seguinte linha:
host all all 10.1.0.0/16 md5
Caso queria limitar por usuário 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 conexões para a
porta padrão 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 Diário do Banco de Dados do Biblivre 3
Para facilitar a vida do usuário Biblivre 3 em ambiente Linux, o colaborador Alessander
Alves Novaes, disponibilizou um script para que o Postgres faça um backup diário dos
dados do Biblivre 3 com sobreposição 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 remoção 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 conteúdo no crontab do usuário postgres para execução diária.
http://www.biblivre.org.br/forum