Koha 17.05/Configuration of Koha using the web installer (de-DE)

Aus Koha-de-Wiki
Wechseln zu: Navigation, Suche

It is assumed you can access the Koha web installer via http://IPADRESS:8080

To use the web installer you will have to log into it by using the database user that was created together with your Koha instance, and you will need to know its password. In the example the Koha instance was named "stadtarchiv", thus the database user was called "koha_stadtarchiv". You will find its password in file "koha-conf.xml" using the following command. Here the password is "xyxyxyxyxyxyxyxy".

$ INSTANCE=stadtarchiv
$ sudo xmlstarlet sel -t -v 'yazgfs/config/pass' \
    /etc/koha/sites/$INSTANCE/koha-conf.xml && echo
xyxyxyxyxyxyxyxy
small-bugzilla.pngBug 18741 Web installer does not load default data

Koha 17.05.00 comes with a bug preventing the web installer from correctly loading some default values. The problem can be manually solved in file "install.pl".

$ sudo vi /usr/share/koha/intranet/cgi-bin/installer/install.pl

In line 248

scalar $query->param('framework') );

has to be replaced by

$query->multi_param('framework') );
This problem is solved in Koha 17.05.01.

small-bugzilla.pngBug 18629 Translatability: Fix problems with web installer 17.05

If you have ever used the old web installer you will see the new web installer coming with Koha 17.05.00 indeed has a new design but the translation unfortunately is a chaotic mixup between English and the expected language.

Koha 17.05.00 de-DE webinstaller01.png
When you access the Koha web installer via http://IPADRESS:8080 you will be greeted by

Welcome to the Koha 17.05 web installer

As described above, in this example you will need the following data to log into the web installer:

  • Username: koha_stadtarchiv
  • Password: xyxyxyxyxyxyxyxy

Click the button "Log in".

Koha 17.05.00 de-DE webinstaller02.png
Web Installer > Choose your language

The web installer asks for the language in which it should talk to you. Only languages that you have already installed can be chosen here (see Creating additional languages for the Graphical User Interfaces).

In the example we will use the language web installer in German, so "de-DE" is chosen here.

Click the button "Continue to the next step".

Koha 17.05.00 de-DE webinstaller03.png
Web installer > Check Perl dependencies

Now you will see the German message that "alle erforderlichen Perl-Module" and "alle erforderlichen Abhängigkeiten" are installed.

Click the button "Continue to the next step".

Koha 17.05.00 de-DE webinstaller04.png
Web installer > Database settings

Now the following database settings are shown:

  • Database type: mysql
  • Database name: koha_stadtarchiv
  • Database host: localhost
  • Database port: 3306 (probably okay if blank)
  • Database user: koha_stadtarchiv

Click the button "Continue to the next step".

Koha 17.05.00 de-DE webinstaller05.png
Web installer > Database settings

The web installer informs you, that the connection to the database was established and additionally the following information is given:

  • Datenbank "koha_stadtarchiv" existiert.
  • Nutzer "koha_stadtarchiv" hat alle benötigten Rechte für die Datenbank "koha_stadtarchiv".

Click the button "Continue to the next step".

Koha 17.05.00 de-DE webinstaller06.png
Web installer > Set up database

The web installer informs you that it's ready to create the database tables and fill them with some default data.

Click the button "Continue to the next step".

Koha 17.05.00 de-DE webinstaller07.png
Web installer > Success

The web installer informs you that the database tables were created.

Click the button "Continue to the next step".

Koha 17.05.00 de-DE webinstaller08.png
Web installer > Install basic configuration settings

The web installer informs you that it's ready to do some basic configuration.

Click the button "Continue to the next step".

Koha 17.05.00 de-DE webinstaller09.png
MARC-Format auswählen

Since we are using the web installer in German there is nothing really to choose - you can just accept the given choice of "Marc21". Note: Only if you are using the standard web installer in English you are able to choose between MARC21 and UNIMARC.

Click the button "Continue to the next step".

Koha 17.05.00 de-DE webinstaller10.png
Web installer > Selecting default settings

This page lets you choose some default settings.

Make sure you have corrected the Perl file "install.pl" ((Bug 18741)) as described above or you are using at least Koha 17.05.01. Otherwise you will end up with a corrupt and not fully functional installation of Koha!

In section "MARC-Frameworks: MARC21 / Mandatory" all entries have to be activated since they are mandatory.

In section "MARC-Frameworks: MARC21 / Optional" you may actually choose the entries you like. I would recommend the following entry:

  • marc21_default_matching_rules

In section "Andere Daten / Mandatory" all entries have to be activated since they are mandatory.

In section "Andere Daten / Optional" you may choose the entries you like. I would recommend the following entries:

  • auth_val
  • patron_atributes
  • sample_z3950_servers

Click the button "Import".

Koha 17.05.00 de-DE webinstaller11.png
Web installer > Default data loaded

The web installer informs you about the various data that were added.

Click the button Set up for Koha's basic requirements".

Koha 17.05.00 de-DE webinstaller12.png
Web installer > Installation complete

For some seconds you will see a screen with congratulations - after about ten seconds this screen should be redirected to the next screen automatically.

Koha 17.05.00 de-DE webinstaller13.png
Web installer > Create a library

Now the web installer asks for some basic configuration settings that before Koha 17.05 had to be entered in the Koha menu "Koha administration" after the installation process.

First you need to give the code for your library (branch) and its name.

  • Bibliothekskürzel: STAWI
  • Name: Stadtarchiv Winterthur

Click the button "Bestätigen".

Koha 17.05.00 de-DE webinstaller14.png
Web installer > Create a patron category

The web installer informs you that the entry for your library (branch) was created.

Next you need to create the patron category that will be used by the administrator account that you will have to create later.

  • Kategoriecode: AP
  • Beschreibung: Archivpersonal
  • Mahnschreiben erforderlich: Nein
  • Kategorie: Mitarbeiter
  • Standardeinstellung für Datenschutz: Für immer
  • Dauer der Mitgliedschaft:
    • In Monaten: 999
    • Bis:

Click the button "Bestätigen".

Koha 17.05.00 de-DE webinstaller15.png
Web installer > Create Koha administrator patron

The web installer informs you that the entry for your patron category was created.

Now you need to create the administrator account that will get "superlibrarian" permissions (i. e. a staff member with maximum permissions).

Administrator identity

  • Nachname: Super
  • Vorname: Librarian
  • Ausweisnummer: 1
  • Bibliothek: Stadtarchiv Winterthur
  • Benutzerkategorie: Archivpersonal

Administrator account permissions

  • 'Superlibrarian'

Administrator login

  • Benutzername: super
  • Passwort: abc123
  • Passwort bestätigen: abc123

Click the button "Bestätigen".

Koha 17.05.00 de-DE webinstaller16.png
Web installer > Create a new item type

The web installer informs you that the administrator account was created.

Now you need to create an item type.

  • Medientyp-Code: BUCH
  • Beschreibung: Buch

Click the button "Bestätigen".

Koha 17.05.00 de-DE webinstaller17.png
Web installer > Create a new circulation rule

The web installer informs you that the item type was created.

Now you need to create a circulation rule.

  • Bibliothek: Stadtarchiv Winterthur
  • Benutzertyp: Alle
  • Medientyp: Alle
  • Anzahl gleichzeitiger Ausleihen: 50
  • Leihfrist: 14
  • Einheiten: Tage
  • Erlaubte Verlängerungen: 10
  • Verlängerungszeitraum: 14
  • Erlaube Vormerkungen verfügbarer Titel: Ja

Click the button "Bestätigen".

Koha 17.05.00 de-DE webinstaller18.png
Web installer > Create a new circulation rule

The web installer informs you that the circulation rule was created.

The web installer congratulates you again.

Click the button "Koha nun benutzen".

Koha 17.05.00 de-DE webinstaller19.png
Now you see the login window of the Koha staff client. Since you are here the first time you may just ignore the message saying "Error: Session timed out. Please log in again."

Just enter the username and its password that you have given when asked to create the administration account.

In the example the needed data is:

  • Benutzername: super
  • Passwort: abc123
  • Bibliothek: Meine Bibliothek

Click the button "Anmelden".

Koha 17.05.00 de-DE webinstaller20.png
If you login successfully you are presented with the staff client interface in German (de-DE) language.

Since German (de-DE) is an additional language you will find the possibility to change to English in the left corner at the bottom.

Koha 17.05.00 de-DE webinstaller21.png
Assumed you can access the Koha OPAC via http://IPADRESS:80 you will also find the Koha OPAC interface is now in German (de-DE) language.

Since German (de-DE) is an additional language you will find the possibility to change to English in the left corner at the bottom and also via the link "Sprachen" in the upper right corner.