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

Edição das 09h33min de 6 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

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 dpkg -i vufind_2.4.deb
If you do not have all of VuFind's dependencies installed already, dpkg will fail with an error message. You can correct this problem by installing the missing requirements using apt-get:

sudo apt-get install -f

Importante:

If you need to install MySQL, you will be prompted for a root password during installation. For better security, it is a good idea to set this; if you do, be sure you remember it so you can configure    VuFind to access the database later.
If you are a Voyager library, you will also need to install the PHP OCI Driver for Oracle – see this page for detailed instructions.
If you will be accessing a Sybase database (e.g. for the Horizon LMS), you should also install the php5-sybase package using apt-get.
If, for some reason, you need to remove the package, you can issue this command (note that -P is for purge and will remove configuration files as well as executable components; use -r for a more cautious   removal): sudo dpkg -P vufind2
Once everything is set up, you should have a working copy of VuFind 2 in /usr/local/vufind2.

Y ou may want to restart your system one more time to be sure all the new settings are in place, or at least make sure appropriate environment variable settings are loaded by running:

source /etc/profile
Now you can proceed to Configuring and Starting VuFind below to finish setup and get things running!

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