Instalar multiples instancias de koha

WARNING! This page is obsolete. This page is no longer correct and exists for historical reasons only.

• Koha actualmente permite el manejo de instancias de forma nativa mediante comandos.

Introducción

Los usuarios de Koha a menudo tienen que instalar varias instancias Koha en el mismo servidor. Explicaremos un esquema de instalación que lo permite. Se basa en las definiciones VirtualHost de Apache y un esquema de nombres para los directorios. Otros métodos pueden ser explorados, pero éste se ha reportado éxitoso y se utiliza en producción en muchos lugares.

Esta guía funciona en Ubuntu Linux. Si necesita soporte para otros sistemas operativos, puede ser necesario cambiar varios comandos, diferentes distribuciones de Linux hay, cada una tiene sus propios esquemas de configuración.

Prerequisitos

En función del sistema operativo del host debe leer CUIDADOSAMENTE el archivo INSTALL.<OS> proporcionado. Vamos a realizar una install standard. Suponemos que (vamos a utilizar y) que ya ha instalado un servidor MySQL en el servidor local. Vamos a ejecutar los comandos como usuario root en el shell.

También necesitamos tener el usuario koha y los privilegios de grupos definidos previamente en nuestro servidor.

Configuración de Apache

Primero, nos aseguramos de tener lo siguiente en su archivo /etc/apache2/ports.conf y ajustarlo si es necesario:

NameVirtualHost *:80
NameVirtualHost *:8080
Listen 80
Listen 8080

Tambien nos aseguramos de tener disponibles los modulos mod_rewrite y mod_deflate

# a2enmod rewrite
# a2enmod deflate

Esquema de nombres de Instancia

Nuestras instancias de Koha serán nombrados koha_instance (en este ejemplo koha_test). Esta información se utilizará en el proceso de instalación y en los pasos de creación de la base de datos.

Vamos a establecer varias variables de entorno para que podamos copiar y pegar los comandos proporcionados aquí. Ajuste el nombre de la instancia de su Koha y la configuración de la base de datos:

# export KOHAINSTANCE="koha_test"
# export DBHOST="localhost"
# export KOHADBUSER="kohaadmin"
# export KOHADBPASS="katikoan"

Creación de la Base de Datos

Como se indica en el archivo INSTALL primero creamos nuestra instancia de base de datos siguiendo el esquema propuesto.

Koha en una Base de Datos local

# mysql -h $DBHOST -p -e "CREATE DATABASE $KOHAINSTANCE"
# mysql -h $DBHOST -p -e "GRANT ALL PRIVILEGES ON $KOHAINSTANCE.* TO '$KOHADBUSER'@'localhost' IDENTIFIED BY '$KOHADBPASS'"
# mysql -h $DBHOST -p -e "FLUSH PRIVILEGES"

Koha en una Base de Datos remota

Si va a instalar koha utilizando una base de datos remota, es necesario especificar el número de IP del servidor Koha al dar kohaadmin dara a los usuarios los privilegios correctos así que tiene que estar seguro que usted lo conoce. Si se trata de 192.168.0.2'´ entonces podemos usar:

# export MYIPADDRESS=192.168.0.2
# mysql -h $DBHOST -p -e "CREATE DATABASE $KOHAINSTANCE"
# mysql -h $DBHOST -p -e "GRANT ALL PRIVILEGES ON $KOHAINSTANCE.* TO '$KOHADBUSER'@'$MYIPADDRESS' IDENTIFIED BY '$KOHADBPASS'"
# mysql -h $DBHOST -p -e "FLUSH PRIVILEGES"

Instalar Koha siguiendo el esquema

Ahora procedemos con una instalación estándar, utilizando los valores que proporcionamos a los comandos anteriores.

Nota: esto varía dependiendo de la versión que está intentando instalar. Usted debe buscar la última versión estable en la seccion de descargas de Koha. También debe notar que en esta guía elegimos algunas configuraciones por defecto que puede que no sean adecuadas para usted por lo que debe afinar esto para su caso.

Primero descargarmos y extraemos las fuentes, en el lugar apropiado:

# cd /usr/local/src/
# wget http://download.koha-community.org/koha-latest.tar.gz
# tar xvzf koha-latest.tar.gz

entonces configure las fuentes (en función de lo que es la versión actual esto podría ser diferente):

# cd koha-3.02.01
# perl Makefile.PL

A continuación se le pedirá que introduzca sus parametros, proceda de la siguiente manera:

#Installation mode (dev, single, standard) [standard]

ya que queremos una instalación estándar, digite Enter para tener el valor seleccionado por defecto. Entonces usted tiene que entrar en el directorio de instalación, seguimos nuestros esquema para del tipo /usr/share/koha_test y digitamos ENTER

directorio base instalación [/usr/share/koha] /usr/share/koha_test.

En las siguientes indicaciones del promt pulse Enter en cada una.

Cuenta de usuario [koha]
Grupo [koha]
DBMS ha usar (Pg, mysql) [mysql]

En esta pulsar Enter para instalar la base de datos local o escriba la IP del servidor de base de datos utilizado anteriormente.

Servidor de base de datos [localhost]
DMBS [3306] 

Utilice el nombre de la base de datos que hemos creado koha_test y pulse Enter:

Por favor especifique el nombre de la base de datos ha ser usada por Koha [koha] koha_test

A continuación, utilizar las credenciales que elegimos para el usuario de base de datos:

Por favor especifique el usuario propietario de la base de datos que va ha ser usada por Koha
Koha [kohaadmin] kohaadmin

Por favor especifique la clave del usuario propietario de la base de datos que sera usada por 
Koha [katikoan] katikoan

Zebra usage is encouraged so we follow the steps to use it, for the MARC flavour for zebra choose your's. El uso de Zebra es recomendado e anima para que siga los pasos de usarlo, para el MARC sabor de zebra elegir el que es.

Instalar los archivos de configuración Zebra? (no, yes) [yes] yes
Formato MARC para indexado Zebra (marc21, unimarc) [marc21] marc21
Lenguaje principal para indexado Zebra (en, fr) [en] en

Usage of dom mode for indexing authorities has several penalties (cite needed, or correct if wrong), choose grs1:

Modo de indexación de Autoridades (dom, grs1) [dom] grs1

Siga con los valores por defecto

Please specify Zebra database user [kohauser] 
Please specify the Zebra database password [zebrastripes]
Install the SRU configuration files? (no, yes) [yes] 
SRU Database host? [localhost]
SRU port for bibliographic data? [9998] 
SRU port for authority data? [9999]
Install the PazPar2 configuration files? [no]
You will need a Memcached server running. (no, yes) [no]
Would you like to run the database-dependent test suite? (no, yes) [no]

Recibira una advertencia si tiene dependencias que no se cumplen, corrigalas usando cpan' o por el método de paquetes de su distribución. Hay diversa información sobre esto en la wiki.

Ahora realizamos el proceso de instalación:

# make
# make install

Si todo va bien, te darás cuenta que ahora tienes estos directorios en el servidor:

/etc/koha_test
/usr/share/koha_test
/var/lib/koha_test
/var/log/koha_test

Ajustando la definición de Virtualhost

Edite el archivo de definición para el virtualhost de koha (nosotros usamos vim aqui, usted puede usar su editor favorito):

vim /etc/$KOHAINSTANCE/koha-httpd.conf

Busque la linea que comience con <VirtualHost algo como esto:

<VirtualHost 127.0.0.1:80>
...
<VirtualHost 127.0.0.1:8080>

y sustituya el numero de IP por * algo como esto:

<VirtualHost *:80>
...
<VirtualHost *:8080>

Configurar los demonios Apache, demonios Zebra y trabajos cron

Ahora vamos a crear algunos enlaces simbólicos necesarios para ejecutar el demonio zebra y lanzarlo:

# export KOHAPATH=/usr/share/$KOHAINSTANCE
# ln -s $KOHAPATH/bin/koha-zebra-ctl.sh /etc/init.d/$KOHAINSTANCE-zebra-daemon
# update-rc.d $KOHAINSTANCE-zebra-daemon defaults 
# /etc/init.d/koha_test-zebra-daemon start

y decirle a Apache para que publique nuestro Koha:

# ln -s /etc/$KOHAINSTANCE/koha-httpd.conf /etc/apache2/sites-available/$KOHAINSTANCE
# a2ensite $KOHAINSTANCE
# /etc/init.d/apache2 reload

Ahora vamos a crear un archivo de prueba para poner los trabajos cron de esta instancia, con las variables de entorno adecuadas establecidas:

# echo "PERL5LIB=$KOHAPATH/lib" > /etc/cron.d/$KOHAINSTANCE
# echo "KOHAPATH=$KOHAPATH" >> /etc/cron.d/$KOHAINSTANCE
# echo "KOHA_CONF=/etc/$KOHAINSTANCE/koha-conf.xml" >> /etc/cron.d/$KOHAINSTANCE

y establecer un trabajo cron muy básico que comprueba si hay actualizaciones en nuestro registros cada minuto y los indexe en zebra

# echo "1 * * * *    koha    $KOHAPATH/bin/migration_tools/rebuild_zebra.pl -a -b -z 2>&1 > /dev/null" >> /etc/cron.d/$KOHAINSTANCE

Notas finales

Y eso es todo.