Koha 3.x en Debian Squeeze

= Paquetes debian para Koha =
Hay un repositorio APT de paquetes para Debían de Koha, y los de sus dependencias faltantes en Debian.
La versión de debian squeeze es soportada; versiones antiguas de debian no tienen soporte.
En el momento, el paquete 'koha-common' es preferido sobre el paquete 'koha'.
== Versiones ==
Hay tres versiones de paquetes Koha. 
 - una version estable (3.10)
 - una antigua version estable (3.8)
 - una version en desarrollo 
Si no esta seguro de cual escoger, vaya por la version estable. Si desea ser mas conservador , vaya por la mas reciente antigua version estable. 
Tenga en cuenta que ambas son todavía en gran medida un trabajo en progreso: no van a funcionar a la perfección por el momento,pero permiten gestionar una biblioteca. Ayudar con las pruebas y el desarrollo es apreciado!
== Para Usar ==
En esta etapa, el uso conjunto de las tres versiones es más o menos idéntico. La diferemcia sólo está en que usted elija cuál desea usar. 
También hay un solución práctica sobre la instalación y configuración de los paquetes.
Si esta usando Debian Wheezy refierase al post de la lista de correo, estos paquetes son actualizados y funcionan con esto: http://lists.katipo.co.nz/pipermail/koha/2013-May/036243.html
=== Antigua Version Estable ===
Para obtener la antigua version 3.8 estable, añada esto a su archivo /etc/apt/sources.list.d/koha.list :
 deb http://debian.koha-community.org/koha oldstable main
=== Actual version estable ===
Para obtener la version estable 3.10, añada esto a su archivo /etc/apt/sources.list.d/koha.list : 
 deb http://debian.koha-community.org/koha squeeze main
=== Version de Desarrollo ===
Para obtener la version de desarrollo (actualmente desde 3.11), añada esto a su su archivo /etc/apt/sources.list.d/koha.list :
 deb http://debian.koha-community.org/koha squeeze-dev main
=== Para todas las versiones ===
Añadir la llave en gpg.asc a sus llaves provadas de APT:
 wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -
(Si esta familiarizado con GnuPG, tendrá que comprobar que tiene una ruta de confianza
de la llave. Si no sabe cómo hacerlo, este espacio es, por desgracia 
demasiado limitado para explicar cómo y tendrá que arriesgarse..)
Después de esto, debería poder instalar Koha:
 sudo apt-get update
 sudo apt-get install koha-common
 less /usr/share/doc/koha-common/README.Debian
Lea el archivo README.Debian para instrucciones de como fingurar 
Koha despues de instalado el paquete. 
Espera! porque no hay un paque koha? Bueno, existe, pero no es en este repo, porque no esta completa: * koha-common contiene todo el codigo y los scripts soportados.No te va a dar una instancia de koha que esté en funcionamiento en la instalación, pero no te permitirá utilizar koha-create y sus herramientas asociadas para crear tantas instancias como desee. Cualquier cosa creada con ests orden será automáticamente dirigido por trabajos de cron, y zebra va a funcionar, y así sucesivamente.
* koha es similar, pero provee un solo sitio. Por el momento sin embargo,este sitio no puede ser administrado por las herramientas que vienen con el paquete, y por lo que tendrá que configurar las tareas cron y zebra por usted mismo. Ver bug 5071 para planes para correguir esto. No se recomienda utilizar este paquete aún.
== Inicio Rápido ==
=== Configuración Inicial ===
Esto asume que esta usando el paquete koha-common 
Para configurar su servidor para usar con nombres DNS:
Después de instalar, edite /etc/koha/koha-sites.conf con detalles acerca de su sitio web. Puede que se necesite crear este archivo.
Si no necesita configuración DNS y espera acceder a koha vía IP solamente (a menudo hecho para las instalaciones de prueba), puede omitir la creación de este archivo y obtendrá los valores por defecto (OPAC en el cliente el puerto 80 y el personal y/o Staff en el puerto 8080).
Algunos ejemplos contenidos podrían ser:
 DOMAIN=".mydomain.co.nz" # Cualquier instancia de biblioteca será un subdominio de esta cadena.
 INTRAPORT="80" # Puerto de escucha TCP de la interfaz de administración
 INTRAPREFIX="" # URL para la administración de interfaz: prefijo que se añade al nombre de
 instancia.
 INTRASUFFIX="-intra" # URL para la interfaz de Administración: El sufijo que se agregará
 al nombre de instancia.
 DEFAULTSQL="/usr/share/koha/defaults.sql.gz" # sólo es necesario si usted va ha 
 pre-poblar desde otra base de datos de Koha
 OPACPORT="80" # Puerto de escucha TCP para la interfaz del usuario 
 (si se salta este, se usará el valor por defecto de apache 80)
 OPACPREFIX="" # URL para la interfaz de los usuarios: prefijo que se añade al nombre de instancia.
 OPACSUFFIX="" # URL para la interfaz de los usuarios: sufijo que se agregará al nombre de
 instancia.
 ZEBRA_MARC_FORMAT="marc21" # Especifica el formato de los registros MARC para ser indexados
 por Zebra. Los posibles valores son 'marc21', 'normarc' y 'unimarc'
 ZEBRA_LANGUAGE="en" # Idioma principal para Indexacion Zebra. Posibles valores 
 son 'en', 'fr' y 'nb'
=== Configurando VirtualHost === 
 en breve metodo de configuración
lo siguiente, necesita hacer disponible el modulo Apache mod_rewrite:
sudo a2enmod rewrite
Si esta planeando ejecutar MySQL en el mismo servidor donde esta ejecutando Koha, asegurese 
de instalarlo primero:
 sudo apt-get install mysql-server
Si esta planeando ejecutar MySQL en un servidor separado, por favor no ejecute koha-create --create-db instancename como se menciona a continuacion. En su lugar, véaseInstall Koha 3.6 on Debian squeeze using a separate MySQL server.
=== Creando la Instancia Koha ===
Ahora necesita crear su primera instancia Koha. Remplace instancename con el nombre de su biblioteca. Si desea tener library.example.com, entonces instancename puede ser probablemente "library".
 sudo koha-create --create-db instancename
Ahora puede visitar la pagina web de administración para continuar con el instalador web de koha.
El nombre de usuario para iniciar sesion con koha será koha_instancename y la contraseña estara cerca del final de /etc/koha/sites/instancename/koha-conf.xml. Tendrá que ser root para verla, también puede utilizar este comando:
 sudo xmlstarlet sel-t-v 'yazgfs /config/pass' /etc/koha/sites/nombreDesuInstancia/koha-conf.xml
para imprimirlo.
=== Construyendo Idiomas ===
Ordenes para construir un idioma para la interfaz (ejemplo para francia frances):
 cd /usr/share/koha/misc/translator
 sudo env PERL5LIB=/usr/share/koha/lib KOHA_CONF=/etc/koha/sites/nombreinstancia/koha-conf.xml perl translate install fr-FR
Ordenes para construir todos los idiomas disponibles para la interfaz:
 cd /usr/share/koha/misc/translator
 Langs="$(ls -1 /usr/share/koha/misc/translator/po/ | grep -ie "pref.po" | sed -e "s/-pref\.po//g")"
 for Current in $Langs ; do sudo env PERL5LIB=/usr/share/koha/lib KOHA_CONF=/etc/koha/sites/nombreinstancia/koha-conf.xml perl translate install $Current ; done
----
koha-common instala una serie de ordenes manuales, que siguen siendo algo poco documentadas. He aquí un resumen de ellas:
* koha-create: create a new library instance. Por ejemplo koha-create --create-db mylibrary will create a new koha catalogue called 'mylibrary', create and populate the database for it, set up zebra, and configure Apache appropriately. Note that by default after creation, your Koha instance may be disabled. If you get "command not found", try /usr/sbin/koha-create (It's possible that that isn't on your $PATH). 
** There are a number of options to koha-create that allow you do to things such as set your MARC flavour and language for zebra.
* koha-enable/koha-disable: this lets you enable or disable a Koha instance, e.g. koha-enable.
* koha-email-enable/koha-disable-email: turn on or off sending of email for the Koha instance. If email is disabled, the mail queue is regularly cleared in order to prevent a wave of emails when its turned on. Note: by default, a new Koha instance has the mail disabled.
* koha-remove: deletes a Koha instance
Ver también : Commands provided by the Debian packages.
== Otros paquetes ==
Este repositorio puede contener también otros paquetes que Koha necesita,
pero que faltan en Debian Squeeze. La lista de paquetes
variará con el tiempo, ya que es necesario los nuevos paquetes y antes 
ellos deben ser cargados a Debian. Después que esten en debian Debian Squeeze, seran
removidos de este repositorio.
En Debian es necesario instalar sudo, i.e. apt-get install sudo. 
Cuando instala en Ubuntu Lucid, debería instalar manualmente estos paquetes primero:
 libhttp-oai-perl_3.23-1_all.deb
 liblocale-currency-format-perl_1.28-1_all.deb
 libmemoize-memcached-perl_0.03-1_all.deb
 libpdf-api2-perl_0.73-1_all.deb
 libpdf-api2-simple-perl_1.1.4u-1_all.deb
 libtext-csv-perl_1.21-1_all.deb
 libtext-csv-encoded-perl_0.10-1_all.deb
Hay algunas instrucciones para instalar Koha en Ubuntu Lucid usando estos repositorios en Koha_on_Lucid_using_Koha_packages
== Normativa de Actualizacion ==
There is a need for packages of both the stable Koha release and
the tip of the git master branch. One is useful for running Koha
in a production environment, the other is useful for testing
and developing Koha, and for preparing for upgrades.
This creates a risk that all the configuration management will become
overwhelming. There is a strong need to keep things simple.
For simplicity, only Debian squeeze will be targeted for now. Also,
for now, all packages are built and uploaded by Robin Sheat
(robin@catalyst.net.nz), until there is a need to set up an actual
upload queue.
Hay una una necesidad que los paquetes tanto de la version estable de Koha
y los de de la punta de la rama master en git. Uno de ellos es útil para ejecutar Koha
en un entorno de producción, el otro es útil para probar
y el desarrollo de Koha, y para preparar para actualizaciones.
Esto crea un riesgo de que toda la gestión de la configuración se convierta 
en algo abrumador. Hay una fuerte necesidad de mantener las cosas simples.
Para simplificar, sólo nos concentraremos en Debian squeeze por ahora. además,
Por ahora, todos los paquetes se construiran y se cargaran por Robin Funda
(robin@catalyst.net.nz), hasta que haya una necesidad de establecer un verdadero
cola de subida.
Hay un repositorio.Y tiene dos paquetes (por ahora):
* squeeze: para los paquetes destinados a su uso en producción
* squeeze-dev: por las cosas que aún están en fase de desarrollo
Ambos paquetes Koha y su dependencias entran en los mismos paquetes.
Los paquetes Koha en el paquete squeeze se construyen a partir de la 3.10.n tag, y los paquetes de squeeze-dev son construido desde master.
== Haciendo cambios a los paquetes Debian ==
Para hacer los cambios a la paqueteria en la rama maestra de Koha,
los cambios se realizarán como lo harían para cualquier otra parte de Koha: 
enviar un parche, y esperar con esperanza que el administrador de la 
versión acepte. cuando se acepte, Robin quien es en realidad el actual 
constructor y quien es el que cargara los paquetes.
Para simplificar, es importante que no se rompa la simetria 
entre la rama maestra de Koha y los paquetes cargados a 
debian.koha-community.org.
== Soportando mas versiones de Debian ==
Es posible, pero con un poco de esfuerzo, para soportar Debian lenny. 
El problema es que hay una gran cantidad de necesidades de software para
Koha que no están empaquetados para lenny, por lo que tendría 
que ser portado y añadido al repositorio apt de Koha. Si alguien está 
dispuesto a hacer el backporting y asumir la responsabilidad 
de mantenerlos actualizados, Robin está dispuesto a organizarlos 
para ser incluido en el repositorio.
Para las versiones de Debian que no sean squeeze, tendremos que 
añadir más paquetes. Cada paquete tendrá que ser construido para 
cada versión por separado, pero que puede ser automatizado, 
por lo menos en su mayoría. Puede haber una necesidad de hacer 
alguna de las partes del empaquetamiento de manera diferente en 
cada versión, y esto será un poco una pesadilla. 
Es la sincera esperanza de Robin que no necesitamos preocuparnos 
acerca de esto por un tiempo, y que podemos resolver 
el problema cuando lo tengamos, y no ahora.
== Construyendo sus propios Paquetes ==
Si desea construir sus propios paquetes para uso interno,el proceso utilizado para la construcción de éstos se puede adaptar. puede encontrarlo en here.
==Nota de casos==
un debian recién actualizado - Lenny a Squeeze - puede a veces tener problemas con el usuario debian-sys-maint mysql. Usted puede arreglar esto por siguiendo las instrucciones
== Vea tambien ==
* Newbie guide (to begin the working configuration)
* Using the Index Daemon with the packages
Categoría:Documentación
Category:Installation
Category:Obsolete