Mudanças entre as edições de "Guia de Instalação"

Edição atual tal como às 12h52min de 7 de maio de 2015

Instalando o VuFInd

Este guia foi desenvolvido para usuários do sistema operacional LINUX, distribuição UBUNTU

Instalação utilizando pacote de distribuição

A forma mais fácil de instalar o VuFind é por meio de pacote de distribuição, que faz a instalação automatizada. Entretanto, o VuFind não possui uma distribuição padrão, assim, requerendo baixá-lo antes de instalar. Caso prefira uma instalação de forma controlada, veja a seção seguinte.

Obtendo o pacote

Primeiramente é preciso baixar o pacote de distribuição para instalar via apt-get. Para tanto, utilize o comando abaixo:

wget http://downloads.sourceforge.net/vufind/vufind_2.4.deb?use_mirror=osdn -O vufind_2.4.deb

Depois será preciso manipular o pacote de distribuição de forma a permitir a instalação por meio do comando apt-get

sudo dpkg -i vufind_2.4.deb
Caso todas as dependências necessárias à instalação do VuFind não estejam instaladas, o comando dpkg falhará e uma mensagem de erro será emitida. Deve-se, então, atender as depedências, para que a instalação do VuFind se dê de forma correta. 

Instalando o Pacote de distribuição

A instalação de pacote de distribuição dá-se por meio do comando apt-get, sendo feito com o privilégio de superusuário.

sudo apt-get install -f

Importante:

1. Caso precise instalar o banco de dados MySQL, será solicitado uma senha root durante a instalação. Assim, tenha certeza de informar a senha correta para que o VuFind acesse corretamente o banco de dados posteriormente. 
2. Caso deseje integrar acervos gerenciados pelo sistema Voyager será preciso intalar o PHP OCI Driver para Oracle. Procure instruções específicas para esse proceidmento. 
3. Caso precise acessar banco de dados Sybase (por exemplo o Horizon LMS) é preciso instalar o php5-sybase package por meio do apt-get.

Caso precise remover o pacote de distribuição, pode-se fazê-lo por meio do comando dpkg abaixo:

sudo dpkg -P vufind2  
O parâmetro -P é de purge e removerá os arquivos de configuração e os execuáveis. Se preferir pode usar o -r que apenas revome, sendo parâmetro de maior cautela. ( 

Depois que tudo estiver configurado, você deve ter uma cópia de trabalho do Vufind 2 em /usr/local/vufind2.

Pode-se reiniciar o sistema, para assegurar que as novas definições estão corretamente no lugar, ou pelo menos fazer ajustes nas variáveis de ambiente, executando:

source /etc/profile
Com a instalação completa, inicia-se o processo de configuração e operação do VuFind. 

Instalação passo a passo

Nesta seção é apresentada a forma de instalação passo a passo, em que se controla melhor o processo, na medida em que se executa todos os processo de instalação.

instalando infraestrutura

Para que o VuFind opere normalmente requer algumas ferramentas que apoiem o seu funcionamento. Por ser um sistema informatizado, requer que seja instalado a linguagem de programação utilizada no desenvolvimento. Parte do VuFind é desenvolvido em PHP e outra em Java. Por isso requer as duas linguagens. O banco de dados utilizado é o MySQL e utiliza o apache como servidor de aplicação.

Instalando o Apache

Em muitas instalações o Apache já vem instalado, que pode ser testado utilizando um browser, colocando o ip do servidor, pois geralmente o Apche utiliza a porta padrão 80. Para instalar o Apache, dê o comando abaixo como superusuário:

sudo apt-get -y install apache2

para facilitar o acesso requerido pelo VuFind:

sudo a2enmod rewrite

Para recarregar as configurações:

sudo /etc/init.d/apache2 force-reload

Importante:

Caso sua instância do VuFind utilize registro com traços em seus identificadores, será necessário adicionar "AllowEncodedSlashes on” na configuração apropriada do Apache, na seção <VirtualHost>

Instalando o MySQL

O VuFind usa o banco de dados MySQL para armazenar informações como os comentários de usuários, tags, entre outros. Pode-se instalar o MySQL pelo método de pacote, que facilita o processo. Para tanto, basta executar o seguinte comando como superusuário:

sudo apt-get -y install mysql-server

Recomenda-se fortemente instalar uma ferramenta de apoio que ajude no gerenciamento do banco, como o PHPMyAdmim. Para instalá-lo, basta executar o seguinte comando, também como superusuário:

sudo apt-get install phpmyadmin

Instalando o PHP

Grande parte do VuFind foi desenvolvida com o PHP e requer as bibliotecas dessa linguagem de programação. Para instalar basta executar o comando como superusuário:

sudo apt-get -y install php5 php5-dev php-pear php5-json php5-ldap php5-mcrypt php5-mysql php5-xsl php5-intl php5-gd

Essa é a instalação padrão para o VuFind, sendo que se não utilizar o sistema de identificação LDAP, pode-se excluir o php5-ldap da lista, por exemplo.

Instalando o Java JDK

A busca do VuFind é desenvolvida em Java, por isso requer a instalação do JDK (Java Development Kit). Para instala-lo, basta executar o comando como superusuário.

sudo apt-get -y install sun-java6-jdk

instalando o VuFind

Com o ambiente operacional pronto, segue-se a instalação do VuFind. Para tanto, basta baixar, instalar e configurar, de forma a ter um portal de busca e entrega pronto para coletar e ofertar serviços de recuperação.

Baixando o VuFInd

O VuFind pode ser baixado em vários formatos, entretanto, esse guia é feito para linux. Assim, a opção aqui é pelo empacotamenteo .tar.gz. Caso esteja em outro sistema operacional ou prefira outra foram, vá até o site do VuFind e escolha a outra forma de distribuição. para baixar e descompactar o VuFind, siga os comandos abaixo:

d /[diretório que deseja  baixar o VuFind]
wget http://downloads.sourceforge.net/vufind/vufind-2.4.tar.gz?use_mirror=osdn -O vufind-2.4.tar.gz
tar xzvf vufind-2.4.tar.gz
sudo mv vufind-2.4 /usr/local/vufind2

Instalando o VuFind

O VuFind é instalado por meio de um script, com configuração básica, podendo ser alterado posteriormente. Assim, execute o script, instale com as configurações padrão e depois ajuste as configurações desejadas:

cd /usr/local/vufind2
php install.php

Será preciso alterar as permissões para que o Apache consiga gravar as configurações e na área de cache. Dê os seguintes comandos para alterar as permissões:

sudo chown -R www-data:www-data /usr/local/vufind2/local/cache
sudo chown -R www-data:www-data /usr/local/vufind2/local/config

Para possibilitar a utilização das ferramentas de linha de comando, será preciso separar as áreas e cache com os seguintes comandos:

mkdir /usr/local/vufind2/local/cache/cli
sudo chmod 777 /usr/local/vufind2/local/cache/cli

Colocando o VuFind no Apache

O Apache requer algumas definições extras para que o VuFind opere corretamente. Para Apache 2.2 ou mais novos, execute os comandos:

sudo ln -s /usr/local/vufind2/local/httpd-vufind.conf /etc/apache2/conf.d/vufind2
Apache 2.4 (Ubuntu 13.10 or later):

sudo ln -s /usr/local/vufind2/local/httpd-vufind.conf /etc/apache2/conf-enabled/vufind2.conf

Para refletir as modificações, reinicie o Apache, com o comando:

sudo /etc/init.d/apache2 reload

Configurando as variáveis de ambiente

As variáveis de ambiente podem ser configuradas por meio de um script. Caso planeje executar o VuFind sob um usuário específico, deve-se definir essas variáveis só para esse usuário. Se quiser fazer as configurações global para todas as contas (o mais fácil, mas não necessariamente a melhor abordagem), basta executar este código para adicionar as linhas necessárias para um novo arquivo /etc/profile.d:

sudo sh -c 'echo export JAVA_HOME=\"/usr/lib/jvm/default-java\" > /etc/profile.d/vufind.sh'
sudo sh -c 'echo export VUFIND_HOME=\"/usr/local/vufind2\"  >> /etc/profile.d/vufind.sh'
sudo sh -c 'echo export VUFIND_LOCAL_DIR=\"/usr/local/vufind2/local\"  >> /etc/profile.d/vufind.sh'
Note: If you are using the Sun JVM instead of the default JVM, you may need to specify a different JAVA_HOME path, like /usr/lib/jvm/java-x-sun.

Após criar o arquivo, deve-se carregar manualmente as mudanças, para que façam efeitos. Execute o comando abaixo:

source /etc/profile.d/vufind.sh