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

http://kobli.bage.es

Comunidad Koha-Kobli

1/24

Instalación Kobli 1.4



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

Contenido
Introducción ............................................................................................... 3
1
2
Instalación de Kobli 1.4 ................................................................................... 3
3 Guía detallada sobre Linux Debian 6.0 ................................................................... 4
Juego de caracteres del servidor .................................................................. 4
Juego de caracteres 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 del usuario para la instancia koha ...................................................... 5
Creamos la base de datos MySQL y el usuario .................................................... 6
Comprobar el Lector de SAX de xml para perl instalado ......................................... 7
Configuración instalador Koha ..................................................................... 7
Compilación e instalación de fuentes ............................................................ 10
Actualizar variables de entorno................................................................... 11
Conexión e inicio de Zebra ........................................................................ 11
Configuramos el apache2: ........................................................................ 13
Ejecutar herramienta de configuración final web: .............................................. 14
Iniciamos como el usuario kobli el indexador de Zebra: ........................................ 21
Limpieza: ........................................................................................... 22
Desinstalación: ........................................................................................... 22
Parar servicios: ..................................................................................... 22
Desinstalar Bases de Datos e Índices: ............................................................ 23
Eliminar directorio de Kobli: ...................................................................... 23
Parámetros básicos ...................................................................................... 23
Crear una biblioteca ............................................................................... 23
Crear un usuario administrador .................................................................. 23
Revisar las preferencias del sistema .............................................................. 24

4

5

4.1
4.2
4.3

5.1
5.2
5.3



http://kobli.bage.es

Comunidad Koha-Kobli

2/24

Instalación Kobli 1.4

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 evaluación de las soluciones SIGB de
código abierto disponibles que sirviese como base para la distribución propia de un
SIGB para las BAGEs interesadas y 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 una información básica de cómo instalar Kobli 1.4. Como
caso 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



Instalación de Kobli 1.4

2


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 orientada
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 te puedes 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.

Necesita de un 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

Necesita de la base de datos textual Zebra (http://www.indexdata.com/zebra) para
búsquedas de registros en MARC21 y servidor Z3950

Necesita la base de datos relacional MySQL (http://mysql.com/) para la gestión de la
Circulación, Catalogación, Usuarios, …
Como alternativa 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.

Necesita del 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 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.

http://kobli.bage.es

Comunidad Koha-Kobli

3/24

Instalación Kobli 1.4



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 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 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 |
| character_set_server | utf8 |

http://kobli.bage.es

Comunidad Koha-Kobli

4/24

Instalación Kobli 1.4

| 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:


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


addDefaultCharset UTF-8
addCharset UTF-8 .utf8

 Reiniciamos 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



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


http://kobli.bage.es

Comunidad Koha-Kobli

5/24

Instalación Kobli 1.4



 Creación directorio de descarga



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


 Creación directorio de instalación


Como usuario root creamos el directorio donde se va a instalar el koha y le