A4 instalación de koha

Anexo 4: Instalación de Koha

Koha es un sistema completo y avanzado, integrado para la gestión de bibliotecas;

utiliza el formato MARC21 y los datos del ISBN para la importación automática de

libros al sistema de clasificación de la biblioteca, ya sea Dewey o algún otro.

En la actualidad, Koha es el sistema de código abierto más utilizado en distintos

países de la Unión Europea y Estados Unidos asimismo en América Latina tiene

varias instalaciones, siendo una de las más representativas la Universidad

Nacional de La Plata en Argentina (http://koha.unlp.edu.ar/) ha ganado premios a

la innovación en software para bibliotecas y se posiciona en la actualidad como la

opción de código abierto más estable y funcional enfocada a la Gestión Integral de

las Bibliotecas; reduciendo costos e incrementando la productividad de su

organización.

Antecedentes

Para una correcta instalación de Koha se recomienda tener presentes los

siguientes antecedentes:

Instalación de un servidor debían (creación de usuario root, usuario normal

y la instalación del sistema base)

Dar permiso al usuario normal para usar el comando “sudo” o “su” (editando

el archivo /etc/sudoers como usuario root)

Todo el trabajo se desarrolla en línea de comandos, no se instala ningún

entorno gráfico de escritorio en el servidor. Esto es opcional

Para la edición de archivos de texto se usa el editor “Nano”.

La sesión de usuario activa es la del usuario normal, no la de root.

Si requiere copiar y pegar las sentencias tendrá que instalar o iniciar un

entorno gráfico de escritorio, se recomienda Xfce.

En cada sección se indican los comandos necesarios para realizar la acción

requerida.

Instalación de Apache2, MySql y PHP

sudo aptitude install apache2 php5 libapache2-mod-php5 mysql-server

mysql-client mysql-admin mysql-query-browser libmysqlclient15-dev

En caso que requiera administrar la base de MySql desde una interfaz gráfica

puede instalar PhpMyAdmin con el siguiente comando:

sudo aptitude install phpmyadmin

Incluir IndexData en repositorios

sudo nano /etc/apt/sources.list

Añadir estas líneas al final:

# Index Data

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

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

Guardar y actualizar:

sudo aptitude update

Posteriormente ejecutar:

sudo wget http://ftp.indexdata.dk/debian/indexdata.asc

--directory-prefix=/root

sudo apt-key add /root/indexdata.asc

Volver a ejecutar:

sudo aptitude update

Instalar Koha

Crear directorio temporal

cd /

sudo mkdir build

Como root

su

chown -R usrserver.usrserver /build

exit

Como usuario usrserver

cd /build

sudo wget http://download.koha-community.org/koha-latest.tar.gz

sudo tar -zvxf koha-latest.tar.gz

Verificar la versión descargada con el comando

dir

cd koha-3.08.04

sudo aptitude update && sudo aptitude upgrade

sudo dpkg --set-selections < install_misc/debian.packages

sudo aptitude install dselect

sudo apt-get dselect-upgrade

Verificar librerías y dependencias

Para verificar si es necesario instalar alguna librería o dependencia se debe

ejecutar:

perl koha_perl_deps.pl -m -u

Si es necesario instalar alguna se ingresa al CPAN para instalarlas:

sudo perl -MCPAN -e shell

Al entrar escribimos

o conf init

Se recomienda realizar la instalación dependencia por dependencia:

install CGI::Session::Driver::memcached

install Template::Plugin::HtmlToText

install Test::Strict

install DateTime::TimeZone

install Gravatar::URL

Al terminar escribimos exit, en la siguiente línea se revisa que no falte ninguna

librería:

perl koha_perl_deps.pl -m –u

Crear base de datos

sudo mysqladmin -uroot create koha -p

sudo echo "grant all on koha.* to 'kohaadmin'@'localhost' identified by

'katikoan';" | mysql -uroot -p

sudo mysqladmin -uroot -p flush-privileges

Verificar Sax Parser

cd /build/koha-3.8.4/misc

sudo ./sax_parser_print.pl

Si aparece:

Koha wants something like:

XML::LibXML::SAX::Parser=HASH(0x81fe220)

You have:

XML::SAX::Expat=HASH(0x9b40448)

Looks bad, check INSTALL.* documentation.

Edit el archivo ParserDetails.ini

sudo nano /etc/perl/XML/SAX/ParserDetails.ini

Comentar todas las líneas con el simbolo #, excepto las siguientes:

[XML::LibXML::SAX::Parser]

http://xml.org/sax/features/namespaces = 1

Volver a verificar:

sudo ./sax_parser_print.pl

Debe aparecer:

Koha wants something like:

XML::LibXML::SAX::Parser=HASH(0x81fe220)

You have:

XML::LibXML::SAX::Parser=HASH(0x88ec308)

Looks good.

Añadir usuario Koha

sudo adduser koha

Asignar una contraseña y seguir los pasos indicados.

Instalación del software Koha

cd /build/koha-3.08.04/

sudo perl Makefile.PL

Responder a las preguntas, generalmente es pulsar Enter en cada una.

Si falta alguna librería se debe instalar antes de seguir.

Ejecutar los siguientes comandos uno por uno:

sudo make

sudo make test

sudo make install

Al terminar exportar las variables de koha con los siguientes comandos:

export KOHA_CONF=/etc/koha/koha-conf.xml

export PERL5LIB=/usr/share/koha/lib

Configurar apache

sudo ln -s /etc/koha/koha-httpd.conf /etc/apache2/sites-available/koha

Autorizar puerto 8080

sudo nano /etc/apache2/ports.conf

Escribir:

Listen 8080

Debajo de Listen 80

Habilitar sitio de Koha

Ejecutar los siguientes comandos:

sudo a2enmod rewrite

sudo a2ensite koha

sudo /etc/init.d/apache2 restart

Configuración de instalación Web

Ejecutar el comando:

sudo ifconfig

Ver la dirección IP que tiene asignada el equipo, aparece después de “init addr:” y

entrar desde otro equipo a esa dirección con el puerto 8080, ejemplo:

http://192.168.1.66:8080

En caso contrario necesitará instalar un entorno gráfico de escritorio, si tiene

instalado Xfce inicie el entorno con la instrucción startx y entre en el explorador

http://192.168.1.66:8080/

web a la dirección: http://127.0.1.1:8080

Al entrar en la dirección http://127.0.1.1:8080 la primera pantalla es la pantalla de

inicio de sesión, el usuario por defecto es “kohaadmin” y la contraseña es

“katikoan”, ver siguiente imagen:

Ilustración 1: Instalación web de Koha 1

Se presiona el botón , se mostrará la siguiente pantalla:

Ilustración 2: Instalación web Koha 2

http://127.0.1.1:8080/

http://127.0.1.1:8080/













Se presiona el hipervínculo y se mostrará la siguiente pantalla:


Se selecciona la opción “Marc21” y se presiona el botón , se mostrará la

siguiente pantalla:


En la cual, si no está familiarizados con Koha se marca todas las opciones que se

presentan, en caso contrario únicamente las que sean necesarias, en este ejemplo

marco todas las opciones de importación y al final de la página presiono el botón

, se mostrará la siguiente pantalla:


En la parte inferior de la página se presiona el botón y se mostrará la

siguiente pantalla:


Después de 5 segundos se mostrará la siguiente pantalla:


Se inicia sesión con el usuario “kohaadmin” y la contraseña “katikoan”, se

selecciona cualquier biblioteca, se presiona el botón y se mostrará la

siguiente pantalla:


Para consultar el OPAC se ingresa en la dirección http://127.0.1.1


Traducción al español

Entrar a una terminal como usuario normal y ejecutar los siguientes comandos:

cd /usr/share/koha/misc/translator/

sudo PERL5LIB=/usr/share/koha/lib KOHA_CONF=/etc/koha/koha-conf.xml

perl translate install es-ES

Se mostrará un error el cual no causa mayor problema, entrar en la administración

de Koha, luego en “Global System Preferences”, y entrar en la opción

“I18N/L10N”, en esta pantalla marcar las opciones como se muestra en la

siguiente pantalla:

http://127.0.1.1/

Ilustración 16: Traducir Koha al español 1

Pulsar el botón , luego el icono de Koha y en la parte

inferior izquierda mostrará la opción para cambiar de idioma, ver siguiente imagen:


En el OPAC será el mismo procedimiento, ver imagen siguiente:


Configuración de Zebra

Iniciar una terminal como usuario root

su

cd /

ln -s /usr/share/koha/bin/koha-zebra-ctl.sh /etc/init.d/koha-zebra-daemon

sudo update-rc.d koha-zebra-daemon defaults

sudo /usr/share/koha/bin/koha-zebra-ctl.sh start

Configurar cronjob

Iniciar una terminal como usuario root

su

cd /usr/share/koha/bin/cronjobs

crontab -u root crontab.example

crontab -u usrserver crontab.example

crontab -e

Ingresar las siguientes líneas en caso de no existir:

#Environment

PERL5LIB=/usr/share/koha/lib

KOHA_CONF=/etc/koha/koha-conf.xml

#Some additional variables

KOHA_CRON_PATH=/usr/share/koha/bin/cronjobs

Descomentar la línea:

/10 * * * * $KOHA_CRON_PATH/../migration_tools/rebuild_zebra.pl -b -a -z

>/dev$

Ubicada después de:

# ZEBRA INDEX UPDATES with -z option, incremental index updates

throughout the $

# for both authorities and bibs

Esto es para reindexar la base de datos automáticamente cada 10 minutos,

guardar el archivo en la ruta: /usr/share/koha/bin/cronjobs con cualquier nombre,

cerrar con la tecla control y la “X”

Administración de Zebra

Koha utiliza el motor de búsqueda Zebra, el cual le proporciona una gran velocidad

y flexibilidad de opciones para las búsquedas.

Iniciar Zebra Server.

su

cd /usr/share/koha/bin

sudo /usr/share/koha/bin/koha-zebra-ctl.sh start

Regenerar índice completo

su koha

export PERL5LIB=/usr/share/koha/lib

cd /usr/share/koha/bin/migration_tools

./rebuild_zebra.pl -b -r –a -v

Vínculos recomendados

Esta instalación de Koha tiene algunos ejemplos de políticas, bibliotecas, usuarios,

configuraciones, servidores Z39.50, etc. para conocer más de este sistema se

recomienda visitar las siguientes páginas:

Manuales, tutoriales, dudas y comunicación con otros usuarios que usan Koha:

koha-es Comunidad Koha para hispanohablantes:

http://tech.groups.yahoo.com/group/koha-es/

Koha Library Software Community: http://koha-community.org/

Wiki Koha http://wiki.koha-community.org/wiki/Main_Page

Para personalizar el OPAC:

Koha blog: http://www.myacpl.org/koha/

http://www.myacpl.org/koha/

http://wiki.koha-community.org/wiki/Main_Page

http://koha-community.org/

http://tech.groups.yahoo.com/group/koha-es/

Technology

A4 instalación de koha