PDF de programación - Guía de instalación de Kobli 1.8

Manual de instalación de

Kobli 1.8.1

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: 22/08/2012

http://kobli.bage.es

Comunidad Koha-Kobli

1/26

Instalación Kobli 1.8.1



3.1
3.2
3.3
3.4
3.5
3.6
3.7
3.8
3.9
3.10
3.11
3.12
3.13
3.14
3.15
3.16
3.17
3.18

Contenido
Introducción ............................................................................................... 3
1
2
Instalación de Kobli ....................................................................................... 3
3 Guía detallada sobre Linux Debian 6.0 ................................................................... 4
Juego de caracteres del servidor .................................................................. 4
Juego de caracteres para base de datos MySQL .................................................. 4
Juego de caracteres en servidor web Apache..................................................... 5
Instalación de repositorios de paquetes Yaz y Zebra ............................................. 5
Creación de usuario para la instancia Kobli ....................................................... 5
Descarga de Kobli ................................................................................... 6
Instalar dependencias de perl ..................................................................... 6
Creación de la base de datos MySQL y el usuario ................................................ 6
Comprobar el lector de SAX de xml para perl instalado .......................................... 7
Configuración del instalador Koha ................................................................. 7
Compilación e instalación de fuentes ............................................................ 10
Actualizar variables de entorno................................................................... 10
Conexión e inicio de Zebra ........................................................................ 11
Configuración de apache2 ........................................................................ 12
Ejecutar la herramienta de configuración final web: ............................................ 13
Iniciar como usuario kobli el indexador de Zebra: ............................................... 21
Creación y configuración de carpetas con los permisos adecuados ............................ 21
Limpieza ............................................................................................ 22
Actualización ............................................................................................. 22
Comprobar si faltan dependencias de perl ...................................................... 22
Pasar a la instalación .............................................................................. 22
Sustituir los ficheros de configuración nuevos por los anteriores .............................. 22
Ejecutar script de Postinstalación ................................................................ 23
Desinstalación ............................................................................................ 24
Parar servicios ..................................................................................... 24
Desinstalar bases de datos e índices ............................................................. 25
Eliminar directorio de Kobli ....................................................................... 25
Parámetros básicos ...................................................................................... 25
Crear una biblioteca ............................................................................... 25
Crear un usuario administrador .................................................................. 25
Revisar las preferencias del sistema .............................................................. 26

6.1
6.2
6.3

4.1
4.2
4.3
4.4

5.1
5.2
5.3

4

5

6



http://kobli.bage.es

Comunidad Koha-Kobli

2/26

Instalación Kobli 1.8.1



Introducción

1


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) que realizó un estudio y posterior evaluación de las soluciones
de código abierto disponibles que sirviese como base para la distribución propia de
un SIGB para las BAGEs interesadas o para cualquier otra biblioteca. Se eligió Koha
por ser el SIGB más avanzado que cubre la mayoría de las funcionalidades
requeridas.

Este documento contiene información básica para instalar Kobli. Como ejemplo se
detallan todos los pasos para instalar Kobli 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)



Instalación de Kobli

2


Kobli, al estar basado en Koha, necesita los mismos requerimientos técnicos con
respecto a servidores web, bases 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.

Requerimientos:


 Servidor web, siendo el más utilizado y recomendado el servidor Apache
(http://httpd.apache.org/). La página de descarga es http://httpd.apache.org/download.cgi.



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

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, etc.
Como alternativa a MySQL está 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.

 Lenguaje perl (http://www.perl.org/) para la ejecución de la aplicación en todos
los sistemas UNIX/LINUX, que viene instalado por defecto porque su
utilización es intensiva.

http://kobli.bage.es

Comunidad Koha-Kobli

3/26

Instalación Kobli 1.8.1

La instalación en las plataformas UNIX/LINUX es bastante similar; en 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


Comprobar que el servidor tiene el juego de caracteres UTF8.


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


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

LANG=es_ES.UTF-8
export LANG

 Asignar al shell actual dicho valor

Ejecutar en línea de comando: root:# . /etc/profile
Comprobar desde el shell con el comando set o env que el valor está
asignado.



3.2 Juego de caracteres para base de datos MySQL

Una vez instalado el servidor MySQL, hay que comprobar 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 [client]
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 juego 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 |
| character_set_results | utf8 |

http://kobli.bage.es

Comunidad Koha-Kobli

4/26

Instalación Kobli 1.8.1

| 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

Una vez instalado el servidor web apache2:


 Añadir o cambiar en /etc/apache2/apache2.conf:


addDefaultCharset UTF-8
addCharset UTF-8 .utf8

 Reiniciar 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 las siguientes fuentes:

# Index Data

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