Koha 17.05/Configuration of Koha using the web installer (de-DE)
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
Bug 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.
Bug 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.
 |
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:
Click the button "Log in". |
 |
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". |
 |
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". |
 |
Web installer > Database settings
Now the following database settings are shown:
Click the button "Continue to the next step". |
 |
Web installer > Database settings
The web installer informs you, that the connection to the database was established and additionally the following information is given:
Click the button "Continue to the next step". |
 |
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". |
 |
Web installer > Success
The web installer informs you that the database tables were created. Click the button "Continue to the next step". |
 |
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". |
 |
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". |
 |
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:
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:
Click the button "Import". |
 |
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". |
 |
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. |
 |
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.
Click the button "Bestätigen". |
 |
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.
Click the button "Bestätigen". |
 |
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
Administrator account permissions
Administrator login
Click the button "Bestätigen". |
 |
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.
Click the button "Bestätigen". |
 |
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.
Click the button "Bestätigen". |
 |
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". |
 |
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:
Click the button "Anmelden". |
 |
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. |
 |
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. |