Exibir código-fonte para Instalação e Configuração

=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)<sup>1</sup>

<sup>1</sup> O scheduled report runner está  com problema no Ubuntu 14.04 e não irá funcionar corretamente. Consulte [http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=14774 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  <tt>/etc/koha/koha-sites.conf</tt> 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 <tt>/etc/mysql/koha-common.cnf</tt>
* criar um novo arquivo em seu lugar contendo as informações de conexão do servidor, sob a forma de um arquivo <tt>my.cnf</tt>.
* leia as páginas do  man <tt>koha-create</tt>, preste atenção a informação sobre <tt>--request-db</tt> e <tt>--populate-db</tt>.

===Acessar a interface web===

Você precisa ter sua configuração de DNS para isso. Os nomes de host padrão são:

* ''libraryname''.''domain'' para a interface pública
* ''libraryname''-intra.''domain'' para a interface dos funcionários
Omde:
* ''libraryname'' é nome fornecido para koha-create
* ''domain'' é o valor do ''DOMAIN'' que você definiu no <tt>/etc/koha/koha-sites.conf</tt>

Se você quiser mudar os datalhes do hostname  da  instância, você pode editar o arquivo <tt>/etc/apache2/sites-enabled/''libraryname''.conf</tt>

Abra o navegador, e aponte para sua interface de funcionários, indo para <tt>http://''libraryname''-intra.''domain''</tt>, ou o que você configurou manualmente.

Quando você ver a tela de login do Koha, o nome de usuário e senha estão armazenadas no arquivo ''koha-conf.xml'' para a instância. Você pode visualizá-los executando o comando a seguir:

 $ sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/libraryname/koha-conf.xml
 koha_libraryname
 $ sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/libraryname/koha-conf.xml
 randompasswordtext


==Configurações adicionais==

===E-mail===
Para que o Koha consiga enviar e-mails é necessário ter o serviço de e-mail configurado no servidor, escolhemos o serviço Postfix, as instruções de instalação e configuração será descrito abaixo:


==== Instalação do pacote de servidor de e-mail Postfix==== 

Abra o terminal e aplique o seguinte comando:

 $ sudo apt-get install postfix

[[Arquivo:Install postfix.png|900px||center|]]

Selecione "Sem configuração" na tela de instalação.

[[Arquivo:Install postfix1.png|900px||center|]]


Por padrão, o e-mail está desativado. Isso é para que você deixe tudo configurado antes de arriscar de enviar avisos indesejados para as pessoas. Para ativar o e-mail, execute o comando abaixo:

 $ sudo koha-email-enable libraryname

===Traduções===

As traduções podem ser instaladas, executando o comando abaixo:

 $ sudo koha-translate --install language-code

Para ver toda a lista de códigos de idioma disponíveis:

 $ sudo koha-translate --list --available