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

De IBICT
Ir para: navegação, pesquisa
(Instalando o Pacote de distribuição)
 
(17 edições intermediárias de 2 usuários não apresentadas)
Linha 5: Linha 5:
  
 
=== Instalação utilizando pacote de distribuição ===
 
=== 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 pass ===
 
  
 +
=== 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 ====
 
==== 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 ====
 
==== 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

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

Í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