Instalao do Gnuteca no Linux Mint 17.

1
Na instalao do Gnuteca, necessitaremos instalar a seguinte sequencia
de programas, depois fazer os ajustes necessrios:
1. PostgreSQL
2. Apache
3. PHP5
4. Gnuteca

Instalando o PostgreSQL
Abra o terminal e baixe os pacotes de instalao do PostgreSQL.
$ sudo apt-get install postgresql-9.3

Se for a primeira vez que executa o comando "sudo" nesta seo do

terminal, o Linux ir pedir para voc digitar a sua senha de usurio root. O
Linux ir verificar quais so os pacotes que dever fazer o download. Em
seguida, responda "S" (Sim) para a pergunta "Voc quer continuar? [S/n]" e
pressione ENTER.
A instalao do SGBD (Sistema de Gerenciamento de Banco de Daddos)
est completa. Agora vamos fazer alguns ajustes iniciais no PostgreSQL. A
primeira coisa a fazer alterar a senha do usurio 'postgres'. Este usurio
criado durante a instalao do SGBD e ser usado para fazer as configuraes
do PostgreSQL.
Primeiro altere o usurio atual para "root".
$ sudo su
Digite a senha do "root" se for requerida e em seguida acesse o prompt
do PostgreSQL:
# su postgres -c psql postgres
Perceba que no prompt de comando, o caminho do diretrio antes do
cursor foi substitudo por "postgres=#". Para alterar a senha do usurio
"postgres" digite o comando:
=# alter user postgres with password 'UmaNovaSenha';
O prompt do PostgreSQL dever exibir a mensagem ALTER ROLE. Para
sair do prompt do PostgreSQL e voltar ao do Linux, digite:

1 de 6

=# \q
Para que as alteraes tenham efeito reinicie o PostgreSQL com o
comando:
# /etc/init.d/postgresql restart
# exit
Pronto. O PostgreSQL est instalado e configurado no Linux Mint.

Instalando o Apache
O Apache existe nos repositrios oficiais do Linux, ento:
$ sudo apt-get install apache2

Ao final da instalao aparecer uma mensagem indicando que no foi

possvel determinar um nome de servidor confivel usando 127.0.0.1
significando apenas que no est configurado um nome para o servidor e que
isto pode ser feito e que aps isso a mensagem ser suprimida. No se
incomode. Ela vai aparecer toda vez que reiniciarmos o apache at atendermos
a solicitao que, na verdade, no afeta o funcionamento do sistema para
nosso caso.
Para o Apache, isso.

Instalando o PHP5
Da mesma forma, utilizaremos o recurso do repositrio oficial:
$ sudo apt-get install php5
Aps a instalao, necessrio reiniciar o apache para integrao do

PHP5:
$ sudo /etc/init.d/apache2 restart

Instalando o Gnuteca

Devemos baixar o Gnuteca para instal-lo. Ele no est disponvel nos

repositrios do Linux. Para tanto, acesse o
Portal do Software Pblico
Brasileiro:
http://www.softwarepublico.gov.br/
Ser necessrio um cadastro simples, nome e e-mail; logue no site,
acesse a lista de softwares e escolha a comunidade gnuteca e, na pgina
dela, em "Perguntas Frequentes (FAQs), clique no link "Como fao para
baixar e instalar o Gnuteca?"; na prxima pgina, clique em
2 de 6

Armazenagem de Arquivos e escolha a verso mais recente.

Para o Linux so disponibilizados pacotes DEB, apropriados para
instalao em distribuies Ubuntu. O mantenedor do programa, a empresa
Solis, recomenda a utilizao do Ubuntu 12 como distribuio homologada
(o Linux Mint baseado no Ubuntu 10.04). Baixei a verso 3.2.3 e entrei no
diretrio onde o arquivo foi salvo (pelo Nemo, depois com o boto direito do
mouse cliquei numa rea livre e escolhi abrir em um terminal; instalei-o com
o seguinte comando no terminal (necessrio usurio root):
$ sudo su
# dpkg -i gnuteca_3.2.3.deb
Aqui vemos vrios erros de dependncia no satisfeitas, ento usamos:
# apt-get install -f
Este comando vai buscar as dependncias para satisfazer a instalao do
Gnuteca. No final, temos um erro e algumas dicas:

Informa-se que o plugin para o PHP chamado yaz no foi instalado,

o pacote baixado no vlido para o Mint. Ele necessrio para
realizar consultas bibliogrficas na Web, ento iremos baixar e
instalar manualmente, processo descrito no item 5;

Informa-se que para ativar as novas configuraes do apache,

necessrio usar o comando service apache2 reload, o que
faremos oprtunamente;

Pede-se para criar as bases de dados e d as dicas (faremos isso no

item 6.3)

Pede-se para incluir uma linha no arquivo /etc/rc.local (faremos isso

no item 6.4).

Instalando o Yaz Manualmente

Para instalar o plugin e suas dependncias, usaremos os recursos do

repositrio oficial com os comandos (como usurio root):
# apt-get install yaz
Aps a instalao, vamos habilitar o plugin editando o arquivo php.ini
localizado no diretrio /etc/php5/apache2/ com o comando:
# gedit /etc/php5/apache2/php.ini
Por volta da linha n 844, veremos a seo Dynamic Extensions onde
iremos incluir a linha extension=yaz.so cuidando para no deixar um ponto3 de 6

e-vrgula na frente que, neste arquivo, funciona como sinal comentrio,

desativando tudo o que vier aps ele.
Est feito. Agora podemos recarregar o apache com o comando:
# service apache 2 reload

AJustes finais
6.1

Virtual Host

O pacote deb do Gnuteca j cria um virtual host dentro da pasta

/etc/apache2/sites-available/ por meio do arquivo gnuteca , de forma que
iremos acessar o sistema no navegador Firefox digitando o endereo:
http://gnuteca.localhost
Por isso preciso indicar em seu DNS o seguinte caminho:
[IP Da mquina que tem o Gnuteca INSTALADO]

gnuteca.localhost

Exemplo:
192.168.0.254 gnuteca.localhost
Agora, se for utilizar apenas umas quatro mquinas e no quiser perder
muito tempo lidando com bind ou seu servidor DNS, voc pode ignorar este
passo porque a instalao coloca esse host dentro do PC que vai administrar a
biblioteca, no arquivo /etc/hosts e ativa o site no apache.

6.2

Permisses de Acesso ao postgres

O usurio postgres o usurio administrador do SGBD e necessitar de

acesso ao banco de dados do Gnuteca para a criao da base de dados. Para
tanto, deve-se editar o arquivo pg_hba.conf, localizado no diretrio
/etc/postgresql/9.3/main/, ento:
# gedit /etc/postgresql/9.3/main/pg_hba.conf
Encontre as linhas indicadas abaixo (a partir da linha n 85) e mude as
permisses para trust de forma que o bloco de comandos fique assim:
local all
postgres
trust
# TYPE DATABASE USER
# "local" is for Unix domain socket connections only CIDR-ADDRESS
local all
all
trust
# IPv4 local connections:
host all
all
127.0.0.1/32
trust
# IPv6 local connections:
4 de 6

host all

all

::1/128

trust

Feito isso, salve e feche o arquivo, depois reinicie o PostgreSQL:

# /etc/init.d/postgresql restart

6.3

Criando a Base de Dados, Tabelas, Consultas e etc.

Para criar a base usaremos os seguintes comandos:

# createdb -Upostgres -Elatin1 --locale=POSIX -Ttemplate0
gnuteca3
Criada a base de dados com o comando acima, preciso entrar no modo
pgsql e criar as tabelas, consultas, usurios, etc. Para entrar faa:
# psql -U postgres gnuteca3
Dentro do banco dever criar as tabelas e usurios. Isso feito com os
dois seguintes comandos:
# \i /var/www/miolo25gnuteca/modules/gnuteca3/misc/sql/dump_gnuteca3.sql
# \i /var/www/miolo25gnuteca/modules/gnuteca3/misc/sql/dump_gnuteca3_users.sql

Note que os passos acima indicam o diretrio do Apache onde ficam os

websites. Feito isso, d um comando para sair do modo pgsql:
# \q

6.4

Gnuteca Cron

O Gnuteca possui um agendador prprio que executa automaticamente

determinadas tarefas, o gcron. Este processo fica rodando no servidor e
atualizar as buscas e disparar os agendamentos de uma em uma hora.
Para colocar a GCron em funcionamento necessrio editar o arquivo
/etc/rc.local e inserir a seguinte linha antes da linha exit 0:
php /var/www/miolo25-gnuteca/misc/scripts/gcron.php &
Mais uma vez, reiniciemos o servidor :
# service apache2 restart
Para parar o script quando desejado necessrio matar o processo
com o comando:
$ kill -9 [nmero do pid]
5 de 6

Para saber o pid de um processo (Process ID, identificao do processo),

usa-se o comando:
$ ps aux | grep [nome do programa]
ou seja:
$ ps aux | grep gcron

6.5 Conferir Dependncias

Aps toda esta instalao, o sistema dever estar funcionando;
importante verificar se no ficou algo esquecido. Para isto o Gnuteca tem uma
operao que verifica as principais dependncias; a mesma acessada em
Configurao Sistema Conferir dependncias.

6 de 6