Guia de Instalação
Índice |
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
