Introduction to the Koha installation process

This is the Koha installation manual.

The Koha installation process uses 2 tools:

  • Instalador Web

  • Herramienta de integración inicial

Esta documentación describirá estas dos herramientas.

¿Qué es el instalador web de Koha?

El instalador web prepara las tablas de la base de datos que guardan toda la información con la que trabajas en Koha, por ejemplo las bibliotecas, usuarios e ítems.

El instalador web comienza con una página de inicio de sesión para que ingreses las credenciales de la cuenta de administrador de base de datos.

The installer will then create the tables and fill the tables with data. The next step in the process is to set up a few mandatory first use settings, via the onboarding tool.

What is the Koha onboarding tool?

La herramienta de integración se asegura que se tiene al menos una biblioteca, categoría de usuario, usuario, tipo de material y política de circulación antes de que comience a utilizar Koha.

Si ha instalado datos de ejemplo para biblioteca, categoría de usuario, y/o tipo de ítem entonces las páginas para crear estos serán omitidas.

Sin embargo, usted siempre tendrá que crear un usuario (para iniciar sesión en la interfaz administrativa al final de la herramienta de integración) y una política de circulación.

Instalador Web

Inicio de sesión de instalador Web

Web installer login

Esta pantalla de inicio de sesión es la primera que aparece al instalar Koha.

image1152

Inicio de sesión de instalador Web

  1. Nombre de versión de Koha: Esto desplegará el número de versión que está instalando.

  2. Nombre de usuario: Este es el nombre de usuario del administrador de la base de datos el cual es * koha_kohadev* por defecto.

  3. Contraseña: Esta es la contraseña del administrador de base de datos que es password por defecto.

  4. Iniciar sesión: Seleccione este botón para iniciar sesión

Selección de idioma

Installer start screen

Esta es la primer pantalla del instalador web.

image1166

Pantalla de inicio de instalador Web

  1. Caja de selección de idioma: En esta se especifica el lenguaje en el que quieres que se muestre Koha.

Nota

Instalando otros lenguajes que tienen traducciones para el instalador (DE o FR, por ejemplo) permitirá usar esos lenguajes para el instalador web.

  1. Haga clic en el botón Continuar con el siguiente paso para cargar la siguiente etapa del instalador web.

Installer perl modules installed

Esta pantalla te indica que el instalador tiene todas las dependencias necesarias, para crear la base de datos en la siguiente pantalla.

image1167

Módulos Perl instalados

Clic en el botón Continuar con el siguiente paso para cargar la siguiente etapa del instalador web.

Configuración de la base de datos

Esta pantalla te indica los ajustes de la base de datos y te solicita que los confirmes dando clic en el botón Continuar con el siguiente paso.

Nota

Para la mayoría de usuarios estos ajustes deberían ser correctos, si no entonces deberás contactar a tu técnico de soporte.

image1168

Configuración de la base de datos

  1. Database settings: Check these database settings are correct.

  2. Clic en el botón Continuar con el siguiente paso para confirmar los ajustes de la base de datos


Connection established

Después de dar clic en el botón Siguiente la conexión a la base de datos está confirmada:

image1169

Se ha establecido la conexión a la base de datos

  1. Mensaje de conexión establecida: Esto te indica que la base de datos ha sido creada correctamente.

  2. Clic en el botón Continuar con el siguiente paso para cargar el siguiente paso

Nota

Si tu tiene dificultades de conexión en este paso, el instalador no continuará. Vuelva a verificar su información de conexión en su archivo koha-conf.xml, y verifique que los permisos y credenciales en la base de datos misma, son correctos.

Listo para llenar las tablas con datos

Esta pantalla le indica que todo está listo para crear las tablas de la base de datos en la siguiente pantalla.

image1170

Base de datos lista para datos

Clic en el botón Continuar con el siguiente paso para cargar el siguiente paso

Nota

Este paso puede llevar un tiempo. Por favor, sea paciente.

Tablas de la base de datos creadas

image1171

Tablas de la base de datos creadas

Dar clic en el botón Continuar con el siguiente paso

Preparado por las configuraciones básicas

Esta pantalla conduce a la instalación de configuraciones básicas que son necesarias para usar Koha.

image1172

Preparado por las configuraciones básicas

Dar clic en el botón Continuar con el siguiente paso

Seleccionar variante MARC

Debe elegir su variante MARC (formato en el que desea que los registros bibliográficos (catálogo) se almacenen en la base de datos) en ésta pantalla:

image1173

Seleccionar variante MARC

  1. Unimarc: Utilizado generalmente en países europeos (excepto Reino Unido) tales como Italia.

  2. MARC21: Seleccionado por defecto ya que es el más utilizado que UNIMARC a nivel global.

  3. Haga clic en el botón Continuar con el siguiente paso para confirmar sus elecciones

Configuración de MARC21 y UNIMARC

Nota

En la pantalla anterior debe haber seleccionado MARC21 o UNIMARC como su variante MARC. Esta página describe ambos.

Configurción de MARC21

image1174

Configurción de MARC21

  1. Default MARC21 standard authority types: An authority type is a template of an authority record (stores the search fields used to search an institutions catalog for an item). This option will install sample authority types.

  2. Default MARC21 bibliographic framework: Following on from the MARC21 selection in the previous screen selecting this checkbox (and the Import button) will actually setup the MARC21 bibliographic framework as the desired MARC flavour.

  3. Selección de reglas de coincidencia para los registros bibliográficos MARC21: Las reglas de coincidencia MARC21 son utilizadas para encontrar toda la información acerca de un registro bibliográfico en específico utilizando los tipos de valores autorizados de búsqueda.

  4. “FA”, a “fast add” minimal MARC21 framework suitable for ILL, or on the fly cataloging: The FA MARC framework displays fewer fields, and allows for faster cataloguing on the fly. Select this checkbox to install this minimal framework.

  5. Muestras de hojas de trabajo bibliográfico MARC21 para algunos tipos comunes de materiales bibliográficos: Esto instala las plantillas que usará para crear ítems.

  6. Valores autorizados del sistema Koha predeterminados: Esto instala valores autorizados obligatorios que cada instalación de Koha necesita.

  7. Reglas de ordenación de la clasificación predeterminadas: Esto insertará varias y comunes reglas de clasificación tales como la decimal Dewey.

  8. Defines default message transports for email and SMS: This provides the option to the user of being able to change how the library contacts them. They can choose from the following: email address, printed message, SMS, or phone call. Notices will not work without these.

  9. Atributos del usuario: Esto no instala ningún dato y debe ser eliminado.

  10. Frecuencias de muestra para suscripciones: Para los ítems que llegan de manera regular y predecible (por ejemplo, revistas mensuales), la instalación de frecuencias de muestra es útil porque puede simplemente seleccionar una frecuencia de muestra preinstalada cuando se crea el ítem.

  11. Avisos de muestra: Esto ingresa avisos de muestra en la base de datos, lo que significa que todo lo que tiene que hacer es personalizar estos avisos de muestra antes de usarlos. Crearlos a mano puede consumir mucho tiempo y es propenso a errores.

  12. Defines default messages for the enhanced messaging configuration: The enhanced messaging configuration lets the user choose what messages they receive from the institution. Selecting this will insert sample message types for the due, predue, and advance notice message types.

  13. Define los transportes de mensajes predeterminados para el envío de mensajes vencidos y mensajes de aviso por correo electrónico y SMS: Esto inserta los tipos de transporte para SMS y correo electrónico. Es obligatorio si desea enviar avisos por correo electrónico o SMS.

  14. Ejemplos de patrones de numeración para suscripciones: Esta opción instalará patrones de numeración de muestra, ahorrándole tener que insertarlos manualmente para revistas y otras publicaciones periódicas.

  15. Algunos valores autorizados básicos predefinidos para ubicaciones de biblioteca, ítems perdidos, estatus, etc. Puede cambiarlos en cualquier momento después de la instalación: Esto instala valores autorizados, los cuales filtran las entradas del usuario, para asegurarse de que coincidan con los criterios especificados antes de que se cree la biblioteca u otro objeto.

  16. CSV profiles: Using Koha you can export items. The CSV profile defines how you want to export the item(s). CSV/tab exports will not work without these.

  17. Valores codificados conforme a las declaraciones de existencias Z39.71-2006 para ítems bibliográficos: No se requiere para usar Koha. Una declaración de existencias le dice al usuario si la biblioteca tiene un ítem específico y dónde está ubicado. Al seleccionar se instalarán valores de código de muestra para los ítems en las declaraciones de existencias.

  18. MARC code list for relators: Not required to use Koha. A relator is a person who was involved in the development of the item (e.g. author). Selecting this will insert sample relator records into the database.

  19. Some basic currencies with USA dollar as default for ACQ module: Install US dollar, Great British Pound, Canadian Dollar and Euro currencies. Set the US dollar as the default acquisition currency. Not installing these will mean that a currency will need to be defined before acquisitions can be used.

  20. Useful patron attribute types: Not required to use Koha. Patrons have a barcode which identifies them. By clicking this checkbox you are making sure that this patron barcode is displayed on the patron summary screen.

  21. Sample patron types and categories: Not required to use Koha. Selecting this will install sample patron categories into the database. This will mean the create patron category step in the onboarding tool is skipped.

  22. Datos de muestras de etiquetas y carné de usuarios: No se requiere para usar Koha, pero son recomendados para la mayoría de nuevas instalaciones. Al seleccionar ésto, instalará datos ejemplo para etiquetas y carné de usuarios y hará fácil la creación de etiquetas y carné de usuarios en el futuro.

  23. Vacaciones de muestra: Domingo, Navidad, Año Nuevo No se requiere para usuar Koha. Seleccionando ésto, insertará ejemplos de festivos públicos repetibles (e.g. Navidad) en la base de datos.

  24. A set of default item types: Not required for Koha. Selecting this will insert sample item type data into the database, meaning the create item type step in the onboarding tool will be skipped.

  25. Sample libraries: Not required for Koha. Selecting this will insert sample libraries into the database. Developers will often want this for demo or development purposes. Selecting this means the create library step in the onboarding tool will be skipped.

  26. Muestra de ítems de noticias: No requerido para Koha. Seleccionando ésto, se insertarán en la base de datos, ejemplos de ítems de noticias que son mostrados en el OPAC (Catálogo de Acceso Público) y en la interfaz del cliente administrativo.

  27. Usuarios de muestra: No requerido para Koha. Los usuarios son la gente que utilizan el Sistema de gestión de la biblioteca, por ejemplo: usuarios de biblioteca y el personal. Seleccionando ésto, insertará un número de usuarios ejemplo en la base de datos. Los desarrolladores, a menudo, querrán estos datos para propósitos de desarrollo o de demostración.

  28. Frases de muestra: No requerido para Koha. Las frases del día pueden ser mostradas a los usuarios de la biblioteca en la interfaz del OPAC (Catálogo de Acceso Público). Seleccionando ésto, instalará algunas citas o frases de muestra relacionadas con la biblioteca.

  29. Permita el acceso a los siguientes servidores para buscar y descargar información de registros: No es requerido para usar Koha, pero recomendado para la mayoría nuevas instalaciones. Seleccionando ésto, configura Koha para permitir el acceso a la selección de servidores Z39.50, los cuales permiten la búsqueda de registros MARC21 para importarlos en la instancia de Koha. Esto permite evitar la necesidad de agregar la información de los registros manualmente o, acelerar enormemente el proceso.

  30. De clic en el botón «importar» para instalar los datos predeterminados y los valores seleccionados.

UNIMARC setup

There are only two data values in the UNIMARC advanced setup which are unique:

  • Authority structure for UNIMARC in English

  • Las hojas de trabajo bibliográfico UNIMARC predeterminadas en Inglés

Nota

Optional values are the same for both UNIMARC and MARC21, therefore their definition will not be repeated.

image1175

UNIMARC setup

  1. Authority structure for UNIMARC in English: Authority records store the search terms used to find items in the database. Unlike MARC21, when using UNIMARC the authority structure needs to be compatible with UNIMARC. Selecting this option makes it compatible.

  2. Default UNIMARC bibliographic framework in English: In the previous screen you clicked to use the UNIMARC flavour, now by selecting this option you are confirming you want to use that framework.

  3. Haga clic en el botón Importar para instalar los datos de muestra

Datos seleccionados agregados

After you have clicked the Import button in either the MARC21 or UNIMARC setup screen this screen will appear. It shows you if the selected/default data values were successfully inserted into the database.

image1176

Datos seleccionados agregados

  1. Datos opcionales agregados: Si seleccionó un valor de datos opcional, entonces, será mostrado aquí. Si no seleccionó ningún valor de datos opcional, entonces, el título datos opcionales agregados no será mostrado.

  2. MySQL data added: These data values will always be installed and consequently displayed on this screen.

  3. Datos obligatorios agregados: Lo mismo que lo anterior.

  4. Mensaje de instalación: Notifica si la base de datos de Koha fue creada satisfactoriamente y esta lista para que utilice la herramienta de integración.

  5. Haga clic en el botón Configurar algunos de los requisitos básicos de Koha para ir a la pantalla de redirección, que a su vez lo llevará a la herramienta de integración.

Redirigir a la herramienta de integración

Si espera alrededor de 10 segundos, esta pantalla debe redirigirlo a la pantalla de inicio de la herramienta de integración.

image1177

Redirigir a la herramienta de integración

Nota

Si después de esperar no se le ha redirige, selecciona el enlace señalado por la flecha en la captura de pantalla anterior.

Herramienta de integración inicial

Crear una biblioteca

El instalador solicitará que se cree la primera biblioteca o sede si las bibliotecas de muestra no se instalaron.

Una biblioteca en Koha es la representación digital de un lugar «físico.» Más bibliotecas pueden ser agregadas después dirigiéndose a Administración -> Bibliotecas y grupos.

image1153

Crear biblioteca

  1. Código de biblioteca: código que consta de hasta 10 letras.

  2. Nombre: Nombre oficial de la biblioteca, tal como se le conoce comúnmente.

  3. Create more libraries: If more libraries are required, or changes need to be made to this freshly created library, go to Administration -> Libraries and groups

  4. Haga clic en el botón Enviar para crear una biblioteca.

Por ejemplo:

image1154

Ejemplo de creación de biblioteca

Código de biblioteca: La expresión regular que filtra las entradas aceptables para el código de la biblioteca solo acepta hasta 10 letras.

Crear una categoría de usuario

Todos los usuarios en Koha deben tener una categoría de usuario. La categoría de usuario es como un molde de gelatina; varias cuenta de usuarios individuales pueden compartir caraterísticas comunes, tales como las reglas de circulación, frecuencia de avisos, reservas permitidas y mucho más. Koha requiere al menos una categoría de usuario para poder agregar usuarios.

Una categoría de usuario requiere:

  • Código de categoría

  • Descripción

  • Se requiere los avisos de retraso

  • Tipo de categoría

  • Privacidad predeterminada

  • Período de inscripción: En meses o Hasta la fecha

image1155

Crear una categoría de usuario

  1. Library creation message: Indicates whether the library was created successfully.

  2. Código de categoría: Código que consta de hasta 10 letras.

  3. Descripción: Oración que describe cuál es la categoría del usuario.

  4. Overdue notice required dropdown button: Set by default to “no”. This specifies if you want the patron category to receive overdue notices.

  5. Tipo de categoría: Esto hace que la categoría creada sea un miembro del personal.

  6. Default privacy: Set by default to “default”. The Default privacy controls the amount of time that the reading history of the patron is stored for.

  7. Enrolment period - in months: This is the number of months that the patrons created from this patron category are enrolled for.

  8. Enrolment period - until date: Select a date from the interactive datepicker calendar icon which appears when you click on this input box. The date you choose will be the enrolment end date for patrons created from this patron category.

  9. Path to create patron category: More patron categories can be created or altered by going to Administration -> Patron categories.

  10. Haga clic en el botón Enviar para crear la categoría de usuario.

Por ejemplo:

image1156

Crear usuarios

Un usuario superbibliotecario es requerido para ingresar a la interfaz del personal de Koha, una vez el proceso de integración ha sido cumplimentado.

Nota

Es muy importante la documentación de nombre de usuario y la contraseña creada en este punto, ya que los credenciales de esta cuenta son requeridos para ingresar como administrador a Koha (superbibliotecario).

Necesitará ingresar/seleccionar:

  • Apellidos

  • First name

  • Número de Carné

  • Biblioteca

  • Categoría de usuario

  • Nombre de usuario

  • Contraseña

    image1157

    Crear usuarios

  1. Mensaje de creación de categoría de usuario: Esto indica si la categoría de usuario fue creada satisfactoriamente.

  2. Apellido: Apellido, o algo descriptivo

  3. Nombre de pila: Nombre de pila, o algo descriptivo

  4. Card number: This number must be unique

  5. Caja desplegable de Biblioteca: Si la biblioteca fue creada utilizando está herramienta de integración, será la única opción. De lo contrario seleccione una biblioteca al azar de las bibliotecas muestra ingresadas por el instalador web.

  6. Caja desplegable «Categoría de usuario*: Si la categoría de usuario fue creada utilizando ésta herramienta de integración, será la única opción. De lo contrario seleccione la categoría de usuario Personal.

  7. Permisos de superbibliotecario: Esta configuración no-editable permite acceder a todas las tareas administrativas de Koha de la biblioteca basadas en la web y la interfaz del personal.

  8. Nombre de usuario: Es el nombre de usuario para iniciar sesión en la interfaz del personal y el OPAC (Catálogo de Acceso Público en Línea).

  9. Contraseña: Es una contraseña que consiste en letras, números y espacios solamente que es mayor de 8 caracteres.

  10. Confirmar contraseña: Repita la contraseña de arriba de nuevo

  11. Haga clic en el botón Enviar para crear la cuenta del usuario

  12. Path to create patron: Patron’s can be created or altered by going to Patrons -> New patron

  13. Assign patron permissions: After creating a patron go More -> Set permissions to assign permissions.

Por ejemplo:

image1158

Ejemplo de creación de usuarios

Create an item type

Si usted no instaló muestras de tipos de ítem en el instalador web, entonces, ésta pantalla será mostrada.

Al igual que con la categoría de usuario, el tipo de ítem es básicamente una plantilla que se utiliza para crear varios ítems con características comunes.

Necesita ingresar:

  • Código del tipo de ítem

  • Descripción

    image1159

    Crear un tipo de ítem

  1. Mensaje de creación de la cuenta del administrador: Indica si el usuario administrador se creó con éxito

  2. Código del tipo de ítem: Código que consta de hasta 10 letras

  3. Descripción: Oración que describe qué es el tipo de ítem.

  4. Ruta para crear el tipos de ítems: Los tipos de ítems pueden ser creados o modificados dirigiéndose a Administración -> Tipos de ítem

  5. Haga clic en el botón Enviar para crear el tipo de ítem

Por ejemplo:

image1160

Ejemplo crear tipo de ítem

Nota

The regular expression filtering item type code input will only accept letters.

Create a circulation rule

Esta pantalla siempre será mostrada no importando que tipo de datos de muestra haya instalado con el instalador web.

En este punto se encuentra creando una regla que aplicará las decisiones organizativas predefinidas de su biblioteca así como las restricciones que se pondrá en los usuarios que prestan los ítems.

image1161

Crear regla de circulación

Nota

Los números son la única entrada válida para todos los campos de entrada en este formulario.

  1. Mensaje de creación del tipo de ítem: Indica si el tipo de ítem se creó con éxito

  2. Library branch dropdown box: This is the library (or libraries) you want to apply the circulation rule to. By default it is set to all, however you can select a singular library to apply the rule to from the dropdown box.

  3. Patron categories dropdown box: This is the patron categories you want to apply the circulation rule to. As with library branch it is set to all by default but more options are avaliable.

  4. Item type dropdown box: This is the item types that you want the circulation rule to apply to. Again more options are avaliable than the default selected all option.

  5. Préstamos permitidos actualmente: Este es el número de ítems permitidos de la biblioteca seleccionada, para las categorías de usuarios seleccionadas y de los tipos de ítems seleccionados. Establecida a 50 por defecto.

  6. Período de préstamo: Número de días u horas en el que un ítem se le está permitido estar afuera. Establecido a 14 por defecto.

  7. Units dropdown box: Set by default to aays, the unit selecting in this field is applied to the numerical values written into loan period and renewals period

  8. Renewals allowed: Number of times a item can be renewed. Set to 10 by default.

  9. Renewals period: Number of days or hours that a renewal lasts for. Set to 14 by default.

  10. Caja desplegable Reservas en estantes permitidas: Si los ítems pueden mantenerse mientras están en el estante.

  11. Path to create circulation rule: Circulation rules can be created or altered by going to Administration -> Circulation and fines rules

  12. Click the submit button to create the circulation rule.

Herramienta de integración cumplimentada

Esta página le informa si la regla de circulación se creó con éxito y si la instalación de Koha está completa.

image1162

  1. Mensaje del instalador web: Indica si la instalación web está cumplimentada.

  2. Mensaje de la creación de las reglas de circulación: Indica si la regla de circulación fue creada con éxito.

  3. Comenzar a utilizar Koha: Haga clic en Ingresar a Koha utilizando la cuenta de administrador de Koha que creó utilizando la herramienta de integración.

Inicie sesión para acceder a la interfaz del personal

Ha finalizado de utilizar la herramienta de integración y puede ingresar en la interface del usuario haciendo uso de las credenciales de la cuenta de usuario que se creó con la herramienta de integración

image1163

Pantalla de inicio de sesión

  1. Nombre de usuario: Ingrese el nombre de usuario que se creó para el usuario

  2. Contraseña: Ingrese la clave que se creó

  3. Library: This is the library staff interface you want to log into. The options are either: my library or the library you installed/created. Leaving the default selected option of my library is fine to log in with first time.

  4. Click the login button to access the staff interface

Por ejemplo:

image1164

Ejemplo de Inicio de sesión

Interfaz del personal

La interfaz del personal debería aparecer ahora

image1165

Interfaz del personal

Ver también

Para más información sobre cómo utilizar la interfaz del personal, por favor visite https://koha-community.org/documentation/

Advanced configurations

VirtualHost overrides

Koha allows for the override of some system settings at a VirtualHost level.

OPAC_BRANCH_DEFAULT

The OPAC_BRANCH_DEFAULT directive can be used to specify the default branch for anonymous users of the OPAC.

SetEnv OPAC_BRANCH_DEFAULT "CPL"
RequestHeader add X-Koha-SetEnv "OPAC_BRANCH_DEFAULT CPL"

Note: This override affects which News and HTML Customisation blocks a user will see prior to logging in to the OPAC.