PDF de programación - Manual de instalación de Kobli 1.4

Manual de instalación de

Kobli 1.4

Guía detallada sobre Linux Debian 6.0

(Squeeze)



Salvador Zaragoza Rubio
Nuño López Ansótegui
Domingo Arroyo Fernández
Alicia Sellés Carot



Fecha: 20/05/2011



 

Instalación Kobli 1.4 



Contenido 
1. Introducción ................................................................................................ 5
2. Instalación de Kobli 1.4 ..................................................................................... 5
3. Guía detallada sobre Linux Debian 6.0..................................................................... 6
3.1. Juego de caracteres del servidor ...................................................................... 6
3.2. Juego de caracteres base de datos MySQL ........................................................... 6
3.3. Juego de caracteres en servidor web Apache ........................................................ 7
3.4. Instalación de repositorios de paquetes Yaz y Zebra ................................................. 7
3.5. Creación del usuario para la instancia koha .......................................................... 7
3.6. Creamos la base de datos MySQL y el usuario........................................................ 8
3.7. Comprobar el Lector de SAX de xml para perl instalado ............................................. 9
3.8. Configuración instalador Koha ........................................................................ 9
3.9. Compilación e instalación de fuentes ............................................................... 12
3.10. Actualizar variables de entorno.................................................................... 13
3.11. Conexión e inicio de Zebra ......................................................................... 13
3.12. Configuramos el apache2 .......................................................................... 16
3.13. Ejecutar herramienta de configuración final web................................................. 16
3.14. Iniciamos como root  la cola del zebra............................................................. 25
3.15. Limpieza............................................................................................. 25
4. Desinstalación............................................................................................. 25
4.1 Parar servicios ........................................................................................ 25
4.2 Desinstalar bases de datos e índices................................................................. 26
4.3 Eliminar directorio de Kobli .......................................................................... 26
5. Parámetros básicos ....................................................................................... 26
5.1 Crear una biblioteca .................................................................................. 26
5.2 Crear un usuario administrador...................................................................... 26
5.3 Revisar las preferencias del sistema ................................................................. 27



http://kobli.bage.es 
 

Comunidad Koha‐Kobli   

3/27 

Instalación Kobli 1.4 



1. Introducción


Kobli es un sistema integrado de gestión de bibliotecas (SIGB) desarrollado por el
impulso del Grupo de Trabajo de las BAGEs (Bibliotecas de la Administración
General del Estado). Dicho Grupo realizó un estudio y evaluación de las soluciones
SIGB de código abierto disponibles en la actualidad con el objetivo de seleccionar la
más adecuada y emplearla como base para una distribución propia para las BAGEs
interesadas y para cualquier otra biblioteca que así lo desee.
Se eligió Koha por ser el SIGB más avanzado que cubre la mayoría de las
funcionalidades requeridas.

Este documento contiene una información básica sobre cómo instalar Kobli 1.4. Se
detallan todos los pasos para instalar Kobli 1.4 en una máquina con Debian 6.0
como sistema operativo.

Si usted dispone de otro sistema operativo Unix o Windows, diríjase a la
documentación específica de instalación de Koha (sobre el que Kobli está
construido) en Koha-community.

http://wiki.koha‐community.org/wiki/Category:Installation


2. Instalación de Kobli 1.4


Kobli, al estar basado en Koha, necesita los mismos requerimientos técnicos con
respecto a servidores web, base de datos y librerías de funcionalidades. Es posible
instalarlo en cualquier plataforma que los implemente, estando orientado,
especialmente, a Sistemas Operativos Unix/Linux.
Puede instalarse en Linux/Debian, Linux/Fedora, FreeBSD. OpenBSD, Windows, etc.

Los SO de Unix/Linux vienen habitualmente con repositorios de paquetes de los que
automáticamente se pueden bajar las aplicaciones necesarias. Si no existieran hay
que conectarse a la página web de la aplicación y descargarse los instaladores o el
código fuente para su posterior compilación.

Necesidades:


(http://httpd.apache.org/). La página de descarga es http://httpd.apache.org/download.cgi.


registros en MARC21 y servidor Z3950.

- base de datos relacional MySQL (http://mysql.com/) para la gestión de la

circulación, catalogación, usuarios… Como alternativa existe la base de datos
relacional PostgreSQL (http://www.postgresql.org/), pero el soporte dentro de Koha es
sólo parcial, por lo que puede dar resultados erróneos y/o inesperados.


- base de datos textual Zebra (http://www.indexdata.com/zebra) para búsquedas de

- servidor web, siendo el más utilizado y recomendado el servidor Apache

- lenguaje Perl (http://www.perl.org/) para la ejecución de la aplicación. En
todos los sistemas UNIX/LINUX viene instalado por defecto porque su utilización es
intensiva. La instalación en las plataformas UNIX/LINUX es bastante similar. En

http://kobli.bage.es 
 

Comunidad Koha‐Kobli   

5/27 

Instalación Kobli 1.4 

Windows, al ser una filosofía totalmente distinta, la dificultad en la instalación
dependerá del grado de pericia y conocimientos de Windows del administrador.

3. Guía detallada sobre Linux Debian 6.0

3.1. Juego de caracteres del servidor


Hay que comprobar que el servidor tiene el juego de caracteres UTF8:


root:# dpkg-reconfigure locales as root y escogemos es_ES.UTF8 UTF8


 Revisar que no hay ningún carácter extraño en /etc/locale.gen
 Editamos /etc/profile y añadimos o cambiamos la variable LANG

LANG=es_ES.UTF-8
export LANG

 Asignamos al shell actual dicho valor.

Ejecutamos en línea de comando: root:# . /etc/profile
Comprobamos desde el shell con el comando set o env que está

asignado el valor.



3.2. Juego de caracteres base de datos MySQL

Estando instalado el servidor MySQL, comprobamos que los siguientes valores
están asignados en /etc/mysql/my.cnf (en algunos sistemas operativos el
fichero de configuración de MySQL puede variar de localización como por ejemplo
/etc/my.cnf).

En la sección [mysqld]
init_connect='SET collation_connection = utf8_general_ci'
init-connect = 'SET NAMES utf8'
character-set-server=utf8
collation-server=utf8_general_ci
character-set-client=utf8

En la [mysql]
default-character-set=utf8


 Reiniciar el servicio de base de datos para que tome los nuevos valores
root:#/etc/init.d/mysql restart.



 Comprobar valores de juegos de caracteres en variables msyql.


root:# mysql –u root -p
mysql> show variables like 'char%';
+--------------------------+----------------------------+
| Variable_name | Value |
+--------------------------+----------------------------+
| character_set_client | utf8 |
| character_set_connection | utf8 |
| character_set_database | utf8 |
| character_set_filesystem | binary |

http://kobli.bage.es 
 

Comunidad Koha‐Kobli   

6/27 

Instalación Kobli 1.4 

| character_set_results | utf8 |
| character_set_server | utf8 |
| character_set_system | utf8 |
| character_sets_dir | /usr/share/mysql/charsets/ |
+--------------------------+----------------------------+
8 rows in set (0.00 sec)


3.3. Juego de caracteres en servidor web Apache

Estando instalado el servidor web apache2:

 Se añade o cambia en /etc/apache2/apache2.conf:


addDefaultCharset UTF-8
addCharset UTF-8 .utf8



 Se reinicia el servicio web para que tome el nuevo valor.



root:# /etc/init.d/apache2 restart



3.4. Instalación de repositorios de paquetes Yaz y Zebra

Asignar fuentes apt para los paquetes Yaz y Zebra.

Editar fichero /etc/apt/sources.list para añadir los siguientes fuentes:

# Index Data

deb http://ftp.indexdata.dk/debian squeeze main
deb-src http://ftp.indexdata.dk/debian squeeze main



Los paquetes de Index Data están firmados con una clave que se puede instalar
como sigue:

root:# wget http://ftp.indexdata.dk/debian/indexdata.asc
root:# apt-key add indexdata.asc

Podemos borrar el fichero indexdata.asc


Ejecutar el siguiente comando para actualizar el sistema:

root:# apt-get update

3.5. Creación del usuario para la instancia koha


 Creación de usuario y asignación de clave

root:# useradd -c "koha ministerio cultura" -d /home/kobli -m -s
/bin/bash kobli



http://kobli.bage.es 
 

Comunidad Koha‐Kobli   

7/27 

Instalación Kobli 1.4 

root:# passwd kobli (o contraseña elegida)


 Creación directorio de descarga



root:# mkdir -p /home/www/koha
root:# chown kobli:kobli /home/www/koha