MANUAL DE INSTALACIN DE KOHA EN BEDIAN

1. Requerimientos para la instalacin de Koha

Para instalar Koha para su uso inmediato se recomienda:
Un servidor Linux - Debian es lo que utilizan la mayora de las personas

apache
MySQL
Perl
acceso root al servidor
Un superior al nivel medio de la habilidad con la lnea de comandos, Apache, MySQL y
herramientas

Koha es un software gratuito y est disponible bajo la Licencia Pblica General de GNU, ya sea la
versin 3 de la Licencia, o (a su eleccin) cualquier versin posterior

2. Obtener Koha
A menudo hay dos o tres versiones de Koha siendo liberados aqu durante el mismo perodo de
tiempo. Ver el calendario de lanzamientos para ms informacin.
Instalacin - Versin actual
Instalacin de Paquetes (Debian / Ubuntu)
Activamente apoyado por paquetes: Debian 7 (Wheezy), Debian 8 (Jessie), Ubuntu 14.04
(TRUSTY Thar)
Los paquetes son los preferidos cuando sea posible, pero si desea ejecutar Koha en otra cosa:
La versin estable actual (.tar.gz)
Las versiones ms antiguas, incluidas las versiones estables y mantenimiento anteriores
Lista de todas las versiones publicadas de Koha
3. Los paquetes de debian para koha
Los paquetes Debian son los preferidos, y ms fcil, manera de instalar Koha en sistemas operativos
basados en Debian, incluyendo Ubuntu y Mint.
versiones del sistema operativo se conoce que funcionan:
Debian 7 (Wheezy)
Debian 8 (Jessie)
Ubuntu 14.04 (TRUSTY Thar) 1
1

el corredor informe programado se rompe en Ubuntu 14.04 y no funcionar correctamente. Consulte

el error 14774 para ms informacin.

1.1Proceso de instalacin
Los comandos que se encuentran en una caja y se inician con '$'
$ like this

estn destinadas a ejecutarse en la lnea de comandos del servidor (pero no incluyen el '$').
1.1.1 Configuracin de los orgenes de los paquetes
Aada la clave GPG para su sistema para que sepa que los paquetes no se han manipulado:
$ wget -q -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

Elegir qu versin de Koha que desee:

antigua estable (3.22) sigue una liberacin detrs de la actual versin estable
estable (16.05) es la versin estable actual
inestable (maestro) sigue el desarrollo actual, esto est destinado a desarrolladores y probadores
solamente
Si ha elegido antigua estable:
$ echo 'deb http://debian.koha-community.org/koha oldstable main' | sudo tee
/etc/apt/sources.list.d/koha.list

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

Actualizar la lista de paquetes:

$ sudo apt-get update

1.1.2 Instalar Koha

$ sudo apt-get install koha-common

1.1.2.1 Aparte: un problema comn en Ubuntu sucede aqu

Aparte: un problema comn en Ubuntu sucede aqu
Si ve esto:
Errors were encountered while processing:
libapache2-mpm-itk
apache2-mpm-itk
koha-common

A continuacin, haga lo siguiente:

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

Y todo va a fijar a s mismo.

1.1.3 Instalacin de la Base de Datos
Si usted est planeando para ejecutar MySQL en el mismo servidor que est en Koha, a continuacin,
ejecute:
$ sudo apt-get install mysql-server

1.1.4 Configurar los valores predeterminados

Editar el archivo /etc/koha/koha-sites.conf y ajustarlo a la configuracin que desea.
Establecer el valor de dominio para el dominio que desea acceder a este Koha partir. Tambin presta
atencin a la INTRASUFFIX como sus entradas DNS tambin requerirn esto.
Las instrucciones para configurar un dominio para Koha se pueden encontrar en la pgina Cmo
configurar un nombre de dominio para Koha .
1.1.5 Puesta en funcionamiento de Apache
$ sudo a2enmod rewrite
$ sudo a2enmod cgi
$ sudo service apache2 restart

1.1.6 Crear una instancia de Koha

Slo haga esto si est ejecutando MySQL local.
Reemplazar libraryname con el nombre de la biblioteca:
$ sudo koha-create --create-db libraryname

Si est ejecutando en otro servidor MySQL:

eliminar /etc/mysql/koha-common.cnf
crear un nuevo archivo en el lugar que contiene la informacin de conexin para el servidor, en
forma de un archivo my.cnf.
leer las pginas del manual para koha-crear, prestar atencin a la informacin sobre
--request-db y --populate-db.
1.1.7 Acceso a la interfaz web
Tendr que haber establecido su DNS para esto. Los nombres de host por defecto son:
libraryname. de dominio para la interfaz pblica
libraryname-intra . de dominio para la interfaz del personal
dnde:

 libraryname es el nombre proporcionado a koha-crear

dominio es el valor de dominio que se establece en /etc/koha/koha-sites.conf
Si desea cambiar los detalles de nombre de host de la instancia, puede editar / etc / apache2 /
sites-enabled / conf libraryname
Abra un navegador web, y el punto a su interfaz de personal, por ir a http: // dominio
libraryname -intra, o lo que sea que haya configurado manualmente..
Cuando vea el inicio de sesin para el programa de instalacin de Koha, el nombre de usuario y la
contrasea estn en el archivo koha-conf.xml para la instancia. Puede verlas:

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

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

1.2 Configuracin adicional

1.2.1 E-mail
De manera predeterminada, el correo electrnico se apaga. Esto es para que pueda obtener todo listo
antes de arriesgar transmisin de los anuncios no deseados a la gente. Para activar el correo electrnico
en:
$ sudo koha-email-enable libraryname

1.2.2 Traducciones
Las traducciones se pueden instalar:
$ sudo koha-translate --install language-code

Para ver todos los cdigos de idioma:

$ sudo koha-translate --list --available

1.2.3 Otros comandos

Hay una lista de los comandos proporcionados por los paquetes de Debian . Todos los comandos
comienzan con koha-, y se han instalado las pginas de manual, por ejemplo:
$ man koha-create

1.2.4 Servicios

Koha instala un servicio en /etc/init.d/koha-common. Esto asegura que el demonio Zebra y,

si est configurado, demonio SIP se estn ejecutando. Se puede utilizar el inicio, detener y
reiniciar los comandos de control de stos.
1.3 Koha Information Packaging
1.3.1 Poltica de estreno
El paquete estable tiene una nueva versin cada vez que el mantenedor de lanzamiento para la versin
estable actual crea una nueva versin. Tan pronto como una nueva versin principal es liberado, este se
actualizar con l tambin (en un par de das lo ideal, de todos modos.)
El paquete antigua estable tiene una nueva versin cada vez que el mantenedor de liberacin crea una
nueva versin. Si hay una nueva versin de la versin importante es liberado en estable, esto va a subir
a la siguiente versin principal que est detrs estable. Esto significa que obtendr una nueva versin
principal slo despus de que ha estado fuera durante varios meses y se han encontrado con suerte
todos los errores.
El paquete inestable se libera cuando:
el mantenedor del paquete recuerda hacerlo (cada par de semanas, por lo general. Ms veces.)
la rama maestra actual es capaz de ser construido sin errores.
1.3.2 Cmo crear koha-configura su sistema
Cuando se crea una instancia con koha-crear, algunas cosas suceden. Por el bien de ejemplo, esto
supone que la instancia que ha creado se llama biblioteca.
Se crea un usuario del sistema, llamado biblioteca de Koha. Todo lo que se puede hacer
con esta instancia se ejecutarn como este usuario.
(Si tiene un local MySQL) se crea un nuevo usuario de MySQL llamada koha_library
(Si tiene un local MySQL) una nueva base de datos MySQL se crea llamada koha_library
/ var / lib / koha / biblioteca se crea y se rellena con una estructura de
directorios por defecto.
El directorio de sitios Koha (/ etc / koha / sitios / biblioteca) se crea y se
rellena. En particular, se genera una koha-conf.xml y puso en su lugar con las contraseas
que se han generado al azar para la base de datos y la cebra.
Un archivo de configuracin de Apache se pone en /etc/apache2/sitesavailable/library.conf. Apache se reinicie para que los cambios surtan efecto.
Se inicia un demonio de cebra para esta instancia, se ejecuta como el usuario del sistema de
biblioteca de Koha.
1.3.3 Emisiones de embalaje
Hay un poco de una mente-volcado de informacin sobre la construccin de paquetes de Debian para
su liberacin. Si desea mantener sus propios paquetes, tambin echar un vistazo a Construyendo

paquetes de Debian - la manera fcil .

Cmo configurar un nombre de dominio para

Koha
Configurar un dominio Koha y configurar los valores por
defecto
Usted puede acceder a la instalacin de Koha usando una direccin IP, o el uso de un dominio. Este
ltimo es casi siempre preferible y es la situacin tratado aqu. Utilizando el mtodo de nombre de
dominio significa que o bien debe informar lo que el nombre de dominio de su servidor de Koha es,
probablemente, el administrador de red, o debe crear y configurar uno para l.
Creacin y configuracin de un dominio se puede hacer en una de dos maneras:
DNS
El archivo / etc / hosts
Si usted est en una gran red habr muy a menudo ser un servidor DNS en esa red que asigna los
nombres de dominio de familiares a las direcciones IP. Si es el administrador del servidor DNS, usted
sabr cmo hacer esto y ser capaz de asignar un nombre de dominio a su servidor de Koha. Si no
administrar el servidor DNS entonces usted necesita hablar con el administrador que lo hace, y pedirles
que asignar un nombre de dominio, o decirle lo que es si ya existe una. Cuando se le da el nombre de
dominio, puede configurar Koha usarlo, siguiendo las instrucciones de abajo. Recuerde que los
cambios en los servidores DNS pueden tardar hasta 24 horas en aplicarse.
En redes muy pequeas hay otra posibilidad que consiste en el uso de archivos del servidor de Koha /
etc / hosts (y el mismo archivo en cualquier otro equipo de la red que se necesita para acceder a
Koha). Puede utilizar este mtodo si est seguro de que la red no tiene su propio servidor DNS y, como
siempre que se sepa que el nombre de dominio que elige no entrar en conflicto con uno especificado
para cualquier otro equipo de la red. Este mtodo es adecuado, por lo tanto, para las instalaciones de
prueba y para las instalaciones en redes muy pequeas. No es un mtodo apropiado para los servidores
de Koha los que se accede desde Internet.
El proceso de instalacin de Koha crea dos subdominios Apache, el primero de los cuales se les dar el
mismo nombre que el nombre de la biblioteca se especifica cuando se emite el comando koha-crear

ms adelante. El segundo sub-dominio se le dar el mismo nombre que la biblioteca, pero seguido de
un sufijo arbitraria: -intra por defecto. As que decidir ahora lo que va a llamar a su biblioteca, si no
lo ha hecho ya.
Si se llama a su libraryname biblioteca y si su dominio era peredur.cym, seran llamados los dos
subdominios:
libraryname.peredur.cym
y:
libraryname-intra.peredur.cym
Las siguientes instrucciones se refieren a usar / etc / hosts para el dominio y asumen que va a
utilizar el dominio peredur.cym. Puede omitir esto y seguir recto hasta la edicin del archivo kohasites.config si el servidor de Koha se ha asignado un dominio utilizando DNS.
Puede llamar al dominio de cualquier cosa que desee, siempre y cuando no entre en conflicto con otro
elemento de la red local. Vamos a seguir utilizando peredur.cym en los ejemplos que siguen.

Edicin / etc / hosts

Antes de editar el archivo / etc / hosts que necesita saber la direccin IP de su servidor de Koha.
El servidor de Koha, como cualquier equipo de la red, tiene una direccin IP. Si usted no sabe lo que es,
usted lo puede encontrar emitiendo el siguiente comando en un terminal:
$ Espectculo ip addr

Dependiendo de si est conectado a la red mediante una conexin por cable o una conexin
inalmbrica, lo normal es ver la direccin IP en contra de cualquiera eth0 o wlan0 en la salida. Ser
una direccin IP en notacin de puntos, por lo general se parecen mucho a 192.168.xx donde x
representa un nmero. As, por ejemplo, podra ser 192.168.1.136. Este es el resultado del
comando show ip addr en mi porttil:
1: Mn: <LOOPBACK, UP, LOWER_UP> MTU 65536 qdisc grupo desconocido estado
predeterminado noqueue qlen 1
enlace / bucle invertido 00: 00: 00: 00: 00: 00 d a 00: 00: 00: 00: 00: 00
inet 127.0.0.1/8 alcance lo anfitrin
valid_lft para siempre para siempre preferred_lft
2: eth0: <sin vehculo, difusin, multidifusin, UP> MTU 1500 qdisc pfifo_fast
predeterminada del grupo de estado Abajo qlen 1000
enlace / D0 ter: BF: 9c: 86: 10: 09 d a FF: FF: FF: FF: FF: FF
3: wlan0: <difusin, multidifusin, UP, LOWER_UP> MTU 1500 qdisc pfifo_fast estado
Arriba predeterminado grupo qlen 1000
enlace / ter 38: b1: db: F9: 6d: 75 d a FF: FF: FF: FF: FF: FF
inet 192.168.1.98/24 d amplio alcance 192.168.1.255 wlan0 dinmica mundial

valid_lft 170987sec preferred_lft 170987sec

inet6 fe80 :: 3ab1: DBFF: fef9: enlace 6d75 / 64 alcance
valid_lft para siempre para siempre preferred_lft

La direccin IP del ordenador porttil se da contra wlan0 y es 192.168.1.98.

Ahora usted tiene la direccin IP que necesita, puede configurar el archivo / etc / hosts. Haga
lo siguiente, ya sea como root o por medio de sudo. Asumo que usted puede usar sudo en las
siguientes instrucciones y que tiene el editor de texto gedit instalado. Si usted no tiene gedit entonces o
bien instalarlo o sustituir el nombre de su editor de texto favorito para gedit en las instrucciones de
abajo. Si usted no es un sudoer, entonces usted debe o bien haces uno, como root, o ejecutar el
editor de texto como root.
En una ventana de terminal, en el indicador, escriba:
$ Sudo gedit / etc / hosts

El texto en el archivo / etc / hosts se ver algo como lo siguiente si usted est en un defecto instalacin
de:
127.0.0.1 localhost
127.0.1.1 nombre-de-su-servidor
# Las siguientes lneas son recomendables en equipos que pueden IPv6
:: 1 localhost ip6-ip6-bucle de retroceso
FE00 :: 0 ip6-localnet
FF00 :: 0 ip6-mcastprefix
FF02 :: 1-IP6 allnodes
FF02 :: 2-IP6 allrouters

Suponiendo que la direccin IP de su servidor de Koha es 192.168.1.136 y suponiendo que se va a

llamar a su libraryname biblioteca, luego despus de la lnea de localhost, insertar dos nuevas lneas
que dicen:
libraryname.peredur.cym 192.168.1.136
192.168.1.136 libraryname-intra.peredur.cym

Esto asegura que todas las peticiones a los dos subdominios se enviarn al servidor con el
192.168.1.136 direccin IP (el servidor de Koha).
Guarde el archivo / etc / hosts.
NOTA: si utiliza el archivo / etc / hosts para definir su dominio, tendr que hacer entradas
como las que anteriormente en el directorio / etc / hosts archivos de todos los equipos que
necesitan acceder a Koha; no slo el que est en el servidor de Koha. Es por eso que es slo una buena
solucin para redes pequeas!

Edicin koha-sites.conf
En gedit (o su editor de texto favorito) abrir el archivo /etc/koha/koha-sites.conf para su
edicin. Recuerde que debe abrirlo con sudo:
$ Sudo gedit /etc/koha/koha-sites.conf

o como raz.
los valores predeterminados del Koha estn contenidos en este archivo. Es necesario hacer algunas
modificaciones en la seccin de variables de creacin de mquinas virtuales Para hacer que el trabajo
Koha en su red. Por defecto, esta seccin se parece a:
#Apache Variables de creacin de mquinas virtuales
DOMINIO = ". MyDNSname.org"
Expedicin = "80" # 8080 para el uso de una instalacin basada en IP.
INTRAPREFIX = ""
INTRASUFFIX = "- intra"
OPACPORT = "80"
OPACPREFIX = ""
OPACSUFFIX = ""

La nica lnea que es de inters para una instalacin bsica es la lnea DOMINIO. Asumiendo que su
dominio se llama peredur.cym, a continuacin, cambie esta lnea a:
DOMINIO = ". Peredur.cym"

Tenga en cuenta el punto al principio del nombre de dominio.

El INTRASUFFIX define el sufijo utilizado para acceder al sitio personal. Puede ser cualquier cosa que
desee, pero si lo cambia, recuerde que debe cambiar el nombre del subdominio, a travs de DNS o el
archivo / etc / hosts (s), para que coincida.

Modificar el archivo de puertos de apache:

$ Sudo gedit /etc/apache2/ports.conf
________________________________________________________________
# If you just change the port or add more ports here, you will likely also
# have to change the VirtualHost statement in
# /etc/apache2/sites-enabled/000-default.conf

Listen 80
Listen 8080

<IfModule ssl_module>
Listen 443
</IfModule>

<IfModule mod_gnutls.c>
Listen 443
</IfModule>

# vim: syntax=apache ts=4 sw=4 sts=4 sr noet

________________________________________________________________

Configurar el archovi de virtualhost del libraryname:

$ Sudo gedit /etc/apache2/sites-enabled/libraryname.conf
________________________________________________________________
# Koha instance bibcen Apache config.

# OPAC
<VirtualHost 10.44.0.163:80>
<IfVersion >= 2.4>
Define instance "bibcen"
</IfVersion>
Include /etc/koha/apache-shared.conf
#

Include /etc/koha/apache-shared-disable.conf

Include /etc/koha/apache-shared-opac-plack.conf
Include /etc/koha/apache-shared-opac.conf

ServerName bibcen

SetEnv KOHA_CONF "/etc/koha/sites/bibcen/koha-conf.xml"

SetEnv MEMCACHED_SERVERS ""
SetEnv MEMCACHED_NAMESPACE ""
AssignUserID bibcen-koha bibcen-koha

ErrorLog

/var/log/koha/bibcen/opac-error.log

TransferLog /var/log/koha/bibcen/opac-access.log

RewriteLog

/var/log/koha/bibcen/opac-rewrite.log

</VirtualHost>

# Intranet
<VirtualHost 127.0.0.2:80>
<IfVersion >= 2.4>
Define instance "bibcen"
</IfVersion>
Include /etc/koha/apache-shared.conf
#

Include /etc/koha/apache-shared-disable.conf

Include /etc/koha/apache-shared-intranet-plack.conf
Include /etc/koha/apache-shared-intranet.conf

ServerName bibcen-intra
SetEnv KOHA_CONF "/etc/koha/sites/bibcen/koha-conf.xml"
SetEnv MEMCACHED_SERVERS ""
SetEnv MEMCACHED_NAMESPACE ""
AssignUserID bibcen-koha bibcen-koha

ErrorLog

/var/log/koha/bibcen/intranet-error.log

TransferLog /var/log/koha/bibcen/intranet-access.log

RewriteLog

/var/log/koha/bibcen/intranet-rewrite.log

</VirtualHost>
________________________________________________________________