Edição das 12h58min de 30 de março de 2016

Instalação no Debian

Os pacotes Debian são os preferidos, e mais fácil, maneira de instalar Koha em sistemas operacionais baseados em Debian, incluindo o Ubuntu e Mint.

Versões do sistema operacional que trabalham corretamente:

• Debian 7 (Wheezy)
• Debian 8 (Jessie)
• Ubuntu 14.04 (Trusty Tahr)¹

¹ O scheduled report runner está com problema no Ubuntu 14.04 e não irá funcionar corretamente. Consulte bug 1477 para mais informações.

Processo de instalação

Comandos que estão em uma caixa e começam com '$'

$ Como este

destinam-se a ser executado na linha do terminal de comando no seu servidor (mas não incluem o '$'.)

Configurar fontes de pacotes

Adicione a chave GPG para o seu sistema para que você saiba que os pacotes não foram adulterados com:

$ wget -q -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

Escolha qual a versão do Koha que você deseja instalar:

• oldstable (3.20) resulta em uma versão anterior da atual versão estável
• stable (3.22) é a atual versão estável
• unstable (master) segue o desenvolvimento atual, está destinado somente a desenvolvedores e testadores

Se você escolher oldstable:

$ echo 'deb http://debian.koha-community.org/koha oldstable main' | sudo tee /etc/apt/sources.list.d/koha.list

Se você escolher stable:

$ echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list

Atualizar a lista de pacotes:

$ sudo apt-get update

Instale o Koha

$ sudo apt-get install koha-common

Além: um problema comum no Ubuntu acontece aqui

Se você ver isto:

Errors were encountered while processing:
 libapache2-mpm-itk
 apache2-mpm-itk
 koha-common

Então faça isso:

$ sudo a2dismod mpm_event
$ sudo apt-get install -f

E tudo vai se arrumar.

Instalar o Banco de Dados

Se você está planejando executar o MySQL no mesmo servidor que Koha, execute o comando:

$ sudo apt-get install mysql-server

Configurar os padrões

Edite o arquivo /etc/koha/koha-sites.conf e ajuste de acordo com a configuração que você deseja. Defina o valor DOMAIN para o domínio que você deseja acessar o koha. Preste atenção também para o INTRASUFFIX como suas entradas de DNS também irá exigir isso.

Configuração do Apache

$ sudo a2enmod rewrite
$ sudo a2enmod cgi
$ sudo service apache2 restart

Criar uma instância do Koha

Só faça isso se você estiver executando o MySQL localmente.

Substitua libraryname com o nome de sua biblioteca:

$ sudo koha-create --create-db libraryname

Se você estiver executando o MySQL em outro servidor:

• remova /etc/mysql/koha-common.cnf
• criar um novo arquivo em seu lugar contendo as informações de conexão do servidor, sob a forma de um arquivo my.cnf.
• leia as páginas do man koha-create, preste atenção a informação sobre --request-db e --populate-db.