Introduction to the Koha installation process

This is the Koha installation manual.

The Koha installation process uses 2 tools:

  • Web Installer

  • Tool di Attivazione

Questa documentazione si riferisce ad entrambi gli strumenti.

Cos’è il Web Installer di Koha ?

Il Web Installer imposta le tabelle del database in cui sono archiviati tutti i dati utilizzati in Koha, ad esempio le biblioteche gestite dal sistema, gli utenti, i record catalografici e le informazioni di copia.

Si accede al Web Installer tramite login con le credenziali di amministratore.

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?

Il Tool di Attivazione garantisce che prima di utilizzare Koha sia stata creata almeno una biblioteca, una categoria di utente, un utente, un tipo di copia e una regola di circolazione.

Se sono stati precedentemente installati un esempio di biblioteca, categoria utente e/o tipo di copia, le schermate per la creazione di questi elementi nel Tool di Attivazione verranno saltate.

Tuttavia, rimane sempre necessario creare un utente per accedere all’interfaccia Staff una volta completate le configurazioni con il Tool di Attivazione e una regola di circolazione.

Web Installer

Login al Web Installer

Web installer login

Questa è la finestra di login che appare all’installazione di Koha.

image1152

Login al Web Installer

  1. Versione di Koha: Viene mostrato il numero della versione di Koha che stai installando.

  2. Username: Utente amministratore del database. Il valore di default è koha_kohadev.

  3. Password: Password dell’utente amministratore del database. Il valore di default è password.

  4. Log in: Seleziona questo bottone per effettuare il login

Selettore della lingua

Installer start screen

Prima schermata del Web Installer.

image1166

Finestra di avvio del Web Installer

  1. Selettore lingua elenco a tendina: Qui si specifica quale lingua utilizzare in Koha.

Nota

Installando altre lingue di cui sono disponibili traduzioni del Web Installer (come accade. ad esempio, per IT, DE o FR) si potrà selezionare la lingua da utilizzare nel Web Installer.

  1. Cliccare sul bottone Continuare al passo successivo.

Installer perl modules installed

Questa schermata indica che sono disponibili tutti i moduli necessari per creare il database.

image1167

Moduli Perl installati

Cliccare sul bottone Continuare al passo successivo.

Configurazione Database

Questa schermata mostra alcune impostazioni di default del database e chiede di confermarle cliccando sul bottone Continuare al passo successivo.

Nota

Per la maggior parte degli utilizzi questi settaggi risulteranno corretti, se non lo fossero è necessario contattare il proprio provider.

image1168

Configurazione Database

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

  2. Cliccare il bottone Continuare al passo successivo per confermare le impostazioni del database

Connection established

Cliccando sul bottone Next la connessione viene attivata:

image1169

Connessione al database stabilita

  1. Il messaggio Connessionw stabilita indica che il database è stato correttamente creato.

  2. Cliccare sul bottone Continuare al passo successivo

Nota

Se ci sono problemi nella connessione al database, il programma di installazione non procederà oltre. In questo caso controllare con attenzione le informazioni di connessione nel file koha-conf.xml e verificare che le autorizzazioni e le credenziali di accesso al database siano corrette.

Pronti a inserire i dati nelle tabelle

Questa schermata informa che tutto è pronto per creare le tabelle del database.

image1170

Database pronto per i dati

Cliccare sul bottone Continuare al passo successivo

Nota

Questo passaggio può richiedere del tempo. Si prega di attendere.

Tabelle del database create

image1171

Tabelle del database create

Cliccare sul bottone Continuare al passo successivo

Pronti per le impostazioni di base

Questa schermata porta all’installazione delle impostazioni di base necessarie per utilizzare Koha.

image1172

Pronti per le impostazioni di base

Cliccare sul bottone Continuare al passo successivo

Selezionare il formato MARC (MAchine Readable Cataloguing)

In questa schermata è necessario scegliere il formato MARC che si desidera utilizzare in catalogazione:

image1173

Selezionare il formato MARC (MAchine Readable Cataloguing)

  1. Unimarc: Generalmente utilizzato in Europa (con l’eccezione del Regno Unito).

  2. MARC21: E” il formato usato globalmente. Questo è il formato selezionato come default.

  3. Cliccare sul bottone Continuare al passo successivo per confermare le scelte

Configurazione di MARC21 e UNIMARC

Nota

Nella schermata precedente è stata fatta la scelta tra i formati MARC21 o UNIMARC. Questa pagina descrive entrambi.

Configurazione di MARC21

image1174

Configurazione di 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. **Regole di corripondenza per i record bibliografici MARC21: ** Le regole di corrispondenza vengono utilizzate per trovare tutte le informazioni sui record bibliografici utilizzando i valori nell’authority.

  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. Esempi di griglie di catalogazione MARC21 per alcuni tipi comuni di materiale bibliografico: Vengono installate alcune griglie predefinite.

  6. Valori autorizzati: Installa i valori autorizzati obbligatori necessari per ogni installazione Koha.

  7. **Fonti di classificazione e regole di riempimento: ** Vengono inserite diverse fonti di classificazione tra cui la classificazione decimale 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. Attributi degli utenti: Non vengono installati dati (verrà rimosso).

  10. Esempi di frequenze per gli abbonamenti: Per copie che vengono acquisite regolarmente (ad esempio per le riviste mensili), attivare questa opzione consente di selezionare delle periodicità pre-installate al momento dell’inserimento delle informazioni di copia.

  11. Esempi di Notifiche: Consente di inserire nel database degli esempi di notifica. In questo modo sarà sufficiente modificare questi esempi prima di utilizzarli. In alternativa, la creazione manuale di nuove notifiche potrebbe richiedere molto tempo.

  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. Definisce il valore di default per l’invio di informazioni di copia, messaggi e notifiche: Viene attivata la possibilità di invio tramite SMS e email. Obbligatorio se si vogliono inviare notifiche per email o SMS.

  14. Esempi di numerazione per abbonamenti: Vengono installati degli esempi di numerazione per riviste e pubblicazioni periodiche, consentendo di evitare un inserimento manuale.

  15. Alcuni valori di default per le collocazioni, lo stato delle copie, ecc. È possibile modificare queste impostazioni in qualsiasi momento dopo l’installazione: Vengono installati dei valori autorizzati, che consentono l’inserimento da parte dell’utente di valori solo se fanno parte delle liste qui inserite.

  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. Valori codificati conformi allo standard Z39.71-2006 per la dichiarazione di posseduto degli elementi bibliografici: Non è obbligatorio per l’utilizzo di Koha. Una dichiarazione di posseduto indica all’utente se la biblioteca possiede una specifica copia e dove si trova. Attivando questa opzione verranno installati dei codici di esempio.

  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. Esempi di tessere utente: Non obbligatorio per l’utilizzo di Koha ma raccomandato per gran parte delle nuove installazioni. Verranno installati degli esempi che semplificano la creazione di nuove tessere utente.

  23. Esempio di giorni di vacanza: Domenica, Natale, Nuovo anno Non obbligatorio per l’utilizzo di Koha. Vengono inseriti nel database i giorni di vacanza generalmente previsti (es. Natale)

  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. Esempio di news: Non obbligatorio per l’utilizzo di Koha. Inserisce esempi di news che possono essere mostrate nell’OPAC (Online Public Access Catalog) e nell’interfaccia Staff.

  27. Esempi di Utente: Non obbligatorio per l’utilizzo di Koha. Gli utenti sono le persone che utilizzano Koha, ad esempio: utilizzatori e personale della biblioteca. Vengono inseriti nel database un certo numero di utenti di esempio . Questa configurazione viene generalmente utilizzata dagli sviluppatori per scopi di test e dimostrativi.

  28. Citazioni di esempio: Non obbligatorio per l’utilizzo di Koha. Le citazioni del giorno possono essere visualizzate agli utenti della biblioteca sull’interfaccia OPAC (Catalogo di accesso pubblico online). Selezionando questa opzione verranno installate alcune citazioni di esempio correlati alla biblioteca.

  29. Consentire l’accesso ai seguenti server per cercare e scaricare informazioni sui record: Non è obbligatorio per l’utilizzo di Koha, ma è consigliato per la maggior parte delle nuove installazioni. Permette di configurare una selezione di target Z39.50, che consentono a Koha di accedere ai server, catturare i record e importarli nel proprio database. Ciò può evitare di inserire manualmente tutte le informazioni del record bibliografico accelerando così il processo di catalogazione.

  30. Cliccare sul bottone Import per installare i dati di default selezionati.

UNIMARC setup

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

  • Authority structure for UNIMARC in English

  • Griglia di catalogazione UNIMARC predefinita in inglese

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. Cliccare sul bottone Importa per installare i dati di default selezionati

Aggiungi i dati selezionati

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

Aggiungi i dati selezionati

  1. Dati opzionali aggiunti: Se sono stati precedentemente selezionati dei dati opzionali, vengono qui mostrati, in caso contrario la sezione Dati opzionali aggiunti non comparirà.

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

  3. Dati obbligatori aggiunti: Come sopra.

  4. **Messaggio di installazione: ** Indica se il database di Koha è stato creato correttamente e si può passare al Tool di Attivazione.

  5. Cliccare sul bottone Impostare alcuni dei requisiti fondamentali di Koha per passare al Tool di Attivazione.

Reindirizza alla pagina del Tool di Attivazione

Dopo circa 10 secondi si viene reindirizzati alla schermata di avvio del Tool di Attivazione.

image1177

Reindirizza alla pagina del Tool di Attivazione

Nota

Se dopo aver aspettato non si viene reindirizzati, selezionare il link indicato dalla freccia sopra indicata.

Tool di Attivazione

Creare una biblioteca

Nel caso in cui non siano state installate con il Web Installer le biblioteche di esempio, il Tool di Attivazione richiederà di creare la prima biblioteca.

In Koha con il termine “biblioteca” si indica la rappresentazione digitale di un luogo fisico. Altre biblioteche possono essere successivamente aggiunte andando in Amministrazione -> Biblioteche e gruppi.

image1153

Creare la biblioteca

  1. Codice della biblioteca: codice composto da un massimo di 10 lettere.

  2. Nome: Nome della biblioteca.

  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. Cliccare sul bottone Invia per creare una biblioteca.

Per esempio:

image1154

Esempio di creazione di una biblioteca

Codice biblioteca: espressione regolare che filtra gli input accettabili per il codice della biblioteca. Accetta un massimo di 10 lettere.

Crea una nuova categoria utenti

Tutti gli utenti in Koha devono appartenere ad una categoria. La categoria definisce diritti e caratteristiche di un dato utente: le regole di circolazione adottate, la frequenza degli avvisi, permessi e altro. Koha richiede la presenza di almeno una categoria di utente.

Una categoria utente richiede:

  • Codice della categoria

  • Descrizione

  • Avviso di prestito scaduto

  • Tipo di categoria

  • Privacy di default

  • Periodo di iscrizione: in numero mesi o fino ad una specifica data

image1155

Crea una nuova categoria utenti

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

  2. Codice categoria: Codice composto da un massimo di 10 lettere.

  3. Descrizione: Descrive la categoria cui l’utente appartiene.

  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 di Categoria: In questo modo la categoria creata un membro dello staff.

  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. Cliccare sul pulsante * Invia * per creare la categoria di utenti.

Per esempio:

image1156

Creare un utente

Un utente Superlibrarian è necessario per accedere all’interfaccia Staff di Koha, una volta che il processo di attivazione e sia stato completato.

Nota

È molto importante annotare il nome utente e la password creati qui dato che si tratta delle credenziali necessarie per accedere come amministratore (superlibrarian) di Koha.

Sarà necessario inserire/selezionare:

  • Cognome

  • First name

  • Numero tessera

  • Biblioteca

  • Categoria utente

  • Username

  • Password:

    image1157

    Creare un utente

  1. Messaggio di creazione della categoria utente: Indica se la categoria dell’utente è stata creata con successo.

  2. Cognome: Cognome, o analogo dato descrittivo

  3. Nome: Nome, o analogo dato descrittivo

  4. Card number: This number must be unique

  5. Biblioteca elenco a tendina: Se la biblioteca è stata creata con il Tool di Attivazione, questa è l’unica opzione. Altrimenti selezionare una delle biblioteche di esempio installate con il Web Installer.

  6. Categoria Utente elenco a tendina: Se una categoria utente è stata creata utilizzando il Tool di Attivazione, questa sarà l’unica opzione. Altrimenti selezionare la categoria Staff.

  7. Permessi del Superlibrarian: Configurazione non editabile: permette di accedere a tutte le procedure di amministrazione e gestione su tutte le biblioteche definite in Koha. E” l’utente Koha con tutti i diritti: è importante proteggerne bene le credenziali di accesso.

  8. Username: Username per accedere all’interfaccia Staff e all’OPAC.

  9. Password: Una password formata da lettere, numeri, e spazi di lunghezza maggiore di 8 caratteri.

  10. Conferma password: Inserire nuovamente la password

  11. Cliccare sul bottone Invia pulsante per creare l’account dell’utente

  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.

Per esempio:

image1158

Creare un esempio di utente

Create an item type

Questa schermata sarà mostrata solo se non sono stati installati esempi tipi di copia con il Web Installer.

Analogamente al tipo di utente, il tipo di copia è fondamentalmente un modello che si utilizza per aggregare più elementi con caratteristiche comuni.

Sarà necessario inserire:

  • Codice del tipo di copia

  • Descrizione

    image1159

    Creare il tipo di copia

  1. ** Messaggio di creazione di utente amministratore: ** Indica se l’utente amministratore è stato creato con successo

  2. Codice del tipo di copia: codice composto da un massimo di 10 lettere

  3. Descrizione: Descrizione della categoria cui l’utente appartiene.

  4. **Percorso per creare il tipo di copia: ** I tipi di copia possono essere creati o modificati accedendo a: Amministratore-> Tipi di copia

  5. Cliccare sul bottone Invia per creare un tipo di copia

Per esempio:

image1160

Esempio di creazione di un tipo di copia

Nota

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

Create a circulation rule

Questa schermata verrà sempre visualizzata indipendentemente dagli esempi installati usando il Web Installer.

Qui possono essere create delle regole pre-impostate per la gestione dei prestiti.

image1161

Creare la regola di circolazione

Nota

In questo form vanno inseriti solo valori numerici.

  1. **Messaggio di creazione del tipo di copia: ** Indica se il tipo di copia è stato creato con successo

  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. Prestiti attualmente autorizzati: E” il numero di prestiti consentiti per la biblioteca selezionata, per categoria di utente e per tipo di copia selezionata. Il valore di default è 50.

  6. Durata del prestito: Numero di giorni o ore consentite per il prestito di una copia. L’impostazione predefinita a 14.

  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. Prenotazioni a scaffale consentite: elenco a tendina: indica se le copie possono essere prestate mentre sono sullo scaffale.

  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.

Tool di Attivazione completato

Questa pagina indica se la regola di circolazione è stata creata correttamente, e che l’installazione di Koha è stata completata

image1162

  1. Messaggio del Web Installer: Indica se l’installazione web è completa

  2. Messaggio regola di circolazione creata: Indica se la regola di circolazione è stata correttamente creata.

  3. **Iniziare a utilizzare Koha: ** Cliccare per effettuare il login a Koha utilizzando l’account di amministratore precedentemente creato con il Tool di Attivazione.

Login per accedere all’Interfaccia Staff

La procedura di configurazione è terminata ed è ora possibile effettuare il login all’Interfaccia Staff utilizzando l’account dell’utente creato con il Tool di Attivazione

image1163

Schermata di Login

  1. Username: Inserire il nome utente

  2. Password: Inserire la password

  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

Per esempio:

image1164

Esempio di Login

Interfaccia Staff

Ora dovrebbe apparire l’interfaccia Staff

image1165

Interfaccia Staff

Vedi anche

Per maggiori informazioni sull’utilizzo dell’interfaccia Staff consultare: 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.