Instrucciones de instalación de Koha en servidor Debian Squeeze en equipo virtualizado con VirtualBox

1. 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.

2.  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 installphpmyadmin
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
Posteriormenteejecutar:
sudowget http://ftp.indexdata.dk/debian/indexdata.asc --directory-
prefix=/root
sudo apt-key add /root/indexdata.asc
Volver a ejecutar:
sudo aptitude update

3. Instalar Koha
Crear directorio temporal
cd /
sudomkdir build
Como root
su
chown -R usrserver.usrserver /build
exit
Como usuario usrserver
cd /build
sudowgethttp://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
sudodpkg --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:
sudoperl -MCPAN -e shell
Al entrar escribimos

4. oconfinit
Se recomienda realizar la instalación dependencia por dependencia:
install CGI::Session::Driver::memcached
installTemplate::Plugin::HtmlToText
installTest::Strict
installDateTime::TimeZone
installGravatar::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
sudomysqladmin -uroot -p flush-privileges
Verificar SaxParser
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.

5. 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
Debeaparecer:
Koha wants something like:
XML::LibXML::SAX::Parser=HASH(0x81fe220)
You have:
XML::LibXML::SAX::Parser=HASH(0x88ec308)
Looks good.
Añadir usuario Koha
sudoadduser 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

6. 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
sudoln -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:
sudoifconfig
Ver la dirección IP que tiene asignada el equipo, aparece después de “initaddr:” 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

7. 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 lacontraseñ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

8. Se presiona el botón , se mostrará la siguiente pantalla:
Ilustración 3: Instalación web Koha 3
Se presiona el botón , se mostrará la siguiente pantalla:
Ilustración 4: Instalación web Koha 4
Se presiona el botón , se mostrará la siguiente pantalla:

9. Ilustración 5: Instalación web Koha 5
Se presiona el botón , se mostrará la siguiente pantalla:
Ilustración 6: Instalación web Koha 6
Se presiona el botón , se mostrará la siguiente pantalla:
Ilustración 7: Instalación web Koha 7

10. Se presiona el botón , se mostrará la siguiente pantalla:
Ilustración 8: Instalación web Koha 8
Se presiona el hipervínculo y se mostrará la siguiente pantalla:
Ilustración 9: Instalación web Koha 9
Se selecciona la opción “Marc21” y se presiona el botón , se mostrará la
siguiente pantalla:

11. Ilustración 10: Instalación web Koha 10
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:
Ilustración 11: Instalación web Koha 11

12. En la parte inferior de la página se presiona el botón y se mostrará la
siguiente pantalla:
Ilustración 12: Instalación web Koha 12
Después de 5 segundos se mostrará la siguiente pantalla:
Ilustración 13: Instalación web Koha 13
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:

13. Ilustración 14: Instalación web Koha 14
Para consultar el OPAC se ingresa en la dirección http://127.0.1.1
Ilustración 15: Instalación web Koha 15
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.xmlperltranslate 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:

14. 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:
Ilustración 17: Traducir Koha al español 2

15. En el OPAC será el mismo procedimiento, ver imagen siguiente:
Ilustración 18: Traducir Koha al español 3
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 usrservercrontab.example
crontab -e
Ingresar las siguientes líneas en caso de no existir:
#Environment
PERL5LIB=/usr/share/koha/lib

16. 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 $
# forbothauthorities 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

17. 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/