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