https://www.ebkus.org/w/api.php?action=feedcontributions&feedformat=atom&user=EbkusEBKuS Dokumentation - Benutzerbeiträge [de]2026-05-05T15:58:46ZBenutzerbeiträgeMediaWiki 1.23.9https://www.ebkus.org/wiki/EBKuS_Dokumentation:ImpressumEBKuS Dokumentation:Impressum2020-12-10T12:20:38Z<p>Ebkus: </p>
<hr />
<div>'''Klientenverwaltung, Aktendokumentation, Gruppenverwaltung und Statistik für Erziehungs- und Familienberatungsstellen'''<br />
<br />
;Copyright (1997-2021)<br />
:Jürg Huber, Albrecht Schmiedel <br />
<br />
;Lizenz<br />
:[http://www.gnu.de/documents/gpl.de.html GNU General Public License (GPL)]<br />
<br />
;E-Mail <br />
:[mailto:albrecht.schmiedel@ebkus.org Albrecht Schmiedel]<br />
:[mailto:juerg@pantau.in-berlin.de Jürg Huber]<br />
<br />
;WWW<br />
:http://www.ebkus.org/</div>Ebkushttps://www.ebkus.org/wiki/Windows_InstallationWindows Installation2020-12-08T18:28:51Z<p>Ebkus: </p>
<hr />
<div>Gültig ab: EBKuS 4.10.1. (Frühere Versionen lassen sich aber ganz ähnlich installieren.)<br />
<br />
<br />
=== Benötigte Software ===<br />
<br />
* [https://www.python.org/ftp/python/2.7.18/python-2.7.18.msi Python 2.7.18]<br />
* [https://files.pythonhosted.org/packages/27/06/596ae3afeefc0cda5840036c42920222cb8136c101ec0f453f2e36df12a0/MySQL-python-1.2.5.win32-py2.7.exe MySQL-python-1.2.5]<br />
* [https://github.com/mhammond/pywin32/releases/download/b228/pywin32-228.win32-py2.7.exe pywin32-228]<br />
* [http://ftp.gwdg.de/pub/misc/mysql/Downloads/MySQL-5.1/mysql-essential-5.1.73-win32.msi MySQL 5.1.73]<br />
* [https://archive.apache.org/dist/httpd/binaries/win32/httpd-2.2.25-win32-x86-openssl-0.9.8y.msi Apache 2.2]<br />
<br />
Alle benötigten Dateien befinden sich auch auf dem [https://ebkus.org/downloads/win32/ EBKuS FTP-Server]. <br />
Nur die ersten drei müssen manuell heruntergeladen<br />
und installiert werden. Die übrigen werden bei Bedarf automatisch<br />
heruntergeladen (sofern eine Internetverbindung besteht, ansonsten siehe unten).<br />
<br />
Natürlich muss noch die neueste <br />
[http://www.ebkus.org/alle_downloads.html EBKuS-Software]<br />
selbst heruntergeladen werden. <br />
<br />
=== Sonstige Voraussetzungen ===<br />
<br />
* '''Betriebssystem''': Erfolgreich getestet auf Windows 10 Professional. Windows Server 2008 und später sowie auch frühere Windows Versionen sind möglich.<br />
* Die von einer EBKuS-Installation verwendeten '''Ports''' dürfen nicht anderweitig verwendete werden:<br />
** Port 443 für den Apache-Webserver mit SSL-Verschlüsselung (kann mit der Konfigurationsvariablen {{konfig|server_https_port}} verändert werden)<br />
** Port 80 für den Apache-Webserver ohne SSL-Verschlüsselung (kann mit der Konfigurationsvariablen {{konfig|server_http_port}} verändert werden). Dieser Port wird allerdings von der Anwendung nicht benötigt; man kann damit aber überprüfen, ob der Webserver installiert ist unabhängig von EBKuS-Instanzen.<br />
** Port 3306 für den MySQL-Datenbankserver <br />
** Die in der {{file|ebkus.conf||}} explizit genannten Ports für die EBKuS-Instanzen<br />
* '''Administratorrechte''' für die Installation. Insbesondere muss bei neueren Windows-Systemen die Kommandozeile explizit mit Administratorrechten aufgerufen werden (rechtsklicken, mit Administratorrechten ausführen). Sonst gelingt die Einrichtung der Dienste nicht.<br />
* Die von EBKuS verwendeten '''Namen für Dienste''' dürfen nicht in Gebrauch sein: {{code|Apache, MySQL}} sowie die mit {{code|EBKuS}} beginnenden Namen für die Instanzen.<br />
* Keine Reste in der Registry von früheren Installationsversuchen :-)<br />
<br />
=== Python installieren ===<br />
<br />
Zuerst Python<br />
* {{code|python-2.7.18.msi}}<br />
und dann PyWin und MySQL-python<br />
* {{code|pywin32-228.win32-py2.7.exe}}<br />
* {{code|MySQL-python-1.2.5.win32-py2.7.exe}}<br />
installieren. Standardinstallation für alle Benutzer. Zur Kontrolle kann man {{pfad4|Start|Programme|Python 2.7|Python (command line)}} aufrufen und dort folgende Eingaben machen:<br />
>>> import win32service<br />
>>><br />
>>> import MySQLdb<br />
>>><br />
Beide Importe müssen ohne Fehlermeldungen funktionieren.<br />
<br />
=== Nur Erstkonfiguration erzeugen ===<br />
<br />
Die Beispiele gehen davon aus, dass die heruntergeladene EBKuS-Software im Verzeichnis {{file|C:\EBKuS-4.10.1}} liegt.<br />
<br />
Wenn man die Option {{code|-c}} bzw. {{code|--config}} des {{code|install-py}}-Skripts verwendet, wird lediglich die Konfigurationsdatei {{file|c:\ebkus_installation\ebkus\ebkus.conf}} erzeugt und nichts weiter installiert. <br />
C:\>cd EBKuS-4.10.1<br />
C:\EBKuS-4.10.1>python install.py -c c:\ebkus_installation<br />
Die so entstandene {{file|c:\ebkus_installation\ebkus\ebkus.conf}} kann nun weiter bearbeitet und in der eigentlichen Installation verwendet werden.<br />
<br />
=== Vollautomatische Testinstallation ===<br />
<br />
Falls die oben genannten Voraussetzungen erfüllt sind (insbesondere freie Standardports 80 und 443), kann man eine vollautomatische Erstinstallation vornehmen (Eingabeaufforderung mit Administratorrechten ausführen!):<br />
C:\>cd EBKuS-4.10.1<br />
C:\EBKuS-4.10.1>python install.py c:\ebkus_installation<br />
Den Fortgang der Installation sieht man auf der Konsole und in der Datei {{file|c:\ebkus_installation\install.log}}.<br />
<br />
Wenn alles gut gegangen ist, erhält man eine funktionierende EBKuS-Installation mit zwei Instanzen, {{code|demo}} und {{code|muster_efb}}. Es gibt dann 4 neue Windows-Dienste: Apache, MySQL, EBKuS-demo und EBKuS-muster_efb. Den Zugriff auf die Instanzen erhält man über die URL {{code|<nowiki>https://localhost/ebkus/demo/</nowiki>}} bzw. {{code|.../muster_efb/}}.<br />
<br />
Die dabei entstandene Datei {{file|c:\ebkus_installation\ebkus\ebkus.conf}} sollte man sichern, da sie den Ausgangspunkt für die endgültige Installation darstellt.<br />
<br />
Die Testinstallation kann dann ganz oder teilweise wieder deinstalliert werden:<br />
C:\EBKuS-4.10.1>python uninstall.py --all c:\ebkus_installation<br />
bzw.<br />
C:\EBKuS-4.10.1>python uninstall.py c:\ebkus_installation ebkus<br />
Im ersten Fall wird auch der Webserver und die Datenbank deinstalliert, im zweiten nur die eigentliche EBKuS-Installation mitsamt allen Instanzen.<br />
<br />
=== Installation mit vorhandenem Webserver und Datenbank ===<br />
<br />
Mit<br />
C:\EBKuS-4.10.1>python install.py --no_mysql --no_apache c:\ebkus_installation<br />
kann man eine Installation durchführen, wenn Apache und MySQL bereits vorhanden sind und nicht durch die EBKuS-Installation bereitgestellt werden sollen. Das Vorgehen ist dann ähnlich der [[Linux_Installation]]. Es muss manuell dafür gesorgt werden, dass die generierte Datei {{file|ebkus_httpd.conf}} in die Apachekonfiguration eingebunden wird, z.B. durch die Zeile <br />
Include c:\ebkus_installation\ebkus\ebkus_httpd.conf<br />
am Ende der Apache {{file|httpd.conf}}. Außerdem muss man nach der Installation und der Umkonfigurierung den Webserver manuell neu starten, damit er die neue Konfiguration übernimmt.<br />
<br />
=== Anpassen der Konfiguration ===<br />
<br />
In der Konfigurationsdatei {{file|ebkus.conf}} gibt es die Systemabschnitte {{code|[DEFAULT], [ebkus], [apache]}} und {{code|[openssl]}} sowie je einen Abschnitt für jede zu installierende Instanz.<br />
<br />
Dokumentation aller Konfigurationsvariablen siehe [[Konfiguration]].<br />
<br />
==== Systemabschnitte ====<br />
<br />
Im Abschnitt {{code|[apache]}} wird für die Variable {{konfig|server_name}} typischerweise die IP-Adresse des Rechners eingetragen. Es kann auch {{code|0.0.0.0}} genommen werden, wenn der Rechner über mehrere Netzwerkkarten mit unterschiedlichen IP-Nummern verfügt und EBKuS über alle erreichbar sein soll. Der Standardwert ist hier {{code|localhost}}, womit EBKuS nur auf dem lokalen Rechner erreichbar wäre.<br />
<br />
Falls die Standardports 80 und 443 nicht für EBKuS zur Verfügung stehen, müssen hier alternative freie Ports eingetragen werden. {{konfig|server_http_port}} dient nur zur Kontrolle des Apache Webservers ({{code|<nowiki>http://localhost/</nowiki>}} liefert "It works!"). Falls eine Alternative für {{konfig|server_https_port}} eingetragen wird, muss der Port in der URL aufgeführt werden, um die Anwendung anzusprechen.<br />
<br />
SSL-Zertifikate werden bei der Installation automatisch erzeugt und die Pfade werden als Werte der Konfiguationsvariablen {{konfig|ssl_certificate_file}} und {{konfig|ssl_certificate_key_file}}<br />
eingetragen. Es handelt sich um selbssignierte Zertifikate, die beim erstmaligen Aufruf mit dem Browser Sicherheitswarnungen auslösen, die man ignorieren muss, um auf die Anwendung zuzugreifen.<br />
Wenn man über eigene Zertifikate verfügt, kann man die Pfade hier eintragen.<br />
<br />
Des weiteren kann die Email-Adresse des Systemadministrators bei {{konfig| server_admin}} eingetragen werden (die evt. auf Fehlerseiten des Servers erscheint). Im Abschnitt {{code|[openssl]}} sollten die regionalen und organisatorischen Angaben angepasst werden, da sie auf dem erzeugten Zertifikat erscheinen (das man sich z.B. im Browser ansehen kann).<br />
<br />
Sie können ein Passwort setzen für die Datenbankuser {{code|root}} (der Instanzdatenbanken löschen und erstellen kann):<br />
C:\>cd ebkus_installation\mysql5.1\bin<br />
C:\ebkus_installation\mysql5.1\bin>mysqladmin.exe -uroot password ''Neues Passwort''<br />
Dies muss dem Konfigurationsparameter {{konfig|database_admin_password}} zugewiesen werden.<br />
<br />
Alle anderen Werte in den Systemabschnitten sollten nur in Ausnahmefällen verändert werden.<br />
<br />
==== Instanzen ====<br />
<br />
Der Name des Abschnitts muss identisch sein mit dem Wert der Variablen {{konfig|instance_name}}. Der Name muss mit einem Buchstaben beginnen und darf neben Ziffern und Buchstaben nur das Sonderzeichen '_' enthalten.<br />
<br />
Mit der Variablen {{konfig|initial_content}} kann man einer Instanz eine Datei mit einem Datenbankdump (Sicherungsdatei) zuweisen, mit dem die Instanz initialisiert wird:<br />
initial_content: C:\backup\demo_braunschweig_backup_v4.8_2020-06-17_02-10-00.zip<br />
bzw.<br />
initial_content: demo_braunschweig_backup_v4.8_2020-06-17_02-10-00.zip<br />
Wenn nur der Dateiname angegeben ist, muss die Datei im Homeverzeichnis liegen ({{file|c:\ebkus_installation\ebkus\}}).<br />
Damit ist es möglich, eine Instanz aus einer bestehenden Installation in eine Neuinstallation zu migrieren (siehe unten). <br />
<br />
Jede Instanz benötigt einen eigenen freien Port (Variable {{konfig|port}}).<br />
<br />
=== Installation ohne Internetzugang ===<br />
<br />
Wenn alle [http://www.ebkus.org/alle_downloads.html benötigte Software für Windows 32 bit] in das Verzeichnis {{file|c:\ebkus_installation\download}} kopiert werden, wird kein Internetzugang benötigt. <br />
<br />
Alternativ kann beim ersten Aufruf von {{code|install.py}} ein Downloadverzeichnis angegeben werden, in dem sich die Installationsdateien befinden müssen:<br />
C:\EBKuS-4.10.1>python install.py -d c:\ebkus_download c:\ebkus_installation<br />
Wenn bereits eine {{file|ebkus.conf}} existiert, wird das in der Variable {{konfig|download_dir}} definierte Verzeichnis verwendet und die Option {{code|-d}} kann entfallen.<br />
<br />
=== Migration ===<br />
<br />
Die Migration beinhaltet die Übernahme der Instanzen aus einer bestehenden EBKuS-Installation in eine Neuinstallation mit der neuen Software. Die EBKuS-Version der bestehenden Installation muss mindestens 4.7 sein; ältere müssen erst im Rahmen der bestehenden Installation updatet werden.<br />
<br />
==== Vorbereitung ====<br />
<br />
Für die Migration muss eine für die Neuinstallation gültige {{file|ebkus.conf}} bereitgestellt werden sowie eine Sicherungsdatei für jede zu migrierende Instanz. Die Sicherungsdatei wird in der alten Installation mit dem Skript {{code|datenbank_sichern.py --zip ''Verzeichnis''}} erzeugt.<br />
Die Zuordnung wird wie oben beschrieben für jede Instanz über die Konfigurationsvariable {{konfig|initial_content}} vorgenommen (nur Dateiname, ohne Pfadangabe). Ansonsten werden die Konfigurationen der Instanzen aus der alten {{file|ebkus.conf}} übernommen. Die Systemabschnitte für die neue {{file|ebkus.conf}} werden wie oben beschrieben aus der Testinstallation bzw. der Erstkonfiguration übernommen.<br />
<br />
==== Neuinstallation ====<br />
<br />
Die neu erstellte {{file|ebkus.conf}} wird zusammen mit den Sicherungsdateien in ein Verzeichnis kopiert, z.B. {{file|c:\ebkus_preconfig}}.<br />
Vor der Neuinstallation sollte die alte Installation mit {{code|uninstall.py}} deinstalliert werden. Insbesondere sollte im Installationsverzeichnis<br />
kein Verzeichnis {{code|ebkus}} mehr existieren.<br />
Dem {{code|install.py}}-Skript wird das Verzeichnis mit der Option {{code|-p}} übergeben:<br />
C:\EBKuS-4.10.1>python install.py -p c:\ebkus_preconfig c:\ebkus_installation<br />
Vor der Installation wird dann der Inhalt dieses Verzeichnisses vom Skript in das Homeverzeichnis kopiert, so dass die Installation durch die neue {{file|ebkus.conf}} gesteuert wird. <br />
<br />
=== Einzelne Instanzen ===<br />
<br />
==== Entfernen ====<br />
<br />
Mit Hilfe des {{code|uninstall.py}}-Skripts lassen sich auch einzelne Instanzen entfernen.<br />
C:\EBKuS-4.10.1>python uninstall.py c:\ebkus_installation ''Instanzname''<br />
Das {{code|uninstall.py}}-Skript kann auch aus dem Homeverzeichnis aufgerufen werden.<br />
<br />
Wichtig: Den Konfigurationsabschnitt der Instanz in der {{file|ebkus.conf}} erst nach der erfolgreichen Deinstallation entfernen! Sonst ist Handarbeit angesagt.<br />
<br />
==== Hinzufügen ====<br />
<br />
Als erstes muss in der {{file|ebkus.conf}} ein Abschnitt für die neu zu erstellende Instanz erstellt werden, evt. mit Angabe einer Sicherungsdatei oder eines SQL-Dumps für die Initialisierung der Datenbank der Instanz (Variable {{konfig|initial_content}}). <br />
<br />
Die Instanz kann dann mit<br />
C:\>cd ebkus_installation\ebkus<br />
C:\ebkus_installation\ebkus>python configure.py ''Instanzname''<br />
eingerichtet werden. <br />
<br />
Wenn keine Datei zur Initialisierung angegeben wird, wird eine Datenbank mit den Standardmerkmalskatalogen und einem evt. konfigurierten Straßenkatalog erstellt. Wenn der Instanzname mit {{code|demo}} beginnt, werden zusätzlich Demodaten generiert.<br />
<br />
=== Mögliche Probleme ===<br />
<br />
* Windows-Dienste werden nicht automatisch installiert: die Konsole muss als Administrator ausgeführt werden.<br />
* Nicht vollständig deinstallierte Dienste: notfalls mit {{code|sc delete ''Name''}} entfernen. Wenn der Name dann trotzdem noch in der Liste der Dienste auftaucht mit dem Zustand {{code|Deaktiviert}}, muss ein Neustart gemacht werden.<br />
* Übrig gebliebene Reste in der Registry von früheren Installationen, z.B. des MySQL-Servers. Diese müssen notfalls manuell beseitigt werden.<br />
* Instanz lässt sich nicht mit Sicherungsdatei initialisieren: Die Sicherungsdatei muss von einer Instanz mit demselben Namen stammen.<br />
* Automatischer Download klappt nicht: Falls der Internetzugang über einen Proxy erfolgt, muss man möglicherweise (ich habs nicht probiert) manuell herunterladen und die Dateien im Downloadverzeichnis ablegen.<br />
* Firefox akzeptiert das von EBKuS gelieferte Zertifikat (wg. doppelter Seriennummer oder so ähnlich): Zertifikate in Firefox löschen über {{pfad5|Einstellungen|Erweitert|Zertifikate|Zertifikate anzeigen|Löschen}}. Die EBKuS-Zertifikate stehen unter dem Namen EFB bzw. unter dem Namen, der in der {{file|ebkus.conf}} als {{konfig|organisation}} (im Abschnitt {{konfig|openssl}}) eingetragen wurde.<br />
<br />
=== Tipps ===<br />
<br />
* Das {{code|install.py}}-Skript lässt sich wiederholt ausführen. Eine bestehende MySQL- und Apache-Installation wird nicht wiederholt. Vorhandene Instanzdatenbanken bleiben ebenfalls intakt. Evt. neu hinzugekommenen Instanzkonfigurationen werden ausgeführt, d.h. die neue Instanz wird eingerichtet. (Löschen einer Instanz jedoch immer mit {{code|uninstall.py}}!) Alle zu generierenden Dateien werden neu generiert, so dass z.B. auf diese Weise Port-Änderungen oder die Änderung des Servernamens durchgeführt werden können.<br />
* Wenn das {{code|install.py}}-Skript mit der Option {{code|-u}} bzw. {{code|--update}} wiederholt wird, werden zusätzlich alle EBKuS-Dateien aus der Distribution in das Homeverzeichnis kopiert. <br />
* Hilfe für alle Skripte erhält man mit der Option {{code|--help}} oder kurz {{code|-h}}:<br />
C:\EBKuS-4.10.1>python install.py --help<br />
C:\EBKuS-4.10.1>python uninstall.py -h<br />
C:\ebkus_installation\ebkus>python configure.py -h<br />
C:\ebkus_installation\ebkus\demo>python dienst.py -h<br />
* Falls Änderungen an generierten Dateien nötig sind (z.B. Apache- oder MySQL-Konfiguration) ist es wenig sinnvoll, diese selbst zu verändern, da man dann nicht mehr die Möglichkeit hat, die Installationsskripte zu verwenden. Besser ist is es, die Templates selber anzupassen. Alle Templates (Vorlagen) für generierte Dateien finden sich im Verzeichnis {{file|templates}} im Homeverzeichnis.</div>Ebkushttps://www.ebkus.org/wiki/Linux_InstallationLinux Installation2020-11-19T12:51:32Z<p>Ebkus: </p>
<hr />
<div>Gültig ab: EBKuS 4.10<br />
<br />
Die folgende Anleitung habe ich mit "Debian GNU/Linux 10 (buster)" getestet; vermutlich funktioniert das auch auf anderen Ubuntu bzw. Debian-basierten Gnu/Linux-Distributionen.<br />
<br />
Die Installation im folgenden Beispiel erfolgt unter dem User {{code|ebkus}} auf einem Rechner mit dem Namen {{code|ebvm}}. Der User {{code|ebkus}} benötigt Superuserrechte ({{code|sudo}}). Es wird angenommen, dass eine Internetverbindung besteht (zur Installation von Software mit {{code|apt-get}}).<br />
<br />
Die Installation erfolgt ausschließlich über die Kommandozeile. Damit funktioniert sie auch auf reinen Servern, die keine GUI haben.<br />
<br />
Bitte auch die [[Windows Installation]] beachten, da sind einige betriebssystemunabhängige Punkte ausführlicher dargestellt als hier.<br />
<br />
=== Voraussetzungen ===<br />
<br />
Folgende Voraussetzungen müssen erfüllt sein, damit EBKuS installiert werden kann:<br />
<br />
==== Python 2.7 ====<br />
<br />
Ist auf solche Systemen normalerweise bereits installiert, ansonsten:<br />
<br />
ebkus@ebvm:~$ sudo apt-get install python2.7<br />
<br />
Die Python Version sollte 2.7.13 oder höher sein, optimalerweise<br />
2.7.18, welches die letzte Python-2-Version darstellt.<br />
Python 2 wird nicht mehr weiterentwickelt wird. EBKuS ist noch nicht<br />
auf Python 3 portiert.<br />
<br />
==== MySQL ====<br />
<br />
Es sollte eine MySQL 5.*-Version zur Verfügung stehen, z.B. 5.1, 5.6<br />
oder 5.7. Zur Installation auf Debian 10 siehe zum Beispiel<br />
https://tecadmin.net/install-mysql-on-debian-10-buster/<br />
Kurz zusammengefasst wie folgt:<br />
<br />
1. System auf den neuesten Stand bringen:<br />
<br />
ebkus@ebvm:~$ sudo apt update <br />
ebkus@ebvm:~$ sudo apt upgrade<br />
<br />
2. PPA (Personal Package Archive, Paketquelle) von MySQL einrichten und MySQL-Installation konfigurieren:<br />
<br />
ebkus@ebvm:~$ wget <nowiki>http://repo.mysql.com/mysql-apt-config_0.8.15-1_all.deb</nowiki><br />
ebkus@ebvm:~$ sudo dpkg -i mysql-apt-config_0.8.15-1_all.deb<br />
<br />
Beim letzten Schritt unbedingt ein MySQL 5 auswählen, also 5.6<br />
oder 5.7! EBKuS wurde noch nicht auf höheren Versionen getestet.<br />
<br />
3. MySQL installieren:<br />
<br />
ebkus@ebvm:~$ sudo apt update <br />
ebkus@ebvm:~$ sudo apt install mysql-community-server<br />
<br />
Bei der Installation muss ein Passwort für den Datenbank-User {{code|root}} angegeben werden, das später in die {{file|ebkus.conf}} eingetragen werden muss. Nach einer erfolgreichen Installation kann man sich mit dem Befehl<br />
<br />
ebkus@ebvm:~$ mysql -uroot -p''Passwort''<br />
Welcome to the MySQL monitor. Commands end with ; or \g.<br />
...<br />
mysql><br />
<br />
mit der Datenbank verbinden.<br />
<br />
Falls der Standardport 3306 für MySQL nicht zur Verfügung steht, muss die Datei {{file|/etc/mysql/my.cnf}} angepasst werden.<br />
<br />
==== Python-MySQLdb ====<br />
<br />
Den Datenbankadapter für Python-MySQL installieren:<br />
ebkus@ebvm:~$ sudo apt-get install python-mysqldb<br />
Nach erfolgreicher Installation kann man Python aufrufen und MySQLdb importieren:<br />
ebkus@ebvm:~$ python<br />
Python 2.7.16 (default, Oct 10 2019, 22:02:15)<br />
...<br />
>>> import MySQLdb<br />
>>><br />
<br />
==== Apache 2 ====<br />
<br />
Den Webserver installieren:<br />
ebkus@ebvm:~$ sudo apt-get install apache2<br />
Nach der erfolgreichen Installation erhält man mit einem Browser mit der Adresse <nowiki>http://localhost/</nowiki> eine Seite mit '''It works!'''. Oder man installiert z.B. {{code|wget}} und erhält mit der genannten Adresse die entsprechende HTML-Datei {{file|index.html}}:<br />
ebkus@ebvm:~$ sudo apt-get install wget<br />
ebkus@ebvm:~$ wget <nowiki>http://localhost/</nowiki><br />
<br />
Falls der Webserver nicht auf den Standardports 80 und 443 laufen soll, muss die Datei {{file|/etc/apache2/ports.conf}} angepasst werden, ebenso die {{file|ebkus.conf}} (siehe [[Konfiguration]])<br />
<br />
Um den Webserver zu konfigurieren, müssen das ssl-Modul und das<br />
cgi-Modul aktiviert werden:<br />
ebkus@ebvm:~$ sudo a2enmod ssl<br />
ebkus@ebvm:~$ sudo a2enmod cgi<br />
<br />
Außerdem muss die von EBKuS generierte Apache-Konfigurationsdatei eingebunden werden:<br />
ebkus@ebvm:~$ cd /etc/apache2/sites-enabled<br />
ebkus@ebvm:/etc/apache2/sites-enabled$ sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl.conf<br />
Die Datei {{file|ebkus_httpd.conf}} existiert zu diesem Zeitpunkt noch nicht, sie wird bei der Installation ({{file|install.py}}) und bei jeder Änderung von Instanzen ({{file|configure.py}}) neu generiert. Sie definiert einen Virtual Host für den Webserver, über den alle EBKuS-Instanzen angesprochen werden.<br />
<br />
'''Dateirechte:''' Alle Verzeichnisse, die in einem Pfad zu einer Datei stehen, die vom Webserver gelesen werden soll, müssen das Leserecht und das Ausführungsrecht besitzen. Wenn das Installationsverzeichnis wie im Beispiel im Homeverzeichnis eines Benutzers steht, müssen diese Rechte evt. explizit vergeben werden:<br />
ebkus@ebvm:~$ sudo chmod go+rx /home/ebkus <br />
Den vom Installationsskript erzeugten Verzeichnissen und Dateien werden diese Rechte automatisch gegeben.<br />
<br />
<br />
==== EBKuS ====<br />
<br />
Die neueste [http://www.ebkus.org/alle_downloads.html EBKuS-Software]<br />
herunterladen, auspacken und in das Distributionsverzeichnis gehen, z.B.:<br />
<br />
ebkus@ebkusvm1:~$ wget https://ebkus.org/downloads/ebkus-4.10/ebkus-4.10-src.zip<br />
ebkus@ebkusvm1:~$ unzip ebkus-4.10-src.zip<br />
ebkus@ebkusvm1:~$ cd EBKuS-4.10<br />
ebkus@ebkusvm1:~/EBKuS-4.10$<br />
<br />
=== Installation ===<br />
<br />
==== Erstkonfiguration ====<br />
<br />
Erstkonfiguration erzeugen:<br />
ebkus@ebkusvm1:~/EBKuS-4.10$ python install.py -c ~/ebkus_installation<br />
Die EBKuS-Konfigurationsdatei {{file|/home/ebkus/ebkus_installation/ebkus/ebkus.conf}} kann nun weiter bearbeitet und für die eigentliche Installation verwendet werden.<br />
<br />
==== Systemkonfiguration ====<br />
<br />
System-[[Konfiguration]] anpassen, insbesondere:<br />
* Passwort für Datenbank-User {{code|root}} eintragen (Parameter {{konfig|database_admin_password}})<br />
* {{konfig|server_name}}, normalerweise die IP-Nummer des Rechners<br />
* Evt. Standardports {{konfig|server_https_port}} und {{konfig|server_http_port}} anpassen<br />
* {{konfig| server_admin}}<br />
* Im Abschnitt {{code|openssl}} Angaben zur Region und Organisation<br />
<br />
==== Instanzkonfiguration ====<br />
<br />
Instanz-[[Konfiguration]] anpassen:<br />
* {{konfig|instance_name}}, optional {{konfig|instance_title}}<br />
* {{konfig|initial_content}}, falls eine initiale Datenbank vorhanden ist (z.B. aus einer früheren Installation)<br />
* {{konfig|port}}<br />
<br />
==== Installation ====<br />
<br />
Installation:<br />
ebkus@ebkusvm1:~/EBKuS-4.10$ python install.py ~/ebkus_installation<br />
Bei der Installation wird man unter Umständen nach dem Passwort des (Linux-)Users gefragt, dasselbe, das man bei einem vorangestellten {{code|sudo}} angeben muss. Damit können die start/stop-Skripte in die Bootsequenz ({{file|/etc/init.d/}}) eingetragen werden<br />
<br />
Nach der Installation (und auch nach jeder Umkonfigurierung mit {{file|configure.py}}) muss der Webserver neu gestartet werden:<br />
ebkus@ebvm:~$ sudo service apache2 restart<br />
* Restarting web server apache2 [ OK ]<br />
Ansonsten wird die neu generierte Webserver-Konfiguration in {{file|ebkus_httpd.conf}} nicht wirksam.<br />
<br />
==== Migration ====<br />
<br />
Falls wie [[Windows_Installation#Migration|hier]] beschrieben eine Menge von bestehenden Instanzen in die neue Installation übernommen werden soll:<br />
ebkus@ebkusvm1:~/EBKuS-4.10$ python install.py -p ~/ebkus_preconfig ~/ebkus_installation<br />
Im Verzeichnis {{file|~/ebkus_preconfig}} muss dann eine gültige {{file|ebkus.conf}} liegen sowie eine Sicherungsdatei für jede Instanz, die in der Konfiguration über den Parameter {{konfig|initial_content}} eingebunden wird.<br />
<br />
=== Dienste ===<br />
<br />
Im Unterschied zu [[Windows Installation|Windows]] werden bei der Installation und der Konfigurierung keine Dienste gestartet oder gestoppt. Es werden jedoch Skripte in {{file|/etc/init.d}} generiert, mit denen die EBKuS-Server hoch und runtergefahren werden. Beim booten des Systems geschieht dies automatisch, d.h. nach einem Reboot steht EBKuS automatisch zur Verfügung.<br />
<br />
Für den Systemadministrator gibt es folgende Skripte, die nach der Installation im Homeverzeichnis stehen:<br />
* {{code|ebkusctl}}: Damit kann jede Instanz einzeln oder auch alle Instanzen gemeinsam hoch- und runtergefahren werden sowie deren Status abgefragt werden. Dieses Skript verwendet intern die generierten Skripte in {{file|/etc/init.d}}.<br />
* {{code|ebkusdump}}: Für jede Instanz einzeln oder für alle zusammen eine Sicherungsdatei erzeugen (verwendet intern {{file|datenbank_sichern.py||}}).<br />
* {{code|ebkusrestore}}: Für jede Instanz einzeln oder für alle zusammen die Datenbank aus eine Sicherungsdatei initialisieren (verwendet intern {{file| datenbank_initialisieren.py||}}).<br />
Z.B.<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl all start<br />
* Starting EBKuS demo [ OK ] <br />
* Starting EBKuS muster_efb [ OK ] <br />
* Starting EBKuS demo_braunschweig [ OK ] <br />
Jedes Skript hat eingebaute Hilfe:<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl --help<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl -h<br />
<br />
<br />
<br />
<br />
<br />
<!--<br />
<br />
Schritte:<br />
<br />
#`Installationsverzeichnis`_ einrichten, z.B. {{code|/home/user/ebinst}}:<br />
mkdir /home/user/ebinst<br />
#In das `Distributionsverzeichnis`_ gehen (z.B. {{code|/home/user/ebkus-cd/ebkus-3.3}}; man könnte hier auch direkt von der CD arbeiten):<br />
<br />
<br />
cd /home/user/ebkus-cd/ebkus-3.3<br />
#EBKuS-Konfiguration erzeugen:<br />
python install.py --config /home/user/ebinst<br />
#Erzeugte Konfigurationsdatei {{code|/home/user/ebinst/ebkus/ebkus.conf}}anpassen (siehe `Konfiguration`_).<br />
#EBKuS und alle in der Konfigurationsdatei definierten Instanzen installieren und konfigurieren:<br />
python install.py /home/user/ebinst<br />
Für jede in der Konfiguration definierten Instanz gibt es dann ein `Instanzverzeichnis`_:<br />
<br />
<blockquote>{{code|/home/user/ebinst/ebkus/}}''Instanzname''<br />
<br />
</blockquote><br />
Die Meldungen des Installationsskriptes stehen auch in der Datei {{code|/home/user/ebinst/install.log}}.<br />
<br />
#(als {{code|root}}) Die in Schritt 5. erzeugte Datei {{code|/home/user/ebinst/ebkus/ebkus_httpd.conf}} in die Apache-Konfigurationsdatei (bei SuSE z.B. /etc/httpd/httpd.conf) inkludieren, z.B. indem Sie dort am Ende die folgende Zeile eintragen:<br />
Include /home/user/ebinst/ebkus/ebkus_httpd.conf<br />
#(als {{code|root}}) Den Apache-Webserver neustarten, damit die modifizierte Konfiguration berücksichtigt wird, z.B. bei SuSE:<br />
rcapache restart<br />
#Eine konfigurierte EBKuS-Instanz testen, z.B. die Instanz demo:<br />
cd /home/user/ebinst/ebkus/demo <br />
./start.py --console<br />
Der gestartete Server gibt Meldungen auf die Konsole aus.<br />
<br />
#Über einen Browser mit der Instanz {{code|demo}} arbeiten (anstatt {{code|demo}} auch mit jeder anderen in der `Konfiguration`_definierten Instanz):<br />
https://localhost/ebkus/demo/cgi/do/login<br />
Die Login-Maske kann auch über eine vorgeschaltete Eingangsseite erreicht werden, die für jede Instanz generiert wird:<br />
<br />
https://localhost/ebkus/demo/index.html<br />
Diese Seite kann mit einem HTML-Editor gemäß den lokalen Bedürfnissen erweitert oder verändert werden. Die zu editierende Datei ist im `Instanzverzeichnis`_ unter {{code|htdocs/index.html}} zu finden.<br />
<br />
Als Administrator anmelden: Benutzer {{code|Admin}}, Passwort {{code|Admin}}. Als angemeldeter Administrator können Sie weitere Benutzer anlegen.<br />
<br />
Die Instanzen {{code|demo}} bzw. {{code|demo_berlin}} enthalten bereits Beispieldaten, mit denen Sie experimentieren können. Sie können sich also gleich als Bearbeiter bzw. als Verwaltungskraft anmelden, z.B. Benutzer {{code|test}}, Passwort {{code|test}} bzw. Benutzer {{code|verw}}, Passwort {{code|verw}}.<br />
<br />
Falls Sie in der Konfiguration den Parameter ''server_name'' mit einer in Ihrem Netzwerk gültigen IP-Adresse oder einem gültigen Namen belegt haben, können Sie auch von anderen Rechnern im Netzwerk auf eine EBKuS-Instanz zugreifen, z.B.:<br />
<br />
https://192.168.1.92/ebkus/demo/index.html https://192.168.1.92/ebkus/demo/cgi/do/login<br />
#(als {{code|root}}) Die Instanz in die Bootsequenz des Servers aufnehmen, so dass beim Hochfahren des Rechners der EBKuS-Server für die Instanz automatisch gestartet wird:<br />
cd /home/user/ebinst/ebkus/demo cp ebkus_demo /etc/init.d<br />
Die Links für die Run-Level manuell setzen oder, z.B. bei SuSE, den Run-Level-Editor verwenden.<br />
<br />
#In einer Produktionsinstanz die Anwendung einrichten, siehe Einrichtung der Anwendung im Handbuch.<br />
<br />
<br />
<br />
<br />
- Apache richtig löschen, so dass frische Konfig kommt:<br />
<br />
- sudo dpkg --purge --force-remove-reinstreq apache2.2-common<br />
<br />
So geht richtiges uninstall mit Konfiguration:<br />
apt-get remove ––purge *paketname*<br />
<br />
<br />
<br />
- download mit wget auf dem ubuntu server<br />
<br />
<br />
<br />
== Apache Konfiguration ==<br />
<br />
cd /etc/apache2/mods-enabled<br />
sudo ln -s ../mods-available/ssl.conf ssl.conf<br />
sudo ln -s ../mods-available/ssl.load ssl.load<br />
<br />
cd /etc/apache2/sites-enabled<br />
sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl<br />
http://ebkus.org/wiki/Linux_Installation#MySQL<br />
http://ebkus.org/wiki/Linux_Installation#Apache_2<br />
<br />
--></div>Ebkushttps://www.ebkus.org/wiki/Windows_InstallationWindows Installation2020-08-22T17:07:07Z<p>Ebkus: </p>
<hr />
<div>Gültig ab: EBKuS 4.10. (Frühere Versionen lassen sich aber ganz ähnlich installieren.)<br />
<br />
<br />
=== Benötigte Software ===<br />
<br />
* [https://www.python.org/ftp/python/2.7.18/python-2.7.18.msi Python 2.7.18]<br />
* [https://files.pythonhosted.org/packages/27/06/596ae3afeefc0cda5840036c42920222cb8136c101ec0f453f2e36df12a0/MySQL-python-1.2.5.win32-py2.7.exe MySQL-python-1.2.5]<br />
* [https://github.com/mhammond/pywin32/releases/download/b228/pywin32-228.win32-py2.7.exe pywin32-228]<br />
* [http://ftp.gwdg.de/pub/misc/mysql/Downloads/MySQL-5.1/mysql-essential-5.1.73-win32.msi MySQL 5.1.73]<br />
* [https://archive.apache.org/dist/httpd/binaries/win32/httpd-2.2.25-win32-x86-openssl-0.9.8y.msi Apache 2.2]<br />
<br />
Alle benötigten Dateien befinden sich auch auf dem [https://ebkus.org/downloads/win32/ EBKuS FTP-Server]. <br />
Nur die ersten drei müssen manuell heruntergeladen<br />
und installiert werden. Die übrigen werden bei Bedarf automatisch<br />
heruntergeladen (sofern eine Internetverbindung besteht, ansonsten siehe unten).<br />
<br />
Natürlich muss noch die neueste <br />
[http://www.ebkus.org/alle_downloads.html EBKuS-Software]<br />
selbst heruntergeladen werden. <br />
<br />
=== Sonstige Voraussetzungen ===<br />
<br />
* '''Betriebssystem''': Erfolgreich getestet auf Windows 10 Professional. Windows Server 2008 und später sowie auch frühere Windows Versionen sind möglich.<br />
* Die von einer EBKuS-Installation verwendeten '''Ports''' dürfen nicht anderweitig verwendete werden:<br />
** Port 443 für den Apache-Webserver mit SSL-Verschlüsselung (kann mit der Konfigurationsvariablen {{konfig|server_https_port}} verändert werden)<br />
** Port 80 für den Apache-Webserver ohne SSL-Verschlüsselung (kann mit der Konfigurationsvariablen {{konfig|server_http_port}} verändert werden). Dieser Port wird allerdings von der Anwendung nicht benötigt; man kann damit aber überprüfen, ob der Webserver installiert ist unabhängig von EBKuS-Instanzen.<br />
** Port 3306 für den MySQL-Datenbankserver <br />
** Die in der {{file|ebkus.conf||}} explizit genannten Ports für die EBKuS-Instanzen<br />
* '''Administratorrechte''' für die Installation. Insbesondere muss bei neueren Windows-Systemen die Kommandozeile explizit mit Administratorrechten aufgerufen werden (rechtsklicken, mit Administratorrechten ausführen). Sonst gelingt die Einrichtung der Dienste nicht.<br />
* Die von EBKuS verwendeten '''Namen für Dienste''' dürfen nicht in Gebrauch sein: {{code|Apache, MySQL}} sowie die mit {{code|EBKuS}} beginnenden Namen für die Instanzen.<br />
* Keine Reste in der Registry von früheren Installationsversuchen :-)<br />
<br />
=== Python installieren ===<br />
<br />
Zuerst Python<br />
* {{code|python-2.7.18.msi}}<br />
und dann PyWin und MySQL-python<br />
* {{code|pywin32-228.win32-py2.7.exe}}<br />
* {{code|MySQL-python-1.2.5.win32-py2.7.exe}}<br />
installieren. Standardinstallation für alle Benutzer. Zur Kontrolle kann man {{pfad4|Start|Programme|Python 2.7|Python (command line)}} aufrufen und dort folgende Eingaben machen:<br />
>>> import win32service<br />
>>><br />
>>> import MySQLdb<br />
>>><br />
Beide Importe müssen ohne Fehlermeldungen funktionieren.<br />
<br />
=== Nur Erstkonfiguration erzeugen ===<br />
<br />
Die Beispiele gehen davon aus, dass die heruntergeladene EBKuS-Software im Verzeichnis {{file|C:\EBKuS-4.10}} liegt.<br />
<br />
Wenn man die Option {{code|-c}} bzw. {{code|--config}} des {{code|install-py}}-Skripts verwendet, wird lediglich die Konfigurationsdatei {{file|c:\ebkus_installation\ebkus\ebkus.conf}} erzeugt und nichts weiter installiert. <br />
C:\>cd EBKuS-4.10<br />
C:\EBKuS-4.10>python install.py -c c:\ebkus_installation<br />
Die so entstandene {{file|c:\ebkus_installation\ebkus\ebkus.conf}} kann nun weiter bearbeitet und in der eigentlichen Installation verwendet werden.<br />
<br />
=== Vollautomatische Testinstallation ===<br />
<br />
Falls die oben genannten Voraussetzungen erfüllt sind (insbesondere freie Standardports 80 und 443), kann man eine vollautomatische Erstinstallation vornehmen (Eingabeaufforderung mit Administratorrechten ausführen!):<br />
C:\>cd EBKuS-4.10<br />
C:\EBKuS-4.10>python install.py c:\ebkus_installation<br />
Den Fortgang der Installation sieht man auf der Konsole und in der Datei {{file|c:\ebkus_installation\install.log}}.<br />
<br />
Wenn alles gut gegangen ist, erhält man eine funktionierende EBKuS-Installation mit zwei Instanzen, {{code|demo}} und {{code|muster_efb}}. Es gibt dann 4 neue Windows-Dienste: Apache, MySQL, EBKuS-demo und EBKuS-muster_efb. Den Zugriff auf die Instanzen erhält man über die URL {{code|<nowiki>https://localhost/ebkus/demo/</nowiki>}} bzw. {{code|.../muster_efb/}}.<br />
<br />
Die dabei entstandene Datei {{file|c:\ebkus_installation\ebkus\ebkus.conf}} sollte man sichern, da sie den Ausgangspunkt für die endgültige Installation darstellt.<br />
<br />
Die Testinstallation kann dann ganz oder teilweise wieder deinstalliert werden:<br />
C:\EBKuS-4.10>python uninstall.py --all c:\ebkus_installation<br />
bzw.<br />
C:\EBKuS-4.10>python uninstall.py c:\ebkus_installation ebkus<br />
Im ersten Fall wird auch der Webserver und die Datenbank deinstalliert, im zweiten nur die eigentliche EBKuS-Installation mitsamt allen Instanzen.<br />
<br />
=== Installation mit vorhandenem Webserver und Datenbank ===<br />
<br />
Mit<br />
C:\EBKuS-4.10>python install.py --no_mysql --no_apache c:\ebkus_installation<br />
kann man eine Installation durchführen, wenn Apache und MySQL bereits vorhanden sind und nicht durch die EBKuS-Installation bereitgestellt werden sollen. Das Vorgehen ist dann ähnlich der [[Linux_Installation]]. Es muss manuell dafür gesorgt werden, dass die generierte Datei {{file|ebkus_httpd.conf}} in die Apachekonfiguration eingebunden wird, z.B. durch die Zeile <br />
Include c:\ebkus_installation\ebkus\ebkus_httpd.conf<br />
am Ende der Apache {{file|httpd.conf}}. Außerdem muss man nach der Installation und der Umkonfigurierung den Webserver manuell neu starten, damit er die neue Konfiguration übernimmt.<br />
<br />
=== Anpassen der Konfiguration ===<br />
<br />
In der Konfigurationsdatei {{file|ebkus.conf}} gibt es die Systemabschnitte {{code|[DEFAULT], [ebkus], [apache]}} und {{code|[openssl]}} sowie je einen Abschnitt für jede zu installierende Instanz.<br />
<br />
Dokumentation aller Konfigurationsvariablen siehe [[Konfiguration]].<br />
<br />
==== Systemabschnitte ====<br />
<br />
Im Abschnitt {{code|[apache]}} wird für die Variable {{konfig|server_name}} typischerweise die IP-Adresse des Rechners eingetragen. Es kann auch {{code|0.0.0.0}} genommen werden, wenn der Rechner über mehrere Netzwerkkarten mit unterschiedlichen IP-Nummern verfügt und EBKuS über alle erreichbar sein soll. Der Standardwert ist hier {{code|localhost}}, womit EBKuS nur auf dem lokalen Rechner erreichbar wäre.<br />
<br />
Falls die Standardports 80 und 443 nicht für EBKuS zur Verfügung stehen, müssen hier alternative freie Ports eingetragen werden. {{konfig|server_http_port}} dient nur zur Kontrolle des Apache Webservers ({{code|<nowiki>http://localhost/</nowiki>}} liefert "It works!"). Falls eine Alternative für {{konfig|server_https_port}} eingetragen wird, muss der Port in der URL aufgeführt werden, um die Anwendung anzusprechen.<br />
<br />
SSL-Zertifikate werden bei der Installation automatisch erzeugt und die Pfade werden als Werte der Konfiguationsvariablen {{konfig|ssl_certificate_file}} und {{konfig|ssl_certificate_key_file}}<br />
eingetragen. Es handelt sich um selbssignierte Zertifikate, die beim erstmaligen Aufruf mit dem Browser Sicherheitswarnungen auslösen, die man ignorieren muss, um auf die Anwendung zuzugreifen.<br />
Wenn man über eigene Zertifikate verfügt, kann man die Pfade hier eintragen.<br />
<br />
Des weiteren kann die Email-Adresse des Systemadministrators bei {{konfig| server_admin}} eingetragen werden (die evt. auf Fehlerseiten des Servers erscheint). Im Abschnitt {{code|[openssl]}} sollten die regionalen und organisatorischen Angaben angepasst werden, da sie auf dem erzeugten Zertifikat erscheinen (das man sich z.B. im Browser ansehen kann).<br />
<br />
Sie können ein Passwort setzen für die Datenbankuser {{code|root}} (der Instanzdatenbanken löschen und erstellen kann):<br />
C:\>cd ebkus_installation\mysql5.1\bin<br />
C:\ebkus_installation\mysql5.1\bin>mysqladmin.exe -uroot password ''Neues Passwort''<br />
Dies muss dem Konfigurationsparameter {{konfig|database_admin_password}} zugewiesen werden.<br />
<br />
Alle anderen Werte in den Systemabschnitten sollten nur in Ausnahmefällen verändert werden.<br />
<br />
==== Instanzen ====<br />
<br />
Der Name des Abschnitts muss identisch sein mit dem Wert der Variablen {{konfig|instance_name}}. Der Name muss mit einem Buchstaben beginnen und darf neben Ziffern und Buchstaben nur das Sonderzeichen '_' enthalten.<br />
<br />
Mit der Variablen {{konfig|initial_content}} kann man einer Instanz eine Datei mit einem Datenbankdump (Sicherungsdatei) zuweisen, mit dem die Instanz initialisiert wird:<br />
initial_content: C:\backup\demo_braunschweig_backup_v4.10_2020-06-17_02-10-00.zip<br />
bzw.<br />
initial_content: demo_braunschweig_backup_v4.10_2020-06-17_02-10-00.zip<br />
Wenn nur der Dateiname angegeben ist, muss die Datei im Homeverzeichnis liegen ({{file|c:\ebkus_installation\ebkus\}}).<br />
Damit ist es möglich, eine Instanz aus einer bestehenden Installation in eine Neuinstallation zu migrieren (siehe unten). <br />
<br />
Jede Instanz benötigt einen eigenen freien Port (Variable {{konfig|port}}).<br />
<br />
=== Installation ohne Internetzugang ===<br />
<br />
Wenn alle [http://www.ebkus.org/alle_downloads.html benötigte Software für Windows 32 bit] in das Verzeichnis {{file|c:\ebkus_installation\download}} kopiert werden, wird kein Internetzugang benötigt. <br />
<br />
Alternativ kann beim ersten Aufruf von {{code|install.py}} ein Downloadverzeichnis angegeben werden, in dem sich die Installationsdateien befinden müssen:<br />
C:\EBKuS-4.5>python install.py -d c:\ebkus_download c:\ebkus_installation<br />
Wenn bereits eine {{file|ebkus.conf}} existiert, wird das in der Variable {{konfig|download_dir}} definierte Verzeichnis verwendet und die Option {{code|-d}} kann entfallen.<br />
<br />
=== Migration ===<br />
<br />
Die Migration beinhaltet die Übernahme der Instanzen aus einer bestehenden EBKuS-Installation in eine Neuinstallation mit der neuen Software. Die EBKuS-Version der bestehenden Installation muss mindestens 4.7 sein; ältere müssen erst im Rahmen der bestehenden Installation updatet werden.<br />
<br />
==== Vorbereitung ====<br />
<br />
Für die Migration muss eine für die Neuinstallation gültige {{file|ebkus.conf}} bereitgestellt werden sowie eine Sicherungsdatei für jede zu migrierende Instanz. Die Sicherungsdatei wird in der alten Installation mit dem Skript {{code|datenbank_sichern.py --zip ''Verzeichnis''}} erzeugt.<br />
Die Zuordnung wird wie oben beschrieben für jede Instanz über die Konfigurationsvariable {{konfig|initial_content}} vorgenommen (nur Dateiname, ohne Pfadangabe). Ansonsten werden die Konfigurationen der Instanzen aus der alten {{file|ebkus.conf}} übernommen. Die Systemabschnitte für die neue {{file|ebkus.conf}} werden wie oben beschrieben aus der Testinstallation bzw. der Erstkonfiguration übernommen.<br />
<br />
==== Neuinstallation ====<br />
<br />
Die neu erstellte {{file|ebkus.conf}} wird zusammen mit den Sicherungsdateien in ein Verzeichnis kopiert, z.B. {{file|c:\ebkus_preconfig}}.<br />
<br />
Dem {{code|install.py}}-Skript wird das Verzeichnis mit der Option {{code|-p}} übergeben:<br />
C:\EBKuS-4.5>python install.py -p c:\ebkus_preconfig c:\ebkus_installation<br />
Vor der Installation wird dann der Inhalt dieses Verzeichnisses in das Homeverzeichnis kopiert, so dass die Installation durch die neue {{file|ebkus.conf}} gesteuert wird. <br />
<br />
=== Einzelne Instanzen ===<br />
<br />
==== Entfernen ====<br />
<br />
Mit Hilfe des {{code|uninstall.py}}-Skripts lassen sich auch einzelne Instanzen entfernen.<br />
C:\EBKuS-4.5>python uninstall.py c:\ebkus_installation ''Instanzname''<br />
Das {{code|uninstall.py}}-Skript kann auch aus dem Homeverzeichnis aufgerufen werden.<br />
<br />
Wichtig: Den Konfigurationsabschnitt der Instanz in der {{file|ebkus.conf}} erst nach der erfolgreichen Deinstallation entfernen! Sonst ist Handarbeit angesagt.<br />
<br />
==== Hinzufügen ====<br />
<br />
Als erstes muss in der {{file|ebkus.conf}} ein Abschnitt für die neu zu erstellende Instanz erstellt werden, evt. mit Angabe einer Sicherungsdatei oder eines SQL-Dumps für die Initialisierung der Datenbank der Instanz (Variable {{konfig|initial_content}}). <br />
<br />
Die Instanz kann dann mit<br />
C:\>cd ebkus_installation\ebkus<br />
C:\ebkus_installation\ebkus>python configure.py ''Instanzname''<br />
eingerichtet werden. <br />
<br />
Wenn keine Datei zur Initialisierung angegeben wird, wird eine Datenbank mit den Standardmerkmalskatalogen und einem evt. konfigurierten Straßenkatalog erstellt. Wenn der Instanzname mit {{code|demo}} beginnt, werden zusätzlich Demodaten generiert.<br />
<br />
=== Mögliche Probleme ===<br />
<br />
* Windows-Dienste werden nicht automatisch installiert: die Konsole muss als Administrator ausgeführt werden.<br />
* Nicht vollständig deinstallierte Dienste: notfalls mit {{code|sc delete ''Name''}} entfernen. Wenn der Name dann trotzdem noch in der Liste der Dienste auftaucht mit dem Zustand {{code|Deaktiviert}}, muss ein Neustart gemacht werden.<br />
* Übrig gebliebene Reste in der Registry von früheren Installationen, z.B. des MySQL-Servers. Diese müssen notfalls manuell beseitigt werden.<br />
* Instanz lässt sich nicht mit Sicherungsdatei initialisieren: Die Sicherungsdatei muss von einer Instanz mit demselben Namen stammen.<br />
* Automatischer Download klappt nicht: Falls der Internetzugang über einen Proxy erfolgt, muss man möglicherweise (ich habs nicht probiert) manuell herunterladen und die Dateien im Downloadverzeichnis ablegen.<br />
* Firefox akzeptiert das von EBKuS gelieferte Zertifikat (wg. doppelter Seriennummer oder so ähnlich): Zertifikate in Firefox löschen über {{pfad5|Einstellungen|Erweitert|Zertifikate|Zertifikate anzeigen|Löschen}}. Die EBKuS-Zertifikate stehen unter dem Namen EFB bzw. unter dem Namen, der in der {{file|ebkus.conf}} als {{konfig|organisation}} (im Abschnitt {{konfig|openssl}}) eingetragen wurde.<br />
<br />
=== Tipps ===<br />
<br />
* Das {{code|install.py}}-Skript lässt sich wiederholt ausführen. Eine bestehende MySQL- und Apache-Installation wird nicht wiederholt. Vorhandene Instanzdatenbanken bleiben ebenfalls intakt. Evt. neu hinzugekommenen Instanzkonfigurationen werden ausgeführt, d.h. die neue Instanz wird eingerichtet. (Löschen einer Instanz jedoch immer mit {{code|uninstall.py}}!) Alle zu generierenden Dateien werden neu generiert, so dass z.B. auf diese Weise Port-Änderungen oder die Änderung des Servernamens durchgeführt werden können.<br />
* Wenn das {{code|install.py}}-Skript mit der Option {{code|-u}} bzw. {{code|--update}} wiederholt wird, werden zusätzlich alle EBKuS-Dateien aus der Distribution in das Homeverzeichnis kopiert. <br />
* Hilfe für alle Skripte erhält man mit der Option {{code|--help}} oder kurz {{code|-h}}:<br />
C:\EBKuS-4.5>python install.py --help<br />
C:\EBKuS-4.5>python uninstall.py -h<br />
C:\ebkus_installation\ebkus>python configure.py -h<br />
C:\ebkus_installation\ebkus\demo>python dienst.py -h<br />
* Falls Änderungen an generierten Dateien nötig sind (z.B. Apache- oder MySQL-Konfiguration) ist es wenig sinnvoll, diese selbst zu verändern, da man dann nicht mehr die Möglichkeit hat, die Installationsskripte zu verwenden. Besser ist is es, die Templates selber anzupassen. Alle Templates (Vorlagen) für generierte Dateien finden sich im Verzeichnis {{file|templates}} im Homeverzeichnis.</div>Ebkushttps://www.ebkus.org/wiki/Windows_InstallationWindows Installation2020-08-22T16:58:03Z<p>Ebkus: </p>
<hr />
<div>Gültig ab: EBKuS 4.10. (Frühere Versionen lassen sich aber ganz ähnlich installieren.)<br />
<br />
<br />
=== Benötigte Software ===<br />
<br />
* [https://www.python.org/ftp/python/2.7.18/python-2.7.18.msi Python 2.7.18]<br />
* [https://files.pythonhosted.org/packages/27/06/596ae3afeefc0cda5840036c42920222cb8136c101ec0f453f2e36df12a0/MySQL-python-1.2.5.win32-py2.7.exe MySQL-python-1.2.5]<br />
* [https://github.com/mhammond/pywin32/releases/download/b228/pywin32-228.win32-py2.7.exe pywin32-228]<br />
* [http://ftp.gwdg.de/pub/misc/mysql/Downloads/MySQL-5.1/mysql-essential-5.1.73-win32.msi MySQL 5.1.73]<br />
* [https://archive.apache.org/dist/httpd/binaries/win32/httpd-2.2.25-win32-x86-openssl-0.9.8y.msi Apache 2.2]<br />
<br />
Alle benötigten Dateien befinden sich auch auf dem [https://ebkus.org/downloads/win32/ EBKuS FTP-Server]. <br />
Nur die ersten drei müssen manuell heruntergeladen<br />
und installiert werden. Die übrigen werden bei Bedarf automatisch<br />
heruntergeladen (sofern eine Internetverbindung besteht, ansonsten siehe unten).<br />
<br />
Natürlich muss noch die neueste <br />
[http://www.ebkus.org/alle_downloads.html EBKuS-Software]<br />
selbst heruntergeladen werden. <br />
<br />
=== Sonstige Voraussetzungen ===<br />
<br />
* '''Betriebssystem''': Erfolgreich getestet auf Windows 10 Professional. Windows Server 2008 und später sowie auch frühere Windows Versionen sind möglich.<br />
* Die von einer EBKuS-Installation verwendeten '''Ports''' dürfen nicht anderweitig verwendete werden:<br />
** Port 443 für den Apache-Webserver mit SSL-Verschlüsselung (kann mit der Konfigurationsvariablen {{konfig|server_https_port}} verändert werden)<br />
** Port 80 für den Apache-Webserver ohne SSL-Verschlüsselung (kann mit der Konfigurationsvariablen {{konfig|server_http_port}} verändert werden). Dieser Port wird allerdings von der Anwendung nicht benötigt; man kann damit aber überprüfen, ob der Webserver installiert ist unabhängig von EBKuS-Instanzen.<br />
** Port 3306 für den MySQL-Datenbankserver <br />
** Die in der {{file|ebkus.conf||}} explizit genannten Ports für die EBKuS-Instanzen<br />
* '''Administratorrechte''' für die Installation. Insbesondere muss bei neueren Windows-Systemen die Kommandozeile explizit mit Administratorrechten aufgerufen werden (rechtsklicken, mit Administratorrechten ausführen). Sonst gelingt die Einrichtung der Dienste nicht.<br />
* Die von EBKuS verwendeten '''Namen für Dienste''' dürfen nicht in Gebrauch sein: {{code|Apache, MySQL}} sowie die mit {{code|EBKuS}} beginnenden Namen für die Instanzen.<br />
* Keine Reste in der Registry von früheren Installationsversuchen :-)<br />
<br />
=== Python installieren ===<br />
<br />
Zuerst Python<br />
* {{code|python-2.7.18.msi}}<br />
und dann PyWin und MySQL-python<br />
* {{code|pywin32-228.win32-py2.7.exe}}<br />
* {{code|MySQL-python-1.2.5.win32-py2.7.exe}}<br />
installieren. Standardinstallation für alle Benutzer. Zur Kontrolle kann man {{pfad4|Start|Programme|Python 2.7|Python (command line)}} aufrufen und dort folgende Eingaben machen:<br />
>>> import win32service<br />
>>><br />
>>> import MySQLdb<br />
>>><br />
Beide Importe müssen ohne Fehlermeldungen funktionieren.<br />
<br />
=== Nur Erstkonfiguration erzeugen ===<br />
<br />
Die Beispiele gehen davon aus, dass die heruntergeladene EBKuS-Software im Verzeichnis {{file|C:\EBKuS-4.10}} liegt.<br />
<br />
Wenn man die Option {{code|-c}} bzw. {{code|--config}} des {{code|install-py}}-Skripts verwendet, wird lediglich die Konfigurationsdatei {{file|c:\ebkus_installation\ebkus\ebkus.conf}} erzeugt und nichts weiter installiert. <br />
C:\>cd EBKuS-4.10<br />
C:\EBKuS-4.10>python install.py -c c:\ebkus_installation<br />
Die so entstandene {{file|c:\ebkus_installation\ebkus\ebkus.conf}} kann nun weiter bearbeitet und in der eigentlichen Installation verwendet werden.<br />
<br />
=== Vollautomatische Testinstallation ===<br />
<br />
Falls die oben genannten Voraussetzungen erfüllt sind (insbesondere freie Standardports 80 und 443), kann man eine vollautomatische Erstinstallation vornehmen (Eingabeaufforderung mit Administratorrechten ausführen!):<br />
C:\>cd EBKuS-4.10<br />
C:\EBKuS-4.10>python install.py c:\ebkus_installation<br />
Den Fortgang der Installation sieht man auf der Konsole und in der Datei {{file|c:\ebkus_installation\install.log}}.<br />
<br />
Wenn alles gut gegangen ist, erhält man eine funktionierende EBKuS-Installation mit zwei Instanzen, {{code|demo}} und {{code|muster_efb}}. Es gibt dann 4 neue Windows-Dienste: Apache, MySQL, EBKuS-demo und EBKuS-muster_efb. Den Zugriff auf die Instanzen erhält man über die URL {{code|<nowiki>https://localhost/ebkus/demo/</nowiki>}} bzw. {{code|.../muster_efb/}}.<br />
<br />
Die dabei entstandene Datei {{file|c:\ebkus_installation\ebkus\ebkus.conf}} sollte man sichern, da sie den Ausgangspunkt für die endgültige Installation darstellt.<br />
<br />
Die Testinstallation kann dann ganz oder teilweise wieder deinstalliert werden:<br />
C:\EBKuS-4.10>python uninstall.py --all c:\ebkus_installation<br />
bzw.<br />
C:\EBKuS-4.10>python uninstall.py c:\ebkus_installation ebkus<br />
Im ersten Fall wird auch der Webserver und die Datenbank deinstalliert, im zweiten nur die eigentliche EBKuS-Installation mitsamt allen Instanzen.<br />
<br />
=== Installation mit vorhandenem Webserver und Datenbank ===<br />
<br />
Mit<br />
C:\EBKuS-4.10>python install.py --no_mysql --no_apache c:\ebkus_installation<br />
kann man eine Installation durchführen, wenn Apache und MySQL bereits vorhanden sind und nicht durch die EBKuS-Installation bereitgestellt werden sollen. Das Vorgehen ist dann ähnlich der [[Linux_Installation]]. Es muss manuell dafür gesorgt werden, dass die generierte Datei {{file|ebkus_httpd.conf}} in die Apachekonfiguration eingebunden wird, z.B. durch die Zeile <br />
Include c:\ebkus_installation\ebkus\ebkus_httpd.conf<br />
am Ende der Apache {{file|httpd.conf}}. Außerdem muss man nach der Installation und der Umkonfigurierung den Webserver manuell neu starten, damit er die neue Konfiguration übernimmt.<br />
<br />
=== Anpassen der Konfiguration ===<br />
<br />
In der Konfigurationsdatei {{file|ebkus.conf}} gibt es die Systemabschnitte {{code|[DEFAULT], [ebkus], [apache]}} und {{code|[openssl]}} sowie je einen Abschnitt für jede zu installierende Instanz.<br />
<br />
Dokumentation aller Konfigurationsvariablen siehe [[Konfiguration]].<br />
<br />
==== Systemabschnitte ====<br />
<br />
Im Abschnitt {{code|[apache]}} wird für die Variable {{konfig|server_name}} typischerweise die IP-Adresse des Rechners eingetragen. Es kann auch {{code|0.0.0.0}} genommen werden, wenn der Rechner über mehrere Netzwerkkarten mit unterschiedlichen IP-Nummern verfügt und EBKuS über alle erreichbar sein soll. Der Standardwert ist hier {{code|localhost}}, womit EBKuS nur auf dem lokalen Rechner erreichbar wäre.<br />
<br />
Falls die Standardports 80 und 443 nicht für EBKuS zur Verfügung stehen, müssen hier alternative freie Ports eingetragen werden. {{konfig|server_http_port}} dient nur zur Kontrolle des Apache Webservers ({{code|<nowiki>http://localhost/</nowiki>}} liefert "It works!"). Falls eine Alternative für {{konfig|server_https_port}} eingetragen wird, muss der Port in der URL aufgeführt werden, um die Anwendung anzusprechen.<br />
<br />
SSL-Zertifikate werden bei der Installation automatisch erzeugt und die Pfade werden als Werte der Konfiguationsvariablen {{konfig|ssl_certificate_file}} und {{konfig|ssl_certificate_key_file}}<br />
eingetragen. Es handelt sich um selbssignierte Zertifikate, die beim erstmaligen Aufruf mit dem Browser Sicherheitswarnungen auslösen, die man ignorieren muss, um auf die Anwendung zuzugreifen.<br />
Wenn man über eigene Zertifikate verfügt, kann man die Pfade hier eintragen.<br />
<br />
Des weiteren kann die Email-Adresse des Systemadministrators bei {{konfig| server_admin}} eingetragen werden (die evt. auf Fehlerseiten des Servers erscheint). Im Abschnitt {{code|[openssl]}} sollten die regionalen und organisatorischen Angaben angepasst werden, da sie auf dem erzeugten Zertifikat erscheinen (das man sich z.B. im Browser ansehen kann).<br />
<br />
Sie können ein Passwort setzen für die Datenbankuser {{code|root}} (der Instanzdatenbanken löschen und erstellen kann):<br />
C:\>cd ebkus_installation\mysql5.1\bin<br />
C:\ebkus_installation\mysql5.1\bin>mysqladmin.exe -uroot password ''Neues Passwort''<br />
Dies muss dem Konfigurationsparameter {{konfig|database_admin_password}} zugewiesen werden.<br />
<br />
Alle anderen Werte in den Systemabschnitten sollten nur in Ausnahmefällen verändert werden.<br />
<br />
==== Instanzen ====<br />
<br />
Der Name des Abschnitts muss identisch sein mit dem Wert der Variablen {{konfig|instance_name}}. Der Name muss mit einem Buchstaben beginnen und darf neben Ziffern und Buchstaben nur das Sonderzeichen '_' enthalten.<br />
<br />
Mit der Variablen {{konfig|initial_content}} kann man einer Instanz eine Datei mit einem Datenbankdump (Sicherungsdatei) zuweisen, mit dem die Instanz initialisiert wird:<br />
initial_content: C:\backup\demo_braunschweig_backup_v4.4.1_2011-06-17_02-10-00.zip<br />
bzw.<br />
initial_content: demo_braunschweig_backup_v4.4.1_2011-06-17_02-10-00.zip<br />
Wenn nur der Dateiname angegeben ist, muss die Datei im Homeverzeichnis liegen ({{file|c:\ebkus_installation\ebkus\}}).<br />
Damit ist es möglich, eine Instanz aus einer bestehenden Installation in eine Neuinstallation zu migrieren (siehe unten). <br />
<br />
Jede Instanz benötigt einen eigenen freien Port (Variable {{konfig|port}}).<br />
<br />
=== Installation ohne Internetzugang ===<br />
<br />
Wenn alle [http://www.ebkus.org/alle_downloads.html benötigte Software für Windows 32 bit] in das Verzeichnis {{file|c:\ebkus_installation\download}} kopiert werden, wird kein Internetzugang benötigt. <br />
<br />
Alternativ kann beim ersten Aufruf von {{code|install.py}} ein Downloadverzeichnis angegeben werden, in dem sich die Installationsdateien befinden müssen:<br />
C:\EBKuS-4.5>python install.py -d c:\ebkus_download c:\ebkus_installation<br />
Wenn bereits eine {{file|ebkus.conf}} existiert, wird das in der Variable {{konfig|download_dir}} definierte Verzeichnis verwendet und die Option {{code|-d}} kann entfallen.<br />
<br />
=== Migration ===<br />
<br />
Die Migration beinhaltet die Übernahme der Instanzen aus einer bestehenden EBKuS-Installation in eine Neuinstallation mit der neuen Software. Die EBKuS-Version der bestehenden Installation muss mindestens 4.2 sein; ältere müssen erst im Rahmen der bestehenden Installation updatet werden.<br />
<br />
==== Vorbereitung ====<br />
<br />
Für die Migration muss eine für die Neuinstallation gültige {{file|ebkus.conf}} bereitgestellt werden sowie eine Sicherungsdatei für jede zu migrierende Instanz. Die Sicherungsdatei wird in der alten Installation mit dem Skript {{code|datenbank_sichern.py --zip ''Verzeichnis''}} erzeugt.<br />
Die Zuordnung wird wie oben beschrieben für jede Instanz über die Konfigurationsvariable {{konfig|initial_content}} vorgenommen (nur Dateiname, ohne Pfadangabe). Ansonsten werden die Konfigurationen der Instanzen aus der alten {{file|ebkus.conf}} übernommen. Die Systemabschnitte für die neue {{file|ebkus.conf}} werden wie oben beschrieben aus der Testinstallation bzw. der Erstkonfiguration übernommen.<br />
<br />
==== Neuinstallation ====<br />
<br />
Die neu erstellte {{file|ebkus.conf}} wird zusammen mit den Sicherungsdateien in ein Verzeichnis kopiert, z.B. {{file|c:\ebkus_preconfig}}.<br />
<br />
Dem {{code|install.py}}-Skript wird das Verzeichnis mit der Option {{code|-p}} übergeben:<br />
C:\EBKuS-4.5>python install.py -p c:\ebkus_preconfig c:\ebkus_installation<br />
Vor der Installation wird dann der Inhalt dieses Verzeichnisses in das Homeverzeichnis kopiert, so dass die Installation durch die neue {{file|ebkus.conf}} gesteuert wird. <br />
<br />
=== Einzelne Instanzen ===<br />
<br />
==== Entfernen ====<br />
<br />
Mit Hilfe des {{code|uninstall.py}}-Skripts lassen sich auch einzelne Instanzen entfernen.<br />
C:\EBKuS-4.5>python uninstall.py c:\ebkus_installation ''Instanzname''<br />
Das {{code|uninstall.py}}-Skript kann auch aus dem Homeverzeichnis aufgerufen werden.<br />
<br />
Wichtig: Den Konfigurationsabschnitt der Instanz in der {{file|ebkus.conf}} erst nach der erfolgreichen Deinstallation entfernen! Sonst ist Handarbeit angesagt.<br />
<br />
==== Hinzufügen ====<br />
<br />
Als erstes muss in der {{file|ebkus.conf}} ein Abschnitt für die neu zu erstellende Instanz erstellt werden, evt. mit Angabe einer Sicherungsdatei oder eines SQL-Dumps für die Initialisierung der Datenbank der Instanz (Variable {{konfig|initial_content}}). <br />
<br />
Die Instanz kann dann mit<br />
C:\>cd ebkus_installation\ebkus<br />
C:\ebkus_installation\ebkus>python configure.py ''Instanzname''<br />
eingerichtet werden. <br />
<br />
Wenn keine Datei zur Initialisierung angegeben wird, wird eine Datenbank mit den Standardmerkmalskatalogen und einem evt. konfigurierten Straßenkatalog erstellt. Wenn der Instanzname mit {{code|demo}} beginnt, werden zusätzlich Demodaten generiert.<br />
<br />
=== Mögliche Probleme ===<br />
<br />
* Windows-Dienste werden nicht automatisch installiert: die Konsole muss als Administrator ausgeführt werden.<br />
* Nicht vollständig deinstallierte Dienste: notfalls mit {{code|sc delete ''Name''}} entfernen. Wenn der Name dann trotzdem noch in der Liste der Dienste auftaucht mit dem Zustand {{code|Deaktiviert}}, muss ein Neustart gemacht werden.<br />
* Übrig gebliebene Reste in der Registry von früheren Installationen, z.B. des MySQL-Servers. Diese müssen notfalls manuell beseitigt werden.<br />
* Instanz lässt sich nicht mit Sicherungsdatei initialisieren: Die Sicherungsdatei muss von einer Instanz mit demselben Namen stammen.<br />
* Automatischer Download klappt nicht: Falls der Internetzugang über einen Proxy erfolgt, muss man möglicherweise (ich habs nicht probiert) manuell herunterladen und die Dateien im Downloadverzeichnis ablegen.<br />
* Firefox akzeptiert das von EBKuS gelieferte Zertifikat (wg. doppelter Seriennummer oder so ähnlich): Zertifikate in Firefox löschen über {{pfad5|Einstellungen|Erweitert|Zertifikate|Zertifikate anzeigen|Löschen}}. Die EBKuS-Zertifikate stehen unter dem Namen EFB bzw. unter dem Namen, der in der {{file|ebkus.conf}} als {{konfig|organisation}} (im Abschnitt {{konfig|openssl}}) eingetragen wurde.<br />
<br />
=== Tipps ===<br />
<br />
* Das {{code|install.py}}-Skript lässt sich wiederholt ausführen. Eine bestehende MySQL- und Apache-Installation wird nicht wiederholt. Vorhandene Instanzdatenbanken bleiben ebenfalls intakt. Evt. neu hinzugekommenen Instanzkonfigurationen werden ausgeführt, d.h. die neue Instanz wird eingerichtet. (Löschen einer Instanz jedoch immer mit {{code|uninstall.py}}!) Alle zu generierenden Dateien werden neu generiert, so dass z.B. auf diese Weise Port-Änderungen oder die Änderung des Servernamens durchgeführt werden können.<br />
* Wenn das {{code|install.py}}-Skript mit der Option {{code|-u}} bzw. {{code|--update}} wiederholt wird, werden zusätzlich alle EBKuS-Dateien aus der Distribution in das Homeverzeichnis kopiert. <br />
* Hilfe für alle Skripte erhält man mit der Option {{code|--help}} oder kurz {{code|-h}}:<br />
C:\EBKuS-4.5>python install.py --help<br />
C:\EBKuS-4.5>python uninstall.py -h<br />
C:\ebkus_installation\ebkus>python configure.py -h<br />
C:\ebkus_installation\ebkus\demo>python dienst.py -h<br />
* Falls Änderungen an generierten Dateien nötig sind (z.B. Apache- oder MySQL-Konfiguration) ist es wenig sinnvoll, diese selbst zu verändern, da man dann nicht mehr die Möglichkeit hat, die Installationsskripte zu verwenden. Besser ist is es, die Templates selber anzupassen. Alle Templates (Vorlagen) für generierte Dateien finden sich im Verzeichnis {{file|templates}} im Homeverzeichnis.</div>Ebkushttps://www.ebkus.org/wiki/Windows_InstallationWindows Installation2020-08-22T16:48:59Z<p>Ebkus: </p>
<hr />
<div>Gültig ab: EBKuS 4.10. (Frühere Versionen lassen sich aber ganz ähnlich installieren.)<br />
<br />
<br />
=== Benötigte Software ===<br />
<br />
* [https://www.python.org/ftp/python/2.7.18/python-2.7.18.msi Python 2.7.18]<br />
* [https://files.pythonhosted.org/packages/27/06/596ae3afeefc0cda5840036c42920222cb8136c101ec0f453f2e36df12a0/MySQL-python-1.2.5.win32-py2.7.exe MySQL-python-1.2.5]<br />
* [https://github.com/mhammond/pywin32/releases/download/b228/pywin32-228.win32-py2.7.exe pywin32-228]<br />
* [http://ftp.gwdg.de/pub/misc/mysql/Downloads/MySQL-5.1/mysql-essential-5.1.73-win32.msi MySQL 5.1.73]<br />
* [https://archive.apache.org/dist/httpd/binaries/win32/httpd-2.2.25-win32-x86-openssl-0.9.8y.msi Apache 2.2]<br />
<br />
Alle benötigten Dateien befinden sich auch auf dem [https://ebkus.org/downloads/win32/ EBKuS FTP-Server]. <br />
Nur die ersten drei müssen manuell heruntergeladen<br />
und installiert werden. Die übrigen werden bei Bedarf automatisch<br />
heruntergeladen (sofern eine Internetverbindung besteht, ansonsten siehe unten).<br />
<br />
Natürlich muss noch die neueste <br />
[http://www.ebkus.org/alle_downloads.html EBKuS-Software]<br />
selbst heruntergeladen werden. <br />
<br />
=== Sonstige Voraussetzungen ===<br />
<br />
* '''Betriebssystem''': Erfolgreich getestet auf Windows 10 Professional. Windows Server 2008 und später sowie auch frühere Windows Versionen sind möglich.<br />
* Die von einer EBKuS-Installation verwendeten '''Ports''' dürfen nicht anderweitig verwendete werden:<br />
** Port 443 für den Apache-Webserver mit SSL-Verschlüsselung (kann mit der Konfigurationsvariablen {{konfig|server_https_port}} verändert werden)<br />
** Port 80 für den Apache-Webserver ohne SSL-Verschlüsselung (kann mit der Konfigurationsvariablen {{konfig|server_http_port}} verändert werden). Dieser Port wird allerdings von der Anwendung nicht benötigt; man kann damit aber überprüfen, ob der Webserver installiert ist unabhängig von EBKuS-Instanzen.<br />
** Port 3306 für den MySQL-Datenbankserver <br />
** Die in der {{file|ebkus.conf||}} explizit genannten Ports für die EBKuS-Instanzen<br />
* '''Administratorrechte''' für die Installation. Insbesondere muss bei neueren Windows-Systemen die Kommandozeile explizit mit Administratorrechten aufgerufen werden (rechtsklicken, mit Administratorrechten ausführen). Sonst gelingt die Einrichtung der Dienste nicht.<br />
* Die von EBKuS verwendeten '''Namen für Dienste''' dürfen nicht in Gebrauch sein: {{code|Apache, MySQL}} sowie die mit {{code|EBKuS}} beginnenden Namen für die Instanzen.<br />
* Keine Reste in der Registry von früheren Installationsversuchen :-)<br />
<br />
=== Python installieren ===<br />
<br />
Zuerst Python<br />
* {{code|python-2.7.18.msi}}<br />
und dann PyWin und MySQL-python<br />
* {{code|pywin32-228.win32-py2.7.exe}}<br />
* {{code|MySQL-python-1.2.5.win32-py2.7.exe}}<br />
installieren. Standardinstallation für alle Benutzer. Zur Kontrolle kann man {{pfad4|Start|Programme|Python 2.7|Python (command line)}} aufrufen und dort folgende Eingaben machen:<br />
>>> import win32service<br />
>>><br />
>>> import MySQLdb<br />
>>><br />
Beide Importe müssen ohne Fehlermeldungen funktionieren.<br />
<br />
=== Nur Erstkonfiguration erzeugen ===<br />
<br />
Die Beispiele gehen davon aus, dass die heruntergeladene EBKuS-Software im Verzeichnis {{file|C:\EBKuS-4.10}} liegt.<br />
<br />
Wenn man die Option {{code|-c}} bzw. {{code|--config}} des {{code|install-py}}-Skripts verwendet, wird lediglich die Konfigurationsdatei {{file|c:\ebkus_installation\ebkus\ebkus.conf}} erzeugt und nichts weiter installiert. <br />
C:\>cd EBKuS-4.10<br />
C:\EBKuS-4.10>python install.py -c c:\ebkus_installation<br />
Die so entstandene {{file|c:\ebkus_installation\ebkus\ebkus.conf}} kann nun weiter bearbeitet und in der eigentlichen Installation verwendet werden.<br />
<br />
=== Vollautomatische Testinstallation ===<br />
<br />
Falls die oben genannten Voraussetzungen erfüllt sind (insbesondere freie Standardports 80 und 443), kann man eine vollautomatische Erstinstallation vornehmen (Eingabeaufforderung mit Administratorrechten ausführen!):<br />
C:\>cd EBKuS-4.10<br />
C:\EBKuS-4.10>python install.py c:\ebkus_installation<br />
Den Fortgang der Installation sieht man auf der Konsole und in der Datei {{file|c:\ebkus_installation\install.log}}.<br />
<br />
Wenn alles gut gegangen ist, erhält man eine funktionierende EBKuS-Installation mit zwei Instanzen, {{code|demo}} und {{code|muster_efb}}. Es gibt dann 4 neue Windows-Dienste: Apache, MySQL, EBKuS-demo und EBKuS-muster_efb. Den Zugriff auf die Instanzen erhält man über die URL {{code|<nowiki>https://localhost/ebkus/demo/</nowiki>}} bzw. {{code|.../muster_efb/}}.<br />
<br />
Die dabei entstandene Datei {{file|c:\ebkus_installation\ebkus\ebkus.conf}} sollte man sichern, da sie den Ausgangspunkt für die endgültige Installation darstellt.<br />
<br />
Die Testinstallation kann dann ganz oder teilweise wieder deinstalliert werden:<br />
C:\EBKuS-4.10>python uninstall.py --all c:\ebkus_installation<br />
bzw.<br />
C:\EBKuS-4.10>python uninstall.py c:\ebkus_installation ebkus<br />
Im ersten Fall wird auch der Webserver und die Datenbank deinstalliert, im zweiten nur die eigentliche EBKuS-Installation mitsamt allen Instanzen.<br />
<br />
=== Installation mit vorhandenem Webserver und Datenbank ===<br />
<br />
Mit<br />
C:\EBKuS-4.10>python install.py --no_mysql --no_apache c:\ebkus_installation<br />
kann man eine Installation durchführen, wenn Apache und MySQL bereits vorhanden sind und nicht durch die EBKuS-Installation bereitgestellt werden sollen. Das Vorgehen ist dann ähnlich der [[Linux_Installation]]. Es muss manuell dafür gesorgt werden, dass die generierte Datei {{file|ebkus_httpd.conf}} in die Apachekonfiguration eingebunden wird, z.B. durch die Zeile <br />
Include c:\ebkus_installation\ebkus\ebkus_httpd.conf<br />
am Ende der Apache {{file|httpd.conf}}. Außerdem muss man nach der Installation und der Umkonfigurierung den Webserver manuell neu starten, damit er die neue Konfiguration übernimmt.<br />
<br />
=== Anpassen der Konfiguration ===<br />
<br />
In der Konfigurationsdatei {{file|ebkus.conf}} gibt es die Systemabschnitte {{code|[DEFAULT], [ebkus], [apache]}} und {{code|[openssl]}} sowie je einen Abschnitt für jede zu installierende Instanz.<br />
<br />
Dokumentation aller Konfigurationsvariablen siehe [[Konfiguration]].<br />
<br />
==== Systemabschnitte ====<br />
<br />
Im Abschnitt {{code|[apache]}} wird für die Variable {{konfig|server_name}} typischerweise die IP-Adresse des Rechners eingetragen. Es kann auch {{code|0.0.0.0}} genommen werden, wenn der Rechner über mehrere Netzwerkkarten mit unterschiedlichen IP-Nummern verfügt und EBKuS über alle erreichbar sein soll. Der Standardwert ist hier {{code|localhost}}, womit EBKuS nur auf dem lokalen Rechner erreichbar wäre.<br />
<br />
Falls die Standardports 80 und 443 nicht für EBKuS zur Verfügung stehen, müssen hier alternative freie Ports eingetragen werden. {{konfig|server_http_port}} dient nur zur Kontrolle des Apache Webservers ({{code|<nowiki>http://localhost/</nowiki>}} liefert "It works!"). Falls eine Alternative für {{konfig|server_https_port}} eingetragen wird, muss der Port in der URL aufgeführt werden, um die Anwendung anzusprechen.<br />
<br />
Des weiteren kann die Email-Adresse des Systemadministrators bei {{konfig| server_admin}} eingetragen werden (die evt. auf Fehlerseiten des Servers erscheint). Im Abschnitt {{code|openssl}} sollten die regionalen und organisatorischen Angaben angepasst werden, da sie auf dem erzeugten Zertifikat erscheinen (das man sich z.B. im Browser ansehen kann).<br />
<br />
Sie können ein Passwort setzen für die Datenbankuser {{code|root}} (der Instanzdatenbanken löschen und erstellen kann):<br />
C:\>cd ebkus_installation\mysql5.1\bin<br />
C:\ebkus_installation\mysql5.1\bin>mysqladmin.exe -uroot password ''Neues Passwort''<br />
Dies muss dem Konfigurationsparameter {{konfig|database_admin_password}} zugewiesen werden.<br />
<br />
Alle anderen Werte in den Systemabschnitten sollten nur in Ausnahmefällen verändert werden.<br />
<br />
==== Instanzen ====<br />
<br />
Der Name des Abschnitts muss identisch sein mit dem Wert der Variablen {{konfig|instance_name}}. Der Name muss mit einem Buchstaben beginnen und darf neben Ziffern und Buchstaben nur das Sonderzeichen '_' enthalten.<br />
<br />
Mit der Variablen {{konfig|initial_content}} kann man einer Instanz eine Datei mit einem Datenbankdump (Sicherungsdatei) zuweisen, mit dem die Instanz initialisiert wird:<br />
initial_content: C:\backup\demo_braunschweig_backup_v4.4.1_2011-06-17_02-10-00.zip<br />
bzw.<br />
initial_content: demo_braunschweig_backup_v4.4.1_2011-06-17_02-10-00.zip<br />
Wenn nur der Dateiname angegeben ist, muss die Datei im Homeverzeichnis liegen ({{file|c:\ebkus_installation\ebkus\}}).<br />
Damit ist es möglich, eine Instanz aus einer bestehenden Installation in eine Neuinstallation zu migrieren (siehe unten). <br />
<br />
Jede Instanz benötigt einen eigenen freien Port (Variable {{konfig|port}}).<br />
<br />
=== Installation ohne Internetzugang ===<br />
<br />
Wenn alle [http://www.ebkus.org/alle_downloads.html benötigte Software für Windows 32 bit] in das Verzeichnis {{file|c:\ebkus_installation\download}} kopiert werden, wird kein Internetzugang benötigt. <br />
<br />
Alternativ kann beim ersten Aufruf von {{code|install.py}} ein Downloadverzeichnis angegeben werden, in dem sich die Installationsdateien befinden müssen:<br />
C:\EBKuS-4.5>python install.py -d c:\ebkus_download c:\ebkus_installation<br />
Wenn bereits eine {{file|ebkus.conf}} existiert, wird das in der Variable {{konfig|download_dir}} definierte Verzeichnis verwendet und die Option {{code|-d}} kann entfallen.<br />
<br />
=== Migration ===<br />
<br />
Die Migration beinhaltet die Übernahme der Instanzen aus einer bestehenden EBKuS-Installation in eine Neuinstallation mit der neuen Software. Die EBKuS-Version der bestehenden Installation muss mindestens 4.2 sein; ältere müssen erst im Rahmen der bestehenden Installation updatet werden.<br />
<br />
==== Vorbereitung ====<br />
<br />
Für die Migration muss eine für die Neuinstallation gültige {{file|ebkus.conf}} bereitgestellt werden sowie eine Sicherungsdatei für jede zu migrierende Instanz. Die Sicherungsdatei wird in der alten Installation mit dem Skript {{code|datenbank_sichern.py --zip ''Verzeichnis''}} erzeugt.<br />
Die Zuordnung wird wie oben beschrieben für jede Instanz über die Konfigurationsvariable {{konfig|initial_content}} vorgenommen (nur Dateiname, ohne Pfadangabe). Ansonsten werden die Konfigurationen der Instanzen aus der alten {{file|ebkus.conf}} übernommen. Die Systemabschnitte für die neue {{file|ebkus.conf}} werden wie oben beschrieben aus der Testinstallation bzw. der Erstkonfiguration übernommen.<br />
<br />
==== Neuinstallation ====<br />
<br />
Die neu erstellte {{file|ebkus.conf}} wird zusammen mit den Sicherungsdateien in ein Verzeichnis kopiert, z.B. {{file|c:\ebkus_preconfig}}.<br />
<br />
Dem {{code|install.py}}-Skript wird das Verzeichnis mit der Option {{code|-p}} übergeben:<br />
C:\EBKuS-4.5>python install.py -p c:\ebkus_preconfig c:\ebkus_installation<br />
Vor der Installation wird dann der Inhalt dieses Verzeichnisses in das Homeverzeichnis kopiert, so dass die Installation durch die neue {{file|ebkus.conf}} gesteuert wird. <br />
<br />
=== Einzelne Instanzen ===<br />
<br />
==== Entfernen ====<br />
<br />
Mit Hilfe des {{code|uninstall.py}}-Skripts lassen sich auch einzelne Instanzen entfernen.<br />
C:\EBKuS-4.5>python uninstall.py c:\ebkus_installation ''Instanzname''<br />
Das {{code|uninstall.py}}-Skript kann auch aus dem Homeverzeichnis aufgerufen werden.<br />
<br />
Wichtig: Den Konfigurationsabschnitt der Instanz in der {{file|ebkus.conf}} erst nach der erfolgreichen Deinstallation entfernen! Sonst ist Handarbeit angesagt.<br />
<br />
==== Hinzufügen ====<br />
<br />
Als erstes muss in der {{file|ebkus.conf}} ein Abschnitt für die neu zu erstellende Instanz erstellt werden, evt. mit Angabe einer Sicherungsdatei oder eines SQL-Dumps für die Initialisierung der Datenbank der Instanz (Variable {{konfig|initial_content}}). <br />
<br />
Die Instanz kann dann mit<br />
C:\>cd ebkus_installation\ebkus<br />
C:\ebkus_installation\ebkus>python configure.py ''Instanzname''<br />
eingerichtet werden. <br />
<br />
Wenn keine Datei zur Initialisierung angegeben wird, wird eine Datenbank mit den Standardmerkmalskatalogen und einem evt. konfigurierten Straßenkatalog erstellt. Wenn der Instanzname mit {{code|demo}} beginnt, werden zusätzlich Demodaten generiert.<br />
<br />
=== Mögliche Probleme ===<br />
<br />
* Windows-Dienste werden nicht automatisch installiert: die Konsole muss als Administrator ausgeführt werden.<br />
* Nicht vollständig deinstallierte Dienste: notfalls mit {{code|sc delete ''Name''}} entfernen. Wenn der Name dann trotzdem noch in der Liste der Dienste auftaucht mit dem Zustand {{code|Deaktiviert}}, muss ein Neustart gemacht werden.<br />
* Übrig gebliebene Reste in der Registry von früheren Installationen, z.B. des MySQL-Servers. Diese müssen notfalls manuell beseitigt werden.<br />
* Instanz lässt sich nicht mit Sicherungsdatei initialisieren: Die Sicherungsdatei muss von einer Instanz mit demselben Namen stammen.<br />
* Automatischer Download klappt nicht: Falls der Internetzugang über einen Proxy erfolgt, muss man möglicherweise (ich habs nicht probiert) manuell herunterladen und die Dateien im Downloadverzeichnis ablegen.<br />
* Firefox akzeptiert das von EBKuS gelieferte Zertifikat (wg. doppelter Seriennummer oder so ähnlich): Zertifikate in Firefox löschen über {{pfad5|Einstellungen|Erweitert|Zertifikate|Zertifikate anzeigen|Löschen}}. Die EBKuS-Zertifikate stehen unter dem Namen EFB bzw. unter dem Namen, der in der {{file|ebkus.conf}} als {{konfig|organisation}} (im Abschnitt {{konfig|openssl}}) eingetragen wurde.<br />
<br />
=== Tipps ===<br />
<br />
* Das {{code|install.py}}-Skript lässt sich wiederholt ausführen. Eine bestehende MySQL- und Apache-Installation wird nicht wiederholt. Vorhandene Instanzdatenbanken bleiben ebenfalls intakt. Evt. neu hinzugekommenen Instanzkonfigurationen werden ausgeführt, d.h. die neue Instanz wird eingerichtet. (Löschen einer Instanz jedoch immer mit {{code|uninstall.py}}!) Alle zu generierenden Dateien werden neu generiert, so dass z.B. auf diese Weise Port-Änderungen oder die Änderung des Servernamens durchgeführt werden können.<br />
* Wenn das {{code|install.py}}-Skript mit der Option {{code|-u}} bzw. {{code|--update}} wiederholt wird, werden zusätzlich alle EBKuS-Dateien aus der Distribution in das Homeverzeichnis kopiert. <br />
* Hilfe für alle Skripte erhält man mit der Option {{code|--help}} oder kurz {{code|-h}}:<br />
C:\EBKuS-4.5>python install.py --help<br />
C:\EBKuS-4.5>python uninstall.py -h<br />
C:\ebkus_installation\ebkus>python configure.py -h<br />
C:\ebkus_installation\ebkus\demo>python dienst.py -h<br />
* Falls Änderungen an generierten Dateien nötig sind (z.B. Apache- oder MySQL-Konfiguration) ist es wenig sinnvoll, diese selbst zu verändern, da man dann nicht mehr die Möglichkeit hat, die Installationsskripte zu verwenden. Besser ist is es, die Templates selber anzupassen. Alle Templates (Vorlagen) für generierte Dateien finden sich im Verzeichnis {{file|templates}} im Homeverzeichnis.</div>Ebkushttps://www.ebkus.org/wiki/Windows_InstallationWindows Installation2020-08-22T16:44:08Z<p>Ebkus: </p>
<hr />
<div>Gültig ab: EBKuS 4.10. (Frühere Versionen lassen sich aber ganz ähnlich installieren.)<br />
<br />
<br />
=== Benötigte Software ===<br />
<br />
* [https://www.python.org/ftp/python/2.7.18/python-2.7.18.msi Python 2.7.18]<br />
* [https://files.pythonhosted.org/packages/27/06/596ae3afeefc0cda5840036c42920222cb8136c101ec0f453f2e36df12a0/MySQL-python-1.2.5.win32-py2.7.exe MySQL-python-1.2.5]<br />
* [https://github.com/mhammond/pywin32/releases/download/b228/pywin32-228.win32-py2.7.exe pywin32-228]<br />
* [http://ftp.gwdg.de/pub/misc/mysql/Downloads/MySQL-5.1/mysql-essential-5.1.73-win32.msi MySQL 5.1.73]<br />
* [https://archive.apache.org/dist/httpd/binaries/win32/httpd-2.2.25-win32-x86-openssl-0.9.8y.msi Apache 2.2]<br />
<br />
Alle benötigten Dateien befinden sich auch auf dem [https://ebkus.org/downloads/win32/ EBKuS FTP-Server]. <br />
Nur die ersten drei müssen manuell heruntergeladen<br />
und installiert werden. Die übrigen werden bei Bedarf automatisch<br />
heruntergeladen (sofern eine Internetverbindung besteht, ansonsten siehe unten).<br />
<br />
Natürlich muss noch die neueste <br />
[http://www.ebkus.org/alle_downloads.html EBKuS-Software]<br />
selbst heruntergeladen werden. <br />
<br />
=== Sonstige Voraussetzungen ===<br />
<br />
* '''Betriebssystem''': Erfolgreich getestet auf Windows 10 Professional. Windows Server 2008 und später sowie auch frühere Windows Versionen sind möglich.<br />
* Die von einer EBKuS-Installation verwendeten '''Ports''' dürfen nicht anderweitig verwendete werden:<br />
** Port 443 für den Apache-Webserver mit SSL-Verschlüsselung (kann mit der Konfigurationsvariablen {{konfig|server_https_port}} verändert werden)<br />
** Port 80 für den Apache-Webserver ohne SSL-Verschlüsselung (kann mit der Konfigurationsvariablen {{konfig|server_http_port}} verändert werden). Dieser Port wird allerdings von der Anwendung nicht benötigt; man kann damit aber überprüfen, ob der Webserver installiert ist unabhängig von EBKuS-Instanzen.<br />
** Port 3306 für den MySQL-Datenbankserver <br />
** Die in der {{file|ebkus.conf||}} explizit genannten Ports für die EBKuS-Instanzen<br />
* '''Administratorrechte''' für die Installation. Insbesondere muss bei neueren Windows-Systemen die Kommandozeile explizit mit Administratorrechten aufgerufen werden (rechtsklicken, mit Administratorrechten ausführen). Sonst gelingt die Einrichtung der Dienste nicht.<br />
* Die von EBKuS verwendeten '''Namen für Dienste''' dürfen nicht in Gebrauch sein: {{code|Apache, MySQL}} sowie die mit {{code|EBKuS}} beginnenden Namen für die Instanzen.<br />
* Keine Reste in der Registry von früheren Installationsversuchen :-)<br />
<br />
=== Python installieren ===<br />
<br />
Zuerst Python<br />
* {{code|python-2.7.18.msi}}<br />
und dann PyWin und MySQL-python<br />
* {{code|pywin32-228.win32-py2.7.exe}}<br />
* {{code|MySQL-python-1.2.5.win32-py2.7.exe}}<br />
installieren. Standardinstallation für alle Benutzer. Zur Kontrolle kann man {{pfad4|Start|Programme|Python 2.7|Python (command line)}} aufrufen und dort folgende Eingaben machen:<br />
>>> import win32service<br />
>>><br />
>>> import MySQLdb<br />
>>><br />
Beide Importe müssen ohne Fehlermeldungen funktionieren.<br />
<br />
=== Nur Erstkonfiguration erzeugen ===<br />
<br />
Die Beispiele gehen davon aus, dass die heruntergeladene EBKuS-Software im Verzeichnis {{file|C:\EBKuS-4.10}} liegt.<br />
<br />
Wenn man die Option {{code|-c}} bzw. {{code|--config}} des {{code|install-py}}-Skripts verwendet, wird lediglich die Konfigurationsdatei {{file|c:\ebkus_installation\ebkus\ebkus.conf}} erzeugt und nichts weiter installiert. <br />
C:\>cd EBKuS-4.10<br />
C:\EBKuS-4.10>python install.py -c c:\ebkus_installation<br />
Die so entstandene {{file|c:\ebkus_installation\ebkus\ebkus.conf}} kann nun weiter bearbeitet und in der eigentlichen Installation verwendet werden.<br />
<br />
=== Vollautomatische Testinstallation ===<br />
<br />
Falls die oben genannten Voraussetzungen erfüllt sind (insbesondere freie Standardports 80 und 443), kann man eine vollautomatische Erstinstallation vornehmen (Eingabeaufforderung mit Administratorrechten ausführen!):<br />
C:\>cd EBKuS-4.10<br />
C:\EBKuS-4.10>python install.py c:\ebkus_installation<br />
Den Fortgang der Installation sieht man auf der Konsole und in der Datei {{file|c:\ebkus_installation\install.log}}.<br />
<br />
Wenn alles gut gegangen ist, erhält man eine funktionierende EBKuS-Installation mit zwei Instanzen, {{code|demo}} und {{code|muster_efb}}. Es gibt dann 4 neue Windows-Dienste: Apache, MySQL, EBKuS-demo und EBKuS-muster_efb. Den Zugriff auf die Instanzen erhält man über die URL {{code|<nowiki>https://localhost/ebkus/demo/</nowiki>}} bzw. {{code|.../muster_efb/}}.<br />
<br />
Die dabei entstandene Datei {{file|c:\ebkus_installation\ebkus\ebkus.conf}} sollte man sichern, da sie den Ausgangspunkt für die endgültige Installation darstellt.<br />
<br />
Die Testinstallation kann dann ganz oder teilweise wieder deinstalliert werden:<br />
C:\EBKuS-4.10>python uninstall.py --all c:\ebkus_installation<br />
bzw.<br />
C:\EBKuS-4.10>python uninstall.py c:\ebkus_installation ebkus<br />
Im ersten Fall wird auch der Webserver und die Datenbank deinstalliert, im zweiten nur die eigentliche EBKuS-Installation mitsamt allen Instanzen.<br />
<br />
=== Installation mit vorhandenem Webserver und Datenbank ===<br />
<br />
Mit<br />
C:\EBKuS-4.10>python install.py --no_mysql --no_apache c:\ebkus_installation<br />
kann man eine Installation durchführen, wenn Apache und MySQL bereits vorhanden sind und nicht durch die EBKuS-Installation bereitgestellt werden sollen. Das Vorgehen ist dann ähnlich der [[Linux_Installation]]. Es muss manuell dafür gesorgt werden, dass die generierte Datei {{file|ebkus_httpd.conf}} in die Apachekonfiguration eingebunden wird, z.B. durch die Zeile <br />
Include c:\ebkus_installation\ebkus\ebkus_httpd.conf<br />
am Ende der Apache {{file|httpd.conf}}. Außerdem muss man nach der Installation und der Umkonfigurierung den Webserver manuell neu starten, damit er die neue Konfiguration übernimmt.<br />
<br />
=== Anpassen der Konfiguration ===<br />
<br />
In der Konfigurationsdatei {{file|ebkus.conf}} gibt es die Systemabschnitte {{code|DEFAULT, ebkus, apache}} und {{code|openssl}} sowie je einen Abschnitt für jede zu installierende Instanz.<br />
<br />
Dokumentation aller Konfigurationsvariablen siehe [[Konfiguration]].<br />
<br />
==== Systemabschnitte ====<br />
<br />
Im Abschnitt {{code|apache}} wird für die Variable {{konfig|server_name}} typischerweise die IP-Adresse des Rechners eingetragen. Es kann auch {{code|0.0.0.0}} genommen werden, wenn der Rechner über mehrere Netzwerkkarten mit unterschiedlichen IP-Nummern verfügt und EBKuS über alle erreichbar sein soll. Der Standardwert ist hier {{code|localhost}}, womit EBKuS nur auf dem lokalen Rechner erreichbar wäre.<br />
<br />
Falls die Standardports 80 und 443 nicht für EBKuS zur Verfügung stehen, müssen hier alternative freie Ports eingetragen werden. {{konfig|server_http_port}} dient nur zur Kontrolle des Apache Webservers ({{code|<nowiki>http://localhost/</nowiki>}} liefert "It works!"). Falls eine Alternative für {{konfig|server_https_port}} eingetragen wird, muss der Port in der URL aufgeführt werden, um die Anwendung anzusprechen.<br />
<br />
Des weiteren kann die Email-Adresse des Systemadministrators bei {{konfig| server_admin}} eingetragen werden (die evt. auf Fehlerseiten des Servers erscheint). Im Abschnitt {{code|openssl}} sollten die regionalen und organisatorischen Angaben angepasst werden, da sie auf dem erzeugten Zertifikat erscheinen (das man sich z.B. im Browser ansehen kann).<br />
<br />
Sie können ein Passwort setzen für die Datenbankuser {{code|root}} (der Instanzdatenbanken löschen und erstellen kann):<br />
C:\>cd ebkus_installation\mysql5.1\bin<br />
C:\ebkus_installation\mysql5.1\bin>mysqladmin.exe -uroot password ''Neues Passwort''<br />
Dies muss dem Konfigurationsparameter {{konfig|database_admin_password}} zugewiesen werden.<br />
<br />
Alle anderen Werte in den Systemabschnitten sollten nur in Ausnahmefällen verändert werden.<br />
<br />
==== Instanzen ====<br />
<br />
Der Name des Abschnitts muss identisch sein mit dem Wert der Variablen {{konfig|instance_name}}. Der Name muss mit einem Buchstaben beginnen und darf neben Ziffern und Buchstaben nur das Sonderzeichen '_' enthalten.<br />
<br />
Mit der Variablen {{konfig|initial_content}} kann man einer Instanz eine Datei mit einem Datenbankdump (Sicherungsdatei) zuweisen, mit dem die Instanz initialisiert wird:<br />
initial_content: C:\backup\demo_braunschweig_backup_v4.4.1_2011-06-17_02-10-00.zip<br />
bzw.<br />
initial_content: demo_braunschweig_backup_v4.4.1_2011-06-17_02-10-00.zip<br />
Wenn nur der Dateiname angegeben ist, muss die Datei im Homeverzeichnis liegen ({{file|c:\ebkus_installation\ebkus\}}).<br />
Damit ist es möglich, eine Instanz aus einer bestehenden Installation in eine Neuinstallation zu migrieren (siehe unten). <br />
<br />
Jede Instanz benötigt einen eigenen freien Port (Variable {{konfig|port}}).<br />
<br />
=== Installation ohne Internetzugang ===<br />
<br />
Wenn alle [http://www.ebkus.org/alle_downloads.html benötigte Software für Windows 32 bit] in das Verzeichnis {{file|c:\ebkus_installation\download}} kopiert werden, wird kein Internetzugang benötigt. <br />
<br />
Alternativ kann beim ersten Aufruf von {{code|install.py}} ein Downloadverzeichnis angegeben werden, in dem sich die Installationsdateien befinden müssen:<br />
C:\EBKuS-4.5>python install.py -d c:\ebkus_download c:\ebkus_installation<br />
Wenn bereits eine {{file|ebkus.conf}} existiert, wird das in der Variable {{konfig|download_dir}} definierte Verzeichnis verwendet und die Option {{code|-d}} kann entfallen.<br />
<br />
=== Migration ===<br />
<br />
Die Migration beinhaltet die Übernahme der Instanzen aus einer bestehenden EBKuS-Installation in eine Neuinstallation mit der neuen Software. Die EBKuS-Version der bestehenden Installation muss mindestens 4.2 sein; ältere müssen erst im Rahmen der bestehenden Installation updatet werden.<br />
<br />
==== Vorbereitung ====<br />
<br />
Für die Migration muss eine für die Neuinstallation gültige {{file|ebkus.conf}} bereitgestellt werden sowie eine Sicherungsdatei für jede zu migrierende Instanz. Die Sicherungsdatei wird in der alten Installation mit dem Skript {{code|datenbank_sichern.py --zip ''Verzeichnis''}} erzeugt.<br />
Die Zuordnung wird wie oben beschrieben für jede Instanz über die Konfigurationsvariable {{konfig|initial_content}} vorgenommen (nur Dateiname, ohne Pfadangabe). Ansonsten werden die Konfigurationen der Instanzen aus der alten {{file|ebkus.conf}} übernommen. Die Systemabschnitte für die neue {{file|ebkus.conf}} werden wie oben beschrieben aus der Testinstallation bzw. der Erstkonfiguration übernommen.<br />
<br />
==== Neuinstallation ====<br />
<br />
Die neu erstellte {{file|ebkus.conf}} wird zusammen mit den Sicherungsdateien in ein Verzeichnis kopiert, z.B. {{file|c:\ebkus_preconfig}}.<br />
<br />
Dem {{code|install.py}}-Skript wird das Verzeichnis mit der Option {{code|-p}} übergeben:<br />
C:\EBKuS-4.5>python install.py -p c:\ebkus_preconfig c:\ebkus_installation<br />
Vor der Installation wird dann der Inhalt dieses Verzeichnisses in das Homeverzeichnis kopiert, so dass die Installation durch die neue {{file|ebkus.conf}} gesteuert wird. <br />
<br />
=== Einzelne Instanzen ===<br />
<br />
==== Entfernen ====<br />
<br />
Mit Hilfe des {{code|uninstall.py}}-Skripts lassen sich auch einzelne Instanzen entfernen.<br />
C:\EBKuS-4.5>python uninstall.py c:\ebkus_installation ''Instanzname''<br />
Das {{code|uninstall.py}}-Skript kann auch aus dem Homeverzeichnis aufgerufen werden.<br />
<br />
Wichtig: Den Konfigurationsabschnitt der Instanz in der {{file|ebkus.conf}} erst nach der erfolgreichen Deinstallation entfernen! Sonst ist Handarbeit angesagt.<br />
<br />
==== Hinzufügen ====<br />
<br />
Als erstes muss in der {{file|ebkus.conf}} ein Abschnitt für die neu zu erstellende Instanz erstellt werden, evt. mit Angabe einer Sicherungsdatei oder eines SQL-Dumps für die Initialisierung der Datenbank der Instanz (Variable {{konfig|initial_content}}). <br />
<br />
Die Instanz kann dann mit<br />
C:\>cd ebkus_installation\ebkus<br />
C:\ebkus_installation\ebkus>python configure.py ''Instanzname''<br />
eingerichtet werden. <br />
<br />
Wenn keine Datei zur Initialisierung angegeben wird, wird eine Datenbank mit den Standardmerkmalskatalogen und einem evt. konfigurierten Straßenkatalog erstellt. Wenn der Instanzname mit {{code|demo}} beginnt, werden zusätzlich Demodaten generiert.<br />
<br />
=== Mögliche Probleme ===<br />
<br />
* Windows-Dienste werden nicht automatisch installiert: die Konsole muss als Administrator ausgeführt werden.<br />
* Nicht vollständig deinstallierte Dienste: notfalls mit {{code|sc delete ''Name''}} entfernen. Wenn der Name dann trotzdem noch in der Liste der Dienste auftaucht mit dem Zustand {{code|Deaktiviert}}, muss ein Neustart gemacht werden.<br />
* Übrig gebliebene Reste in der Registry von früheren Installationen, z.B. des MySQL-Servers. Diese müssen notfalls manuell beseitigt werden.<br />
* Instanz lässt sich nicht mit Sicherungsdatei initialisieren: Die Sicherungsdatei muss von einer Instanz mit demselben Namen stammen.<br />
* Automatischer Download klappt nicht: Falls der Internetzugang über einen Proxy erfolgt, muss man möglicherweise (ich habs nicht probiert) manuell herunterladen und die Dateien im Downloadverzeichnis ablegen.<br />
* Firefox akzeptiert das von EBKuS gelieferte Zertifikat (wg. doppelter Seriennummer oder so ähnlich): Zertifikate in Firefox löschen über {{pfad5|Einstellungen|Erweitert|Zertifikate|Zertifikate anzeigen|Löschen}}. Die EBKuS-Zertifikate stehen unter dem Namen EFB bzw. unter dem Namen, der in der {{file|ebkus.conf}} als {{konfig|organisation}} (im Abschnitt {{konfig|openssl}}) eingetragen wurde.<br />
<br />
=== Tipps ===<br />
<br />
* Das {{code|install.py}}-Skript lässt sich wiederholt ausführen. Eine bestehende MySQL- und Apache-Installation wird nicht wiederholt. Vorhandene Instanzdatenbanken bleiben ebenfalls intakt. Evt. neu hinzugekommenen Instanzkonfigurationen werden ausgeführt, d.h. die neue Instanz wird eingerichtet. (Löschen einer Instanz jedoch immer mit {{code|uninstall.py}}!) Alle zu generierenden Dateien werden neu generiert, so dass z.B. auf diese Weise Port-Änderungen oder die Änderung des Servernamens durchgeführt werden können.<br />
* Wenn das {{code|install.py}}-Skript mit der Option {{code|-u}} bzw. {{code|--update}} wiederholt wird, werden zusätzlich alle EBKuS-Dateien aus der Distribution in das Homeverzeichnis kopiert. <br />
* Hilfe für alle Skripte erhält man mit der Option {{code|--help}} oder kurz {{code|-h}}:<br />
C:\EBKuS-4.5>python install.py --help<br />
C:\EBKuS-4.5>python uninstall.py -h<br />
C:\ebkus_installation\ebkus>python configure.py -h<br />
C:\ebkus_installation\ebkus\demo>python dienst.py -h<br />
* Falls Änderungen an generierten Dateien nötig sind (z.B. Apache- oder MySQL-Konfiguration) ist es wenig sinnvoll, diese selbst zu verändern, da man dann nicht mehr die Möglichkeit hat, die Installationsskripte zu verwenden. Besser ist is es, die Templates selber anzupassen. Alle Templates (Vorlagen) für generierte Dateien finden sich im Verzeichnis {{file|templates}} im Homeverzeichnis.</div>Ebkushttps://www.ebkus.org/wiki/Windows_InstallationWindows Installation2020-08-22T16:16:33Z<p>Ebkus: </p>
<hr />
<div>Gültig ab: EBKuS 4.10. (Frühere Versionen lassen sich aber ganz ähnlich installieren.)<br />
<br />
<br />
=== Benötigte Software ===<br />
<br />
* [https://www.python.org/ftp/python/2.7.18/python-2.7.18.msi Python 2.7.18]<br />
* [https://files.pythonhosted.org/packages/27/06/596ae3afeefc0cda5840036c42920222cb8136c101ec0f453f2e36df12a0/MySQL-python-1.2.5.win32-py2.7.exe MySQL-python-1.2.5]<br />
* [https://github.com/mhammond/pywin32/releases/download/b228/pywin32-228.win32-py2.7.exe pywin32-228]<br />
* [http://ftp.gwdg.de/pub/misc/mysql/Downloads/MySQL-5.1/mysql-essential-5.1.73-win32.msi MySQL 5.1.73]<br />
* [https://archive.apache.org/dist/httpd/binaries/win32/httpd-2.2.25-win32-x86-openssl-0.9.8y.msi Apache 2.2]<br />
<br />
Alle benötigten Dateien befinden sich auch auf dem [https://ebkus.org/downloads/win32/ EBKuS FTP-Server]. <br />
Nur die ersten drei müssen manuell heruntergeladen<br />
und installiert werden. Die übrigen werden bei Bedarf automatisch<br />
heruntergeladen (sofern eine Internetverbindung besteht, ansonsten siehe unten).<br />
<br />
Natürlich muss noch die neueste <br />
[http://www.ebkus.org/alle_downloads.html EBKuS-Software]<br />
selbst heruntergeladen werden. <br />
<br />
=== Sonstige Voraussetzungen ===<br />
<br />
* '''Betriebssystem''': Erfolgreich getestet auf Windows 10 Professional. Windows Server 2008 und später sowie auch frühere Windows Versionen sind möglich.<br />
* Die von einer EBKuS-Installation verwendeten '''Ports''' dürfen nicht anderweitig verwendete werden:<br />
** Port 443 für den Apache-Webserver mit SSL-Verschlüsselung (kann mit der Konfigurationsvariablen {{konfig|server_https_port}} verändert werden)<br />
** Port 80 für den Apache-Webserver ohne SSL-Verschlüsselung (kann mit der Konfigurationsvariablen {{konfig|server_http_port}} verändert werden). Dieser Port wird allerdings von der Anwendung nicht benötigt; man kann damit aber überprüfen, ob der Webserver installiert ist unabhängig von EBKuS-Instanzen.<br />
** Port 3306 für den MySQL-Datenbankserver <br />
** Die in der {{file|ebkus.conf||}} explizit genannten Ports für die EBKuS-Instanzen<br />
* '''Administratorrechte''' für die Installation. Insbesondere muss bei neueren Windows-Systemen die Kommandozeile explizit mit Administratorrechten aufgerufen werden (rechtsklicken, mit Administratorrechten ausführen). Sonst gelingt die Einrichtung der Dienste nicht.<br />
* Die von EBKuS verwendeten '''Namen für Dienste''' dürfen nicht in Gebrauch sein: {{code|Apache, MySQL}} sowie die mit {{code|EBKuS}} beginnenden Namen für die Instanzen.<br />
* Keine Reste in der Registry von früheren Installationsversuchen :-)<br />
<br />
=== Python installieren ===<br />
<br />
Zuerst Python<br />
* {{code|python-2.7.18.msi}}<br />
und dann PyWin und MySQL-python<br />
* {{code|pywin32-228.win32-py2.7.exe}}<br />
* {{code|MySQL-python-1.2.5.win32-py2.7.exe}}<br />
installieren. Standardinstallation für alle Benutzer. Zur Kontrolle kann man {{pfad4|Start|Programme|Python 2.7|Python (command line)}} aufrufen und dort folgende Eingaben machen:<br />
>>> import win32service<br />
>>><br />
>>> import MySQLdb<br />
>>><br />
Beide Importe müssen ohne Fehlermeldungen funktionieren.<br />
<br />
=== Nur Erstkonfiguration erzeugen ===<br />
<br />
Die Beispiele gehen davon aus, dass die heruntergeladene EBKuS-Software im Verzeichnis {{file|C:\EBKuS-4.10}} liegt.<br />
<br />
Wenn man die Option {{code|-c}} bzw. {{code|--config}} des {{code|install-py}}-Skripts verwendet, wird lediglich die Konfigurationsdatei {{file|c:\ebkus_installation\ebkus\ebkus.conf}} erzeugt und nichts weiter installiert. <br />
C:\>cd EBKuS-4.10<br />
C:\EBKuS-4.10>python install.py -c c:\ebkus_installation<br />
Die so entstandene {{file|c:\ebkus_installation\ebkus\ebkus.conf}} kann nun weiter bearbeitet und in der eigentlichen Installation verwendet werden.<br />
<br />
=== Vollautomatische Testinstallation ===<br />
<br />
Falls die oben genannten Voraussetzungen erfüllt sind (insbesondere freie Standardports 80 und 443), kann man eine vollautomatische Erstinstallation vornehmen (Eingabeaufforderung mit Administratorrechten ausführen!):<br />
C:\>cd EBKuS-4.10<br />
C:\EBKuS-4.10>python install.py c:\ebkus_installation<br />
Den Fortgang der Installation sieht man auf der Konsole und in der Datei {{file|c:\ebkus_installation\install.log}}.<br />
<br />
Wenn alles gut gegangen ist, erhält man eine funktionierende EBKuS-Installation mit zwei Instanzen, {{code|demo}} und {{code|muster_efb}}. Es gibt dann 4 neue Windows-Dienste: Apache, MySQL, EBKuS-demo und EBKuS-muster_efb. Den Zugriff auf die Instanzen erhält man über die URL {{code|<nowiki>https://localhost/ebkus/demo/</nowiki>}} bzw. {{code|.../muster_efb/}}.<br />
<br />
Die dabei entstandene Datei {{file|c:\ebkus_installation\ebkus\ebkus.conf}} sollte man sichern, da sie den Ausgangspunkt für die endgültige Installation darstellt.<br />
<br />
Die Testinstallation kann dann ganz oder teilweise wieder deinstalliert werden:<br />
C:\EBKuS-4.10>python uninstall.py --all c:\ebkus_installation<br />
bzw.<br />
C:\EBKuS-4.10>python uninstall.py c:\ebkus_installation ebkus<br />
Im ersten Fall wird auch der Webserver und die Datenbank deinstalliert, im zweiten nur die eigentliche EBKuS-Installation mitsamt allen Instanzen.<br />
<br />
=== Installation mit vorhandenem Webserver und Datenbank ===<br />
<br />
Mit<br />
C:\EBKuS-4.10>python install.py --no_mysql --no_apache c:\ebkus_installation<br />
kann man eine Installation durchführen, wenn Apache und MySQL bereits vorhanden sind und nicht durch die EBKuS-Installation bereitgestellt werden sollen. Das Vorgehen ist dann ähnlich der [[Linux_Installation]]. Es muss manuell dafür gesorgt werden, dass die generierte Datei {{file|ebkus_httpd.conf}} in die Apachekonfiguration eingebunden wird, z.B. durch die Zeile <br />
Include c:\ebkus_installation\ebkus\ebkus_httpd.conf<br />
am Ende der Apache {{file|httpd.conf}}. Außerdem muss man nach der Installation und der Umkonfigurierung den Webserver manuell neu starten, damit er die neue Konfiguration übernimmt.<br />
<br />
=== Anpassen der Konfiguration ===<br />
<br />
In der Konfigurationsdatei {{file|ebkus.conf}} gibt es die Systemabschnitte {{code|DEFAULT, ebkus, apache}} und {{code|openssl}} sowie je einen Abschnitt für jede zu installierende Instanz.<br />
<br />
Dokumentation aller Konfigurationsvariablen siehe [[Konfiguration]].<br />
<br />
==== Systemabschnitte ====<br />
<br />
Im Abschnitt {{code|apache}} muss für die Variable {{konfig|server_name}} der Name angegeben werden, unter dem der Rechner im Netz ansprechbar ist (FQDN), ersatzweise die IP-Adresse. Der Name bzw. die IP-Adresse ist Bestandteil der URL, unter der EBKuS angesprochen wird. Der Standardwert ist hier {{code|localhost}}, womit EBKuS nur auf dem lokalen Rechner erreichbar wäre.<br />
<br />
Falls die Standardports 80 und 443 nicht für EBKuS zur Verfügung stehen, müssen hier alternative freie Ports eingetragen werden. {{konfig|server_http_port}} dient nur zur Kontrolle des Apache Webservers ({{code|<nowiki>http://localhost/</nowiki>}} liefert "It works!"). Falls eine Alternative für {{konfig|server_https_port}} eingetragen wird, muss der Port in der URL aufgeführt werden, um die Anwendung anzusprechen.<br />
<br />
Des weiteren kann die Email-Adresse des Systemadministrators bei {{konfig| server_admin}} eingetragen werden (die evt. auf Fehlerseiten des Servers erscheint). Im Abschnitt {{code|openssl}} sollten die regionalen und organisatorischen Angaben angepasst werden, da sie auf dem erzeugten Zertifikat erscheinen (das man sich z.B. im Browser ansehen kann).<br />
<br />
Sie können ein Passwort setzen für die Datenbankuser {{code|root}} (der Instanzdatenbanken löschen und erstellen kann):<br />
C:\>cd ebkus_installation\mysql5.1\bin<br />
C:\ebkus_installation\mysql5.1\bin>mysqladmin.exe -uroot password ''Neues Passwort''<br />
Dies muss dem Konfigurationsparameter {{konfig|database_admin_password}} zugewiesen werden.<br />
<br />
Alle anderen Werte in den Systemabschnitten sollten nur in Ausnahmefällen verändert werden.<br />
<br />
==== Instanzen ====<br />
<br />
Der Name des Abschnitts muss identisch sein mit dem Wert der Variablen {{konfig|instance_name}}. Der Name muss mit einem Buchstaben beginnen und darf neben Ziffern und Buchstaben nur das Sonderzeichen '_' enthalten.<br />
<br />
Mit der Variablen {{konfig|initial_content}} kann man einer Instanz eine Datei mit einem Datenbankdump (Sicherungsdatei) zuweisen, mit dem die Instanz initialisiert wird:<br />
initial_content: C:\backup\demo_braunschweig_backup_v4.4.1_2011-06-17_02-10-00.zip<br />
bzw.<br />
initial_content: demo_braunschweig_backup_v4.4.1_2011-06-17_02-10-00.zip<br />
Wenn nur der Dateiname angegeben ist, muss die Datei im Homeverzeichnis liegen ({{file|c:\ebkus_installation\ebkus\}}).<br />
Damit ist es möglich, eine Instanz aus einer bestehenden Installation in eine Neuinstallation zu migrieren (siehe unten). <br />
<br />
Jede Instanz benötigt einen eigenen freien Port (Variable {{konfig|port}}).<br />
<br />
=== Installation ohne Internetzugang ===<br />
<br />
Wenn alle [http://www.ebkus.org/alle_downloads.html benötigte Software für Windows 32 bit] in das Verzeichnis {{file|c:\ebkus_installation\download}} kopiert werden, wird kein Internetzugang benötigt. <br />
<br />
Alternativ kann beim ersten Aufruf von {{code|install.py}} ein Downloadverzeichnis angegeben werden, in dem sich die Installationsdateien befinden müssen:<br />
C:\EBKuS-4.5>python install.py -d c:\ebkus_download c:\ebkus_installation<br />
Wenn bereits eine {{file|ebkus.conf}} existiert, wird das in der Variable {{konfig|download_dir}} definierte Verzeichnis verwendet und die Option {{code|-d}} kann entfallen.<br />
<br />
=== Migration ===<br />
<br />
Die Migration beinhaltet die Übernahme der Instanzen aus einer bestehenden EBKuS-Installation in eine Neuinstallation mit der neuen Software. Die EBKuS-Version der bestehenden Installation muss mindestens 4.2 sein; ältere müssen erst im Rahmen der bestehenden Installation updatet werden.<br />
<br />
==== Vorbereitung ====<br />
<br />
Für die Migration muss eine für die Neuinstallation gültige {{file|ebkus.conf}} bereitgestellt werden sowie eine Sicherungsdatei für jede zu migrierende Instanz. Die Sicherungsdatei wird in der alten Installation mit dem Skript {{code|datenbank_sichern.py --zip ''Verzeichnis''}} erzeugt.<br />
Die Zuordnung wird wie oben beschrieben für jede Instanz über die Konfigurationsvariable {{konfig|initial_content}} vorgenommen (nur Dateiname, ohne Pfadangabe). Ansonsten werden die Konfigurationen der Instanzen aus der alten {{file|ebkus.conf}} übernommen. Die Systemabschnitte für die neue {{file|ebkus.conf}} werden wie oben beschrieben aus der Testinstallation bzw. der Erstkonfiguration übernommen.<br />
<br />
==== Neuinstallation ====<br />
<br />
Die neu erstellte {{file|ebkus.conf}} wird zusammen mit den Sicherungsdateien in ein Verzeichnis kopiert, z.B. {{file|c:\ebkus_preconfig}}.<br />
<br />
Dem {{code|install.py}}-Skript wird das Verzeichnis mit der Option {{code|-p}} übergeben:<br />
C:\EBKuS-4.5>python install.py -p c:\ebkus_preconfig c:\ebkus_installation<br />
Vor der Installation wird dann der Inhalt dieses Verzeichnisses in das Homeverzeichnis kopiert, so dass die Installation durch die neue {{file|ebkus.conf}} gesteuert wird. <br />
<br />
=== Einzelne Instanzen ===<br />
<br />
==== Entfernen ====<br />
<br />
Mit Hilfe des {{code|uninstall.py}}-Skripts lassen sich auch einzelne Instanzen entfernen.<br />
C:\EBKuS-4.5>python uninstall.py c:\ebkus_installation ''Instanzname''<br />
Das {{code|uninstall.py}}-Skript kann auch aus dem Homeverzeichnis aufgerufen werden.<br />
<br />
Wichtig: Den Konfigurationsabschnitt der Instanz in der {{file|ebkus.conf}} erst nach der erfolgreichen Deinstallation entfernen! Sonst ist Handarbeit angesagt.<br />
<br />
==== Hinzufügen ====<br />
<br />
Als erstes muss in der {{file|ebkus.conf}} ein Abschnitt für die neu zu erstellende Instanz erstellt werden, evt. mit Angabe einer Sicherungsdatei oder eines SQL-Dumps für die Initialisierung der Datenbank der Instanz (Variable {{konfig|initial_content}}). <br />
<br />
Die Instanz kann dann mit<br />
C:\>cd ebkus_installation\ebkus<br />
C:\ebkus_installation\ebkus>python configure.py ''Instanzname''<br />
eingerichtet werden. <br />
<br />
Wenn keine Datei zur Initialisierung angegeben wird, wird eine Datenbank mit den Standardmerkmalskatalogen und einem evt. konfigurierten Straßenkatalog erstellt. Wenn der Instanzname mit {{code|demo}} beginnt, werden zusätzlich Demodaten generiert.<br />
<br />
=== Mögliche Probleme ===<br />
<br />
* Windows-Dienste werden nicht automatisch installiert: die Konsole muss als Administrator ausgeführt werden.<br />
* Nicht vollständig deinstallierte Dienste: notfalls mit {{code|sc delete ''Name''}} entfernen. Wenn der Name dann trotzdem noch in der Liste der Dienste auftaucht mit dem Zustand {{code|Deaktiviert}}, muss ein Neustart gemacht werden.<br />
* Übrig gebliebene Reste in der Registry von früheren Installationen, z.B. des MySQL-Servers. Diese müssen notfalls manuell beseitigt werden.<br />
* Instanz lässt sich nicht mit Sicherungsdatei initialisieren: Die Sicherungsdatei muss von einer Instanz mit demselben Namen stammen.<br />
* Automatischer Download klappt nicht: Falls der Internetzugang über einen Proxy erfolgt, muss man möglicherweise (ich habs nicht probiert) manuell herunterladen und die Dateien im Downloadverzeichnis ablegen.<br />
* Firefox akzeptiert das von EBKuS gelieferte Zertifikat (wg. doppelter Seriennummer oder so ähnlich): Zertifikate in Firefox löschen über {{pfad5|Einstellungen|Erweitert|Zertifikate|Zertifikate anzeigen|Löschen}}. Die EBKuS-Zertifikate stehen unter dem Namen EFB bzw. unter dem Namen, der in der {{file|ebkus.conf}} als {{konfig|organisation}} (im Abschnitt {{konfig|openssl}}) eingetragen wurde.<br />
<br />
=== Tipps ===<br />
<br />
* Das {{code|install.py}}-Skript lässt sich wiederholt ausführen. Eine bestehende MySQL- und Apache-Installation wird nicht wiederholt. Vorhandene Instanzdatenbanken bleiben ebenfalls intakt. Evt. neu hinzugekommenen Instanzkonfigurationen werden ausgeführt, d.h. die neue Instanz wird eingerichtet. (Löschen einer Instanz jedoch immer mit {{code|uninstall.py}}!) Alle zu generierenden Dateien werden neu generiert, so dass z.B. auf diese Weise Port-Änderungen oder die Änderung des Servernamens durchgeführt werden können.<br />
* Wenn das {{code|install.py}}-Skript mit der Option {{code|-u}} bzw. {{code|--update}} wiederholt wird, werden zusätzlich alle EBKuS-Dateien aus der Distribution in das Homeverzeichnis kopiert. <br />
* Hilfe für alle Skripte erhält man mit der Option {{code|--help}} oder kurz {{code|-h}}:<br />
C:\EBKuS-4.5>python install.py --help<br />
C:\EBKuS-4.5>python uninstall.py -h<br />
C:\ebkus_installation\ebkus>python configure.py -h<br />
C:\ebkus_installation\ebkus\demo>python dienst.py -h<br />
* Falls Änderungen an generierten Dateien nötig sind (z.B. Apache- oder MySQL-Konfiguration) ist es wenig sinnvoll, diese selbst zu verändern, da man dann nicht mehr die Möglichkeit hat, die Installationsskripte zu verwenden. Besser ist is es, die Templates selber anzupassen. Alle Templates (Vorlagen) für generierte Dateien finden sich im Verzeichnis {{file|templates}} im Homeverzeichnis.</div>Ebkushttps://www.ebkus.org/wiki/Windows_InstallationWindows Installation2020-08-22T16:14:24Z<p>Ebkus: </p>
<hr />
<div>Gültig ab: EBKuS 4.10. (Frühere Versionen lassen sich aber ganz ähnlich installieren.)<br />
<br />
<br />
=== Benötigte Software ===<br />
<br />
* [https://www.python.org/ftp/python/2.7.18/python-2.7.18.msi Python 2.7.18]<br />
* [https://files.pythonhosted.org/packages/27/06/596ae3afeefc0cda5840036c42920222cb8136c101ec0f453f2e36df12a0/MySQL-python-1.2.5.win32-py2.7.exe MySQL-python-1.2.5]<br />
* [https://github.com/mhammond/pywin32/releases/download/b228/pywin32-228.win32-py2.7.exe pywin32-228]<br />
* [http://ftp.gwdg.de/pub/misc/mysql/Downloads/MySQL-5.1/mysql-essential-5.1.73-win32.msi MySQL 5.1.73]<br />
* [https://archive.apache.org/dist/httpd/binaries/win32/httpd-2.2.25-win32-x86-openssl-0.9.8y.msi Apache 2.2]<br />
<br />
Alle benötigten Dateien befinden sich auch auf dem [https://ebkus.org/downloads/win32/ EBKuS FTP-Server]. <br />
Nur die ersten drei müssen manuell heruntergeladen<br />
und installiert werden. Die übrigen werden bei Bedarf automatisch<br />
heruntergeladen (sofern eine Internetverbindung besteht, ansonsten siehe unten).<br />
<br />
Natürlich muss noch die neueste <br />
[http://www.ebkus.org/alle_downloads.html EBKuS-Software]<br />
selbst heruntergeladen werden. <br />
<br />
=== Sonstige Voraussetzungen ===<br />
<br />
* '''Betriebssystem''': Erfolgreich getestet auf Windows 10 Professional. Windows Server 2008 und später sowie auch frühere Windows Versionen sind möglich.<br />
* Die von einer EBKuS-Installation verwendeten '''Ports''' dürfen nicht anderweitig verwendete werden:<br />
** Port 443 für den Apache-Webserver mit SSL-Verschlüsselung (kann mit der Konfigurationsvariablen {{konfig|server_https_port}} verändert werden)<br />
** Port 80 für den Apache-Webserver ohne SSL-Verschlüsselung (kann mit der Konfigurationsvariablen {{konfig|server_http_port}} verändert werden). Dieser Port wird allerdings von der Anwendung nicht benötigt; man kann damit aber überprüfen, ob der Webserver installiert ist unabhängig von EBKuS-Instanzen.<br />
** Port 3306 für den MySQL-Datenbankserver <br />
** Die in der {{file|ebkus.conf||}} explizit genannten Ports für die EBKuS-Instanzen<br />
* '''Administratorrechte''' für die Installation. Insbesondere muss bei neueren Windows-Systemen die Kommandozeile explizit mit Administratorrechten aufgerufen werden (rechtsklicken, mit Administratorrechten ausführen). Sonst gelingt die Einrichtung der Dienste nicht.<br />
* Die von EBKuS verwendeten '''Namen für Dienste''' dürfen nicht in Gebrauch sein: {{code|Apache, MySQL}} sowie die mit {{code|EBKuS}} beginnenden Namen für die Instanzen.<br />
* Keine Reste in der Registry von früheren Installationsversuchen :-)<br />
<br />
=== Python installieren ===<br />
<br />
Zuerst Python<br />
* {{code|python-2.7.18.msi}}<br />
und dann PyWin und MySQL-python<br />
* {{code|pywin32-228.win32-py2.7.exe}}<br />
* {{code|MySQL-python-1.2.5.win32-py2.7.exe}}<br />
installieren. Standardinstallation für alle Benutzer. Zur Kontrolle kann man {{pfad4|Start|Programme|Python 2.7|Python (command line)}} aufrufen und dort folgende Eingaben machen:<br />
>>> import win32service<br />
>>><br />
>>> import MySQLdb<br />
>>><br />
Beide Importe müssen ohne Fehlermeldungen funktionieren.<br />
<br />
=== Nur Erstkonfiguration erzeugen ===<br />
<br />
Die Beispiele gehen davon aus, dass die heruntergeladene EBKuS-Software im Verzeichnis {{file|C:\EBKuS-4.10}} liegt.<br />
<br />
Wenn man die Option {{code|-c}} bzw. {{code|--config}} des {{code|install-py}}-Skripts verwendet, wird lediglich die Konfigurationsdatei {{file|c:\ebkus_installation\ebkus\ebkus.conf}} erzeugt und nichts weiter installiert. <br />
C:\>cd EBKuS-4.10<br />
C:\EBKuS-4.10>python install.py -c c:\ebkus_installation<br />
Die so entstandene {{file|c:\ebkus_installation\ebkus\ebkus.conf}} kann nun weiter bearbeitet und in der eigentlichen Installation verwendet werden.<br />
<br />
=== Vollautomatische Testinstallation ===<br />
<br />
Falls die oben genannten Voraussetzungen erfüllt sind (insbesondere freie Standardports 80 und 443), kann man eine vollautomatische Erstinstallation vornehmen (Eingabeaufforderung mit Administratorrechten ausführen!):<br />
C:\>cd EBKuS-4.10<br />
C:\EBKuS-4.10>python install.py c:\ebkus_installation<br />
Den Fortgang der Installation sieht man auf der Konsole und in der Datei {{file|c:\ebkus_installation\install.log}}.<br />
<br />
Wenn alles gut gegangen ist, erhält man eine funktionierende EBKuS-Installation mit zwei Instanzen, {{code|demo}} und {{code|muster_efb}}. Es gibt dann 4 neue Windows-Dienste: Apache, MySQL, EBKuS-demo und EBKuS-muster_efb. Den Zugriff auf die Instanzen erhält man über die URL {{code|<nowiki>https://localhost/ebkus/demo/</nowiki>}} bzw. {{code|.../muster_efb/}}.<br />
<br />
Die dabei entstandene Datei {{file|c:\ebkus_installation\ebkus\ebkus.conf}} sollte man sichern, da sie den Ausgangspunkt für die endgültige Installation darstellt.<br />
<br />
Die Testinstallation kann dann ganz oder teilweise wieder deinstalliert werden:<br />
C:\EBKuS-4.10>python uninstall.py --all c:\ebkus_installation<br />
bzw.<br />
C:\EBKuS-4.10>python uninstall.py c:\ebkus_installation ebkus<br />
Im ersten Fall wird auch der Webserver und die Datenbank deinstalliert, im zweiten nur die eigentliche EBKuS-Installation mitsamt allen Instanzen.<br />
<br />
=== Installation mit vorhandenem Webserver und Datenbank ===<br />
<br />
Mit<br />
C:\EBKuS-4.10>python install.py --no_mysql --no_apache c:\ebkus_installation<br />
kann man eine Installation durchführen, wenn Apache und MySQL bereits vorhanden sind und nicht durch die EBKuS-Installation bereitgestellt werden sollen. Das Vorgehen ist dann ähnlich der [[Linux_Installation]]. Es muss manuell dafür gesorgt werden, dass die generierte Datei {{file|ebkus_httpd.conf}} in die Apachekonfiguration eingebunden wird, z.B. durch die Zeile <br />
Include c:\ebkus_installation\ebkus\ebkus_httpd.conf<br />
am Ende der Apache {{file|httpd.conf}}. Außerdem muss man nach der Installation und der Umkonfigurierung den Webserver manuell neu starten, damit er die neue Konfiguration übernimmt.<br />
<br />
=== Anpassen der Konfiguration ===<br />
<br />
In der Konfigurationsdatei {{file|ebkus.conf}} gibt es die Systemabschnitte {{code|DEFAULT, ebkus, apache}} und {{code|openssl}} sowie je einen Abschnitt für jede zu installierende Instanz.<br />
<br />
Dokumentation aller Konfigurationsvariablen siehe [[Konfiguration]].<br />
<br />
==== Systemabschnitte ====<br />
<br />
Im Abschnitt {{code|apache}} muss für die Variable {{konfig|server_name}} der Name angegeben werden, unter dem der Rechner im Netz ansprechbar ist (FQDN), ersatzweise die IP-Adresse. Der Name bzw. die IP-Adresse ist Bestandteil der URL, unter der EBKuS angesprochen wird. Der Standardwert ist hier {{code|localhost}}, womit EBKuS nur auf dem lokalen Rechner erreichbar wäre.<br />
<br />
Falls die Standardports 80 und 443 nicht für EBKuS zur Verfügung stehen, müssen hier alternative freie Ports eingetragen werden. {{konfig|server_http_port}} dient nur zur Kontrolle des Apache Webservers ({{code|<nowiki>http://localhost/</nowiki>}} liefert "It works!"). Falls eine Alternative für {{konfig|server_https_port}} eingetragen wird, muss der Port in der URL aufgeführt werden, um die Anwendung anzusprechen.<br />
<br />
Des weiteren kann die Email-Adresse des Systemadministrators bei {{konfig| server_admin}} eingetragen werden (die evt. auf Fehlerseiten des Servers erscheint). Im Abschnitt {{code|openssl}} sollten die regionalen und organisatorischen Angaben angepasst werden, da sie auf dem erzeugten Zertifikat erscheinen (das man sich z.B. im Browser ansehen kann).<br />
<br />
Sie können ein Passwort setzen für die Datenbankuser {{code|root}} (der Instanzdatenbanken löschen und erstellen kann):<br />
C:\>cd ebkus_installation\mysql5.1\bin<br />
C:\ebkus_installation\mysql5.1\bin>mysqladmin.exe -uroot password ''Neues Passwort''<br />
Dies muss dem Konfigurationsparameter {{konfig|database_admin_password}} zugewiesen werden.<br />
<br />
Alle anderen Werte in den Systemabschnitten sollten nur in Ausnahmefällen verändert werden.<br />
<br />
==== Instanzen ====<br />
<br />
Der Name des Abschnitts muss identisch sein mit dem Wert der Variablen {{konfig|instance_name}}. Der Name muss mit einem Buchstaben beginnen und darf neben Ziffern und Buchstaben nur das Sonderzeichen '_' enthalten.<br />
<br />
Mit der Variablen {{konfig|initial_content}} kann man einer Instanz eine Datei mit einem Datenbankdump (Sicherungsdatei) zuweisen, mit dem die Instanz initialisiert wird:<br />
initial_content: C:\backup\demo_braunschweig_backup_v4.4.1_2011-06-17_02-10-00.zip<br />
bzw.<br />
initial_content: demo_braunschweig_backup_v4.4.1_2011-06-17_02-10-00.zip<br />
Wenn nur der Dateiname angegeben ist, muss die Datei im Homeverzeichnis liegen ({{file|c:\ebkus_installation\ebkus\}}).<br />
Damit ist es möglich, eine Instanz aus einer bestehenden Installation in eine Neuinstallation zu migrieren (siehe unten). <br />
<br />
Jede Instanz benötigt einen eigenen freien Port (Variable {{konfig|port}}).<br />
<br />
=== Installation ohne Internetzugang ===<br />
<br />
Wenn alle [http://www.ebkus.org/alle_downloads.html benötigte Software für Windows 32 bit] in das Verzeichnis {{file|c:\ebkus_installation\download}} kopiert werden, wird kein Internetzugang benötigt. <br />
<br />
Alternativ kann beim ersten Aufruf von {{code|install.py}} ein Downloadverzeichnis angegeben werden, in dem sich die Installationsdateien befinden müssen:<br />
C:\EBKuS-4.5>python install.py -d c:\ebkus_download c:\ebkus_installation<br />
Wenn bereits eine {{file|ebkus.conf}} existiert, wird das in der Variable {{konfig|download_dir}} definierte Verzeichnis verwendet und die Option {{code|-d}} kann entfallen.<br />
<br />
=== Migration ===<br />
<br />
Die Migration beinhaltet die Übernahme der Instanzen aus einer bestehenden EBKuS-Installation in eine Neuinstallation mit der neuen Software. Die EBKuS-Version der bestehenden Installation muss mindestens 4.2 sein; ältere müssen erst im Rahmen der bestehenden Installation updatet werden.<br />
<br />
==== Vorbereitung ====<br />
<br />
Für die Migration muss eine für die Neuinstallation gültige {{file|ebkus.conf}} bereitgestellt werden sowie eine Sicherungsdatei für jede zu migrierende Instanz. Die Sicherungsdatei wird in der alten Installation mit dem Skript {{code|datenbank_sichern.py --zip ''Verzeichnis''}} erzeugt.<br />
Die Zuordnung wird wie oben beschrieben für jede Instanz über die Konfigurationsvariable {{konfig|initial_content}} vorgenommen (nur Dateiname, ohne Pfadangabe). Ansonsten werden die Konfigurationen der Instanzen aus der alten {{file|ebkus.conf}} übernommen. Die Systemabschnitte für die neue {{file|ebkus.conf}} werden wie oben beschrieben aus der Testinstallation bzw. der Erstkonfiguration übernommen.<br />
<br />
==== Neuinstallation ====<br />
<br />
Die neu erstellte {{file|ebkus.conf}} wird zusammen mit den Sicherungsdateien in ein Verzeichnis kopiert, z.B. {{file|c:\ebkus_preconfig}}.<br />
<br />
Dem {{code|install.py}}-Skript wird das Verzeichnis mit der Option {{code|-p}} übergeben:<br />
C:\EBKuS-4.5>python install.py -p c:\ebkus_preconfig c:\ebkus_installation<br />
Vor der Installation wird dann der Inhalt dieses Verzeichnisses in das Homeverzeichnis kopiert, so dass die Installation durch die neue {{file|ebkus.conf}} gesteuert wird. <br />
<br />
=== Einzelne Instanzen ===<br />
<br />
==== Entfernen ====<br />
<br />
Mit Hilfe des {{code|uninstall.py}}-Skripts lassen sich auch einzelne Instanzen entfernen.<br />
C:\EBKuS-4.5>python uninstall.py c:\ebkus_installation ''Instanzname''<br />
Das {{code|uninstall.py}}-Skript kann auch aus dem Homeverzeichnis aufgerufen werden.<br />
<br />
Wichtig: Den Konfigurationsabschnitt der Instanz in der {{file|ebkus.conf}} erst nach der erfolgreichen Deinstallation entfernen! Sonst ist Handarbeit angesagt.<br />
<br />
==== Hinzufügen ====<br />
<br />
Als erstes muss in der {{file|ebkus.conf}} ein Abschnitt für die neu zu erstellende Instanz erstellt werden, evt. mit Angabe einer Sicherungsdatei oder eines SQL-Dumps für die Initialisierung der Datenbank der Instanz (Variable {{konfig|initial_content}}). <br />
<br />
Die Instanz kann dann mit<br />
C:\>cd ebkus_installation\ebkus<br />
C:\ebkus_installation\ebkus>python configure.py ''Instanzname''<br />
eingerichtet werden. <br />
<br />
Wenn keine Datei zur Initialisierung angegeben wird, wird eine Datenbank mit den Standardmerkmalskatalogen und einem evt. konfigurierten Straßenkatalog erstellt. Wenn der Instanzname mit {{code|demo}} beginnt, werden zusätzlich Demodaten generiert.<br />
<br />
=== Mögliche Probleme ===<br />
<br />
* Windows-Dienste werden nicht automatisch installiert: die Konsole muss als Administrator ausgeführt werden.<br />
* Nicht vollständig deinstallierte Dienste: notfalls mit {{code|sc delete ''Name''}} entfernen. Wenn der Name dann trotzdem noch in der Liste der Dienste auftaucht mit dem Zustand {{code|Deaktiviert}}, muss ein Neustart gemacht werden.<br />
* Übrig gebliebene Reste in der Registry von früheren Installationen, z.B. des MySQL-Servers. Diese müssen notfalls manuell beseitigt werden.<br />
* Instanz lässt sich nicht mit Sicherungsdatei initialisieren: Die Sicherungsdatei muss von einer Instanz mit demselben Namen stammen.<br />
* Automatischer Download klappt nicht: Falls der Internetzugang über einen Proxy erfolgt, muss man möglicherweise (ich habs nicht probiert) manuell herunterladen und die Dateien im Downloadverzeichnis ablegen.<br />
* Firefox akzeptiert das von EBKuS gelieferte Zertifikat (wg. doppelter Seriennummer oder so ähnlich): Zertifikate in Firefox löschen über {{pfad5|Einstellungen|Erweitert|Zertifikate|Zertifikate anzeigen|Löschen}}. Die EBKuS-Zertifikate stehen unter dem Namen EFB bzw. unter dem Namen, der in der {{file|ebkus.conf}} als {{konfig|organisation}} (im Abschnitt {{konfig|openssl}}) eingetragen wurde.<br />
<br />
=== Tipps ===<br />
<br />
* Das {{code|install.py}}-Skript lässt sich wiederholt ausführen. Eine bestehende MySQL- und Apache-Installation wird nicht wiederholt. Vorhandene Instanzdatenbanken bleiben ebenfalls intakt. Evt. neu hinzugekommenen Instanzkonfigurationen werden ausgeführt, d.h. die neue Instanz wird eingerichtet. (Löschen einer Instanz jedoch immer mit {{code|uninstall.py}}!) Alle zu generierenden Dateien werden neu generiert, so dass z.B. auf diese Weise Port-Änderungen oder die Änderung des Servernamens durchgeführt werden können.<br />
* Wenn das {{code|install.py}}-Skript mit der Option {{code|-u}} bzw. {{code|--update}} wiederholt wird, werden zusätzlich alle EBKuS-Dateien aus der Distribution in das Homeverzeichnis kopiert. <br />
* Hilfe für alle Skripte erhält man mit der Option {{code|--help}} oder kurz {{code|-h}}:<br />
C:\EBKuS-4.5>python install.py --help<br />
C:\EBKuS-4.5>python uninstall.py -h<br />
C:\ebkus_installation\ebkus>python configure.py -h<br />
C:\ebkus_installation\ebkus\demo>dienst.py -h<br />
* Falls Änderungen an generierten Dateien nötig sind (z.B. Apache- oder MySQL-Konfiguration) ist es wenig sinnvoll, diese selbst zu verändern, da man dann nicht mehr die Möglichkeit hat, die Installationsskripte zu verwenden. Besser ist is es, die Templates selber anzupassen. Alle Templates (Vorlagen) für generierte Dateien finden sich im Verzeichnis {{file|templates}} im Homeverzeichnis.</div>Ebkushttps://www.ebkus.org/wiki/Windows_InstallationWindows Installation2020-08-22T16:07:12Z<p>Ebkus: </p>
<hr />
<div>Gültig ab: EBKuS 4.10. (Frühere Versionen lassen sich aber ganz ähnlich installieren.)<br />
<br />
<br />
=== Benötigte Software ===<br />
<br />
* [https://www.python.org/ftp/python/2.7.18/python-2.7.18.msi Python 2.7.18]<br />
* [https://files.pythonhosted.org/packages/27/06/596ae3afeefc0cda5840036c42920222cb8136c101ec0f453f2e36df12a0/MySQL-python-1.2.5.win32-py2.7.exe MySQL-python-1.2.5]<br />
* [https://github.com/mhammond/pywin32/releases/download/b228/pywin32-228.win32-py2.7.exe pywin32-228]<br />
* [http://ftp.gwdg.de/pub/misc/mysql/Downloads/MySQL-5.1/mysql-essential-5.1.73-win32.msi MySQL 5.1.73]<br />
* [https://archive.apache.org/dist/httpd/binaries/win32/httpd-2.2.25-win32-x86-openssl-0.9.8y.msi Apache 2.2]<br />
<br />
Alle benötigten Dateien befinden sich auch auf dem [https://ebkus.org/downloads/win32/ EBKuS FTP-Server]. <br />
Nur die ersten drei müssen manuell heruntergeladen<br />
und installiert werden. Die übrigen werden bei Bedarf automatisch<br />
heruntergeladen (sofern eine Internetverbindung besteht, ansonsten siehe unten).<br />
<br />
Natürlich muss noch die neueste <br />
[http://www.ebkus.org/alle_downloads.html EBKuS-Software]<br />
selbst heruntergeladen werden. <br />
<br />
=== Sonstige Voraussetzungen ===<br />
<br />
* '''Betriebssystem''': Erfolgreich getestet auf Windows 10 Professional. Windows Server 2008 und später sowie auch frühere Windows Versionen sind möglich.<br />
* Die von einer EBKuS-Installation verwendeten '''Ports''' dürfen nicht anderweitig verwendete werden:<br />
** Port 443 für den Apache-Webserver mit SSL-Verschlüsselung (kann mit der Konfigurationsvariablen {{konfig|server_https_port}} verändert werden)<br />
** Port 80 für den Apache-Webserver ohne SSL-Verschlüsselung (kann mit der Konfigurationsvariablen {{konfig|server_http_port}} verändert werden). Dieser Port wird allerdings von der Anwendung nicht benötigt; man kann damit aber überprüfen, ob der Webserver installiert ist unabhängig von EBKuS-Instanzen.<br />
** Port 3306 für den MySQL-Datenbankserver <br />
** Die in der {{file|ebkus.conf||}} explizit genannten Ports für die EBKuS-Instanzen<br />
* '''Administratorrechte''' für die Installation. Insbesondere muss bei neueren Windows-Systemen die Kommandozeile explizit mit Administratorrechten aufgerufen werden (rechtsklicken, mit Administratorrechten ausführen). Sonst gelingt die Einrichtung der Dienste nicht.<br />
* Die von EBKuS verwendeten '''Namen für Dienste''' dürfen nicht in Gebrauch sein: {{code|Apache, MySQL}} sowie die mit {{code|EBKuS}} beginnenden Namen für die Instanzen.<br />
* Keine Reste in der Registry von früheren Installationsversuchen :-)<br />
<br />
=== Python installieren ===<br />
<br />
Zuerst Python<br />
* {{code|python-2.7.18.msi}}<br />
und dann PyWin und MySQL-python<br />
* {{code|pywin32-228.win32-py2.7.exe}}<br />
* {{code|MySQL-python-1.2.5.win32-py2.7.exe}}<br />
installieren. Standardinstallation für alle Benutzer. Zur Kontrolle kann man {{pfad4|Start|Programme|Python 2.7|Python (command line)}} aufrufen und dort folgende Eingaben machen:<br />
>>> import win32service<br />
>>><br />
>>> import MySQLdb<br />
>>><br />
Beide Importe müssen ohne Fehlermeldungen funktionieren.<br />
<br />
=== Nur Erstkonfiguration erzeugen ===<br />
<br />
Die Beispiele gehen davon aus, dass die heruntergeladene EBKuS-Software im Verzeichnis {{file|C:\EBKuS-4.10}} liegt.<br />
<br />
Wenn man die Option {{code|-c}} bzw. {{code|--config}} des {{code|install-py}}-Skripts verwendet, wird lediglich die Konfigurationsdatei {{file|c:\ebkus_installation\ebkus\ebkus.conf}} erzeugt und nichts weiter installiert. <br />
C:\>cd EBKuS-4.10<br />
C:\EBKuS-4.10>install.py -c c:\ebkus_installation<br />
Die so entstandene {{file|c:\ebkus_installation\ebkus\ebkus.conf}} kann nun weiter bearbeitet und in der eigentlichen Installation verwendet werden.<br />
<br />
=== Vollautomatische Testinstallation ===<br />
<br />
Falls die oben genannten Voraussetzungen erfüllt sind (insbesondere freie Standardports 80 und 443), kann man eine vollautomatische Erstinstallation vornehmen (Eingabeaufforderung mit Administratorrechten ausführen!):<br />
C:\>cd EBKuS-4.10<br />
C:\EBKuS-4.10>install.py c:\ebkus_installation<br />
Den Fortgang der Installation sieht man auf der Konsole und in der Datei {{file|c:\ebkus_installation\install.log}}.<br />
<br />
Wenn alles gut gegangen ist, erhält man eine funktionierende EBKuS-Installation mit zwei Instanzen, {{code|demo}} und {{code|muster_efb}}. Es gibt dann 4 neue Windows-Dienste: Apache, MySQL, EBKuS-demo und EBKuS-muster_efb. Den Zugriff auf die Instanzen erhält man über die URL {{code|<nowiki>https://localhost/ebkus/demo/</nowiki>}} bzw. {{code|.../muster_efb/}}.<br />
<br />
Die dabei entstandene Datei {{file|c:\ebkus_installation\ebkus\ebkus.conf}} sollte man sichern, da sie den Ausgangspunkt für die endgültige Installation darstellt.<br />
<br />
Die Testinstallation kann dann ganz oder teilweise wieder deinstalliert werden:<br />
C:\EBKuS-4.10>uninstall.py --all c:\ebkus_installation<br />
bzw.<br />
C:\EBKuS-4.10>uninstall.py c:\ebkus_installation ebkus<br />
Im ersten Fall wird auch der Webserver und die Datenbank deinstalliert, im zweiten nur die eigentliche EBKuS-Installation mitsamt allen Instanzen.<br />
<br />
=== Installation mit vorhandenem Webserver und Datenbank ===<br />
<br />
Mit<br />
C:\EBKuS-4.10>install.py --no_mysql --no_apache c:\ebkus_installation<br />
kann man eine Installation durchführen, wenn Apache und MySQL bereits vorhanden sind und nicht durch die EBKuS-Installation bereitgestellt werden sollen. Das Vorgehen ist dann ähnlich der [[Linux_Installation]]. Es muss manuell dafür gesorgt werden, dass die generierte Datei {{file|ebkus_httpd.conf}} in die Apachekonfiguration eingebunden wird, z.B. durch die Zeile <br />
Include c:\ebkus_installation\ebkus\ebkus_httpd.conf<br />
am Ende der Apache {{file|httpd.conf}}. Außerdem muss man nach der Installation und der Umkonfigurierung den Webserver manuell neu starten, damit er die neue Konfiguration übernimmt.<br />
<br />
=== Anpassen der Konfiguration ===<br />
<br />
In der Konfigurationsdatei {{file|ebkus.conf}} gibt es die Systemabschnitte {{code|DEFAULT, ebkus, apache}} und {{code|openssl}} sowie je einen Abschnitt für jede zu installierende Instanz.<br />
<br />
Dokumentation aller Konfigurationsvariablen siehe [[Konfiguration]].<br />
<br />
==== Systemabschnitte ====<br />
<br />
Im Abschnitt {{code|apache}} muss für die Variable {{konfig|server_name}} der Name angegeben werden, unter dem der Rechner im Netz ansprechbar ist (FQDN), ersatzweise die IP-Adresse. Der Name bzw. die IP-Adresse ist Bestandteil der URL, unter der EBKuS angesprochen wird. Der Standardwert ist hier {{code|localhost}}, womit EBKuS nur auf dem lokalen Rechner erreichbar wäre.<br />
<br />
Falls die Standardports 80 und 443 nicht für EBKuS zur Verfügung stehen, müssen hier alternative freie Ports eingetragen werden. {{konfig|server_http_port}} dient nur zur Kontrolle des Apache Webservers ({{code|<nowiki>http://localhost/</nowiki>}} liefert "It works!"). Falls eine Alternative für {{konfig|server_https_port}} eingetragen wird, muss der Port in der URL aufgeführt werden, um die Anwendung anzusprechen.<br />
<br />
Des weiteren kann die Email-Adresse des Systemadministrators bei {{konfig| server_admin}} eingetragen werden (die evt. auf Fehlerseiten des Servers erscheint). Im Abschnitt {{code|openssl}} sollten die regionalen und organisatorischen Angaben angepasst werden, da sie auf dem erzeugten Zertifikat erscheinen (das man sich z.B. im Browser ansehen kann).<br />
<br />
Sie können ein Passwort setzen für die Datenbankuser {{code|root}} (der Instanzdatenbanken löschen und erstellen kann):<br />
C:\>cd ebkus_installation\mysql5.1\bin<br />
C:\ebkus_installation\mysql5.1\bin>mysqladmin.exe -uroot password ''Neues Passwort''<br />
Dies muss dem Konfigurationsparameter {{konfig|database_admin_password}} zugewiesen werden.<br />
<br />
Alle anderen Werte in den Systemabschnitten sollten nur in Ausnahmefällen verändert werden.<br />
<br />
==== Instanzen ====<br />
<br />
Der Name des Abschnitts muss identisch sein mit dem Wert der Variablen {{konfig|instance_name}}. Der Name muss mit einem Buchstaben beginnen und darf neben Ziffern und Buchstaben nur das Sonderzeichen '_' enthalten.<br />
<br />
Mit der Variablen {{konfig|initial_content}} kann man einer Instanz eine Datei mit einem Datenbankdump (Sicherungsdatei) zuweisen, mit dem die Instanz initialisiert wird:<br />
initial_content: C:\backup\demo_braunschweig_backup_v4.4.1_2011-06-17_02-10-00.zip<br />
bzw.<br />
initial_content: demo_braunschweig_backup_v4.4.1_2011-06-17_02-10-00.zip<br />
Wenn nur der Dateiname angegeben ist, muss die Datei im Homeverzeichnis liegen ({{file|c:\ebkus_installation\ebkus\}}).<br />
Damit ist es möglich, eine Instanz aus einer bestehenden Installation in eine Neuinstallation zu migrieren (siehe unten). <br />
<br />
Jede Instanz benötigt einen eigenen freien Port (Variable {{konfig|port}}).<br />
<br />
=== Installation ohne Internetzugang ===<br />
<br />
Wenn alle [http://www.ebkus.org/alle_downloads.html benötigte Software für Windows 32 bit] in das Verzeichnis {{file|c:\ebkus_installation\download}} kopiert werden, wird kein Internetzugang benötigt. <br />
<br />
Alternativ kann beim ersten Aufruf von {{code|install.py}} ein Downloadverzeichnis angegeben werden, in dem sich die Installationsdateien befinden müssen:<br />
C:\EBKuS-4.5>install.py -d c:\ebkus_download c:\ebkus_installation<br />
Wenn bereits eine {{file|ebkus.conf}} existiert, wird das in der Variable {{konfig|download_dir}} definierte Verzeichnis verwendet und die Option {{code|-d}} kann entfallen.<br />
<br />
=== Migration ===<br />
<br />
Die Migration beinhaltet die Übernahme der Instanzen aus einer bestehenden EBKuS-Installation in eine Neuinstallation mit der neuen Software. Die EBKuS-Version der bestehenden Installation muss mindestens 4.2 sein; ältere müssen erst im Rahmen der bestehenden Installation updatet werden.<br />
<br />
==== Vorbereitung ====<br />
<br />
Für die Migration muss eine für die Neuinstallation gültige {{file|ebkus.conf}} bereitgestellt werden sowie eine Sicherungsdatei für jede zu migrierende Instanz. Die Sicherungsdatei wird in der alten Installation mit dem Skript {{code|datenbank_sichern.py --zip ''Verzeichnis''}} erzeugt.<br />
Die Zuordnung wird wie oben beschrieben für jede Instanz über die Konfigurationsvariable {{konfig|initial_content}} vorgenommen (nur Dateiname, ohne Pfadangabe). Ansonsten werden die Konfigurationen der Instanzen aus der alten {{file|ebkus.conf}} übernommen. Die Systemabschnitte für die neue {{file|ebkus.conf}} werden wie oben beschrieben aus der Testinstallation bzw. der Erstkonfiguration übernommen.<br />
<br />
==== Neuinstallation ====<br />
<br />
Die neu erstellte {{file|ebkus.conf}} wird zusammen mit den Sicherungsdateien in ein Verzeichnis kopiert, z.B. {{file|c:\ebkus_preconfig}}.<br />
<br />
Dem {{code|install.py}}-Skript wird das Verzeichnis mit der Option {{code|-p}} übergeben:<br />
C:\EBKuS-4.5>install.py -p c:\ebkus_preconfig c:\ebkus_installation<br />
Vor der Installation wird dann der Inhalt dieses Verzeichnisses in das Homeverzeichnis kopiert, so dass die Installation durch die neue {{file|ebkus.conf}} gesteuert wird. <br />
<br />
=== Einzelne Instanzen ===<br />
<br />
==== Entfernen ====<br />
<br />
Mit Hilfe des {{code|uninstall.py}}-Skripts lassen sich auch einzelne Instanzen entfernen.<br />
C:\EBKuS-4.5>uninstall.py c:\ebkus_installation ''Instanzname''<br />
Das {{code|uninstall.py}}-Skript kann auch aus dem Homeverzeichnis aufgerufen werden.<br />
<br />
Wichtig: Den Konfigurationsabschnitt der Instanz in der {{file|ebkus.conf}} erst nach der erfolgreichen Deinstallation entfernen! Sonst ist Handarbeit angesagt.<br />
<br />
==== Hinzufügen ====<br />
<br />
Als erstes muss in der {{file|ebkus.conf}} ein Abschnitt für die neu zu erstellende Instanz erstellt werden, evt. mit Angabe einer Sicherungsdatei oder eines SQL-Dumps für die Initialisierung der Datenbank der Instanz (Variable {{konfig|initial_content}}). <br />
<br />
Die Instanz kann dann mit<br />
C:\>cd ebkus_installation\ebkus<br />
C:\ebkus_installation\ebkus>configure.py ''Instanzname''<br />
eingerichtet werden. <br />
<br />
Wenn keine Datei zur Initialisierung angegeben wird, wird eine Datenbank mit den Standardmerkmalskatalogen und einem evt. konfigurierten Straßenkatalog erstellt. Wenn der Instanzname mit {{code|demo}} beginnt, werden zusätzlich Demodaten generiert.<br />
<br />
=== Mögliche Probleme ===<br />
<br />
* Windows-Dienste werden nicht automatisch installiert: die Konsole muss als Administrator ausgeführt werden.<br />
* Nicht vollständig deinstallierte Dienste: notfalls mit {{code|sc delete ''Name''}} entfernen. Wenn der Name dann trotzdem noch in der Liste der Dienste auftaucht mit dem Zustand {{code|Deaktiviert}}, muss ein Neustart gemacht werden.<br />
* Übrig gebliebene Reste in der Registry von früheren Installationen, z.B. des MySQL-Servers. Diese müssen notfalls manuell beseitigt werden.<br />
* Instanz lässt sich nicht mit Sicherungsdatei initialisieren: Die Sicherungsdatei muss von einer Instanz mit demselben Namen stammen.<br />
* Automatischer Download klappt nicht: Falls der Internetzugang über einen Proxy erfolgt, muss man möglicherweise (ich habs nicht probiert) manuell herunterladen und die Dateien im Downloadverzeichnis ablegen.<br />
* Firefox akzeptiert das von EBKuS gelieferte Zertifikat (wg. doppelter Seriennummer oder so ähnlich): Zertifikate in Firefox löschen über {{pfad5|Einstellungen|Erweitert|Zertifikate|Zertifikate anzeigen|Löschen}}. Die EBKuS-Zertifikate stehen unter dem Namen EFB bzw. unter dem Namen, der in der {{file|ebkus.conf}} als {{konfig|organisation}} (im Abschnitt {{konfig|openssl}}) eingetragen wurde.<br />
<br />
=== Tipps ===<br />
<br />
* Das {{code|install.py}}-Skript lässt sich wiederholt ausführen. Eine bestehende MySQL- und Apache-Installation wird nicht wiederholt. Vorhandene Instanzdatenbanken bleiben ebenfalls intakt. Evt. neu hinzugekommenen Instanzkonfigurationen werden ausgeführt, d.h. die neue Instanz wird eingerichtet. (Löschen einer Instanz jedoch immer mit {{code|uninstall.py}}!) Alle zu generierenden Dateien werden neu generiert, so dass z.B. auf diese Weise Port-Änderungen oder die Änderung des Servernamens durchgeführt werden können.<br />
* Wenn das {{code|install.py}}-Skript mit der Option {{code|-u}} bzw. {{code|--update}} wiederholt wird, werden zusätzlich alle EBKuS-Dateien aus der Distribution in das Homeverzeichnis kopiert. <br />
* Hilfe für alle Skripte erhält man mit der Option {{code|--help}} oder kurz {{code|-h}}:<br />
C:\EBKuS-4.5>install.py --help<br />
C:\EBKuS-4.5>uninstall.py -h<br />
C:\ebkus_installation\ebkus>configure.py -h<br />
C:\ebkus_installation\ebkus\demo>dienst.py -h<br />
* Falls Änderungen an generierten Dateien nötig sind (z.B. Apache- oder MySQL-Konfiguration) ist es wenig sinnvoll, diese selbst zu verändern, da man dann nicht mehr die Möglichkeit hat, die Installationsskripte zu verwenden. Besser ist is es, die Templates selber anzupassen. Alle Templates (Vorlagen) für generierte Dateien finden sich im Verzeichnis {{file|templates}} im Homeverzeichnis.</div>Ebkushttps://www.ebkus.org/wiki/Windows_InstallationWindows Installation2020-08-22T16:05:01Z<p>Ebkus: </p>
<hr />
<div>Gültig ab: EBKuS 4.10. (Frühere Versionen lassen sich aber mit<br />
demselben Vorgehen installieren.)<br />
<br />
<br />
=== Benötigte Software ===<br />
<br />
* [https://www.python.org/ftp/python/2.7.18/python-2.7.18.msi Python 2.7.18]<br />
* [https://files.pythonhosted.org/packages/27/06/596ae3afeefc0cda5840036c42920222cb8136c101ec0f453f2e36df12a0/MySQL-python-1.2.5.win32-py2.7.exe MySQL-python-1.2.5]<br />
* [https://github.com/mhammond/pywin32/releases/download/b228/pywin32-228.win32-py2.7.exe pywin32-228]<br />
* [http://ftp.gwdg.de/pub/misc/mysql/Downloads/MySQL-5.1/mysql-essential-5.1.73-win32.msi MySQL 5.1.73]<br />
* [https://archive.apache.org/dist/httpd/binaries/win32/httpd-2.2.25-win32-x86-openssl-0.9.8y.msi Apache 2.2]<br />
<br />
Alle benötigten Dateien befinden sich auch auf dem [https://ebkus.org/downloads/win32/ EBKuS FTP-Server]. <br />
Nur die ersten drei müssen manuell heruntergeladen<br />
und installiert werden. Die übrigen werden bei Bedarf automatisch<br />
heruntergeladen (sofern eine Internetverbindung besteht, ansonsten siehe unten).<br />
<br />
Natürlich muss noch die neueste <br />
[http://www.ebkus.org/alle_downloads.html EBKuS-Software]<br />
selbst heruntergeladen werden. <br />
<br />
=== Sonstige Voraussetzungen ===<br />
<br />
* '''Betriebssystem''': Erfolgreich getestet auf Windows 10 Professional. Windows Server 2008 und später sowie auch frühere Windows Versionen sind möglich.<br />
* Die von einer EBKuS-Installation verwendeten '''Ports''' dürfen nicht anderweitig verwendete werden:<br />
** Port 443 für den Apache-Webserver mit SSL-Verschlüsselung (kann mit der Konfigurationsvariablen {{konfig|server_https_port}} verändert werden)<br />
** Port 80 für den Apache-Webserver ohne SSL-Verschlüsselung (kann mit der Konfigurationsvariablen {{konfig|server_http_port}} verändert werden). Dieser Port wird allerdings von der Anwendung nicht benötigt; man kann damit aber überprüfen, ob der Webserver installiert ist unabhängig von EBKuS-Instanzen.<br />
** Port 3306 für den MySQL-Datenbankserver <br />
** Die in der {{file|ebkus.conf||}} explizit genannten Ports für die EBKuS-Instanzen<br />
* '''Administratorrechte''' für die Installation. Insbesondere muss bei neueren Windows-Systemen die Kommandozeile explizit mit Administratorrechten aufgerufen werden (rechtsklicken, mit Administratorrechten ausführen). Sonst gelingt die Einrichtung der Dienste nicht.<br />
* Die von EBKuS verwendeten '''Namen für Dienste''' dürfen nicht in Gebrauch sein: {{code|Apache, MySQL}} sowie die mit {{code|EBKuS}} beginnenden Namen für die Instanzen.<br />
* Keine Reste in der Registry von früheren Installationsversuchen :-)<br />
<br />
=== Python installieren ===<br />
<br />
Zuerst Python<br />
* {{code|python-2.7.18.msi}}<br />
und dann PyWin und MySQL-python<br />
* {{code|pywin32-228.win32-py2.7.exe}}<br />
* {{code|MySQL-python-1.2.5.win32-py2.7.exe}}<br />
installieren. Standardinstallation für alle Benutzer. Zur Kontrolle kann man {{pfad4|Start|Programme|Python 2.7|Python (command line)}} aufrufen und dort folgende Eingaben machen:<br />
>>> import win32service<br />
>>><br />
>>> import MySQLdb<br />
>>><br />
Beide Importe müssen ohne Fehlermeldungen funktionieren.<br />
<br />
=== Nur Erstkonfiguration erzeugen ===<br />
<br />
Die Beispiele gehen davon aus, dass die heruntergeladene EBKuS-Software im Verzeichnis {{file|C:\EBKuS-4.4.1}} liegt.<br />
<br />
Wenn man die Option {{code|-c}} bzw. {{code|--config}} des {{code|install-py}}-Skripts verwendet, wird lediglich die Konfigurationsdatei {{file|c:\ebkus_installation\ebkus\ebkus.conf}} erzeugt und nichts weiter installiert. <br />
C:\>cd EBKuS-4.4.1<br />
C:\EBKuS-4.4.1>install.py -c c:\ebkus_installation<br />
Die so entstandene {{file|c:\ebkus_installation\ebkus\ebkus.conf}} kann nun weiter bearbeitet und in der eigentlichen Installation verwendet werden.<br />
<br />
=== Vollautomatische Testinstallation ===<br />
<br />
Falls die oben genannten Voraussetzungen erfüllt sind (insbesondere freie Standardports 80 und 443), kann man eine vollautomatische Erstinstallation vornehmen (Eingabeaufforderung mit Administratorrechten ausführen!):<br />
C:\>cd EBKuS-4.4.1<br />
C:\EBKuS-4.4.1>install.py c:\ebkus_installation<br />
Den Fortgang der Installation sieht man auf der Konsole und in der Datei {{file|c:\ebkus_installation\install.log}}.<br />
<br />
Wenn alles gut gegangen ist, erhält man eine funktionierende EBKuS-Installation mit zwei Instanzen, {{code|demo}} und {{code|muster_efb}}. Es gibt dann 4 neue Windows-Dienste: Apache, MySQL, EBKuS-demo und EBKuS-muster_efb. Den Zugriff auf die Instanzen erhält man über die URL {{code|<nowiki>https://localhost/ebkus/demo/</nowiki>}} bzw. {{code|.../muster_efb/}}.<br />
<br />
Die dabei entstandene Datei {{file|c:\ebkus_installation\ebkus\ebkus.conf}} sollte man sichern, da sie den Ausgangspunkt für die endgültige Installation darstellt.<br />
<br />
Die Testinstallation kann dann ganz oder teilweise wieder deinstalliert werden:<br />
C:\EBKuS-4.4.1>uninstall.py --all c:\ebkus_installation<br />
bzw.<br />
C:\EBKuS-4.4.1>uninstall.py c:\ebkus_installation ebkus<br />
Im ersten Fall wird auch der Webserver und die Datenbank deinstalliert, im zweiten nur die eigentliche EBKuS-Installation mitsamt allen Instanzen.<br />
<br />
=== Installation mit vorhandenem Webserver und Datenbank ===<br />
<br />
Mit<br />
C:\EBKuS-4.4.1>install.py --no_mysql --no_apache c:\ebkus_installation<br />
kann man eine Installation durchführen, wenn Apache und MySQL bereits vorhanden sind und nicht durch die EBKuS-Installation bereitgestellt werden sollen. Das Vorgehen ist dann ähnlich der [[Linux_Installation]]. Es muss manuell dafür gesorgt werden, dass die generierte Datei {{file|ebkus_httpd.conf}} in die Apachekonfiguration eingebunden wird, z.B. durch die Zeile <br />
Include c:\ebkus_installation\ebkus\ebkus_httpd.conf<br />
am Ende der Apache {{file|httpd.conf}}. Außerdem muss man nach der Installation und der Umkonfigurierung den Webserver manuell neu starten, damit er die neue Konfiguration übernimmt.<br />
<br />
=== Anpassen der Konfiguration ===<br />
<br />
In der Konfigurationsdatei {{file|ebkus.conf}} gibt es die Systemabschnitte {{code|DEFAULT, ebkus, apache}} und {{code|openssl}} sowie je einen Abschnitt für jede zu installierende Instanz.<br />
<br />
Dokumentation aller Konfigurationsvariablen siehe [[Konfiguration]].<br />
<br />
==== Systemabschnitte ====<br />
<br />
Im Abschnitt {{code|apache}} muss für die Variable {{konfig|server_name}} der Name angegeben werden, unter dem der Rechner im Netz ansprechbar ist (FQDN), ersatzweise die IP-Adresse. Der Name bzw. die IP-Adresse ist Bestandteil der URL, unter der EBKuS angesprochen wird. Der Standardwert ist hier {{code|localhost}}, womit EBKuS nur auf dem lokalen Rechner erreichbar wäre.<br />
<br />
Falls die Standardports 80 und 443 nicht für EBKuS zur Verfügung stehen, müssen hier alternative freie Ports eingetragen werden. {{konfig|server_http_port}} dient nur zur Kontrolle des Apache Webservers ({{code|<nowiki>http://localhost/</nowiki>}} liefert "It works!"). Falls eine Alternative für {{konfig|server_https_port}} eingetragen wird, muss der Port in der URL aufgeführt werden, um die Anwendung anzusprechen.<br />
<br />
Des weiteren kann die Email-Adresse des Systemadministrators bei {{konfig| server_admin}} eingetragen werden (die evt. auf Fehlerseiten des Servers erscheint). Im Abschnitt {{code|openssl}} sollten die regionalen und organisatorischen Angaben angepasst werden, da sie auf dem erzeugten Zertifikat erscheinen (das man sich z.B. im Browser ansehen kann).<br />
<br />
Sie können ein Passwort setzen für die Datenbankuser {{code|root}} (der Instanzdatenbanken löschen und erstellen kann):<br />
C:\>cd ebkus_installation\mysql5.1\bin<br />
C:\ebkus_installation\mysql5.1\bin>mysqladmin.exe -uroot password ''Neues Passwort''<br />
Dies muss dem Konfigurationsparameter {{konfig|database_admin_password}} zugewiesen werden.<br />
<br />
Alle anderen Werte in den Systemabschnitten sollten nur in Ausnahmefällen verändert werden.<br />
<br />
==== Instanzen ====<br />
<br />
Der Name des Abschnitts muss identisch sein mit dem Wert der Variablen {{konfig|instance_name}}. Der Name muss mit einem Buchstaben beginnen und darf neben Ziffern und Buchstaben nur das Sonderzeichen '_' enthalten.<br />
<br />
Mit der Variablen {{konfig|initial_content}} kann man einer Instanz eine Datei mit einem Datenbankdump (Sicherungsdatei) zuweisen, mit dem die Instanz initialisiert wird:<br />
initial_content: C:\backup\demo_braunschweig_backup_v4.4.1_2011-06-17_02-10-00.zip<br />
bzw.<br />
initial_content: demo_braunschweig_backup_v4.4.1_2011-06-17_02-10-00.zip<br />
Wenn nur der Dateiname angegeben ist, muss die Datei im Homeverzeichnis liegen ({{file|c:\ebkus_installation\ebkus\}}).<br />
Damit ist es möglich, eine Instanz aus einer bestehenden Installation in eine Neuinstallation zu migrieren (siehe unten). <br />
<br />
Jede Instanz benötigt einen eigenen freien Port (Variable {{konfig|port}}).<br />
<br />
=== Installation ohne Internetzugang ===<br />
<br />
Wenn alle [http://www.ebkus.org/alle_downloads.html benötigte Software für Windows 32 bit] in das Verzeichnis {{file|c:\ebkus_installation\download}} kopiert werden, wird kein Internetzugang benötigt. <br />
<br />
Alternativ kann beim ersten Aufruf von {{code|install.py}} ein Downloadverzeichnis angegeben werden, in dem sich die Installationsdateien befinden müssen:<br />
C:\EBKuS-4.5>install.py -d c:\ebkus_download c:\ebkus_installation<br />
Wenn bereits eine {{file|ebkus.conf}} existiert, wird das in der Variable {{konfig|download_dir}} definierte Verzeichnis verwendet und die Option {{code|-d}} kann entfallen.<br />
<br />
=== Migration ===<br />
<br />
Die Migration beinhaltet die Übernahme der Instanzen aus einer bestehenden EBKuS-Installation in eine Neuinstallation mit der neuen Software. Die EBKuS-Version der bestehenden Installation muss mindestens 4.2 sein; ältere müssen erst im Rahmen der bestehenden Installation updatet werden.<br />
<br />
==== Vorbereitung ====<br />
<br />
Für die Migration muss eine für die Neuinstallation gültige {{file|ebkus.conf}} bereitgestellt werden sowie eine Sicherungsdatei für jede zu migrierende Instanz. Die Sicherungsdatei wird in der alten Installation mit dem Skript {{code|datenbank_sichern.py --zip ''Verzeichnis''}} erzeugt.<br />
Die Zuordnung wird wie oben beschrieben für jede Instanz über die Konfigurationsvariable {{konfig|initial_content}} vorgenommen (nur Dateiname, ohne Pfadangabe). Ansonsten werden die Konfigurationen der Instanzen aus der alten {{file|ebkus.conf}} übernommen. Die Systemabschnitte für die neue {{file|ebkus.conf}} werden wie oben beschrieben aus der Testinstallation bzw. der Erstkonfiguration übernommen.<br />
<br />
==== Neuinstallation ====<br />
<br />
Die neu erstellte {{file|ebkus.conf}} wird zusammen mit den Sicherungsdateien in ein Verzeichnis kopiert, z.B. {{file|c:\ebkus_preconfig}}.<br />
<br />
Dem {{code|install.py}}-Skript wird das Verzeichnis mit der Option {{code|-p}} übergeben:<br />
C:\EBKuS-4.5>install.py -p c:\ebkus_preconfig c:\ebkus_installation<br />
Vor der Installation wird dann der Inhalt dieses Verzeichnisses in das Homeverzeichnis kopiert, so dass die Installation durch die neue {{file|ebkus.conf}} gesteuert wird. <br />
<br />
=== Einzelne Instanzen ===<br />
<br />
==== Entfernen ====<br />
<br />
Mit Hilfe des {{code|uninstall.py}}-Skripts lassen sich auch einzelne Instanzen entfernen.<br />
C:\EBKuS-4.5>uninstall.py c:\ebkus_installation ''Instanzname''<br />
Das {{code|uninstall.py}}-Skript kann auch aus dem Homeverzeichnis aufgerufen werden.<br />
<br />
Wichtig: Den Konfigurationsabschnitt der Instanz in der {{file|ebkus.conf}} erst nach der erfolgreichen Deinstallation entfernen! Sonst ist Handarbeit angesagt.<br />
<br />
==== Hinzufügen ====<br />
<br />
Als erstes muss in der {{file|ebkus.conf}} ein Abschnitt für die neu zu erstellende Instanz erstellt werden, evt. mit Angabe einer Sicherungsdatei oder eines SQL-Dumps für die Initialisierung der Datenbank der Instanz (Variable {{konfig|initial_content}}). <br />
<br />
Die Instanz kann dann mit<br />
C:\>cd ebkus_installation\ebkus<br />
C:\ebkus_installation\ebkus>configure.py ''Instanzname''<br />
eingerichtet werden. <br />
<br />
Wenn keine Datei zur Initialisierung angegeben wird, wird eine Datenbank mit den Standardmerkmalskatalogen und einem evt. konfigurierten Straßenkatalog erstellt. Wenn der Instanzname mit {{code|demo}} beginnt, werden zusätzlich Demodaten generiert.<br />
<br />
=== Mögliche Probleme ===<br />
<br />
* Windows-Dienste werden nicht automatisch installiert: die Konsole muss als Administrator ausgeführt werden.<br />
* Nicht vollständig deinstallierte Dienste: notfalls mit {{code|sc delete ''Name''}} entfernen. Wenn der Name dann trotzdem noch in der Liste der Dienste auftaucht mit dem Zustand {{code|Deaktiviert}}, muss ein Neustart gemacht werden.<br />
* Übrig gebliebene Reste in der Registry von früheren Installationen, z.B. des MySQL-Servers. Diese müssen notfalls manuell beseitigt werden.<br />
* Instanz lässt sich nicht mit Sicherungsdatei initialisieren: Die Sicherungsdatei muss von einer Instanz mit demselben Namen stammen.<br />
* Automatischer Download klappt nicht: Falls der Internetzugang über einen Proxy erfolgt, muss man möglicherweise (ich habs nicht probiert) manuell herunterladen und die Dateien im Downloadverzeichnis ablegen.<br />
* Firefox akzeptiert das von EBKuS gelieferte Zertifikat (wg. doppelter Seriennummer oder so ähnlich): Zertifikate in Firefox löschen über {{pfad5|Einstellungen|Erweitert|Zertifikate|Zertifikate anzeigen|Löschen}}. Die EBKuS-Zertifikate stehen unter dem Namen EFB bzw. unter dem Namen, der in der {{file|ebkus.conf}} als {{konfig|organisation}} (im Abschnitt {{konfig|openssl}}) eingetragen wurde.<br />
<br />
=== Tipps ===<br />
<br />
* Das {{code|install.py}}-Skript lässt sich wiederholt ausführen. Eine bestehende MySQL- und Apache-Installation wird nicht wiederholt. Vorhandene Instanzdatenbanken bleiben ebenfalls intakt. Evt. neu hinzugekommenen Instanzkonfigurationen werden ausgeführt, d.h. die neue Instanz wird eingerichtet. (Löschen einer Instanz jedoch immer mit {{code|uninstall.py}}!) Alle zu generierenden Dateien werden neu generiert, so dass z.B. auf diese Weise Port-Änderungen oder die Änderung des Servernamens durchgeführt werden können.<br />
* Wenn das {{code|install.py}}-Skript mit der Option {{code|-u}} bzw. {{code|--update}} wiederholt wird, werden zusätzlich alle EBKuS-Dateien aus der Distribution in das Homeverzeichnis kopiert. <br />
* Hilfe für alle Skripte erhält man mit der Option {{code|--help}} oder kurz {{code|-h}}:<br />
C:\EBKuS-4.5>install.py --help<br />
C:\EBKuS-4.5>uninstall.py -h<br />
C:\ebkus_installation\ebkus>configure.py -h<br />
C:\ebkus_installation\ebkus\demo>dienst.py -h<br />
* Falls Änderungen an generierten Dateien nötig sind (z.B. Apache- oder MySQL-Konfiguration) ist es wenig sinnvoll, diese selbst zu verändern, da man dann nicht mehr die Möglichkeit hat, die Installationsskripte zu verwenden. Besser ist is es, die Templates selber anzupassen. Alle Templates (Vorlagen) für generierte Dateien finden sich im Verzeichnis {{file|templates}} im Homeverzeichnis.</div>Ebkushttps://www.ebkus.org/wiki/Windows_InstallationWindows Installation2020-08-22T15:58:26Z<p>Ebkus: </p>
<hr />
<div>Gültig ab: EBKuS 4.10<br />
<br />
Die Software, mit der frühere Versionen von EBKuS auf Windows<br />
automatisch installiert wurden, ist inzwischen in die Jahre<br />
gekommen. Ab Version 4.4.1 ist nun auch eine automatische<br />
Installation mit neuerer Software möglich. Dazu ist eine komplette<br />
Neuinstallation erforderlich. Der parallele Betrieb von alter und<br />
neuer Software ist nicht möglich.<br />
<br />
=== Benötigte Software ===<br />
<br />
* [https://www.python.org/ftp/python/2.7.18/python-2.7.18.msi Python 2.7.18]<br />
* [https://files.pythonhosted.org/packages/27/06/596ae3afeefc0cda5840036c42920222cb8136c101ec0f453f2e36df12a0/MySQL-python-1.2.5.win32-py2.7.exe MySQL-python-1.2.5]<br />
* [https://github.com/mhammond/pywin32/releases/download/b228/pywin32-228.win32-py2.7.exe pywin32-228]<br />
* [http://ftp.gwdg.de/pub/misc/mysql/Downloads/MySQL-5.1/mysql-essential-5.1.73-win32.msi MySQL 5.1.73]<br />
* [https://archive.apache.org/dist/httpd/binaries/win32/httpd-2.2.25-win32-x86-openssl-0.9.8y.msi Apache 2.2]<br />
<br />
Alle benötigten Dateien befinden sich auch auf dem [https://ebkus.org/downloads/win32/ EBKuS FTP-Server]. <br />
Nur die ersten drei müssen manuell heruntergeladen<br />
und installiert werden. Die übrigen werden bei Bedarf automatisch<br />
heruntergeladen (sofern eine Internetverbindung besteht, ansonsten siehe unten).<br />
<br />
Natürlich muss noch die neueste <br />
[http://www.ebkus.org/alle_downloads.html EBKuS-Software]<br />
selbst heruntergeladen werden. <br />
<br />
=== Sonstige Voraussetzungen ===<br />
<br />
* '''Betriebssystem''': Erfolgreich getestet auf Windows 2000 Professional, Windows XP Professional, Windows 7 Professional und Windows Server 2008.<br />
* Die von einer EBKuS-Installation verwendeten '''Ports''' dürfen nicht anderweitig verwendete werden:<br />
** Port 443 für den Apache-Webserver mit SSL-Verschlüsselung (kann mit der Konfigurationsvariablen {{konfig|server_https_port}} verändert werden)<br />
** Port 80 für den Apache-Webserver ohne SSL-Verschlüsselung (kann mit der Konfigurationsvariablen {{konfig|server_http_port}} verändert werden). Dieser Port wird allerdings von der Anwendung nicht benötigt; man kann damit aber überprüfen, ob der Webserver installiert ist unabhängig von EBKuS-Instanzen.<br />
** Port 3306 für den MySQL-Datenbankserver <br />
** Die in der {{file|ebkus.conf||}} explizit genannten Ports für die EBKuS-Instanzen<br />
* '''Administratorrechte''' für die Installation. Insbesondere muss bei neueren Windows-Systemen die Kommandozeile explizit mit Administratorrechten aufgerufen werden (rechtsklicken, mit Administratorrechten ausführen). Sonst gelingt die Einrichtung der Dienste nicht.<br />
* Die von EBKuS verwendeten '''Namen für Dienste''' dürfen nicht in Gebrauch sein: {{code|Apache, MySQL}} sowie die mit {{code|EBKuS}} beginnenden Namen für die Instanzen.<br />
* Keine Reste in der Registry von früheren Installationsversuchen :-)<br />
<br />
=== Python installieren ===<br />
<br />
Zuerst Python<br />
* {{code|python-2.7.18.msi}}<br />
und dann PyWin und MySQL-python<br />
* {{code|pywin32-228.win32-py2.7.exe}}<br />
* {{code|MySQL-python-1.2.3.win32-py2.7.exe}}<br />
installieren. Standardinstallation für alle Benutzer. Zur Kontrolle kann man {{pfad4|Start|Programme|Python 2.7|Python (command line)}} aufrufen und dort folgende Eingaben machen:<br />
>>> import win32service<br />
>>><br />
>>> import MySQLdb<br />
>>><br />
Beide Importe müssen ohne Fehlermeldungen funktionieren.<br />
<br />
=== Nur Erstkonfiguration erzeugen ===<br />
<br />
Die Beispiele gehen davon aus, dass die heruntergeladene EBKuS-Software im Verzeichnis {{file|C:\EBKuS-4.4.1}} liegt.<br />
<br />
Wenn man die Option {{code|-c}} bzw. {{code|--config}} des {{code|install-py}}-Skripts verwendet, wird lediglich die Konfigurationsdatei {{file|c:\ebkus_installation\ebkus\ebkus.conf}} erzeugt und nichts weiter installiert. <br />
C:\>cd EBKuS-4.4.1<br />
C:\EBKuS-4.4.1>install.py -c c:\ebkus_installation<br />
Die so entstandene {{file|c:\ebkus_installation\ebkus\ebkus.conf}} kann nun weiter bearbeitet und in der eigentlichen Installation verwendet werden.<br />
<br />
=== Vollautomatische Testinstallation ===<br />
<br />
Falls die oben genannten Voraussetzungen erfüllt sind (insbesondere freie Standardports 80 und 443), kann man eine vollautomatische Erstinstallation vornehmen (Eingabeaufforderung mit Administratorrechten ausführen!):<br />
C:\>cd EBKuS-4.4.1<br />
C:\EBKuS-4.4.1>install.py c:\ebkus_installation<br />
Den Fortgang der Installation sieht man auf der Konsole und in der Datei {{file|c:\ebkus_installation\install.log}}.<br />
<br />
Wenn alles gut gegangen ist, erhält man eine funktionierende EBKuS-Installation mit zwei Instanzen, {{code|demo}} und {{code|muster_efb}}. Es gibt dann 4 neue Windows-Dienste: Apache, MySQL, EBKuS-demo und EBKuS-muster_efb. Den Zugriff auf die Instanzen erhält man über die URL {{code|<nowiki>https://localhost/ebkus/demo/</nowiki>}} bzw. {{code|.../muster_efb/}}.<br />
<br />
Die dabei entstandene Datei {{file|c:\ebkus_installation\ebkus\ebkus.conf}} sollte man sichern, da sie den Ausgangspunkt für die endgültige Installation darstellt.<br />
<br />
Die Testinstallation kann dann ganz oder teilweise wieder deinstalliert werden:<br />
C:\EBKuS-4.4.1>uninstall.py --all c:\ebkus_installation<br />
bzw.<br />
C:\EBKuS-4.4.1>uninstall.py c:\ebkus_installation ebkus<br />
Im ersten Fall wird auch der Webserver und die Datenbank deinstalliert, im zweiten nur die eigentliche EBKuS-Installation mitsamt allen Instanzen.<br />
<br />
=== Installation mit vorhandenem Webserver und Datenbank ===<br />
<br />
Mit<br />
C:\EBKuS-4.4.1>install.py --no_mysql --no_apache c:\ebkus_installation<br />
kann man eine Installation durchführen, wenn Apache und MySQL bereits vorhanden sind und nicht durch die EBKuS-Installation bereitgestellt werden sollen. Das Vorgehen ist dann ähnlich der [[Linux_Installation]]. Es muss manuell dafür gesorgt werden, dass die generierte Datei {{file|ebkus_httpd.conf}} in die Apachekonfiguration eingebunden wird, z.B. durch die Zeile <br />
Include c:\ebkus_installation\ebkus\ebkus_httpd.conf<br />
am Ende der Apache {{file|httpd.conf}}. Außerdem muss man nach der Installation und der Umkonfigurierung den Webserver manuell neu starten, damit er die neue Konfiguration übernimmt.<br />
<br />
=== Anpassen der Konfiguration ===<br />
<br />
In der Konfigurationsdatei {{file|ebkus.conf}} gibt es die Systemabschnitte {{code|DEFAULT, ebkus, apache}} und {{code|openssl}} sowie je einen Abschnitt für jede zu installierende Instanz.<br />
<br />
Dokumentation aller Konfigurationsvariablen siehe [[Konfiguration]].<br />
<br />
==== Systemabschnitte ====<br />
<br />
Im Abschnitt {{code|apache}} muss für die Variable {{konfig|server_name}} der Name angegeben werden, unter dem der Rechner im Netz ansprechbar ist (FQDN), ersatzweise die IP-Adresse. Der Name bzw. die IP-Adresse ist Bestandteil der URL, unter der EBKuS angesprochen wird. Der Standardwert ist hier {{code|localhost}}, womit EBKuS nur auf dem lokalen Rechner erreichbar wäre.<br />
<br />
Falls die Standardports 80 und 443 nicht für EBKuS zur Verfügung stehen, müssen hier alternative freie Ports eingetragen werden. {{konfig|server_http_port}} dient nur zur Kontrolle des Apache Webservers ({{code|<nowiki>http://localhost/</nowiki>}} liefert "It works!"). Falls eine Alternative für {{konfig|server_https_port}} eingetragen wird, muss der Port in der URL aufgeführt werden, um die Anwendung anzusprechen.<br />
<br />
Des weiteren kann die Email-Adresse des Systemadministrators bei {{konfig| server_admin}} eingetragen werden (die evt. auf Fehlerseiten des Servers erscheint). Im Abschnitt {{code|openssl}} sollten die regionalen und organisatorischen Angaben angepasst werden, da sie auf dem erzeugten Zertifikat erscheinen (das man sich z.B. im Browser ansehen kann).<br />
<br />
Sie können ein Passwort setzen für die Datenbankuser {{code|root}} (der Instanzdatenbanken löschen und erstellen kann):<br />
C:\>cd ebkus_installation\mysql5.1\bin<br />
C:\ebkus_installation\mysql5.1\bin>mysqladmin.exe -uroot password ''Neues Passwort''<br />
Dies muss dem Konfigurationsparameter {{konfig|database_admin_password}} zugewiesen werden.<br />
<br />
Alle anderen Werte in den Systemabschnitten sollten nur in Ausnahmefällen verändert werden.<br />
<br />
==== Instanzen ====<br />
<br />
Der Name des Abschnitts muss identisch sein mit dem Wert der Variablen {{konfig|instance_name}}. Der Name muss mit einem Buchstaben beginnen und darf neben Ziffern und Buchstaben nur das Sonderzeichen '_' enthalten.<br />
<br />
Mit der Variablen {{konfig|initial_content}} kann man einer Instanz eine Datei mit einem Datenbankdump (Sicherungsdatei) zuweisen, mit dem die Instanz initialisiert wird:<br />
initial_content: C:\backup\demo_braunschweig_backup_v4.4.1_2011-06-17_02-10-00.zip<br />
bzw.<br />
initial_content: demo_braunschweig_backup_v4.4.1_2011-06-17_02-10-00.zip<br />
Wenn nur der Dateiname angegeben ist, muss die Datei im Homeverzeichnis liegen ({{file|c:\ebkus_installation\ebkus\}}).<br />
Damit ist es möglich, eine Instanz aus einer bestehenden Installation in eine Neuinstallation zu migrieren (siehe unten). <br />
<br />
Jede Instanz benötigt einen eigenen freien Port (Variable {{konfig|port}}).<br />
<br />
=== Installation ohne Internetzugang ===<br />
<br />
Wenn alle [http://www.ebkus.org/alle_downloads.html benötigte Software für Windows 32 bit] in das Verzeichnis {{file|c:\ebkus_installation\download}} kopiert werden, wird kein Internetzugang benötigt. <br />
<br />
Alternativ kann beim ersten Aufruf von {{code|install.py}} ein Downloadverzeichnis angegeben werden, in dem sich die Installationsdateien befinden müssen:<br />
C:\EBKuS-4.5>install.py -d c:\ebkus_download c:\ebkus_installation<br />
Wenn bereits eine {{file|ebkus.conf}} existiert, wird das in der Variable {{konfig|download_dir}} definierte Verzeichnis verwendet und die Option {{code|-d}} kann entfallen.<br />
<br />
=== Migration ===<br />
<br />
Die Migration beinhaltet die Übernahme der Instanzen aus einer bestehenden EBKuS-Installation in eine Neuinstallation mit der neuen Software. Die EBKuS-Version der bestehenden Installation muss mindestens 4.2 sein; ältere müssen erst im Rahmen der bestehenden Installation updatet werden.<br />
<br />
==== Vorbereitung ====<br />
<br />
Für die Migration muss eine für die Neuinstallation gültige {{file|ebkus.conf}} bereitgestellt werden sowie eine Sicherungsdatei für jede zu migrierende Instanz. Die Sicherungsdatei wird in der alten Installation mit dem Skript {{code|datenbank_sichern.py --zip ''Verzeichnis''}} erzeugt.<br />
Die Zuordnung wird wie oben beschrieben für jede Instanz über die Konfigurationsvariable {{konfig|initial_content}} vorgenommen (nur Dateiname, ohne Pfadangabe). Ansonsten werden die Konfigurationen der Instanzen aus der alten {{file|ebkus.conf}} übernommen. Die Systemabschnitte für die neue {{file|ebkus.conf}} werden wie oben beschrieben aus der Testinstallation bzw. der Erstkonfiguration übernommen.<br />
<br />
==== Neuinstallation ====<br />
<br />
Die neu erstellte {{file|ebkus.conf}} wird zusammen mit den Sicherungsdateien in ein Verzeichnis kopiert, z.B. {{file|c:\ebkus_preconfig}}.<br />
<br />
Dem {{code|install.py}}-Skript wird das Verzeichnis mit der Option {{code|-p}} übergeben:<br />
C:\EBKuS-4.5>install.py -p c:\ebkus_preconfig c:\ebkus_installation<br />
Vor der Installation wird dann der Inhalt dieses Verzeichnisses in das Homeverzeichnis kopiert, so dass die Installation durch die neue {{file|ebkus.conf}} gesteuert wird. <br />
<br />
=== Einzelne Instanzen ===<br />
<br />
==== Entfernen ====<br />
<br />
Mit Hilfe des {{code|uninstall.py}}-Skripts lassen sich auch einzelne Instanzen entfernen.<br />
C:\EBKuS-4.5>uninstall.py c:\ebkus_installation ''Instanzname''<br />
Das {{code|uninstall.py}}-Skript kann auch aus dem Homeverzeichnis aufgerufen werden.<br />
<br />
Wichtig: Den Konfigurationsabschnitt der Instanz in der {{file|ebkus.conf}} erst nach der erfolgreichen Deinstallation entfernen! Sonst ist Handarbeit angesagt.<br />
<br />
==== Hinzufügen ====<br />
<br />
Als erstes muss in der {{file|ebkus.conf}} ein Abschnitt für die neu zu erstellende Instanz erstellt werden, evt. mit Angabe einer Sicherungsdatei oder eines SQL-Dumps für die Initialisierung der Datenbank der Instanz (Variable {{konfig|initial_content}}). <br />
<br />
Die Instanz kann dann mit<br />
C:\>cd ebkus_installation\ebkus<br />
C:\ebkus_installation\ebkus>configure.py ''Instanzname''<br />
eingerichtet werden. <br />
<br />
Wenn keine Datei zur Initialisierung angegeben wird, wird eine Datenbank mit den Standardmerkmalskatalogen und einem evt. konfigurierten Straßenkatalog erstellt. Wenn der Instanzname mit {{code|demo}} beginnt, werden zusätzlich Demodaten generiert.<br />
<br />
=== Mögliche Probleme ===<br />
<br />
* Windows-Dienste werden nicht automatisch installiert: die Konsole muss als Administrator ausgeführt werden.<br />
* Nicht vollständig deinstallierte Dienste: notfalls mit {{code|sc delete ''Name''}} entfernen. Wenn der Name dann trotzdem noch in der Liste der Dienste auftaucht mit dem Zustand {{code|Deaktiviert}}, muss ein Neustart gemacht werden.<br />
* Übrig gebliebene Reste in der Registry von früheren Installationen, z.B. des MySQL-Servers. Diese müssen notfalls manuell beseitigt werden.<br />
* Instanz lässt sich nicht mit Sicherungsdatei initialisieren: Die Sicherungsdatei muss von einer Instanz mit demselben Namen stammen.<br />
* Automatischer Download klappt nicht: Falls der Internetzugang über einen Proxy erfolgt, muss man möglicherweise (ich habs nicht probiert) manuell herunterladen und die Dateien im Downloadverzeichnis ablegen.<br />
* Firefox akzeptiert das von EBKuS gelieferte Zertifikat (wg. doppelter Seriennummer oder so ähnlich): Zertifikate in Firefox löschen über {{pfad5|Einstellungen|Erweitert|Zertifikate|Zertifikate anzeigen|Löschen}}. Die EBKuS-Zertifikate stehen unter dem Namen EFB bzw. unter dem Namen, der in der {{file|ebkus.conf}} als {{konfig|organisation}} (im Abschnitt {{konfig|openssl}}) eingetragen wurde.<br />
<br />
=== Tipps ===<br />
<br />
* Das {{code|install.py}}-Skript lässt sich wiederholt ausführen. Eine bestehende MySQL- und Apache-Installation wird nicht wiederholt. Vorhandene Instanzdatenbanken bleiben ebenfalls intakt. Evt. neu hinzugekommenen Instanzkonfigurationen werden ausgeführt, d.h. die neue Instanz wird eingerichtet. (Löschen einer Instanz jedoch immer mit {{code|uninstall.py}}!) Alle zu generierenden Dateien werden neu generiert, so dass z.B. auf diese Weise Port-Änderungen oder die Änderung des Servernamens durchgeführt werden können.<br />
* Wenn das {{code|install.py}}-Skript mit der Option {{code|-u}} bzw. {{code|--update}} wiederholt wird, werden zusätzlich alle EBKuS-Dateien aus der Distribution in das Homeverzeichnis kopiert. <br />
* Hilfe für alle Skripte erhält man mit der Option {{code|--help}} oder kurz {{code|-h}}:<br />
C:\EBKuS-4.5>install.py --help<br />
C:\EBKuS-4.5>uninstall.py -h<br />
C:\ebkus_installation\ebkus>configure.py -h<br />
C:\ebkus_installation\ebkus\demo>dienst.py -h<br />
* Falls Änderungen an generierten Dateien nötig sind (z.B. Apache- oder MySQL-Konfiguration) ist es wenig sinnvoll, diese selbst zu verändern, da man dann nicht mehr die Möglichkeit hat, die Installationsskripte zu verwenden. Besser ist is es, die Templates selber anzupassen. Alle Templates (Vorlagen) für generierte Dateien finden sich im Verzeichnis {{file|templates}} im Homeverzeichnis.</div>Ebkushttps://www.ebkus.org/wiki/Linux_InstallationLinux Installation2020-08-19T10:23:24Z<p>Ebkus: </p>
<hr />
<div>Gültig ab: EBKuS 4.10<br />
<br />
Die folgende Anleitung habe ich mit "Debian GNU/Linux 10 (buster)" getestet; vermutlich funktioniert das auch auf anderen Ubuntu bzw. Debian-basierten Gnu/Linux-Distributionen.<br />
<br />
Die Installation im folgenden Beispiel erfolgt unter dem User {{code|ebkus}} auf einem Rechner mit dem Namen {{code|ebvm}}. Der User {{code|ebkus}} benötigt Superuserrechte ({{code|sudo}}). Es wird angenommen, dass eine Internetverbindung besteht (zur Installation von Software mit {{code|apt-get}}).<br />
<br />
Die Installation erfolgt ausschließlich über die Kommandozeile. Damit funktioniert sie auch auf reinen Servern, die keine GUI haben.<br />
<br />
Bitte auch die [[Windows Installation]] beachten, da sind einige betriebssystemunabhängige Punkte ausführlicher dargestellt als hier.<br />
<br />
=== Voraussetzungen ===<br />
<br />
Folgende Voraussetzungen müssen erfüllt sein, damit EBKuS installiert werden kann:<br />
<br />
==== Python 2.7 ====<br />
<br />
Ist auf solche Systemen normalerweise bereits installiert, ansonsten:<br />
<br />
ebkus@ebvm:~$ sudo apt-get install python2.7<br />
<br />
Die Python Version sollte 2.7.13 oder höher sein, optimalerweise<br />
2.7.18, welches die letzte Python-2-Version darstellt.<br />
Python 2 wird nicht mehr weiterentwickelt wird. EBKuS ist noch nicht<br />
auf Python 3 portiert.<br />
<br />
==== MySQL ====<br />
<br />
Es sollte eine MySQL 5.*-Version zur Verfügung stehen, z.B. 5.1, 5.6<br />
oder 5.7. Zur Installation auf Debian 10 siehe zum Beispiel<br />
https://tecadmin.net/install-mysql-on-debian-10-buster/<br />
Kurz zusammengefasst wie folgt:<br />
<br />
1. System auf den neuesten Stand bringen:<br />
<br />
ebkus@ebvm:~$ sudo apt update <br />
ebkus@ebvm:~$ sudo apt upgrade<br />
<br />
2. PPA (Personal Package Archive, Paketquelle) von MySQL einrichten und MySQL-Installation konfigurieren:<br />
<br />
ebkus@ebvm:~$ wget <nowiki>http://repo.mysql.com/mysql-apt-config_0.8.15-1_all.deb</nowiki><br />
ebkus@ebvm:~$ sudo dpkg -i mysql-apt-config_0.8.15-1_all.deb<br />
<br />
Beim letzten Schritt unbedingt ein MySQL 5 auswählen, also 5.6<br />
oder 5.7! EBKuS wurde noch nicht auf höheren Versionen getestet.<br />
<br />
3. MySQL installieren:<br />
<br />
ebkus@ebvm:~$ sudo apt update <br />
ebkus@ebvm:~$ sudo apt install mysql-server<br />
<br />
Bei der Installation muss ein Passwort für den Datenbank-User {{code|root}} angegeben werden, das später in die {{file|ebkus.conf}} eingetragen werden muss. Nach einer erfolgreichen Installation kann man sich mit dem Befehl<br />
<br />
ebkus@ebvm:~$ mysql -uroot -p''Passwort''<br />
Welcome to the MySQL monitor. Commands end with ; or \g.<br />
...<br />
mysql><br />
<br />
mit der Datenbank verbinden.<br />
<br />
Falls der Standardport 3306 für MySQL nicht zur Verfügung steht, muss die Datei {{file|/etc/mysql/my.cnf}} angepasst werden.<br />
<br />
==== Python-MySQLdb ====<br />
<br />
Den Datenbankadapter für Python-MySQL installieren:<br />
ebkus@ebvm:~$ sudo apt-get install python-mysqldb<br />
Nach erfolgreicher Installation kann man Python aufrufen und MySQLdb importieren:<br />
ebkus@ebvm:~$ python<br />
Python 2.7.16 (default, Oct 10 2019, 22:02:15)<br />
...<br />
>>> import MySQLdb<br />
>>><br />
<br />
==== Apache 2 ====<br />
<br />
Den Webserver installieren:<br />
ebkus@ebvm:~$ sudo apt-get install apache2<br />
Nach der erfolgreichen Installation erhält man mit einem Browser mit der Adresse <nowiki>http://localhost/</nowiki> eine Seite mit '''It works!'''. Oder man installiert z.B. {{code|wget}} und erhält mit der genannten Adresse die entsprechende HTML-Datei {{file|index.html}}:<br />
ebkus@ebvm:~$ sudo apt-get install wget<br />
ebkus@ebvm:~$ wget <nowiki>http://localhost/</nowiki><br />
<br />
Falls der Webserver nicht auf den Standardports 80 und 443 laufen soll, muss die Datei {{file|/etc/apache2/ports.conf}} angepasst werden, ebenso die {{file|ebkus.conf}} (siehe [[Konfiguration]])<br />
<br />
Um den Webserver zu konfigurieren, müssen das ssl-Modul und das<br />
cgi-Modul aktiviert werden:<br />
ebkus@ebvm:~$ sudo a2enmod ssl<br />
ebkus@ebvm:~$ sudo a2enmod cgi<br />
<br />
Außerdem muss die von EBKuS generierte Apache-Konfigurationsdatei eingebunden werden:<br />
ebkus@ebvm:~$ cd /etc/apache2/sites-enabled<br />
ebkus@ebvm:/etc/apache2/sites-enabled$ sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl.conf<br />
Die Datei {{file|ebkus_httpd.conf}} existiert zu diesem Zeitpunkt noch nicht, sie wird bei der Installation ({{file|install.py}}) und bei jeder Änderung von Instanzen ({{file|configure.py}}) neu generiert. Sie definiert einen Virtual Host für den Webserver, über den alle EBKuS-Instanzen angesprochen werden.<br />
<br />
'''Dateirechte:''' Alle Verzeichnisse, die in einem Pfad zu einer Datei stehen, die vom Webserver gelesen werden soll, müssen das Leserecht und das Ausführungsrecht besitzen. Wenn das Installationsverzeichnis wie im Beispiel im Homeverzeichnis eines Benutzers steht, müssen diese Rechte evt. explizit vergeben werden:<br />
ebkus@ebvm:~$ sudo chmod go+rx /home/ebkus <br />
Den vom Installationsskript erzeugten Verzeichnissen und Dateien werden diese Rechte automatisch gegeben.<br />
<br />
<br />
==== EBKuS ====<br />
<br />
Die neueste [http://www.ebkus.org/alle_downloads.html EBKuS-Software]<br />
herunterladen, auspacken und in das Distributionsverzeichnis gehen, z.B.:<br />
<br />
ebkus@ebkusvm1:~$ wget https://ebkus.org/downloads/ebkus-4.10/ebkus-4.10-src.zip<br />
ebkus@ebkusvm1:~$ unzip ebkus-4.10-src.zip<br />
ebkus@ebkusvm1:~$ cd EBKuS-4.10<br />
ebkus@ebkusvm1:~/EBKuS-4.10$<br />
<br />
=== Installation ===<br />
<br />
==== Erstkonfiguration ====<br />
<br />
Erstkonfiguration erzeugen:<br />
ebkus@ebkusvm1:~/EBKuS-4.10$ python install.py -c ~/ebkus_installation<br />
Die EBKuS-Konfigurationsdatei {{file|/home/ebkus/ebkus_installation/ebkus/ebkus.conf}} kann nun weiter bearbeitet und für die eigentliche Installation verwendet werden.<br />
<br />
==== Systemkonfiguration ====<br />
<br />
System-[[Konfiguration]] anpassen, insbesondere:<br />
* Passwort für Datenbank-User {{code|root}} eintragen (Parameter {{konfig|database_admin_password}})<br />
* {{konfig|server_name}}, normalerweise die IP-Nummer des Rechners<br />
* Evt. Standardports {{konfig|server_https_port}} und {{konfig|server_http_port}} anpassen<br />
* {{konfig| server_admin}}<br />
* Im Abschnitt {{code|openssl}} Angaben zur Region und Organisation<br />
<br />
==== Instanzkonfiguration ====<br />
<br />
Instanz-[[Konfiguration]] anpassen:<br />
* {{konfig|instance_name}}, optional {{konfig|instance_title}}<br />
* {{konfig|initial_content}}, falls eine initiale Datenbank vorhanden ist (z.B. aus einer früheren Installation)<br />
* {{konfig|port}}<br />
<br />
==== Installation ====<br />
<br />
Installation:<br />
ebkus@ebkusvm1:~/EBKuS-4.10$ python install.py ~/ebkus_installation<br />
Bei der Installation wird man unter Umständen nach dem Passwort des (Linux-)Users gefragt, dasselbe, das man bei einem vorangestellten {{code|sudo}} angeben muss. Damit können die start/stop-Skripte in die Bootsequenz ({{file|/etc/init.d/}}) eingetragen werden<br />
<br />
Nach der Installation (und auch nach jeder Umkonfigurierung mit {{file|configure.py}}) muss der Webserver neu gestartet werden:<br />
ebkus@ebvm:~$ sudo service apache2 restart<br />
* Restarting web server apache2 [ OK ]<br />
Ansonsten wird die neu generierte Webserver-Konfiguration in {{file|ebkus_httpd.conf}} nicht wirksam.<br />
<br />
==== Migration ====<br />
<br />
Falls wie [[Windows_Installation#Migration|hier]] beschrieben eine Menge von bestehenden Instanzen in die neue Installation übernommen werden soll:<br />
ebkus@ebkusvm1:~/EBKuS-4.10$ python install.py -p ~/ebkus_preconfig ~/ebkus_installation<br />
Im Verzeichnis {{file|~/ebkus_preconfig}} muss dann eine gültige {{file|ebkus.conf}} liegen sowie eine Sicherungsdatei für jede Instanz, die in der Konfiguration über den Parameter {{konfig|initial_content}} eingebunden wird.<br />
<br />
=== Dienste ===<br />
<br />
Im Unterschied zu [[Windows Installation|Windows]] werden bei der Installation und der Konfigurierung keine Dienste gestartet oder gestoppt. Es werden jedoch Skripte in {{file|/etc/init.d}} generiert, mit denen die EBKuS-Server hoch und runtergefahren werden. Beim booten des Systems geschieht dies automatisch, d.h. nach einem Reboot steht EBKuS automatisch zur Verfügung.<br />
<br />
Für den Systemadministrator gibt es folgende Skripte, die nach der Installation im Homeverzeichnis stehen:<br />
* {{code|ebkusctl}}: Damit kann jede Instanz einzeln oder auch alle Instanzen gemeinsam hoch- und runtergefahren werden sowie deren Status abgefragt werden. Dieses Skript verwendet intern die generierten Skripte in {{file|/etc/init.d}}.<br />
* {{code|ebkusdump}}: Für jede Instanz einzeln oder für alle zusammen eine Sicherungsdatei erzeugen (verwendet intern {{file|datenbank_sichern.py||}}).<br />
* {{code|ebkusrestore}}: Für jede Instanz einzeln oder für alle zusammen die Datenbank aus eine Sicherungsdatei initialisieren (verwendet intern {{file| datenbank_initialisieren.py||}}).<br />
Z.B.<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl all start<br />
* Starting EBKuS demo [ OK ] <br />
* Starting EBKuS muster_efb [ OK ] <br />
* Starting EBKuS demo_braunschweig [ OK ] <br />
Jedes Skript hat eingebaute Hilfe:<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl --help<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl -h<br />
<br />
<br />
<br />
<br />
<br />
<!--<br />
<br />
Schritte:<br />
<br />
#`Installationsverzeichnis`_ einrichten, z.B. {{code|/home/user/ebinst}}:<br />
mkdir /home/user/ebinst<br />
#In das `Distributionsverzeichnis`_ gehen (z.B. {{code|/home/user/ebkus-cd/ebkus-3.3}}; man könnte hier auch direkt von der CD arbeiten):<br />
<br />
<br />
cd /home/user/ebkus-cd/ebkus-3.3<br />
#EBKuS-Konfiguration erzeugen:<br />
python install.py --config /home/user/ebinst<br />
#Erzeugte Konfigurationsdatei {{code|/home/user/ebinst/ebkus/ebkus.conf}}anpassen (siehe `Konfiguration`_).<br />
#EBKuS und alle in der Konfigurationsdatei definierten Instanzen installieren und konfigurieren:<br />
python install.py /home/user/ebinst<br />
Für jede in der Konfiguration definierten Instanz gibt es dann ein `Instanzverzeichnis`_:<br />
<br />
<blockquote>{{code|/home/user/ebinst/ebkus/}}''Instanzname''<br />
<br />
</blockquote><br />
Die Meldungen des Installationsskriptes stehen auch in der Datei {{code|/home/user/ebinst/install.log}}.<br />
<br />
#(als {{code|root}}) Die in Schritt 5. erzeugte Datei {{code|/home/user/ebinst/ebkus/ebkus_httpd.conf}} in die Apache-Konfigurationsdatei (bei SuSE z.B. /etc/httpd/httpd.conf) inkludieren, z.B. indem Sie dort am Ende die folgende Zeile eintragen:<br />
Include /home/user/ebinst/ebkus/ebkus_httpd.conf<br />
#(als {{code|root}}) Den Apache-Webserver neustarten, damit die modifizierte Konfiguration berücksichtigt wird, z.B. bei SuSE:<br />
rcapache restart<br />
#Eine konfigurierte EBKuS-Instanz testen, z.B. die Instanz demo:<br />
cd /home/user/ebinst/ebkus/demo <br />
./start.py --console<br />
Der gestartete Server gibt Meldungen auf die Konsole aus.<br />
<br />
#Über einen Browser mit der Instanz {{code|demo}} arbeiten (anstatt {{code|demo}} auch mit jeder anderen in der `Konfiguration`_definierten Instanz):<br />
https://localhost/ebkus/demo/cgi/do/login<br />
Die Login-Maske kann auch über eine vorgeschaltete Eingangsseite erreicht werden, die für jede Instanz generiert wird:<br />
<br />
https://localhost/ebkus/demo/index.html<br />
Diese Seite kann mit einem HTML-Editor gemäß den lokalen Bedürfnissen erweitert oder verändert werden. Die zu editierende Datei ist im `Instanzverzeichnis`_ unter {{code|htdocs/index.html}} zu finden.<br />
<br />
Als Administrator anmelden: Benutzer {{code|Admin}}, Passwort {{code|Admin}}. Als angemeldeter Administrator können Sie weitere Benutzer anlegen.<br />
<br />
Die Instanzen {{code|demo}} bzw. {{code|demo_berlin}} enthalten bereits Beispieldaten, mit denen Sie experimentieren können. Sie können sich also gleich als Bearbeiter bzw. als Verwaltungskraft anmelden, z.B. Benutzer {{code|test}}, Passwort {{code|test}} bzw. Benutzer {{code|verw}}, Passwort {{code|verw}}.<br />
<br />
Falls Sie in der Konfiguration den Parameter ''server_name'' mit einer in Ihrem Netzwerk gültigen IP-Adresse oder einem gültigen Namen belegt haben, können Sie auch von anderen Rechnern im Netzwerk auf eine EBKuS-Instanz zugreifen, z.B.:<br />
<br />
https://192.168.1.92/ebkus/demo/index.html https://192.168.1.92/ebkus/demo/cgi/do/login<br />
#(als {{code|root}}) Die Instanz in die Bootsequenz des Servers aufnehmen, so dass beim Hochfahren des Rechners der EBKuS-Server für die Instanz automatisch gestartet wird:<br />
cd /home/user/ebinst/ebkus/demo cp ebkus_demo /etc/init.d<br />
Die Links für die Run-Level manuell setzen oder, z.B. bei SuSE, den Run-Level-Editor verwenden.<br />
<br />
#In einer Produktionsinstanz die Anwendung einrichten, siehe Einrichtung der Anwendung im Handbuch.<br />
<br />
<br />
<br />
<br />
- Apache richtig löschen, so dass frische Konfig kommt:<br />
<br />
- sudo dpkg --purge --force-remove-reinstreq apache2.2-common<br />
<br />
So geht richtiges uninstall mit Konfiguration:<br />
apt-get remove ––purge *paketname*<br />
<br />
<br />
<br />
- download mit wget auf dem ubuntu server<br />
<br />
<br />
<br />
== Apache Konfiguration ==<br />
<br />
cd /etc/apache2/mods-enabled<br />
sudo ln -s ../mods-available/ssl.conf ssl.conf<br />
sudo ln -s ../mods-available/ssl.load ssl.load<br />
<br />
cd /etc/apache2/sites-enabled<br />
sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl<br />
http://ebkus.org/wiki/Linux_Installation#MySQL<br />
http://ebkus.org/wiki/Linux_Installation#Apache_2<br />
<br />
--></div>Ebkushttps://www.ebkus.org/wiki/Linux_InstallationLinux Installation2020-08-19T10:21:42Z<p>Ebkus: </p>
<hr />
<div>Gültig ab: EBKuS 4.10<br />
<br />
Die folgende Anleitung habe ich mit "Debian GNU/Linux 10 (buster)" getestet; vermutlich funktioniert das auch auf anderen Ubuntu bzw. Debian-basierten Gnu/Linux-Distributionen.<br />
<br />
Die Installation im folgenden Beispiel erfolgt unter dem User {{code|ebkus}} auf einem Rechner mit dem Namen {{code|ebvm}}. Der User {{code|ebkus}} benötigt Superuserrechte ({{code|sudo}}). Es wird angenommen, dass eine Internetverbindung besteht (zur Installation von Software mit {{code|apt-get}}).<br />
<br />
Die Installation erfolgt ausschließlich über die Kommandozeile. Damit funktioniert sie auch auf reinen Servern, die keine GUI haben.<br />
<br />
Bitte auch die [[Windows Installation]] beachten, da sind einige betriebssystemunabhängige Punkte ausführlicher dargestellt als hier.<br />
<br />
=== Voraussetzungen ===<br />
<br />
Folgende Voraussetzungen müssen erfüllt sein, damit EBKuS installiert werden kann:<br />
<br />
==== Python 2.7 ====<br />
<br />
Ist auf solche Systemen normalerweise bereits installiert, ansonsten:<br />
<br />
ebkus@ebvm:~$ sudo apt-get install python2.7<br />
<br />
Die Python Version sollte 2.7.13 oder höher sein, optimalerweise<br />
2.7.18, welches die letzte Python-2-Version darstellt.<br />
Python 2 wird nicht mehr weiterentwickelt wird. EBKuS ist noch nicht<br />
auf Python 3 portiert.<br />
<br />
==== MySQL ====<br />
<br />
Es sollte eine MySQL 5.*-Version zur Verfügung stehen, z.B. 5.1, 5.6<br />
oder 5.7. Zur Installation auf Debian 10 siehe zum Beispiel<br />
https://tecadmin.net/install-mysql-on-debian-10-buster/<br />
Kurz zusammengefasst wie folgt:<br />
<br />
1. System auf den neuesten Stand bringen:<br />
<br />
ebkus@ebvm:~$ sudo apt update <br />
ebkus@ebvm:~$ sudo apt upgrade<br />
<br />
2. PPA (Personal Package Archive, Paketquelle) von MySQL einrichten und MySQL-Installation konfigurieren:<br />
<br />
ebkus@ebvm:~$ wget <nowiki>http://repo.mysql.com/mysql-apt-config_0.8.15-1_all.deb</nowiki><br />
ebkus@ebvm:~$ sudo dpkg -i mysql-apt-config_0.8.15-1_all.deb<br />
<br />
Beim letzten Schritt unbedingt ein MySQL 5 auswählen, also 5.6<br />
oder 5.7! EBKuS wurde noch nicht auf höheren Versionen getestet.<br />
<br />
3. MySQL installieren:<br />
<br />
ebkus@ebvm:~$ sudo apt update <br />
ebkus@ebvm:~$ sudo apt install mysql-server<br />
<br />
Bei der Installation muss ein Passwort für den Datenbank-User {{code|root}} angegeben werden, das später in die {{file|ebkus.conf}} eingetragen werden muss. Nach einer erfolgreichen Installation kann man sich mit dem Befehl<br />
<br />
ebkus@ebvm:~$ mysql -uroot -p''Passwort''<br />
Welcome to the MySQL monitor. Commands end with ; or \g.<br />
...<br />
mysql><br />
<br />
mit der Datenbank verbinden.<br />
<br />
Falls der Standardport 3306 für MySQL nicht zur Verfügung steht, muss die Datei {{file|/etc/mysql/my.cnf}} angepasst werden.<br />
<br />
==== Python-MySQLdb ====<br />
<br />
Den Datenbankadapter für Python-MySQL installieren:<br />
ebkus@ebvm:~$ sudo apt-get install python-mysqldb<br />
Nach erfolgreicher Installation kann man Python aufrufen und MySQLdb importieren:<br />
ebkus@ebvm:~$ python<br />
Python 2.7.16 (default, Oct 10 2019, 22:02:15)<br />
...<br />
>>> import MySQLdb<br />
>>><br />
<br />
==== Apache 2 ====<br />
<br />
Den Webserver installieren:<br />
ebkus@ebvm:~$ sudo apt-get install apache2<br />
Nach der erfolgreichen Installation erhält man mit einem Browser mit der Adresse <nowiki>http://localhost/</nowiki> eine Seite mit '''It works!'''. Oder man installiert z.B. {{code|wget}} und erhält mit der genannten Adresse die entsprechende HTML-Datei {{file|index.html}}:<br />
ebkus@ebvm:~$ sudo apt-get install wget<br />
ebkus@ebvm:~$ wget <nowiki>http://localhost/</nowiki><br />
<br />
Falls der Webserver nicht auf den Standardports 80 und 443 laufen soll, muss die Datei {{file|/etc/apache2/ports.conf}} angepasst werden, ebenso die {{file|ebkus.conf}} (siehe [[Konfiguration]])<br />
<br />
Um den Webserver zu konfigurieren, müssen das ssl-Modul und das<br />
cgi-Modul aktiviert werden:<br />
ebkus@ebvm:~$ sudo a2enmod ssl<br />
ebkus@ebvm:~$ sudo a2enmod cgi<br />
<br />
Außerdem muss die von EBKuS generierte Apache-Konfigurationsdatei eingebunden werden:<br />
ebkus@ebvm:~$ cd /etc/apache2/sites-enabled<br />
ebkus@ebvm:/etc/apache2/sites-enabled$ sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl.conf<br />
Die Datei {{file|ebkus_httpd.conf}} existiert zu diesem Zeitpunkt noch nicht, sie wird bei der Installation ({{file|install.py}}) und bei jeder Änderung von Instanzen ({{file|configure.py}}) neu generiert. Sie definiert einen Virtual Host für den Webserver, über den alle EBKuS-Instanzen angesprochen werden.<br />
<br />
'''Dateirechte:''' Alle Verzeichnisse, die in einem Pfad zu einer Datei stehen, die vom Webserver gelesen werden soll, müssen das Leserecht und das Ausführungsrecht besitzen. Wenn das Installationsverzeichnis wie im Beispiel im Homeverzeichnis eines Benutzers steht, müssen diese Rechte evt. explizit vergeben werden:<br />
ebkus@ebvm:~$ sudo chmod go+rx /home/ebkus <br />
Den vom Installationsskript erzeugten Verzeichnissen und Dateien werden diese Rechte automatisch gegeben.<br />
<br />
<br />
==== EBKuS ====<br />
<br />
Die neueste [http://www.ebkus.org/alle_downloads.html EBKuS-Software]<br />
herunterladen, auspacken und in das Distributionsverzeichnis gehen, z.B.:<br />
<br />
ebkus@ebkusvm1:~$ wget https://ebkus.org/downloads/ebkus-4.10/ebkus-4.10-src.zip<br />
ebkus@ebkusvm1:~$ unzip ebkus-4.10-src.zip<br />
ebkus@ebkusvm1:~$ cd EBKuS-4.10<br />
ebkus@ebkusvm1:~/EBKuS-4.10$<br />
<br />
=== Installation ===<br />
<br />
==== Erstkonfiguration ====<br />
<br />
Erstkonfiguration erzeugen:<br />
ebkus@ebkusvm1:~/EBKuS-4.10$ python install.py -c ~/ebkus_installation<br />
Die EBKuS-Konfigurationsdatei {{file|/home/ebkus/ebkus_installation/ebkus/ebkus.conf}} kann nun weiter bearbeitet und für die eigentliche Installation verwendet werden.<br />
<br />
==== Systemkonfiguration ====<br />
<br />
System-[[Konfiguration]] anpassen, insbesondere:<br />
* Passwort für Datenbank-User {{code|root}} eintragen (Parameter {{konfig|database_admin_password}})<br />
* {{konfig|server_name}}, normalerweise die IP-Nummer des Rechners<br />
* Evt. Standardports {{konfig|server_https_port}} und {{konfig|server_http_port}} anpassen<br />
* {{konfig| server_admin}}<br />
* Im Abschnitt {{code|openssl}} Angaben zur Region und Organisation<br />
<br />
==== Instanzkonfiguration ====<br />
<br />
Instanz-[[Konfiguration]] anpassen:<br />
* {{konfig|instance_name}}, optional {{konfig|instance_title}}<br />
* {{konfig|initial_content}}, falls eine initiale Datenbank vorhanden ist (z.B. aus einer früheren Installation)<br />
* {{konfig|port}}<br />
<br />
==== Installation ====<br />
<br />
Installation:<br />
ebkus@ebkusvm1:~/EBKuS-4.10$ python install.py ~/ebkus_installation<br />
Bei der Installation wird man unter Umständen nach dem Passwort des (Linux-)Users gefragt, dasselbe, das man bei einem vorangestellten {{code|sudo}} angeben muss. Damit können die start/stop-Skripte in die Bootsequenz ({{file|/etc/init.d/}}) eingetragen werden<br />
<br />
Nach der Installation (und auch nach jeder Umkonfigurierung mit {{file|configure.py}}) muss der Webserver neu gestartet werden:<br />
ebkus@ebvm:~$ sudo service apache2 restart<br />
* Restarting web server apache2 [ OK ]<br />
Ansonsten wird die neu generierte Webserver-Konfiguration in {{file|ebkus_httpd.conf}} nicht wirksam.<br />
<br />
==== Migration ====<br />
<br />
Falls wie [[Windows_Installation#Migration|hier]] beschrieben eine Menge von bestehenden Instanzen in die neue Installation übernommen werden soll:<br />
ebkus@ebkusvm1:~/EBKuS-4.10$ python install.py -p ~/ebkus_preconfig ~/ebkus_installation<br />
Im Verzeichnis {{file|~/ebkus_preconfig}} muss dann eine gültige {{file|ebkus.conf}} liegen sowie eine Sicherungsdatei für jede Instanz, die in der Konfiguration über den Parameter {{konfig|initial_content}} eingebunden wird.<br />
<br />
=== Dienste ===<br />
<br />
Im Unterschied zur [[Windows Installation|Windows]] werden bei der Installation und der Konfigurierung keine Dienste gestartet oder gestoppt. Es werden jedoch Skripte in {{file|/etc/init.d}} generiert, mit denen die EBKuS-Server hoch und runtergefahren werden. Beim booten des Systems geschieht dies automatisch, d.h. nach einem Reboot steht EBKuS automatisch zur Verfügung.<br />
<br />
Für den Systemadministrator gibt es folgende Skripte, die nach der Installation im Homeverzeichnis stehen:<br />
* {{code|ebkusctl}}: Damit kann jede Instanz einzeln oder auch alle Instanzen gemeinsam hoch- und runtergefahren werden sowie deren Status abgefragt werden. Dieses Skript verwendet intern die generierten Skripte in {{file|/etc/init.d}}.<br />
* {{code|ebkusdump}}: Für jede Instanz einzeln oder für alle zusammen eine Sicherungsdatei erzeugen (verwendet intern {{file|datenbank_sichern.py||}}).<br />
* {{code|ebkusrestore}}: Für jede Instanz einzeln oder für alle zusammen die Datenbank aus eine Sicherungsdatei initialisieren (verwendet intern {{file| datenbank_initialisieren.py||}}).<br />
Z.B.<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl all start<br />
* Starting EBKuS demo [ OK ] <br />
* Starting EBKuS muster_efb [ OK ] <br />
* Starting EBKuS demo_braunschweig [ OK ] <br />
Jedes Skript hat eingebaute Hilfe:<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl --help<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl -h<br />
<br />
<br />
<br />
<br />
<br />
<!--<br />
<br />
Schritte:<br />
<br />
#`Installationsverzeichnis`_ einrichten, z.B. {{code|/home/user/ebinst}}:<br />
mkdir /home/user/ebinst<br />
#In das `Distributionsverzeichnis`_ gehen (z.B. {{code|/home/user/ebkus-cd/ebkus-3.3}}; man könnte hier auch direkt von der CD arbeiten):<br />
<br />
<br />
cd /home/user/ebkus-cd/ebkus-3.3<br />
#EBKuS-Konfiguration erzeugen:<br />
python install.py --config /home/user/ebinst<br />
#Erzeugte Konfigurationsdatei {{code|/home/user/ebinst/ebkus/ebkus.conf}}anpassen (siehe `Konfiguration`_).<br />
#EBKuS und alle in der Konfigurationsdatei definierten Instanzen installieren und konfigurieren:<br />
python install.py /home/user/ebinst<br />
Für jede in der Konfiguration definierten Instanz gibt es dann ein `Instanzverzeichnis`_:<br />
<br />
<blockquote>{{code|/home/user/ebinst/ebkus/}}''Instanzname''<br />
<br />
</blockquote><br />
Die Meldungen des Installationsskriptes stehen auch in der Datei {{code|/home/user/ebinst/install.log}}.<br />
<br />
#(als {{code|root}}) Die in Schritt 5. erzeugte Datei {{code|/home/user/ebinst/ebkus/ebkus_httpd.conf}} in die Apache-Konfigurationsdatei (bei SuSE z.B. /etc/httpd/httpd.conf) inkludieren, z.B. indem Sie dort am Ende die folgende Zeile eintragen:<br />
Include /home/user/ebinst/ebkus/ebkus_httpd.conf<br />
#(als {{code|root}}) Den Apache-Webserver neustarten, damit die modifizierte Konfiguration berücksichtigt wird, z.B. bei SuSE:<br />
rcapache restart<br />
#Eine konfigurierte EBKuS-Instanz testen, z.B. die Instanz demo:<br />
cd /home/user/ebinst/ebkus/demo <br />
./start.py --console<br />
Der gestartete Server gibt Meldungen auf die Konsole aus.<br />
<br />
#Über einen Browser mit der Instanz {{code|demo}} arbeiten (anstatt {{code|demo}} auch mit jeder anderen in der `Konfiguration`_definierten Instanz):<br />
https://localhost/ebkus/demo/cgi/do/login<br />
Die Login-Maske kann auch über eine vorgeschaltete Eingangsseite erreicht werden, die für jede Instanz generiert wird:<br />
<br />
https://localhost/ebkus/demo/index.html<br />
Diese Seite kann mit einem HTML-Editor gemäß den lokalen Bedürfnissen erweitert oder verändert werden. Die zu editierende Datei ist im `Instanzverzeichnis`_ unter {{code|htdocs/index.html}} zu finden.<br />
<br />
Als Administrator anmelden: Benutzer {{code|Admin}}, Passwort {{code|Admin}}. Als angemeldeter Administrator können Sie weitere Benutzer anlegen.<br />
<br />
Die Instanzen {{code|demo}} bzw. {{code|demo_berlin}} enthalten bereits Beispieldaten, mit denen Sie experimentieren können. Sie können sich also gleich als Bearbeiter bzw. als Verwaltungskraft anmelden, z.B. Benutzer {{code|test}}, Passwort {{code|test}} bzw. Benutzer {{code|verw}}, Passwort {{code|verw}}.<br />
<br />
Falls Sie in der Konfiguration den Parameter ''server_name'' mit einer in Ihrem Netzwerk gültigen IP-Adresse oder einem gültigen Namen belegt haben, können Sie auch von anderen Rechnern im Netzwerk auf eine EBKuS-Instanz zugreifen, z.B.:<br />
<br />
https://192.168.1.92/ebkus/demo/index.html https://192.168.1.92/ebkus/demo/cgi/do/login<br />
#(als {{code|root}}) Die Instanz in die Bootsequenz des Servers aufnehmen, so dass beim Hochfahren des Rechners der EBKuS-Server für die Instanz automatisch gestartet wird:<br />
cd /home/user/ebinst/ebkus/demo cp ebkus_demo /etc/init.d<br />
Die Links für die Run-Level manuell setzen oder, z.B. bei SuSE, den Run-Level-Editor verwenden.<br />
<br />
#In einer Produktionsinstanz die Anwendung einrichten, siehe Einrichtung der Anwendung im Handbuch.<br />
<br />
<br />
<br />
<br />
- Apache richtig löschen, so dass frische Konfig kommt:<br />
<br />
- sudo dpkg --purge --force-remove-reinstreq apache2.2-common<br />
<br />
So geht richtiges uninstall mit Konfiguration:<br />
apt-get remove ––purge *paketname*<br />
<br />
<br />
<br />
- download mit wget auf dem ubuntu server<br />
<br />
<br />
<br />
== Apache Konfiguration ==<br />
<br />
cd /etc/apache2/mods-enabled<br />
sudo ln -s ../mods-available/ssl.conf ssl.conf<br />
sudo ln -s ../mods-available/ssl.load ssl.load<br />
<br />
cd /etc/apache2/sites-enabled<br />
sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl<br />
http://ebkus.org/wiki/Linux_Installation#MySQL<br />
http://ebkus.org/wiki/Linux_Installation#Apache_2<br />
<br />
--></div>Ebkushttps://www.ebkus.org/wiki/Linux_InstallationLinux Installation2020-08-19T09:57:32Z<p>Ebkus: </p>
<hr />
<div>Gültig ab: EBKuS 4.10<br />
<br />
Die folgende Anleitung habe ich mit "Debian GNU/Linux 10 (buster)" getestet; vermutlich funktioniert das auch auf anderen Ubuntu bzw. Debian-basierten Gnu/Linux-Distributionen.<br />
<br />
Die Installation im folgenden Beispiel erfolgt unter dem User {{code|ebkus}} auf einem Rechner mit dem Namen {{code|ebvm}}. Der User {{code|ebkus}} benötigt Superuserrechte ({{code|sudo}}). Es wird angenommen, dass eine Internetverbindung besteht (zur Installation von Software mit {{code|apt-get}}).<br />
<br />
Die Installation erfolgt ausschließlich über die Kommandozeile. Damit funktioniert sie auch auf reinen Servern, die keine GUI haben.<br />
<br />
Bitte auch die [[Windows Installation]] beachten, da sind einige betriebssystemunabhängige Punkte ausführlicher dargestellt als hier.<br />
<br />
=== Voraussetzungen ===<br />
<br />
Folgende Voraussetzungen müssen erfüllt sein, damit EBKuS installiert werden kann:<br />
<br />
==== Python 2.7 ====<br />
<br />
Ist auf solche Systemen normalerweise bereits installiert, ansonsten:<br />
<br />
ebkus@ebvm:~$ sudo apt-get install python2.7<br />
<br />
Die Python Version sollte 2.7.13 oder höher sein, optimalerweise<br />
2.7.18, welches die letzte Python-2-Version darstellt.<br />
Python 2 wird nicht mehr weiterentwickelt wird. EBKuS ist noch nicht<br />
auf Python 3 portiert.<br />
<br />
==== MySQL ====<br />
<br />
Es sollte eine MySQL 5.*-Version zur Verfügung stehen, z.B. 5.1, 5.6<br />
oder 5.7. Zur Installation auf Debian 10 siehe zum Beispiel<br />
https://tecadmin.net/install-mysql-on-debian-10-buster/<br />
Kurz zusammengefasst wie folgt:<br />
<br />
1. System auf den neuesten Stand bringen:<br />
<br />
ebkus@ebvm:~$ sudo apt update <br />
ebkus@ebvm:~$ sudo apt upgrade<br />
<br />
2. PPA von MySQL einrichten und MySQL-Installation konfigurieren:<br />
<br />
ebkus@ebvm:~$ wget <nowiki>http://repo.mysql.com/mysql-apt-config_0.8.15-1_all.deb</nowiki><br />
ebkus@ebvm:~$ sudo dpkg -i mysql-apt-config_0.8.15-1_all.deb<br />
<br />
Beim letzten Schritt unbedingt ein MySQL 5 auswählen, also 5.6<br />
oder 5.7! EBKuS wurde noch nicht auf höheren Versionen getestet.<br />
<br />
3. MySQL installieren:<br />
<br />
ebkus@ebvm:~$ sudo apt update <br />
ebkus@ebvm:~$ sudo apt install mysql-server<br />
<br />
Bei der Installation muss ein Passwort für den Datenbank-User {{code|root}} angegeben werden, das später in die {{file|ebkus.conf}} eingetragen werden muss. Nach einer erfolgreichen Installation kann man sich mit dem Befehl<br />
<br />
ebkus@ebvm:~$ mysql -uroot -p''Passwort''<br />
Welcome to the MySQL monitor. Commands end with ; or \g.<br />
...<br />
mysql><br />
<br />
mit der Datenbank verbinden.<br />
<br />
Falls der Standardport 3306 für MySQL nicht zur Verfügung steht, muss die Datei {{file|/etc/mysql/my.cnf}} angepasst werden.<br />
<br />
==== Python-MySQLdb ====<br />
<br />
Den Datenbankadapter für Python-MySQL installieren:<br />
ebkus@ebvm:~$ sudo apt-get install python-mysqldb<br />
Nach erfolgreicher Installation kann man Python aufrufen und MySQLdb importieren:<br />
ebkus@ebvm:~$ python<br />
Python 2.7.16 (default, Oct 10 2019, 22:02:15)<br />
...<br />
>>> import MySQLdb<br />
>>><br />
<br />
==== Apache 2 ====<br />
<br />
Den Webserver installieren:<br />
ebkus@ebvm:~$ sudo apt-get install apache2<br />
Nach der erfolgreichen Installation erhält man mit einem Browser mit der Adresse <nowiki>http://localhost/</nowiki> eine Seite mit '''It works!'''. Oder man installiert z.B. {{code|wget}} und erhält mit der genannten Adresse die entsprechende HTML-Datei {{file|index.html}}:<br />
ebkus@ebvm:~$ sudo apt-get install wget<br />
ebkus@ebvm:~$ wget <nowiki>http://localhost/</nowiki><br />
<br />
Falls der Webserver nicht auf den Standardports 80 und 443 laufen soll, muss die Datei {{file|/etc/apache2/ports.conf}} angepasst werden, ebenso die {{file|ebkus.conf}} (siehe [[Konfiguration]])<br />
<br />
Um den Webserver zu konfigurieren, müssen das ssl-Modul und das<br />
cgi-Modul aktiviert werden:<br />
ebkus@ebvm:~$ sudo a2enmod ssl<br />
ebkus@ebvm:~$ sudo a2enmod cgi<br />
<br />
Außerdem muss die von EBKuS generierte Apache-Konfigurationsdatei eingebunden werden:<br />
ebkus@ebvm:~$ cd /etc/apache2/sites-enabled<br />
ebkus@ebvm:/etc/apache2/sites-enabled$ sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl.conf<br />
Die Datei {{file|ebkus_httpd.conf}} existiert zu diesem Zeitpunkt noch nicht, sie wird bei der Installation ({{file|install.py}}) und bei jeder Änderung von Instanzen ({{file|configure.py}}) neu generiert. Sie definiert einen Virtual Host für den Webserver, über den alle EBKuS-Instanzen angesprochen werden.<br />
<br />
'''Dateirechte:''' Alle Verzeichnisse, die in einem Pfad zu einer Datei stehen, die vom Webserver gelesen werden soll, müssen das Leserecht und das Ausführungsrecht besitzen. Wenn das Installationsverzeichnis wie im Beispiel im Homeverzeichnis eines Benutzers steht, müssen diese Rechte evt. explizit vergeben werden:<br />
ebkus@ebvm:~$ sudo chmod go+rx /home/ebkus <br />
Den vom Installationsskript erzeugten Verzeichnissen und Dateien werden diese Rechte automatisch gegeben.<br />
<br />
<br />
==== EBKuS ====<br />
<br />
Die neueste [http://www.ebkus.org/alle_downloads.html EBKuS-Software]<br />
herunterladen, auspacken und in das Distributionsverzeichnis gehen, z.B.:<br />
<br />
ebkus@ebkusvm1:~$ wget https://ebkus.org/downloads/ebkus-4.10/ebkus-4.10-src.zip<br />
ebkus@ebkusvm1:~$ unzip ebkus-4.10-src.zip<br />
ebkus@ebkusvm1:~$ cd EBKuS-4.10<br />
ebkus@ebkusvm1:~/EBKuS-4.10$<br />
<br />
=== Installation ===<br />
<br />
==== Erstkonfiguration ====<br />
<br />
Erstkonfiguration erzeugen:<br />
ebkus@ebkusvm1:~/EBKuS-4.10$ python install.py -c ~/ebkus_installation<br />
Die EBKuS-Konfigurationsdatei {{file|/home/ebkus/ebkus_installation/ebkus/ebkus.conf}} kann nun weiter bearbeitet und für die eigentliche Installation verwendet werden.<br />
<br />
==== Systemkonfiguration ====<br />
<br />
System-[[Konfiguration]] anpassen, insbesondere:<br />
* Passwort für Datenbank-User {{code|root}} eintragen (Parameter {{konfig|database_admin_password}})<br />
* {{konfig|server_name}}, normalerweise die IP-Nummer des Rechners<br />
* Evt. Standardports {{konfig|server_https_port}} und {{konfig|server_http_port}} anpassen<br />
* {{konfig| server_admin}}<br />
* Im Abschnitt {{code|openssl}} Angaben zur Region und Organisation<br />
<br />
==== Instanzkonfiguration ====<br />
<br />
Instanz-[[Konfiguration]] anpassen:<br />
* {{konfig|instance_name}}, optional {{konfig|instance_title}}<br />
* {{konfig|initial_content}}, falls eine initiale Datenbank vorhanden ist (z.B. aus einer früheren Installation)<br />
* {{konfig|port}}<br />
<br />
==== Installation ====<br />
<br />
Installation:<br />
ebkus@ebkusvm1:~/EBKuS-4.10$ python install.py ~/ebkus_installation<br />
Bei der Installation wird man unter Umständen nach dem Passwort des (Linux-)Users gefragt, dasselbe, das man bei einem vorangestellten {{code|sudo}} angeben muss. Damit können die start/stop-Skripte in die Bootsequenz ({{file|/etc/init.d/}}) eingetragen werden<br />
<br />
Nach der Installation (und auch nach jeder Umkonfigurierung mit {{file|configure.py}}) muss der Webserver neu gestartet werden:<br />
ebkus@ebvm:~$ sudo service apache2 restart<br />
* Restarting web server apache2 [ OK ]<br />
Ansonsten wird die neu generierte Webserver-Konfiguration in {{file|ebkus_httpd.conf}} nicht wirksam.<br />
<br />
==== Migration ====<br />
<br />
Falls wie [[Windows_Installation#Migration|hier]] beschrieben eine Menge von bestehenden Instanzen in die neue Installation übernommen werden soll:<br />
ebkus@ebkusvm1:~/EBKuS-4.10$ python install.py -p ~/ebkus_preconfig ~/ebkus_installation<br />
Im Verzeichnis {{file|~/ebkus_preconfig}} muss dann eine gültige {{file|ebkus.conf}} liegen sowie eine Sicherungsdatei für jede Instanz, die in der Konfiguration über den Parameter {{konfig|initial_content}} eingebunden wird.<br />
<br />
=== Dienste ===<br />
<br />
Im Unterschied zur [[Windows Installation|Windows]] werden bei der Installation und der Konfigurierung keine Dienste gestartet oder gestoppt. Es werden jedoch Skripte in {{file|/etc/init.d}} generiert, mit denen die EBKuS-Server hoch und runtergefahren werden. Beim booten des Systems geschieht dies automatisch, d.h. nach einem Reboot steht EBKuS automatisch zur Verfügung.<br />
<br />
Für den Systemadministrator gibt es folgende Skripte, die nach der Installation im Homeverzeichnis stehen:<br />
* {{code|ebkusctl}}: Damit kann jede Instanz einzeln oder auch alle Instanzen gemeinsam hoch- und runtergefahren werden sowie deren Status abgefragt werden. Dieses Skript verwendet intern die generierten Skripte in {{file|/etc/init.d}}.<br />
* {{code|ebkusdump}}: Für jede Instanz einzeln oder für alle zusammen eine Sicherungsdatei erzeugen (verwendet intern {{file|datenbank_sichern.py||}}).<br />
* {{code|ebkusrestore}}: Für jede Instanz einzeln oder für alle zusammen die Datenbank aus eine Sicherungsdatei initialisieren (verwendet intern {{file| datenbank_initialisieren.py||}}).<br />
Z.B.<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl all start<br />
* Starting EBKuS demo [ OK ] <br />
* Starting EBKuS muster_efb [ OK ] <br />
* Starting EBKuS demo_braunschweig [ OK ] <br />
Jedes Skript hat eingebaute Hilfe:<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl --help<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl -h<br />
<br />
<br />
<br />
<br />
<br />
<!--<br />
<br />
Schritte:<br />
<br />
#`Installationsverzeichnis`_ einrichten, z.B. {{code|/home/user/ebinst}}:<br />
mkdir /home/user/ebinst<br />
#In das `Distributionsverzeichnis`_ gehen (z.B. {{code|/home/user/ebkus-cd/ebkus-3.3}}; man könnte hier auch direkt von der CD arbeiten):<br />
cd /home/user/ebkus-cd/ebkus-3.3<br />
#EBKuS-Konfiguration erzeugen:<br />
python install.py --config /home/user/ebinst<br />
#Erzeugte Konfigurationsdatei {{code|/home/user/ebinst/ebkus/ebkus.conf}}anpassen (siehe `Konfiguration`_).<br />
#EBKuS und alle in der Konfigurationsdatei definierten Instanzen installieren und konfigurieren:<br />
python install.py /home/user/ebinst<br />
Für jede in der Konfiguration definierten Instanz gibt es dann ein `Instanzverzeichnis`_:<br />
<br />
<blockquote>{{code|/home/user/ebinst/ebkus/}}''Instanzname''<br />
<br />
</blockquote><br />
Die Meldungen des Installationsskriptes stehen auch in der Datei {{code|/home/user/ebinst/install.log}}.<br />
<br />
#(als {{code|root}}) Die in Schritt 5. erzeugte Datei {{code|/home/user/ebinst/ebkus/ebkus_httpd.conf}} in die Apache-Konfigurationsdatei (bei SuSE z.B. /etc/httpd/httpd.conf) inkludieren, z.B. indem Sie dort am Ende die folgende Zeile eintragen:<br />
Include /home/user/ebinst/ebkus/ebkus_httpd.conf<br />
#(als {{code|root}}) Den Apache-Webserver neustarten, damit die modifizierte Konfiguration berücksichtigt wird, z.B. bei SuSE:<br />
rcapache restart<br />
#Eine konfigurierte EBKuS-Instanz testen, z.B. die Instanz demo:<br />
cd /home/user/ebinst/ebkus/demo <br />
./start.py --console<br />
Der gestartete Server gibt Meldungen auf die Konsole aus.<br />
<br />
#Über einen Browser mit der Instanz {{code|demo}} arbeiten (anstatt {{code|demo}} auch mit jeder anderen in der `Konfiguration`_definierten Instanz):<br />
https://localhost/ebkus/demo/cgi/do/login<br />
Die Login-Maske kann auch über eine vorgeschaltete Eingangsseite erreicht werden, die für jede Instanz generiert wird:<br />
<br />
https://localhost/ebkus/demo/index.html<br />
Diese Seite kann mit einem HTML-Editor gemäß den lokalen Bedürfnissen erweitert oder verändert werden. Die zu editierende Datei ist im `Instanzverzeichnis`_ unter {{code|htdocs/index.html}} zu finden.<br />
<br />
Als Administrator anmelden: Benutzer {{code|Admin}}, Passwort {{code|Admin}}. Als angemeldeter Administrator können Sie weitere Benutzer anlegen.<br />
<br />
Die Instanzen {{code|demo}} bzw. {{code|demo_berlin}} enthalten bereits Beispieldaten, mit denen Sie experimentieren können. Sie können sich also gleich als Bearbeiter bzw. als Verwaltungskraft anmelden, z.B. Benutzer {{code|test}}, Passwort {{code|test}} bzw. Benutzer {{code|verw}}, Passwort {{code|verw}}.<br />
<br />
Falls Sie in der Konfiguration den Parameter ''server_name'' mit einer in Ihrem Netzwerk gültigen IP-Adresse oder einem gültigen Namen belegt haben, können Sie auch von anderen Rechnern im Netzwerk auf eine EBKuS-Instanz zugreifen, z.B.:<br />
<br />
https://192.168.1.92/ebkus/demo/index.html https://192.168.1.92/ebkus/demo/cgi/do/login<br />
#(als {{code|root}}) Die Instanz in die Bootsequenz des Servers aufnehmen, so dass beim Hochfahren des Rechners der EBKuS-Server für die Instanz automatisch gestartet wird:<br />
cd /home/user/ebinst/ebkus/demo cp ebkus_demo /etc/init.d<br />
Die Links für die Run-Level manuell setzen oder, z.B. bei SuSE, den Run-Level-Editor verwenden.<br />
<br />
#In einer Produktionsinstanz die Anwendung einrichten, siehe Einrichtung der Anwendung im Handbuch.<br />
<br />
<br />
<br />
<br />
- Apache richtig löschen, so dass frische Konfig kommt:<br />
<br />
- sudo dpkg --purge --force-remove-reinstreq apache2.2-common<br />
<br />
So geht richtiges uninstall mit Konfiguration:<br />
apt-get remove ––purge *paketname*<br />
<br />
<br />
<br />
- download mit wget auf dem ubuntu server<br />
<br />
<br />
<br />
== Apache Konfiguration ==<br />
<br />
cd /etc/apache2/mods-enabled<br />
sudo ln -s ../mods-available/ssl.conf ssl.conf<br />
sudo ln -s ../mods-available/ssl.load ssl.load<br />
<br />
cd /etc/apache2/sites-enabled<br />
sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl<br />
http://ebkus.org/wiki/Linux_Installation#MySQL<br />
http://ebkus.org/wiki/Linux_Installation#Apache_2<br />
<br />
--></div>Ebkushttps://www.ebkus.org/wiki/KonfigurationKonfiguration2020-08-19T09:57:31Z<p>Ebkus: </p>
<hr />
<div>Die zentrale Konfigurationsdatei für eine EBKuS-Installation ist eine Textdatei namens <code>ebkus.conf</code> und befindet sich im Homeverzeichnis ({{file|ebkus}} im Installationsverzeichnis).<br />
<br />
Als Ausgangspunkt für die eigene Konfiguration dient die vom Installationsskript {{code|install.py}} aus einer Vorlage generierte Konfigurationsdatei. Die meisten Parameter (= Konfigurationvariable) sind darin bereits korrekt gesetzt.<br />
<br />
<br />
== Aufbau von <code>ebkus.conf</code> ==<br />
<br />
Zeilen, die leer sind oder mit dem Kommentarzeichen <code>#</code> beginnen, werden ignoriert, z.B.:<br />
<br />
<pre>#ebkus_home: %(install_dir)s\ebkus</pre><br />
<br />
In diesem Fall hat der Parameter den in der Tabelle genannten Standardwert.<br />
<br />
Zeilen, die nur aus einem Namen in eckigen Klammern bestehen, leiten eine Sektion ein, z.B.:<br />
<br />
<pre>[apache]</pre><br />
Die übrigen Zeilen weisen einem Parameter einen Wert zu. Sie beginnen mit dem Namen des Parameters, gefolgt von einem Doppelpunkt, gefolgt von dem Wert. Vor oder nach dem Doppelpunkt können Leerzeichen stehen. Beispiel:<br />
<br />
<pre>install_dir: C:\ebkus_installation</pre><br />
Werte können eine Syntax enthalten, die es erlaubt, vorher definierte Parameter in einen aktuellen Wert einzubeziehen (''Parametersubstitution''), z.B.:<br />
<br />
<pre>ebkus_home: %(install_dir)s\ebkus</pre><br />
Hier wird der Wert von <code>install_dir</code> in den Wert von <code>ebkus_home</code> einbezogen. Das ist genauso, als ob man gleich<br />
<br />
<pre>ebkus_home: C:\ebkus_installation\ebkus</pre><br />
definiert hätte. <code>%(</code>''parameter''<code>)s</code> wird durch den Wert von ''parameter'' ersetzt.<br />
<br />
Jede gültige Konfigurationsdatei muss die folgenden Sektionen aufweisen:<br />
<br />
*<code>[DEFAULT]</code><br />
*<code>[ebkus]</code><br />
*<code>[apache]</code><br />
*<code>[openssl]</code><br />
*eine Sektion für jede Instanz: <code>[</code>''Instanzname''<code>]</code><br />
<br />
Die möglichen Parameter für jede Sektion sind in den folgenden Tabellen aufgeführt.<br />
<br />
Alle Parameter außer denen, die in den Tabelle rot markiert sind, haben einen Standardwert (manchmal auch ''Defaultwert'' genannt), der in der Tabelle in der Spalte Standardwert angegeben ist. Ein Parameter hat diesen Wert, wenn er in der Konfiguration fehlt oder auskommentiert ist.<br />
<br />
Wie man sieht, können Parametersubstitutionen auch bei Standardwerten stattfinden. Der Wert des notwendige Parameter ''install_dir'' findet dadurch Eingang in weitere Parameter (''ebkus_home'', ''instance_home''), ohne dass diese explizit in der Konfiguration aufgeführt sind.<br />
<br />
''Anmerkung zu den Tabellen'': In einigen Fällen ist der angegebene Parameter bzw. Standardwert aus layout-technischen Gründen auf mehrere Zeilen verteilt, obwohl er eigentlich ohne Leerzeichen hintereinanderweg in einer Zeile stehen müsste.<br />
<br />
Wir unterscheiden ''Systemparameter'' von ''fachlichen Parametern''. Erstere betreffen den technischen Betrieb von EBKuS und werden von den Systemadministratoren (IT) bei der Installation eingerichtet. Fachparameter können ebenso wie Systemparameter in der {{file|ebkus.conf}} in der Instanzsektion gesetzt werden, außerdem kann aber auch der Anwendungsbetreuer über {{pfad2|Administratorhauptmenü|Allgemeine Konfiguration}} weitere Veränderungen vornehmen. Die vom Anwendungsbetreuer vorgenommenen Änderungen haben stets Vorrang über den Angaben in der {{file|ebkus.conf}}.<br />
<br />
<br />
== Systemparameter ==<br />
<br />
=== <nowiki>[DEFAULT]</nowiki> ===<br />
<br />
Die generierte Konfigurationsdatei enthält die korrekten Werte.<br />
<br />
Der Parameter {{konfig|install_dir}} bezeichnet das Installationsverzeichnis und muss immer in der Konfiguration definiert werden. Es bildet den Bezugspunkt für alle weiteren Pfade. Standardmäßig ist {{konfig|ebkus_home}} das Verzeichnis <code>ebkus</code> im Installationsverzeichnis; das sollte nicht verändert werden.<br />
<br />
Die in der Sektion <code>[DEFAULT]</code> definierten Parameter können in allen anderen Sektionen im Rahmen der Parametersubstitution als Teil eine Wertes verwendet werden (z.B. in der Definition von {{konfig|instance_home}}). Ansonsten stehen nur die Parameter derselben Sektion zur Verfügung.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|install_dir}}<br />
|style="background-color:orangered;"|{{code|}}<br />
|Installationsverzeichnis<br />
|-<br />
|{{konfig|ebkus_home}}<br />
|{{konfig|install_dir}}/ebkus<br />
|Homeverzeichnis<br />
|}<br />
<br />
<br />
=== <nowiki>[ebkus]</nowiki> ===<br />
<br />
Die generierte Konfigurationsdatei enthält in der Regel die korrekten Werte.<br />
<br />
Die {{konfig|database_admin_*}}-Parameter erlauben den Installationsskripten, neue Datenbanken für Instanzen einzurichten und diese bei der Deinstallation auch wieder zu entfernen.<br />
<br />
Falls aus Sicherheitsgründen erwünscht, kann hier ein Passwort für den Administratorzugriff auf MySQL eingetragen werden. Geschieht dies unter Windows vor der automatischen Installation von MySQL, wird bei der automatischen Installation der Administratorzugriff mit diesem Passwort eingerichtet.<br />
<br />
Falls das Passwort für den Administratorzugriff nicht im Klartext in der Konfigurationsdatei stehen soll, kann stattdessen <code>ASK</code>eingetragen werden. Dann fragen alle Skripte, die den Administratorzugriff benötigen, interaktiv nach dem Passwort, ohne es irgendwo zu speichern.<br />
<br />
Da MySQL standardmäßig nur von dem lokalen Rechner erreichbar ist, und dieser ohnehin nur für dem Administrator zugänglich ist, ist die zusätzliche Absicherung durch ein Passwort oft nicht nötig.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|download_dir}}<br />
|{{konfig|install_dir}}/download<br />
|Downloadverzeichnis. Dort steht die zu installierende Software, die im Bedarfsfall heruntergeladen wird.<br />
|-<br />
|{{konfig|database_admin_host}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer des Rechners, auf dem MySQL läuft. Muss angegeben werden, wenn das nicht der lokale Rechner ist.<br />
|-<br />
|{{konfig|database_admin_user}}<br />
|{{code|root}}<br />
|MySQL-Benutzer mit Administratorrechten<br />
|-<br />
|{{konfig|database_admin_password}}<br />
|{{code|}}<br />
|Dessen Passwort. Wenn hier ``ASK`` steht, wird das Passwort bei Bedarf interaktiv abgefragt.<br />
<br />
|-<br />
|{{konfig|mysql_dir}}<br />
|{{code|}}<br />
|Verzeichnis, in dem die MySQL-Programme mysql, mysqldump, etc. stehen. Muss angegeben werden, wenn MySQL-Programme nicht im Pfad stehen.<br />
<br />
|-<br />
|{{konfig|python_executable}}<br />
|<br />
|Vollständiger Pfad des Python-Executable, mit dem EBKuS ausgeführt wird<br />
|}<br />
<br />
<br />
=== <nowiki>[apache]</nowiki> ===<br />
<br />
Für den Parameter {{konfig|server_name}} muss unbedingt der Name oder die IP-Nummer des Rechners eingetragen werden, auf dem der Apache-Webserver läuft. Die generierte Konfigurationsdatei setzt den Standardwert <code>localhost</code>, womit EBKuS nur auf dem lokalen Rechner zugänglich ist.<br />
<br />
Für den Parameter {{konfig|server_admin}} sollte eine sinnvolle Email-Adresse eingetragen werden. Sie taucht in Apache-Fehlermeldungen auf (die allerdings normalerweise nicht vorkommen sollten).<br />
<br />
Alle übrigen Werte können in der Regel von der generierten Konfigurationsdatei übernommen werden.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|apache_log_dir}}<br />
|{{konfig|ebkus_home}}/log<br />
|Verzeichnis, in dem der Apache-Webserver Log-Dateien anlegt<br />
|-<br />
|{{konfig|server_admin}}<br />
|{{code|admin@localhost}}<br />
|Email-Adresse des Serveradministrators, die auf evt. Fehlerseiten des Servers erscheint.<br />
<br />
|-<br />
|{{konfig|server_name}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer des Rechners, auf dem der Apache-Webserver läuft.<br />
**Muss** explizit eingetragen werden, sonst kann EBKuS nur auf dem lokalen Rechner verwendet werden!<br />
<br />
|-<br />
|{{konfig|server_https_port}}<br />
|{{code|443}}<br />
|Port für verschlüsselte Verbindungen. Die EBKuS-Anwendung wird ausschließlich über diesen Port abgewickelt. Wenn der Standardport {{code|443}} nicht zur Verfügung steht, kann hier ein alternativer Port angegeben werden. Dieser muss dann als Teil der URL aufgeführt werden, z.B. für den Alternativport {{code|500}}: {{code|<nowiki>https://192.168.1.73:500/ebkus/demo/</nowiki>}}.<br />
<br />
|-<br />
|{{konfig|server_https_port}}<br />
|{{code|80}}<br />
|Port für unverschlüsselte Verbindungen. Die EBKuS-Anwendung verwendet diesen Port nicht. Dient nur zur Kontrolle des Apache Webservers: {{code|<nowiki>http://localhost/</nowiki>}} liefert "It works!". Wird hier der Port {{code|8080}} angegeben, müsste man {{code|<nowiki>http://localhost:8080/</nowiki>}} schreiben.<br />
<br />
|-<br />
|{{konfig|ssl_certificate_file}}<br />
|{{konfig|ebkus_home}}/ebkus_ssl_certificates/ebkusserver.cert<br />
|Vollständiger Pfad der SSL-Zertifikat-Datei<br />
<br />
<br />
|-<br />
|{{konfig|ssl_certificate_key_file}}<br />
|{{konfig|ebkus_home}}/ebkus_ssl_certificates/ebkusserver.key<br />
|Vollständiger Pfad der SSL-Schlüssel-Datei<br />
|}<br />
<br />
<br />
=== <nowiki>[openssl]</nowiki> ===<br />
<br />
Die Anwendung ist voll funktionsfähig mit den Werten aus der generierten Konfigurationsdatei; es empfiehlt sich jedoch, die organisatorischen Angaben für das SSL-Zertifikat anzupassen.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|openssl_executable}}<br />
|{{code|openssl}}<br />
|Falls openssl nicht im Pfad steht, muss der hier der vollständige Pfad zum Executable stehen<br />
<br />
|-<br />
|{{konfig|output_password}}<br />
|{{code|polo}}<br />
|Wird zur automatischen Zertifikatgenerierung benötigt<br />
<br />
|-<br />
|{{konfig|staat}}<br />
|{{code|DE}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|-<br />
|{{konfig|land}}<br />
|{{code|Berlin}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|-<br />
|{{konfig|ort}}<br />
|{{code|Berlin}}<br />
|Erscheint im SSL-Zertifikat<br />
|-<br />
|{{konfig|organisation}}<br />
|{{code|EFB}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|-<br />
|{{konfig|organisationseinheit}}<br />
|{{code|EFB}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|}<br />
<br />
<br />
=== <nowiki>[</nowiki>''Instanz''<nowiki>]</nowiki> ===<br />
<br />
<br />
Im Rahmen einer EBKuS-Installation auf einem Server können mehrere Instanzen einer EBKuS-Anwendung eingerichtet werden. Jede Instanz<br />
<br />
*hat einen Namen ({{konfig|instance_name}})<br />
*ist über eine eigene URL ansprechbar (<code>https://</code>'''server_name'''<code>/ebkus/</code>'''instance_name'''<code>/index.html</code>)<br />
*hat eine eigene Datenbank im Rahmen einer MySQL-Installation ({{konfig|database_name}}, {{konfig|database_user}}, {{konfig|database_password}})<br />
*hat ein eigenes Verzeichnis ({{konfig|instance_home}})<br />
*hat einen eigenen EBKuS-Server, der vom Apache-Webserver über eine eigene Portnummer angesprochen wird ({{konfig|port}})<br />
*hat eine eigene Log-Datei ({{konfig|log_file}})<br />
<br />
<br />
Für jede gewünschte Instanz wird eine Sektion in der Konfigurationsdatei angelegt. Die Sektionsüberschrift wird aus dem Namen der Instanz in eckigen Klammern gebildet. Der Name sollte mit einem Buchstaben beginnen und ansonsten nur Buchstaben, Ziffern und Unterstriche (<code>_</code>) enthalten (keine Leerzeichen!). Ein zusätzlicher Name für die Instanz ohne diese Einschränkung lässt sich über den Parameter {{konfig|instance_title}} einrichten (siehe unten).<br />
<br />
Falls der Instanzname mit <code>demo</code> beginnt, werden bei der Installation der Datenbank automatisch Demodaten erzeugt. Neben dem Benutzer <code>Admin</code> (Passwort: <code>Admin</code>) gibt es dann auch den Benutzer <code>test</code> (Passwort: <code>test</code>) und <code>verw</code>(Passwort: <code>verw</code>).<br />
<br />
Jede Sektion kann die in der Tabelle aufgeführten Parameter definieren. Erforderlich ist Wiederholung des Instanznamen als Wert von {{konfig|instance_name}}, ferner die Angabe einer eigenen, eindeutigen Portnummer, {{konfig|port}}. Für alle anderen Parameter können die Standardwerte genommen werden.<br />
<br />
Natürlich muss man {{konfig|berliner_version}} auf <code>true</code> setzen, wenn man die Berliner Version mit Berliner Straßenkatalog haben möchte; EBKuS-spezifische Fehlermeldungen sollten außerdem eine sinnvolle Telefonnummer bzw. Email-Adresse des Anwendungsbetreuers haben ({{konfig|admin_tel}}, {{konfig|admin_email}}).<br />
<br />
Die Parameter {{konfig|host}} und {{konfig|database_host}} müssen nur dann angepasst werden, wenn der EBKuS-Server bzw. die MySQL-Datenbank nicht auf demselben Rechner laufen wie der Apache-Webserver.<br />
<br />
Die bei der Installation generierte Konfigurationsdatei definiert vier Instanzen (2 davon auskommentiert):<br />
<br />
*<code>demo</code>: Demodaten, kein Straßenkatalog<br />
*<code>muster_efb</code>: keine Demodaten, kein Straßenkatalog. Beispiel für eine Produktionsinstanz, die vom Anwendungsbetreuer eingerichtet werden muss (siehe Einrichtung der Anwendung im Handbuch).<br />
<br />
Auskommentiert:<br />
*<code>demo_berlin</code>: Demodaten, Berliner Straßenkatalog (kleiner Ausschnitt, nur Straßen, deren Namen mit 'K' beginnen)<br />
*<code>demo_braunschweig</code>: Demodaten, Straßenkatalog mit Straßen aus Braunschweig, Gifhorn, Wolfenbüttel und Wolfsburg.<br />
<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
<br />
<br />
|-<br />
|{{konfig|instance_name}}<br />
|style="background-color:orangered;"|{{code|}}<br />
|Name der Instanz. Muss angegeben werden und dem Namen des Abschnitts (in eckigen Klammern) identisch sein. Darf keine Sonderzeichen außer den Unterstrich ('_') enthalten.<br />
<br />
<br />
|-<br />
|{{konfig|instance_home}}<br />
|{{konfig|ebkus_home}}/{{konfig|instance_name}}<br />
|Instanzverzeichnis. Liegt im Homeverzeichnis. Sollte nicht verändert werden.<br />
<br />
|-<br />
|{{konfig|initial_content}}<br />
|{{code|}}<br />
|Hier kann eine Datei angegeben werden, mit der die Instanzdatenbank initialisiert werden kann. Diese Datei wird immer dann geladen, wenn bei der Installation der Instanz ({{code|install.py}} oder {{code|configure.py}}) keine funktionierende Datenbank für die Instanz vorgefunden wird. Wenn keine Datei angegeben ist, wird eine neue Datenbank mit dem Merkmalskatalog ({{file|sql/merkmale_standard.py}}) und evt. einem Straßenkatalog erstellt. Wenn kein vollständiger Pfad für die Datei angegeben wird, muss die Datei im Homeverzeichnis liegen. Zulässige Dateien sind die mit dem Skript {{code|datenbank_sichern.py}} erzeugte Dateien sowie sonstige passende SQL-Dumps.<br />
<br />
|-<br />
|{{konfig|berliner_version}}<br />
|{{code|false}}<br />
|Wenn hier {{code|true}} steht, wird die Berliner EBKuS-Version verwendet mit Berliner Straßenkatalog. <br />
<br />
|-<br />
|{{konfig|database_host}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer, auf dem der Datenbankserver läuft.<br />
<br />
|-<br />
|{{konfig|database_name}}<br />
|{{konfig|instance_name}}<br />
|Name der Instanzdatenbank<br />
<br />
<br />
|-<br />
|{{konfig|database_user}}<br />
|{{konfig|instance_name}}<br />
|Benutzername der Instanzdatenbank<br />
<br />
|-<br />
|{{konfig|database_password}}<br />
|{{konfig|instance_name}}<br />
|Passwort der Instanzdatenbank<br />
<br />
<br />
|-<br />
|{{konfig|gemeindeschluessel_von_plz}}<br />
|{{code|}}<br />
|Definiert die Teilmenge der amtlichen Gemeindeschlüssel für die Bundesstatistik. Im Normalfall muss hier nichts eingetragen werden.<br />
<br /><br />
In der Bundesstatistik soll der amtliche Gemeindeschlüssel für den Wohnort des Klienten eingetragen werden, wenn der Wohnort des Klienten außerhalb des Kreises der Beratungsstelle liegt. Um die Menge der Daten zu begrenzen, kann hier über die Anfangsziffern der Postleitzahl eine Teilmenge definiert werden. Wenn mehrere Ziffernfolgen angegeben werden, müssen diese mit <code>;</code> getrennt werden.<br /><br /> Beispiele: <ul> <li>Alle Gemeindeschlüssel verwenden, außer die Postleitzahl der Gemeinde beginnt mit '9': <pre> 0;1;2;3;4;5;6;7;8 </pre> </li> <li>Große Teile Niedersachsens: <pre> 29;30;31;37;38 </pre> </li> <li>Nördliches Niedersachsen und Schleswig Holstein: <pre> 2 </pre> </li> <li>Berlin und Umgebung: <pre> 10;12;13;14;15;16 </pre> </li> <li>Bleibt die Variable leer, werden alle Gemeindeschlüssel verwendet. </li> </ul> Wenn es bei der Erkennung von Gemeindeschluesseln zu vielen Fehlern kommt, beispielsweise wegen unterschiedlicher Schreibweisen von Orten, kann man selber eine Datei <code>EBKUS_HOME/sql/gemeindeschluessel.csv</code> erstellen, bestehend aus einer Tabelle mit den Spalten <code>plz, ort ags</code>. Als Vorlage kann die Datei <code>EBKUS_HOME/sql/gemeindeschluessel_cache.csv</code> dienen, die automatisch erzeugt wird, wenn die Konfigurationsvariable <code>gemeindeschluessel_von_plz</code> einen Wert hat. <br />
|-<br />
|{{konfig|host}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer des Rechners, auf der der EBKuS-Server der Instanz läuft.<br />
<br />
<br />
|-<br />
|{{konfig|keine_bundesstatistik}}<br />
|{{code|false}}<br />
|Falls hier {{code|true}} steht, wird die Bundesstatistik aus der Anwendung ausgeblendet. Es kann keine Bundesstatistik ausgefüllt werden und steht auch nicht für Statistik und Export zur Verfügung.<br />
<br />
|-<br />
|{{konfig|log_file}}<br />
|{{konfig|instance_home}}{{code|/}}{{konfig|instance_name}}{{code|.log}}<br />
|Name der Datei, in die der EBKuS-Server Meldungen schreibt<br />
<br />
|-<br />
|{{konfig|log_level}}<br />
|{{code|INFO}}<br />
|Legt fest, wie "geschwätzig" der EBKuS-Server ist. Muss einer der folgenden Werte sein, in aufsteigender Wortfülle: {{code|CRITICAL, ERROR, WARNING, INFO, DEBUG}} ({{code|DEBUG}} ist nur für die Fehlersuche geeignet, da sehr viel ausgegeben wird.)<br />
<br />
|-<br />
|{{konfig|port}}<br />
|style="background-color:orangered;"|{{code|}}<br />
|Portnummer über die der EBKuS-Server angesprochen wird. Muss angegeben werden. Jede Instanz muss eine unterschiedliche Portnummer erhalten.<br />
|}<br />
<br />
<br />
==== Konfiguration für externe Anwendungen ====<br />
<br />
Die folgenden Konfigurationsvariablen bewirken, dass auf der Klientenkarte ein Kasten mit maximal vier Buttons erscheint, die in einem neuen Tab/Fenster eine URL aufrufen, die Felder des aktuellen (letzten) Falles bzw. des angemeldeten Mitarbeiters als Bestandteile haben kann:<br />
# Kein Kasten, wenn diese Variable keinen Wert hat.<br />
extern_fieldset_label: Externe Anwendung<br />
# Position auf der Klientenkarte<br />
extern_fieldset_position: 6<br />
# Maximal vier Buttons, für jeden eine Bezeichnung und eine Url.<br />
# Ein Button kommt nur zustande, wenn sowohl Label als auch Url<br />
# einen Wert haben. <br />
extern_button1_label: GoogleWeb<br />
extern_button1_url: <nowiki>http://www.google.com/search?q=$$fall_id$$_$$fall_akte__ort$$</nowiki><br />
extern_button2_label: GoogleMaps<br />
extern_button2_url: <nowiki>http://www.google.com/maps?q=$$mitarbeiter_na$$</nowiki><br />
extern_button3_label: GoogleImages<br />
extern_button3_url: <nowiki>http://www.google.com/images?q=$$fall_akte__ort$$</nowiki><br />
extern_button4_label: GoogleNews<br />
extern_button4_url: http://www.google.com/news?q=$$fall_fn$$</nowiki><br />
<br />
Urls können Abschnitte der folgenden Form enthalten:<br />
{{code|$$<fall oder mitarbeiter>_<feld>$$}}<br />
Der ganze Abschnitt wird durch den Wert von {{code|<feld>}} ersetzt, <br />
wobei entweder im Fall-Objekt oder im Mitarbeiter-Objekt <br />
nachgeschlagen wird. <br />
Beispiele:<br />
{{code|$$fall_id$$}}, {{code|$$mitarbeiter_na$$}}, {{code|$$fall_akte__ort$$}}<br />
<br />
Im Beispiel oben werden als externe Anwendungen verschiedene Google-Dienst aufgerufen, wobei als Parameter Daten aus dem aktuellen Fall übergeben werden.<br />
(Das Beispiel ist nicht sinnvoll und dient nur der Illustration des Mechanismus.)<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|extern_fieldset_label}}<br />
|{{code|}}<br />
|Bezeichnung für den Kasten mit den Buttons für die externen Anwendungen<br />
<br />
|-<br />
|{{konfig|extern_fieldset_position}}<br />
|{{code|2}}<br />
|Position auf der Klientenkarte (Gezählt werden die umrandeten Kästen mit einer Bezeichnung: Klientendaten, Bezugspersonen, Leistungen, etc.)<br />
|-<br />
|{{konfig|extern_buttonX_label}}<br />
|{{code|}}<br />
|Name der externen Anwendung<br />
<br />
<br />
|-<br />
|{{konfig|extern_buttonX_url}}<br />
|{{code|}}<br />
|URL der externen Anwendung mit Platzhaltern für die zu übernehmenden Parameter<br />
<br />
|}<br />
<br />
{{konfig|X}} kann 1,2,3 oder 4 sein.<br />
<br />
<br />
== Fachliche Parameter ==<br />
<br />
Die hier beschriebenen Einstellungen können auch vom Anwendungsbetreuer über {{pfad2|Administratorhauptmenü|Allgemeine Konfiguration}} vorgenommen werden.<br />
<br />
<br />
=== <nowiki>[</nowiki>''Instanz''<nowiki>]</nowiki> ===<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|admin_email}}<br />
|{{code|Keine Angabe}}<br />
|Email-Adresse des Anwendungsbetreuers.<br />
<br />
Wird in Fehlermeldungen genannt.<br />
|-<br />
|{{konfig|admin_name}}<br />
|{{code|Keine Angabe}}<br />
|Name des Anwendungsbetreuers.<br />
<br />
Wird in Fehlermeldungen genannt.<br />
|-<br />
|{{konfig|admin_tel}}<br />
|{{code|Keine Angabe}}<br />
|Telefonnummer des Anwendungsbetreuers.<br />
<br />
Wird in Fehlermeldungen genannt.<br />
|-<br />
|{{konfig|anmeldungsdaten_}} {{konfig|obligatorisch}}<br />
|{{code|false}}<br />
|Falls <code>true</code> werden die Anmeldungsdaten obligatorisch im Aufnahmeformular erhoben anstatt optional in einer getrennten Maske.<br />
<br />
Die entsprechenden Pflichfelder sind dabei auszufüllen. Eine spätere Bearbeitung der Anmeldungsdaten erfolgt wie bisher in einer eigenständigen Maske (analog der späteren Bearbeitung einer Leistung).<br />
|-<br />
|{{konfig|anmeldeprobleme_und_}} {{konfig|beschaeftigung_bei_}}{{konfig|anmeldung_erfassen}}<br />
|{{code|false}}<br />
|Falls <code>true</code> werden Probleme bei der Anmeldung und Beschäftigung schon bei der Anmeldung erfasst und später für die Fachstatistik übernommen.<br />
<br />
Die Auswahlfelder 'Beschäftigung Jugendliche(r)', 'Beschäftigungsverhältnis Mutter', 'Beschäftigungsverhältnis Vater' und das Mehrfachauswahlfeld 'Problem(e) bei der Anmeldung' aus der Fachstatistik werden in den Kasten Anmeldekontakt als Pflichtfelder aufgenommen. Es ist jedoch in jedem Fall möglich 'Keine Angabe' auszuwählen (genau wie in der Fachstatistik selbst). Die Daten werden mit dem Fall (nicht mit der Akte bzw. den Stammdaten) gespeichert. Wenn eine Fachstatistik angelegt wird, werden die Daten übernommen.<br />
|-<br />
|{{konfig|beratungskontakte}}<br />
|{{code|false}}<br />
|Falls <code>true</code> können in der Klientenakte einzelne Beratungskontakte eingetragen werden. Die Summen werden in die Bundesstatistik und in die Fachstatistik als Vorgabe übernommen.<br />
|-<br />
|{{konfig|beratungskontakte_bs}}<br />
|{{code|false}}<br />
|Falls <code>true</code> treten Anpassungen speziell für Braunschweig in Kraft.<br />
<br />
Die Variable <code>beratungskontakte</code> muss ebenfalls auf <code>true</code> stehen.<br />
|-<br />
|{{konfig|cache_on}}<br />
|{{code|true}}<br />
|Falls <code>true</code> wird der Objektcache eingeschaltet, sonst bleibt er abgeschaltet.<br />
<br />
Normalerweise ist der Cache an, aber es kann in seltenen Fällen zu Fehlern kommen, die verschwinden, wenn er abgeschaltet wird. Auf die inhaltlichen Abläufe hat das keine Auswirkungen, <br />
allenfalls auf die Performance.<br />
|-????<br />
|{{konfig|erinnern_nach_wochen_ohne_kontakt}}<br />
|{{code|0}}<br />
|Anzahl der Wochen ohne Kontakt nach der ein offener Fall in die Erinnerungsfunktion aufgenommen wird.<br />
<br />
Wenn hier eine Zahl zwischen 1 und 99 steht, wird die Erinnerungsfunktion aktiviert. Auf einem zusätzlichen Button im Hauptmenü steht dann die Anzahl der offenen Fälle, mit denen es länger als die angegebene Anzahl von Wochen keinen Kontakt gegeben hat. Nach dem Betätigen des Buttons erscheint eine Liste dieser Fälle. Jeder Fall kann als erledigt markiert werden, worauf er künftig normalerweiser nicht mehr in der Liste erscheint. Für die gesamte Liste gibt es aber eine Option, alle Fälle einschließlich der erledigten anzuzeigen. Die 'Erledigt'-Markierung kann dann auch wieder rückgängig gemacht werden.<br />
<br />
Es muss hier die Ziffer 0 stehen, wenn die Erinnerungsfunktion deaktiviert bleiben soll.<br />
|-<br />
|{{konfig|fachstatistik_akte_}} {{konfig|diskrepanz_nicht_zulassen}}<br />
|{{code|false}}<br />
|Falls <code>true</code> werden Diskrepanzen zwischen Fachstatistik und Akte nicht zugelassen.<br />
<br />
Die entsprechenden Items in der Fachstatistik zeigen die Werte aus der Akte und sind nicht modifizierbar. Eine Diskrepanz kann so gar nicht entstehen. Allerdings muss bei Änderungen in der Akte die Fachstatistik neu abgespeichert werden, damit die Änderungen übernommen und für die Statistik wirksam werden.<br /> Betroffen sind nur die Items 'Familienstatus', 'Empfohlen von' und 'Erbrachte Leistungen in der Fachstatistik', deren Werte im Normalfall aus der Akte vorbelegt werden.<br />
|-<br />
|{{konfig|fallunabhaengige}} {{konfig|_aktivitaeten_bs}}<br />
|{{code|false}}<br />
|Falls <code>true</code> können fallunabhängige Aktivitäten eingetragen und ausgewertet werden. Speziell für Braunschweig. <br />
|-<br />
|{{konfig|fallbeginn_bei_}}{{konfig|erster_leistung}}<br />
|{{code|false}}<br />
|Bei Neumelde- und Abschlusszahlen sowie Klienten pro Mitarbeiter wird der Fallbeginn ab dem Datum der erste Leistung definiert anstatt ab dem Anmeldedatum.<br />
|-<br />
|{{konfig|fallbeginn_waehlbar}}<br />
|{{code|false}}<br />
|Bei Neumelde- und Abschlusszahlen sowie Klienten pro Mitarbeiter kann ein Häkchen gesetzt werden, um den Fallbeginn ab erster Leistung zu definieren.<br />
|-<br />
|{{konfig|instance_title}}<br />
|{{konfig|instance_name}}<br />
|Langname für die Instanz.<br />
<br />
Erscheint bei der Anmeldung und in der Statuszeile.<br />
|-<br />
|{{konfig|jgh_gemeindeschluessel}}<br />
|{{code|}}<br />
|Die letzten drei Ziffern des [http://de.wikipedia.org/wiki/Amtlicher_Gemeindeschl%C3%BCssel Amtlichen Gemeindeschlüssels] oder das Wort "blank".<br />
<br />
Standardmäßig setzt EBKuS für diese drei Ziffern (Spalte 7-9 des Exportdatensatzes) drei mal die Ziffer 0 ein. Unseres Wissens werden diese Daten für die<br />
Bundesstatistik allerdings nicht ausgewertet. Bei Bedarf kann hier das Wort "blank" angegeben werden, dann erscheinen im Datensatz drei Leerzeichen, oder es können drei Ziffern<br />
eingegeben werden, die dann in den Datensatz eingefügt werden.<br />
|-<br />
|{{konfig|leistungsende_in_}}<br />
{{konfig|zukunft_erlaubt}}<br />
|{{code|false}}<br />
|Beim Eintrag einer Leistung darf für das Ende ein Datum, das in der Zukunft liegt, eingetragen werden.<br />
<br />
Der Abschluss des Falls ist erst möglich, wenn alle Leistungen beendet sind.<br />
|-<br />
|{{konfig|loeschfrist}}<br />
|{{code|36}}<br />
|Löschfrist in Monaten.<br />
<br />
Akten, die älter sind, können vom Administrator gelöscht werden.<br />
|-<br />
|{{konfig|log_query_laenger_als}}<br />
|{{code|0}}<br />
|Falls größer 0, Datenbankqueries in die Logdatei schreiben, die länger dauern als die angegeben Zahl in Millisekunden.<br />
<br />
Wenn 0 eingetragen wird, werden keine Datenbankqueries protokolliert. Alle Datenbankqueries können mit <code>log_level=DEBUG</code> erfasst werden. Nützlich zur Diagnose von Performanceproblemen.<br />
|-<br />
|{{konfig|meldung_vom_admin}}<br />
|{{code|}}<br />
|Inhalt wird als Meldung vom Administrator unübersehbar auf jeder EBKuS-Seite über der Statuszeile ausgegeben.<br />
<br />
Damit kann der Administrator Meldungen an alle aktiven EBKuS-Nutzer ausgeben, z.B. um einen Ausfall von EBKuS wegen Wartungsarbeiten anzukündigen. <br />
|-<br />
|{{konfig|neumeldungen_nach_region}}<br />
|{{code|}}<br />
|Definiert eine Tabelle ''Neumeldungen nach Region'' unter ''Neumelde- und Abschlusszahlen''.<br />
<br />
Die Regionen, für die in der Tabelle die Neumeldungen ausgezählt werden sollen, müssen unter {{pfad4|Hauptmenü|Statistikabfrage|Teilmenge|Neu}} als Teilmengendefinitionen eingeführt werden. Der Namen der gewünschten Definitionen werden durch <code>;</code> getrennt aufgeführt. <br /><br /> Beispiel: <ul> <li> <pre> Gifhorn und Samtgemeinde Meinersen; Braunschweig 38120 und 38112 </pre> </li> </ul> "Gifhorn und Samtgemeinde Meinersen" ist eine Teilmengendefinition mit der Definition: <code>( ort = 'Gifhorn' ODER samtgemeinde = 'Meinersen' )</code>. "Braunschweig 38120 und 38112" ist eine Teilmengendefinition mit der Definition: <code>( ort = 'Braunschweig' UND plz = '38112' oder '38120' )</code>. <br /><br /> <br />
|-<br />
|{{konfig|session_time}}<br />
|{{code|120}}<br />
|Länge einer Session in Minuten. <br />
<br />
Nach dieser Zeit wird ein Benutzer automatisch abgemeldet, wenn er keine Eingaben mehr macht.<br />
|-<br />
|{{konfig|sql_abfrage}}<br />
|{{code|false}}<br />
|Falls <code>true</code> steht die Maske zum Absetzen von SQL-Abfragen vom Administrationsmenü aus zur Verfügung. <br />
<br />
|-<br />
|{{konfig|strassenkatalog}}<br />
|{{code|}}<br />
|Falls diese Variable nicht leer ist, wird bei der Adresseingabe der Straßenkatalog verwendet.<br />
<br />
Der eigentliche Wert der Variable spielt nur bei der Erstinstallation der Instanz eine Rolle.<br />Eine Instanz ohne Straßenkatalog kann auch später noch für die Verwendung mit Straßenkatalog eingerichtet werden, indem der Straßenkatalog über {{pfad2|Administratorhauptmenü|Straßenkatalog importieren}} importiert wird und der Variable {{konfig|strassenkatalog}} ein beliebiger Wert zugewiesen wird, beispielsweise der Ortsname.<br />
|-<br />
|{{konfig|strassenkatalog_}} {{konfig|vollstaendig}}<br />
|{{code|false}}<br />
|Falls <code>true</code> wird angenommen, dass der Straßenkatalog Einträge für jede einzelne Hausnummer enthält.<br />
<br />
Ansonsten wird angenommen, dass lediglich Einträge für ganze Straßen bzw. für bestimmte Intervalle von Hausnummern vorhanden sind.<br />
|-<br />
|{{konfig|strassensuche}}<br />
|{{code|}}<br />
|Bestimmt die Anzeige von Zusatzinformationen aus dem Straßenkatalog bei der Darstellung und Eingabe von Adressen.<br />
<br />
Zulässige Werte sind: <code>ort bezirk ortsteil samtgemeinde</code>.<br /><br /> Beispiele: <ul> <li>In Berlin gibt es nur einen Ort im Straßenkatalog, nämlich 'Berlin'. Das Feld <code>ort</code> ist daher nicht nötig. Ortsteil und Samtgemeinde haben im Straßenkatalog keine Werte, Bezirk allerdings schon. Der sinnvolle Wert für Berlin ist also <pre> bezirk </pre> </li> <li>In Gifhorn gibt es mehrere Orte im Straßenkatalog. Sowohl Ortsteile und Samtgemeinden spielen eine Rolle und sind im Straßenkatalog erfasst, Bezirke jedoch nicht. Der sinnvolle Wert hier ist also <pre> ort ortsteil samtgemeinde </pre> </li> <li>Wenn es nur einen Ort gibt und weder Bezirke, Ortsteile oder Samtgemeinden im Straßenkatalog erfasst sind, sollte die Variable leer bleiben. </ul> <br /><br />Irrelevant, wenn kein Straßenkatalog verwendet wird.<br />
|-<br />
|{{konfig|warnung_bei_fachstatistik_}} {{konfig|akte_diskrepanz}}<br />
|{{code|false}}<br />
|Falls <code>true</code> wird beim Speichern der Fachstatistik auf eine Diskrepanz zwischen Akte und Fachstatistik hingewiesen, falls vorhanden.<br />
<br />
Wenn man bei dem dann zur Verfügung stehendem Item "Diskrepanz zur Akte zulassen" ein Häkchen setzt, kann man trotzdem speichern.<br /> Betroffen sind nur die Items 'Familienstatus', 'Empfohlen von' und 'Erbrachte Leistungen in der Fachstatistik', deren Werte im Normalfall aus der Akte vorbelegt werden.<br />
|-<br />
|{{konfig|wiederaufnahmefrist}}<br />
|{{code|1}}<br />
|Anzahl der Monate, innerhalb derer ein abgeschlossener Fall wiederaufgenommen werden kann ("z.d.A. rückgängig").<br />
<br />
Danach muss ein neuer Fall angelegt werden.<br />
|-<br />
|{{konfig|wohnt_nicht_ausserhalb}}<br />
|{{code|}}<br />
|Definiert die Teilmenge der Adressen, die im Sinne der Bundesstatistik in die Zuständigkeit der Beratungsstelle fallen.<br />
<br />
Aufgrund der hier angegebenen Kriterien wird entschieden, ob der Klient in der Bundesstatistik als ausserhalb des Zuständigkeitsbereichs der Beratungsstelle wohnend angegeben wird. Als mögliche Kriterien kommen in Frage: <code>plz,ort,ortsteil,samtgemeinde,bezirk,plraum</code>. Die Kriterien <code>ortsteil,samtgemeinde,bezirk</code> sind nur sinnvoll, wenn ein Straßenkatalog verwendet wird und dieser auch entsprechende Angaben enthält. <br /><br /> Die Kriterien werden wie folgt in der angegebenen Reihenfolge abgearbeitet: <ul> <li>Wenn die Klientenadresse keinen Wert für das Kriterium aufweist, wird zum nächsten Kriterium übergegangen. </li> <li>Falls die Klientenadresse einen Wert hat und im Kriterium genannt wird, wohnt er nicht außerhalb. Ist der Wert im Kriterium nicht genannt, wohnt er außerhalb. In beiden Fällen werden die weiteren Kriterien nicht mehr betrachtet. </li> <li>Falls aufgrund fehlender Werte (oder fehlender Kriterien) kein Kriterium angewendet werden konnte, wird standardmäßig angenommen, dass der Klient nicht außerhalb wohnt. </li> </ul> Beispiele: <ul> <li> <pre> bezirk: Friedrichshain-Kreuzberg; ort: Berlin </pre> In Berlin enthalten alle mit dem Straßenkatalog abgeglichene Adressen einen Wert für den Bezirk. Da jede Beratungsstelle genau für einen Bezirk zuständig ist, kann auf dieser Basis entschieden werden. Falls eine Adresse nicht mit dem Straßenkatalog abgeglichen wurde, kann der Ort als Kriterium herangezogen werden, da in diesem Fall für Bezirk keine Angaben vorliegen. </li> <li> Falls kein Straßenkatalog verwendet wird, kann nur der Ort, die Postleitzahl oder evt. der Planungsraum (falls solche definiert sind und routinemäßig mit den Klientenadressen zusammen erfasst werden) als Kriterium verwendet werden, z.B. (fiktiv!): <pre> plz: 12345;23456;34567 </pre> Adressen mit diesen Postleitzahlen werden als nicht außerhalb wohnend betrachtet, alle anderen als außerhalb. Falls die Klientenadresse keine 5-stellige PLZ enthält, gilt der Wert als fehlend. Ungenauigkeiten werden in Kauf genommen, da die Region der Zuständigkeit nicht immer exakt mit den Regionen der Postleitzahlen übereinstimmt. </li> <li> <pre> samtgemeinde: Name1;Name2;Name3; plz: 12345;23456 </pre> Analog zum Berliner Beispiel würde hier auch zunächst das Kriterium Samtgemeinde versucht, das aber nur nach einem Abgleich mit dem Straßenkatalog bekannt ist. Für die nicht abgeglichenen Adressen wird dann die Postleitzahl herangezogen. In seltenen Fällen kann das zu Fehlern führen, da die Bereiche der Postleitzahlen manchmal nicht mit den Bereichen der Zuständigkeit exakt übereinstimmen. </li> </ul> Falls das Ergebnis "wohnt außerhalb" ist, wird automatisch ein entsprechender Eintrag in die Bundesstatistik vorgenommen, der beim Ausfüllen oben im Kasten "Falldaten" angezeigt wird. Wenn möglich wird der <strong>amtliche Gemeindeschlüssel</strong> eingetragen. Wenn dieser nicht gefunden wird, wird Postleitzahl und Wohnort angegeben. <br /><br /> <strong>Syntax</strong> wie in den Beispielen. Rund um die Trenner <code>;</code> und <code>:</code> dürfen Leerzeichen stehen. Es können auch mehrere Zeilen verwendet werden. <br /><br /> Unter (Berater-) {{pfad5|Hauptmenü|Statistik|Teilmenge|Neu|Neue Bedingung}}" finden Sie für jedes Kriterium die Menge der möglichen Werte. <br /><br /> Zur <strong>Testen</strong> gibt es unter {{pfad3|Aministratorhauptmenü|Bundesstatistik|Exportieren}} einen neuen Punkt ''Adressen außerhalb prüfen''. Sie können dort in einer Tabelle sehen, welche Adressen als außerhalb klassifiziert werden. <br />
|}</div>Ebkushttps://www.ebkus.org/wiki/Linux_InstallationLinux Installation2020-08-19T09:38:22Z<p>Ebkus: </p>
<hr />
<div>Gültig ab: EBKuS 4.10<br />
<br />
Die folgende Anleitung habe ich mit "Debian GNU/Linux 10 (buster)" getestet; vermutlich funktioniert das auch auf anderen Ubuntu bzw. Debian-basierten Gnu/Linux-Distributionen.<br />
<br />
Die Installation im folgenden Beispiel erfolgt unter dem User {{code|ebkus}} auf einem Rechner mit dem Namen {{code|ebvm}}. Der User {{code|ebkus}} benötigt Superuserrechte ({{code|sudo}}). Es wird angenommen, dass eine Internetverbindung besteht (zur Installation von Software mit {{code|apt-get}}).<br />
<br />
Die Installation erfolgt ausschließlich über die Kommandozeile. Damit funktioniert sie auch auf reinen Servern, die keine GUI haben.<br />
<br />
Bitte auch die [[Windows Installation]] beachten, da sind einige betriebssystemunabhängige Punkte ausführlicher dargestellt als hier.<br />
<br />
=== Voraussetzungen ===<br />
<br />
Folgende Voraussetzungen müssen erfüllt sein, damit EBKuS installiert werden kann:<br />
<br />
==== Python 2.7 ====<br />
<br />
Ist auf solche Systemen normalerweise bereits installiert, ansonsten:<br />
<br />
ebkus@ebvm:~$ sudo apt-get install python2.7<br />
<br />
Die Python Version sollte 2.7.13 oder höher sein, optimalerweise<br />
2.7.18, welches die letzte Python-2-Version darstellt.<br />
Python 2 wird nicht mehr weiterentwickelt wird. EBKuS ist noch nicht<br />
auf Python 3 portiert.<br />
<br />
==== MySQL ====<br />
<br />
Es sollte eine MySQL 5.*-Version zur Verfügung stehen, z.B. 5.1, 5.6<br />
oder 5.7. Zur Installation auf Debian 10 siehe zum Beispiel<br />
https://tecadmin.net/install-mysql-on-debian-10-buster/<br />
Kurz zusammengefasst wie folgt:<br />
<br />
1. System auf den neuesten Stand bringen:<br />
<br />
ebkus@ebvm:~$ sudo apt update <br />
ebkus@ebvm:~$ sudo apt upgrade<br />
<br />
2. PPA von MySQL einrichten und MySQL-Installation konfigurieren:<br />
<br />
ebkus@ebvm:~$ wget <nowiki>http://repo.mysql.com/mysql-apt-config_0.8.15-1_all.deb</nowiki><br />
ebkus@ebvm:~$ sudo dpkg -i mysql-apt-config_0.8.15-1_all.deb<br />
<br />
Beim letzten Schritt unbedingt ein MySQL 5 auswählen, also 5.6<br />
oder 5.7! EBKuS wurde noch nicht auf höheren Versionen getestet.<br />
<br />
3. MySQL installieren:<br />
<br />
ebkus@ebvm:~$ sudo apt update <br />
ebkus@ebvm:~$ sudo apt install mysql-server<br />
<br />
Bei der Installation muss ein Passwort für den Datenbank-User {{code|root}} angegeben werden, das später in die {{file|ebkus.conf}} eingetragen werden muss. Nach einer erfolgreichen Installation kann man sich mit dem Befehl<br />
<br />
ebkus@ebvm:~$ mysql -uroot -p''Passwort''<br />
Welcome to the MySQL monitor. Commands end with ; or \g.<br />
...<br />
mysql><br />
<br />
mit der Datenbank verbinden.<br />
<br />
Falls der Standardport 3306 für MySQL nicht zur Verfügung steht, muss die Datei {{file|/etc/mysql/my.cnf}} angepasst werden.<br />
<br />
==== Python-MySQLdb ====<br />
<br />
Den Datenbankadapter für Python-MySQL installieren:<br />
ebkus@ebvm:~$ sudo apt-get install python-mysqldb<br />
Nach erfolgreicher Installation kann man Python aufrufen und MySQLdb importieren:<br />
ebkus@ebvm:~$ python<br />
Python 2.7.16 (default, Oct 10 2019, 22:02:15)<br />
...<br />
>>> import MySQLdb<br />
>>><br />
<br />
==== Apache 2 ====<br />
<br />
Den Webserver installieren:<br />
ebkus@ebvm:~$ sudo apt-get install apache2<br />
Nach der erfolgreichen Installation erhält man mit einem Browser mit der Adresse <nowiki>http://localhost/</nowiki> eine Seite mit '''It works!'''. Oder man installiert z.B. {{code|wget}} und erhält mit der genannten Adresse die entsprechende HTML-Datei {{file|index.html}}:<br />
ebkus@ebvm:~$ sudo apt-get install wget<br />
ebkus@ebvm:~$ wget <nowiki>http://localhost/</nowiki><br />
<br />
Falls der Webserver nicht auf den Standardports 80 und 443 laufen soll, muss die Datei {{file|/etc/apache2/ports.conf}} angepasst werden, ebenso die {{file|ebkus.conf}} (siehe [[Konfiguration]])<br />
<br />
Um den Webserver zu konfigurieren, müssen das ssl-Modul und das<br />
cgi-Modul aktiviert werden:<br />
ebkus@ebvm:~$ sudo a2enmod ssl<br />
ebkus@ebvm:~$ sudo a2enmod cgi<br />
<br />
Außerdem muss die von EBKuS generierte Apache-Konfigurationsdatei eingebunden werden:<br />
ebkus@ebvm:~$ cd /etc/apache2/sites-enabled<br />
ebkus@ebvm:/etc/apache2/sites-enabled$ sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl.conf<br />
Die Datei {{file|ebkus_httpd.conf}} existiert zu diesem Zeitpunkt noch nicht, sie wird bei der Installation ({{file|install.py}}) und bei jeder Änderung von Instanzen ({{file|configure.py}}) neu generiert. Sie definiert einen Virtual Host für den Webserver, über den alle EBKuS-Instanzen angesprochen werden.<br />
<br />
'''Dateirechte:''' Alle Verzeichnisse, die in einem Pfad zu einer Datei stehen, die vom Webserver gelesen werden soll, müssen das Leserecht und das Ausführungsrecht besitzen. Wenn das Installationsverzeichnis wie im Beispiel im Homeverzeichnis eines Benutzers steht, müssen diese Rechte evt. explizit vergeben werden:<br />
ebkus@ebvm:~$ sudo chmod go+rx /home/ebkus <br />
Den vom Installationsskript erzeugten Verzeichnissen und Dateien werden diese Rechte automatisch gegeben.<br />
<br />
<br />
==== EBKuS ====<br />
<br />
Die neueste [http://www.ebkus.org/alle_downloads.html EBKuS-Software]<br />
herunterladen, auspacken und in das Distributionsverzeichnis gehen, z.B.:<br />
<br />
ebkus@ebkusvm1:~$ wget https://ebkus.org/downloads/ebkus-4.10/ebkus-4.10-src.zip<br />
ebkus@ebkusvm1:~$ unzip ebkus-4.10-src.zip<br />
ebkus@ebkusvm1:~$ cd EBKuS-4.10<br />
ebkus@ebkusvm1:~/EBKuS-4.10$<br />
<br />
=== Installation ===<br />
<br />
==== Erstkonfiguration ====<br />
<br />
Erstkonfiguration erzeugen:<br />
ebkus@ebkusvm1:~/EBKuS-4.10$ python install.py -c ~/ebkus_installation<br />
Die EBKuS-Konfigurationsdatei {{file|/home/ebkus/ebkus_installation/ebkus/ebkus.conf}} kann nun weiter bearbeitet und für die eigentliche Installation verwendet werden.<br />
<br />
==== Systemkonfiguration ====<br />
<br />
System-[[Konfiguration]] anpassen, insbesondere:<br />
* Passwort für Datenbank-User {{code|root}} eintragen (Parameter {{konfig|database_admin_password}})<br />
* {{konfig|server_name}}, normalerweise die IP-Nummer des Rechners.<br />
* Evt. Standardports {{konfig|server_https_port}} und {{konfig|server_http_port}} anpassen<br />
* {{konfig| server_admin}}<br />
* Im Abschnitt {{code|openssl}} Angaben zur Region und Organisation<br />
<br />
==== Instanzkonfiguration ====<br />
<br />
Instanz-[[Konfiguration]] anpassen:<br />
* {{konfig|instance_name}}, optional {{konfig|instance_title}}<br />
* {{konfig|initial_content}}, falls eine initiale Datenbank vorhanden ist (z.B. aus einer früheren Installation)<br />
* {{konfig|port}}<br />
<br />
==== Installation ====<br />
<br />
Installation:<br />
ebkus@ebkusvm1:~/EBKuS-4.10$ ./install.py ~/ebkus_installation<br />
Bei der Installation wird man unter Umständen nach dem Passwort des (Linux-)Users gefragt, dasselbe, das man bei einem vorangestellten {{code|sudo}} angeben muss. Damit können die start/stop-Skripte in die Bootsequenz ({{file|/etc/init.d/}}) eingetragen werden<br />
<br />
Nach der Installation (und auch nach jeder Umkonfigurierung mit {{file|configure.py}}) muss der Webserver neu gestartet werden:<br />
ebkus@ebvm:~$ sudo service apache2 restart<br />
* Restarting web server apache2 [ OK ]<br />
Ansonsten wird die neu generierte Webserver-Konfiguration in {{file|ebkus_httpd.conf}} nicht wirksam.<br />
<br />
==== Migration ====<br />
<br />
Falls wie [[Windows_Installation#Migration|hier]] beschrieben eine Menge von bestehenden Instanzen in die neue Installation übernommen werden soll:<br />
ebkus@ebkusvm1:~/EBKuS-4.10$ ./install.py -p ~/ebkus_preconfig ~/ebkus_installation<br />
Im Verzeichnis {{file|~/ebkus_preconfig}} muss dann eine gültige {{file|ebkus.conf}} liegen sowie eine Sicherungsdatei für jede Instanz, die in der Konfiguration über den Parameter {{konfig|initial_content}} eingebunden wird.<br />
<br />
=== Dienste ===<br />
<br />
Im Unterschied zur [[Windows Installation|Windows]] werden bei der Installation und der Konfigurierung keine Dienste gestartet oder gestoppt. Es werden jedoch Skripte in {{file|/etc/init.d}} generiert, mit denen die EBKuS-Server hoch und runtergefahren werden. Beim booten des Systems geschieht dies automatisch, d.h. nach einem Reboot steht EBKuS automatisch zur Verfügung.<br />
<br />
Für den Systemadministrator gibt es folgende Skripte, die nach der Installation im Homeverzeichnis stehen:<br />
* {{code|ebkusctl}}: Damit kann jede Instanz einzeln oder auch alle Instanzen gemeinsam hoch- und runtergefahren werden sowie deren Status abgefragt werden. Dieses Skript verwendet intern die generierten Skripte in {{file|/etc/init.d}}.<br />
* {{code|ebkusdump}}: Für jede Instanz einzeln oder für alle zusammen eine Sicherungsdatei erzeugen (verwendet intern {{file|datenbank_sichern.py||}}).<br />
* {{code|ebkusrestore}}: Für jede Instanz einzeln oder für alle zusammen die Datenbank aus eine Sicherungsdatei initialisieren (verwendet intern {{file| datenbank_initialisieren.py||}}).<br />
Z.B.<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl all start<br />
* Starting EBKuS demo [ OK ] <br />
* Starting EBKuS muster_efb [ OK ] <br />
* Starting EBKuS demo_braunschweig [ OK ] <br />
Jedes Skript hat eingebaute Hilfe:<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl --help<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl -h<br />
<br />
<br />
<br />
<br />
<br />
<!--<br />
<br />
Schritte:<br />
<br />
#`Installationsverzeichnis`_ einrichten, z.B. {{code|/home/user/ebinst}}:<br />
mkdir /home/user/ebinst<br />
#In das `Distributionsverzeichnis`_ gehen (z.B. {{code|/home/user/ebkus-cd/ebkus-3.3}}; man könnte hier auch direkt von der CD arbeiten):<br />
cd /home/user/ebkus-cd/ebkus-3.3<br />
#EBKuS-Konfiguration erzeugen:<br />
python install.py --config /home/user/ebinst<br />
#Erzeugte Konfigurationsdatei {{code|/home/user/ebinst/ebkus/ebkus.conf}}anpassen (siehe `Konfiguration`_).<br />
#EBKuS und alle in der Konfigurationsdatei definierten Instanzen installieren und konfigurieren:<br />
python install.py /home/user/ebinst<br />
Für jede in der Konfiguration definierten Instanz gibt es dann ein `Instanzverzeichnis`_:<br />
<br />
<blockquote>{{code|/home/user/ebinst/ebkus/}}''Instanzname''<br />
<br />
</blockquote><br />
Die Meldungen des Installationsskriptes stehen auch in der Datei {{code|/home/user/ebinst/install.log}}.<br />
<br />
#(als {{code|root}}) Die in Schritt 5. erzeugte Datei {{code|/home/user/ebinst/ebkus/ebkus_httpd.conf}} in die Apache-Konfigurationsdatei (bei SuSE z.B. /etc/httpd/httpd.conf) inkludieren, z.B. indem Sie dort am Ende die folgende Zeile eintragen:<br />
Include /home/user/ebinst/ebkus/ebkus_httpd.conf<br />
#(als {{code|root}}) Den Apache-Webserver neustarten, damit die modifizierte Konfiguration berücksichtigt wird, z.B. bei SuSE:<br />
rcapache restart<br />
#Eine konfigurierte EBKuS-Instanz testen, z.B. die Instanz demo:<br />
cd /home/user/ebinst/ebkus/demo <br />
./start.py --console<br />
Der gestartete Server gibt Meldungen auf die Konsole aus.<br />
<br />
#Über einen Browser mit der Instanz {{code|demo}} arbeiten (anstatt {{code|demo}} auch mit jeder anderen in der `Konfiguration`_definierten Instanz):<br />
https://localhost/ebkus/demo/cgi/do/login<br />
Die Login-Maske kann auch über eine vorgeschaltete Eingangsseite erreicht werden, die für jede Instanz generiert wird:<br />
<br />
https://localhost/ebkus/demo/index.html<br />
Diese Seite kann mit einem HTML-Editor gemäß den lokalen Bedürfnissen erweitert oder verändert werden. Die zu editierende Datei ist im `Instanzverzeichnis`_ unter {{code|htdocs/index.html}} zu finden.<br />
<br />
Als Administrator anmelden: Benutzer {{code|Admin}}, Passwort {{code|Admin}}. Als angemeldeter Administrator können Sie weitere Benutzer anlegen.<br />
<br />
Die Instanzen {{code|demo}} bzw. {{code|demo_berlin}} enthalten bereits Beispieldaten, mit denen Sie experimentieren können. Sie können sich also gleich als Bearbeiter bzw. als Verwaltungskraft anmelden, z.B. Benutzer {{code|test}}, Passwort {{code|test}} bzw. Benutzer {{code|verw}}, Passwort {{code|verw}}.<br />
<br />
Falls Sie in der Konfiguration den Parameter ''server_name'' mit einer in Ihrem Netzwerk gültigen IP-Adresse oder einem gültigen Namen belegt haben, können Sie auch von anderen Rechnern im Netzwerk auf eine EBKuS-Instanz zugreifen, z.B.:<br />
<br />
https://192.168.1.92/ebkus/demo/index.html https://192.168.1.92/ebkus/demo/cgi/do/login<br />
#(als {{code|root}}) Die Instanz in die Bootsequenz des Servers aufnehmen, so dass beim Hochfahren des Rechners der EBKuS-Server für die Instanz automatisch gestartet wird:<br />
cd /home/user/ebinst/ebkus/demo cp ebkus_demo /etc/init.d<br />
Die Links für die Run-Level manuell setzen oder, z.B. bei SuSE, den Run-Level-Editor verwenden.<br />
<br />
#In einer Produktionsinstanz die Anwendung einrichten, siehe Einrichtung der Anwendung im Handbuch.<br />
<br />
<br />
<br />
<br />
- Apache richtig löschen, so dass frische Konfig kommt:<br />
<br />
- sudo dpkg --purge --force-remove-reinstreq apache2.2-common<br />
<br />
So geht richtiges uninstall mit Konfiguration:<br />
apt-get remove ––purge *paketname*<br />
<br />
<br />
<br />
- download mit wget auf dem ubuntu server<br />
<br />
<br />
<br />
== Apache Konfiguration ==<br />
<br />
cd /etc/apache2/mods-enabled<br />
sudo ln -s ../mods-available/ssl.conf ssl.conf<br />
sudo ln -s ../mods-available/ssl.load ssl.load<br />
<br />
cd /etc/apache2/sites-enabled<br />
sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl<br />
http://ebkus.org/wiki/Linux_Installation#MySQL<br />
http://ebkus.org/wiki/Linux_Installation#Apache_2<br />
<br />
--></div>Ebkushttps://www.ebkus.org/wiki/Linux_InstallationLinux Installation2020-08-19T09:20:22Z<p>Ebkus: </p>
<hr />
<div>Gültig ab: EBKuS 4.10<br />
<br />
Die folgende Anleitung habe ich mit "Debian GNU/Linux 10 (buster)" getestet; vermutlich funktioniert das auch auf anderen Ubuntu bzw. Debian-basierten Gnu/Linux-Distributionen.<br />
<br />
Die Installation im folgenden Beispiel erfolgt unter dem User {{code|ebkus}} auf einem Rechner mit dem Namen {{code|ebvm}}. Der User {{code|ebkus}} benötigt Superuserrechte ({{code|sudo}}). Es wird angenommen, dass eine Internetverbindung besteht (zur Installation von Software mit {{code|apt-get}}).<br />
<br />
Die Installation erfolgt ausschließlich über die Kommandozeile. Damit funktioniert sie auch auf reinen Servern, die keine GUI haben.<br />
<br />
Bitte auch die [[Windows Installation]] beachten, da sind einige betriebssystemunabhängige Punkte ausführlicher dargestellt als hier.<br />
<br />
=== Voraussetzungen ===<br />
<br />
Folgende Voraussetzungen müssen erfüllt sein, damit EBKuS installiert werden kann:<br />
<br />
==== Python 2.7 ====<br />
<br />
Ist auf solche Systemen normalerweise bereits installiert, ansonsten:<br />
<br />
ebkus@ebvm:~$ sudo apt-get install python2.7<br />
<br />
Die Python Version sollte 2.7.13 oder höher sein, optimalerweise<br />
2.7.18, welches die letzte Python-2-Version darstellt.<br />
Python 2 wird nicht mehr weiterentwickelt wird. EBKuS ist noch nicht<br />
auf Python 3 portiert.<br />
<br />
==== MySQL ====<br />
<br />
Es sollte eine MySQL 5.*-Version zur Verfügung stehen, z.B. 5.1, 5.6<br />
oder 5.7. Zur Installation auf Debian 10 siehe zum Beispiel<br />
https://tecadmin.net/install-mysql-on-debian-10-buster/<br />
Kurz zusammengefasst wie folgt:<br />
<br />
1. System auf den neuesten Stand bringen:<br />
<br />
ebkus@ebvm:~$ sudo apt update <br />
ebkus@ebvm:~$ sudo apt upgrade<br />
<br />
2. PPA von MySQL einrichten und MySQL-Installation konfigurieren:<br />
<br />
ebkus@ebvm:~$ wget <nowiki>http://repo.mysql.com/mysql-apt-config_0.8.15-1_all.deb</nowiki><br />
ebkus@ebvm:~$ sudo dpkg -i mysql-apt-config_0.8.15-1_all.deb<br />
<br />
Beim letzten Schritt unbedingt ein MySQL 5 auswählen, also 5.6<br />
oder 5.7! EBKuS wurde noch nicht auf höheren Versionen getestet.<br />
<br />
3. MySQL installieren:<br />
<br />
ebkus@ebvm:~$ sudo apt update <br />
ebkus@ebvm:~$ sudo apt install mysql-server<br />
<br />
Bei der Installation muss ein Passwort für den Datenbank-User {{code|root}} angegeben werden, das später in die {{file|ebkus.conf}} eingetragen werden muss. Nach einer erfolgreichen Installation kann man sich mit dem Befehl<br />
<br />
ebkus@ebvm:~$ mysql -uroot -p''Passwort''<br />
Welcome to the MySQL monitor. Commands end with ; or \g.<br />
...<br />
mysql><br />
<br />
mit der Datenbank verbinden.<br />
<br />
Falls der Standardport 3306 für MySQL nicht zur Verfügung steht, muss die Datei {{file|/etc/mysql/my.cnf}} angepasst werden.<br />
<br />
==== Python-MySQLdb ====<br />
<br />
Den Datenbankadapter für Python-MySQL installieren:<br />
ebkus@ebvm:~$ sudo apt-get install python-mysqldb<br />
Nach erfolgreicher Installation kann man Python aufrufen und MySQLdb importieren:<br />
ebkus@ebvm:~$ python<br />
Python 2.7.16 (default, Oct 10 2019, 22:02:15)<br />
...<br />
>>> import MySQLdb<br />
>>><br />
<br />
==== Apache 2 ====<br />
<br />
Den Webserver installieren:<br />
ebkus@ebvm:~$ sudo apt-get install apache2<br />
Nach der erfolgreichen Installation erhält man mit einem Browser mit der Adresse <nowiki>http://localhost/</nowiki> eine Seite mit '''It works!'''. Oder man installiert z.B. {{code|wget}} und erhält mit der genannten Adresse die entsprechende HTML-Datei {{file|index.html}}:<br />
ebkus@ebvm:~$ sudo apt-get install wget<br />
ebkus@ebvm:~$ wget <nowiki>http://localhost/</nowiki><br />
<br />
Falls der Webserver nicht auf den Standardports 80 und 443 laufen soll, muss die Datei {{file|/etc/apache2/ports.conf}} angepasst werden, ebenso die {{file|ebkus.conf}} (siehe [[Konfiguration]])<br />
<br />
Um den Webserver zu konfigurieren, müssen das ssl-Modul und das<br />
cgi-Modul aktiviert werden:<br />
ebkus@ebvm:~$ sudo a2enmod ssl<br />
ebkus@ebvm:~$ sudo a2enmod cgi<br />
<br />
Außerdem muss die von EBKuS generierte Apache-Konfigurationsdatei eingebunden werden:<br />
ebkus@ebvm:~$ cd /etc/apache2/sites-enabled<br />
ebkus@ebvm:/etc/apache2/sites-enabled$ sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl.conf<br />
Die Datei {{file|ebkus_httpd.conf}} existiert zu diesem Zeitpunkt noch nicht, sie wird bei der Installation ({{file|install.py}}) und bei jeder Änderung von Instanzen ({{file|configure.py}}) neu generiert. Sie definiert einen Virtual Host für den Webserver, über den alle EBKuS-Instanzen angesprochen werden.<br />
<br />
'''Dateirechte:''' Alle Verzeichnisse, die in einem Pfad zu einer Datei stehen, die vom Webserver gelesen werden soll, müssen das Leserecht und das Ausführungsrecht besitzen. Wenn das Installationsverzeichnis wie im Beispiel im Homeverzeichnis eines Benutzers steht, müssen diese Rechte evt. explizit vergeben werden:<br />
ebkus@ebvm:~$ sudo chmod go+rx /home/ebkus <br />
Den vom Installationsskript erzeugten Verzeichnissen und Dateien werden diese Rechte automatisch gegeben.<br />
<br />
<br />
==== EBKuS ====<br />
<br />
Die neueste [http://www.ebkus.org/alle_downloads.html EBKuS-Software]<br />
herunterladen, auspacken und in das Distributionsverzeichnis gehen, z.B.:<br />
<br />
ebkus@ebkusvm1:~$ wget https://ebkus.org/downloads/ebkus-4.10/ebkus-4.10-src.zip<br />
ebkus@ebkusvm1:~$ unzip ebkus-4.10-src.zip<br />
ebkus@ebkusvm1:~$ cd EBKuS-4.10<br />
ebkus@ebkusvm1:~/EBKuS-4.10$<br />
<br />
=== Installation ===<br />
<br />
==== Erstkonfiguration ====<br />
<br />
Erstkonfiguration erzeugen:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ python install.py -c ~/ebkus_installation<br />
Die EBKuS-Konfigurationsdatei {{file|/home/ebkus/ebkus_installation/ebkus/ebkus.conf}} kann nun weiter bearbeitet und für die eigentliche Installation verwendet werden.<br />
<br />
==== Systemkonfiguration ====<br />
<br />
System-[[Konfiguration]] anpassen, insbesondere:<br />
* Passwort für Datenbank-User {{code|root}} eintragen (Parameter {{konfig|database_admin_password}})<br />
* {{konfig|server_name}}, normalerweise die IP-Nummer des Rechners.<br />
* Evt. Standardports {{konfig|server_https_port}} und {{konfig|server_http_port}} anpassen<br />
* {{konfig| server_admin}}<br />
* Im Abschnitt {{code|openssl}} Angaben zur Region und Organisation<br />
<br />
==== Instanzkonfiguration ====<br />
<br />
Instanz-[[Konfiguration]] anpassen:<br />
* {{konfig|instance_name}}, optional {{konfig|instance_title}}<br />
* {{konfig|initial_content}}, falls eine initiale Datenbank vorhanden ist (z.B. aus einer früheren Installation)<br />
* {{konfig|port}}<br />
<br />
==== Installation ====<br />
<br />
Installation:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ ./install.py ~/ebkus_installation<br />
Bei der Installation wird man unter Umständen nach dem Passwort des (Linux-)Users gefragt, dasselbe, das man bei einem vorangestellten {{code|sudo}} angeben muss. Damit können die start/stop-Skripte in die Bootsequenz ({{file|/etc/init.d/}}) eingetragen werden<br />
<br />
Nach der Installation (und auch nach jeder Umkonfigurierung mit {{file|configure.py}}) muss der Webserver neu gestartet werden:<br />
ebkus@ebvm:~$ sudo service apache2 restart<br />
* Restarting web server apache2 [ OK ]<br />
Ansonsten wird die neu generierte Webserver-Konfiguration in {{file|ebkus_httpd.conf}} nicht wirksam.<br />
<br />
==== Migration ====<br />
<br />
Falls wie [[Windows_Installation#Migration|hier]] beschrieben eine Menge von bestehenden Instanzen in die neue Installation übernommen werden soll:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ ./install.py -p ~/ebkus_preconfig ~/ebkus_installation<br />
Im Verzeichnis {{file|~/ebkus_preconfig}} muss dann eine gültige {{file|ebkus.conf}} liegen sowie eine Sicherungsdatei für jede Instanz, die in der Konfiguration über den Parameter {{konfig|initial_content}} eingebunden wird.<br />
<br />
=== Dienste ===<br />
<br />
Im Unterschied zur [[Windows Installation|Windows]] werden bei der Installation und der Konfigurierung keine Dienste gestartet oder gestoppt. Es werden jedoch Skripte in {{file|/etc/init.d}} generiert, mit denen die EBKuS-Server hoch und runtergefahren werden. Beim booten des Systems geschieht dies automatisch, d.h. nach einem Reboot steht EBKuS automatisch zur Verfügung.<br />
<br />
Für den Systemadministrator gibt es folgende Skripte, die nach der Installation im Homeverzeichnis stehen:<br />
* {{code|ebkusctl}}: Damit kann jede Instanz einzeln oder auch alle Instanzen gemeinsam hoch- und runtergefahren werden sowie deren Status abgefragt werden. Dieses Skript verwendet intern die generierten Skripte in {{file|/etc/init.d}}.<br />
* {{code|ebkusdump}}: Für jede Instanz einzeln oder für alle zusammen eine Sicherungsdatei erzeugen (verwendet intern {{file|datenbank_sichern.py||}}).<br />
* {{code|ebkusrestore}}: Für jede Instanz einzeln oder für alle zusammen die Datenbank aus eine Sicherungsdatei initialisieren (verwendet intern {{file| datenbank_initialisieren.py||}}).<br />
Z.B.<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl all start<br />
* Starting EBKuS demo [ OK ] <br />
* Starting EBKuS muster_efb [ OK ] <br />
* Starting EBKuS demo_braunschweig [ OK ] <br />
Jedes Skript hat eingebaute Hilfe:<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl --help<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl -h<br />
<br />
<br />
<br />
<br />
<br />
<!--<br />
<br />
Schritte:<br />
<br />
#`Installationsverzeichnis`_ einrichten, z.B. {{code|/home/user/ebinst}}:<br />
mkdir /home/user/ebinst<br />
#In das `Distributionsverzeichnis`_ gehen (z.B. {{code|/home/user/ebkus-cd/ebkus-3.3}}; man könnte hier auch direkt von der CD arbeiten):<br />
cd /home/user/ebkus-cd/ebkus-3.3<br />
#EBKuS-Konfiguration erzeugen:<br />
python install.py --config /home/user/ebinst<br />
#Erzeugte Konfigurationsdatei {{code|/home/user/ebinst/ebkus/ebkus.conf}}anpassen (siehe `Konfiguration`_).<br />
#EBKuS und alle in der Konfigurationsdatei definierten Instanzen installieren und konfigurieren:<br />
python install.py /home/user/ebinst<br />
Für jede in der Konfiguration definierten Instanz gibt es dann ein `Instanzverzeichnis`_:<br />
<br />
<blockquote>{{code|/home/user/ebinst/ebkus/}}''Instanzname''<br />
<br />
</blockquote><br />
Die Meldungen des Installationsskriptes stehen auch in der Datei {{code|/home/user/ebinst/install.log}}.<br />
<br />
#(als {{code|root}}) Die in Schritt 5. erzeugte Datei {{code|/home/user/ebinst/ebkus/ebkus_httpd.conf}} in die Apache-Konfigurationsdatei (bei SuSE z.B. /etc/httpd/httpd.conf) inkludieren, z.B. indem Sie dort am Ende die folgende Zeile eintragen:<br />
Include /home/user/ebinst/ebkus/ebkus_httpd.conf<br />
#(als {{code|root}}) Den Apache-Webserver neustarten, damit die modifizierte Konfiguration berücksichtigt wird, z.B. bei SuSE:<br />
rcapache restart<br />
#Eine konfigurierte EBKuS-Instanz testen, z.B. die Instanz demo:<br />
cd /home/user/ebinst/ebkus/demo <br />
./start.py --console<br />
Der gestartete Server gibt Meldungen auf die Konsole aus.<br />
<br />
#Über einen Browser mit der Instanz {{code|demo}} arbeiten (anstatt {{code|demo}} auch mit jeder anderen in der `Konfiguration`_definierten Instanz):<br />
https://localhost/ebkus/demo/cgi/do/login<br />
Die Login-Maske kann auch über eine vorgeschaltete Eingangsseite erreicht werden, die für jede Instanz generiert wird:<br />
<br />
https://localhost/ebkus/demo/index.html<br />
Diese Seite kann mit einem HTML-Editor gemäß den lokalen Bedürfnissen erweitert oder verändert werden. Die zu editierende Datei ist im `Instanzverzeichnis`_ unter {{code|htdocs/index.html}} zu finden.<br />
<br />
Als Administrator anmelden: Benutzer {{code|Admin}}, Passwort {{code|Admin}}. Als angemeldeter Administrator können Sie weitere Benutzer anlegen.<br />
<br />
Die Instanzen {{code|demo}} bzw. {{code|demo_berlin}} enthalten bereits Beispieldaten, mit denen Sie experimentieren können. Sie können sich also gleich als Bearbeiter bzw. als Verwaltungskraft anmelden, z.B. Benutzer {{code|test}}, Passwort {{code|test}} bzw. Benutzer {{code|verw}}, Passwort {{code|verw}}.<br />
<br />
Falls Sie in der Konfiguration den Parameter ''server_name'' mit einer in Ihrem Netzwerk gültigen IP-Adresse oder einem gültigen Namen belegt haben, können Sie auch von anderen Rechnern im Netzwerk auf eine EBKuS-Instanz zugreifen, z.B.:<br />
<br />
https://192.168.1.92/ebkus/demo/index.html https://192.168.1.92/ebkus/demo/cgi/do/login<br />
#(als {{code|root}}) Die Instanz in die Bootsequenz des Servers aufnehmen, so dass beim Hochfahren des Rechners der EBKuS-Server für die Instanz automatisch gestartet wird:<br />
cd /home/user/ebinst/ebkus/demo cp ebkus_demo /etc/init.d<br />
Die Links für die Run-Level manuell setzen oder, z.B. bei SuSE, den Run-Level-Editor verwenden.<br />
<br />
#In einer Produktionsinstanz die Anwendung einrichten, siehe Einrichtung der Anwendung im Handbuch.<br />
<br />
<br />
<br />
<br />
- Apache richtig löschen, so dass frische Konfig kommt:<br />
<br />
- sudo dpkg --purge --force-remove-reinstreq apache2.2-common<br />
<br />
So geht richtiges uninstall mit Konfiguration:<br />
apt-get remove ––purge *paketname*<br />
<br />
<br />
<br />
- download mit wget auf dem ubuntu server<br />
<br />
<br />
<br />
== Apache Konfiguration ==<br />
<br />
cd /etc/apache2/mods-enabled<br />
sudo ln -s ../mods-available/ssl.conf ssl.conf<br />
sudo ln -s ../mods-available/ssl.load ssl.load<br />
<br />
cd /etc/apache2/sites-enabled<br />
sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl<br />
http://ebkus.org/wiki/Linux_Installation#MySQL<br />
http://ebkus.org/wiki/Linux_Installation#Apache_2<br />
<br />
--></div>Ebkushttps://www.ebkus.org/wiki/Linux_InstallationLinux Installation2020-08-19T08:19:22Z<p>Ebkus: </p>
<hr />
<div>Gültig ab: EBKuS 4.10<br />
<br />
Die folgende Anleitung habe ich mit "Debian GNU/Linux 10 (buster)" getestet; vermutlich funktioniert das auch auf anderen Ubuntu bzw. Debian-basierten Gnu/Linux-Distributionen.<br />
<br />
Die Installation im folgenden Beispiel erfolgt unter dem User {{code|ebkus}} auf einem Rechner mit dem Namen {{code|ebvm}}. Der User {{code|ebkus}} benötigt Superuserrechte ({{code|sudo}}). Es wird angenommen, dass eine Internetverbindung besteht (zur Installation von Software mit {{code|apt-get}}).<br />
<br />
Die Installation erfolgt ausschließlich über die Kommandozeile. Damit funktioniert sie auch auf reinen Servern, die keine GUI haben.<br />
<br />
Bitte auch die [[Windows Installation]] beachten, da sind einige betriebssystemunabhängige Punkte ausführlicher dargestellt als hier.<br />
<br />
=== Voraussetzungen ===<br />
<br />
Folgende Voraussetzungen müssen erfüllt sein, damit EBKuS installiert werden kann:<br />
<br />
==== Python 2.7 ====<br />
<br />
Ist auf solche Systemen normalerweise bereits installiert, ansonsten:<br />
<br />
ebkus@ebvm:~$ sudo apt-get install python2.7<br />
<br />
Die Python Version sollte 2.7.13 oder höher sein, optimalerweise<br />
2.7.18, welches die letzte Python-2-Version darstellt.<br />
Python 2 wird nicht mehr weiterentwickelt wird. EBKuS ist noch nicht<br />
auf Python 3 portiert.<br />
<br />
==== MySQL ====<br />
<br />
Es sollte eine MySQL 5.*-Version zur Verfügung stehen, z.B. 5.1, 5.6<br />
oder 5.7. Zur Installation auf Debian 10 siehe zum Beispiel<br />
https://tecadmin.net/install-mysql-on-debian-10-buster/<br />
Kurz zusammengefasst wie folgt:<br />
<br />
1. System auf den neuesten Stand bringen:<br />
<br />
ebkus@ebvm:~$ sudo apt update <br />
ebkus@ebvm:~$ sudo apt upgrade<br />
<br />
2. PPA von MySQL einrichten und MySQL-Installation konfigurieren:<br />
<br />
ebkus@ebvm:~$ wget <nowiki>http://repo.mysql.com/mysql-apt-config_0.8.15-1_all.deb</nowiki><br />
ebkus@ebvm:~$ sudo dpkg -i mysql-apt-config_0.8.15-1_all.deb<br />
<br />
Beim letzten Schritt unbedingt ein MySQL 5 auswählen, also 5.6<br />
oder 5.7! EBKuS wurde noch nicht auf höheren Versionen getestet.<br />
<br />
3. MySQL installieren:<br />
<br />
ebkus@ebvm:~$ sudo apt update <br />
ebkus@ebvm:~$ sudo apt install mysql-server<br />
<br />
Bei der Installation muss ein Passwort für den Datenbank-User {{code|root}} angegeben werden, das später in die {{file|ebkus.conf}} eingetragen werden muss. Nach einer erfolgreichen Installation kann man sich mit dem Befehl<br />
<br />
ebkus@ebvm:~$ mysql -uroot -p''Passwort''<br />
Welcome to the MySQL monitor. Commands end with ; or \g.<br />
...<br />
mysql><br />
<br />
mit der Datenbank verbinden.<br />
<br />
Falls der Standardport 3306 für MySQL nicht zur Verfügung steht, muss die Datei {{file|/etc/mysql/my.cnf}} angepasst werden.<br />
<br />
==== Python-MySQLdb ====<br />
<br />
Den Datenbankadapter für Python-MySQL installieren:<br />
ebkus@ebvm:~$ sudo apt-get install python-mysqldb<br />
Nach erfolgreicher Installation kann man Python aufrufen und MySQLdb importieren:<br />
ebkus@ebvm:~$ python<br />
Python 2.7.16 (default, Oct 10 2019, 22:02:15)<br />
...<br />
>>> import MySQLdb<br />
>>><br />
<br />
==== Apache 2 ====<br />
<br />
Den Webserver installieren:<br />
ebkus@ebvm:~$ sudo apt-get install apache2<br />
Nach der erfolgreichen Installation erhält man mit einem Browser mit der Adresse <nowiki>http://localhost/</nowiki> eine Seite mit '''It works!'''. Oder man installiert z.B. {{code|wget}} und erhält mit der genannten Adresse die entsprechende HTML-Datei {{file|index.html}}:<br />
ebkus@ebvm:~$ sudo apt-get install wget<br />
ebkus@ebvm:~$ wget <nowiki>http://localhost/</nowiki><br />
<br />
Falls der Webserver nicht auf den Standardports 80 und 443 laufen soll, muss die Datei {{file|/etc/apache2/ports.conf}} angepasst werden, ebenso die {{file|ebkus.conf}} (siehe [[Konfiguration]])<br />
<br />
Um den Webserver zu konfigurieren, müssen das ssl-Modul und das<br />
cgi-Modul aktiviert werden:<br />
ebkus@ebvm:~$ sudo a2enmod ssl<br />
ebkus@ebvm:~$ sudo a2enmod cgi<br />
<br />
Außerdem muss die von EBKuS generierte Apache-Konfigurationsdatei eingebunden werden:<br />
ebkus@ebvm:~$ cd /etc/apache2/sites-enabled<br />
ebkus@ebvm:/etc/apache2/sites-enabled$ sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl.conf<br />
Die Datei {{file|ebkus_httpd.conf}} existiert zu diesem Zeitpunkt noch nicht, sie wird bei der Installation ({{file|install.py}}) und bei jeder Änderung von Instanzen ({{file|configure.py}}) neu generiert. Sie definiert einen Virtual Host für den Webserver, über den alle EBKuS-Instanzen angesprochen werden.<br />
<br />
'''Dateirechte:''' Alle Verzeichnisse, die in einem Pfad zu einer Datei stehen, die vom Webserver gelesen werden soll, müssen das Leserecht und das Ausführungsrecht besitzen. Wenn das Installationsverzeichnis wie im Beispiel im Homeverzeichnis eines Benutzers steht, müssen diese Rechte evt. explizit vergeben werden:<br />
ebkus@ebvm:~$ sudo chmod go+rx /home/ebkus <br />
Den vom Installationsskript erzeugten Verzeichnissen und Dateien werden diese Rechte automatisch gegeben.<br />
<br />
<br />
==== EBKuS ====<br />
<br />
Die neueste [http://www.ebkus.org/alle_downloads.html EBKuS-Software]<br />
herunterladen, auspacken und in das Distributionsverzeichnis gehen, z.B.:<br />
<br />
ebkus@ebkusvm1:~$ wget https://ebkus.org/downloads/ebkus-4.10/ebkus-4.10-src.zip<br />
ebkus@ebkusvm1:~$ unzip ebkus-4.10-src.zip<br />
ebkus@ebkusvm1:~$ cd EBKuS-4.10<br />
ebkus@ebkusvm1:~/EBKuS-4.10$<br />
<br />
=== Installation ===<br />
<br />
==== Erstkonfiguration ====<br />
<br />
Erstkonfiguration erzeugen:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ ./install.py -c ~/ebkus_installation<br />
Die EBKuS-Konfigurationsdatei {{file|/home/ebkus/ebkus_installation/ebkus/ebkus.conf}} kann nun weiter bearbeitet und für die eigentliche Installation verwendet werden.<br />
<br />
==== Systemkonfiguration ====<br />
<br />
System-[[Konfiguration]] anpassen, insbesondere:<br />
* Passwort für Datenbank-User {{code|root}} eintragen (Parameter {{konfig|database_admin_password}})<br />
* {{konfig|server_name}}, entweder IP-Nummer oder Name (FQDN)<br />
* Evt. Standardports {{konfig|server_https_port}} und {{konfig|server_http_port}} anpassen<br />
* {{konfig| server_admin}}<br />
* Im Abschnitt {{code|openssl}} Angaben zur Region und Organisation<br />
<br />
==== Instanzkonfiguration ====<br />
<br />
Instanz-[[Konfiguration]] anpassen:<br />
* {{konfig|instance_name}}, optional {{konfig|instance_title}}<br />
* {{konfig|initial_content}}, falls eine initiale Datenbank vorhanden ist (z.B. aus einer früheren Installation)<br />
* {{konfig|port}}<br />
<br />
==== Installation ====<br />
<br />
Installation:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ ./install.py ~/ebkus_installation<br />
Bei der Installation wird man unter Umständen nach dem Passwort des (Linux-)Users gefragt, dasselbe, das man bei einem vorangestellten {{code|sudo}} angeben muss. Damit können die start/stop-Skripte in die Bootsequenz ({{file|/etc/init.d/}}) eingetragen werden<br />
<br />
Nach der Installation (und auch nach jeder Umkonfigurierung mit {{file|configure.py}}) muss der Webserver neu gestartet werden:<br />
ebkus@ebvm:~$ sudo service apache2 restart<br />
* Restarting web server apache2 [ OK ]<br />
Ansonsten wird die neu generierte Webserver-Konfiguration in {{file|ebkus_httpd.conf}} nicht wirksam.<br />
<br />
==== Migration ====<br />
<br />
Falls wie [[Windows_Installation#Migration|hier]] beschrieben eine Menge von bestehenden Instanzen in die neue Installation übernommen werden soll:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ ./install.py -p ~/ebkus_preconfig ~/ebkus_installation<br />
Im Verzeichnis {{file|~/ebkus_preconfig}} muss dann eine gültige {{file|ebkus.conf}} liegen sowie eine Sicherungsdatei für jede Instanz, die in der Konfiguration über den Parameter {{konfig|initial_content}} eingebunden wird.<br />
<br />
=== Dienste ===<br />
<br />
Im Unterschied zur [[Windows Installation|Windows]] werden bei der Installation und der Konfigurierung keine Dienste gestartet oder gestoppt. Es werden jedoch Skripte in {{file|/etc/init.d}} generiert, mit denen die EBKuS-Server hoch und runtergefahren werden. Beim booten des Systems geschieht dies automatisch, d.h. nach einem Reboot steht EBKuS automatisch zur Verfügung.<br />
<br />
Für den Systemadministrator gibt es folgende Skripte, die nach der Installation im Homeverzeichnis stehen:<br />
* {{code|ebkusctl}}: Damit kann jede Instanz einzeln oder auch alle Instanzen gemeinsam hoch- und runtergefahren werden sowie deren Status abgefragt werden. Dieses Skript verwendet intern die generierten Skripte in {{file|/etc/init.d}}.<br />
* {{code|ebkusdump}}: Für jede Instanz einzeln oder für alle zusammen eine Sicherungsdatei erzeugen (verwendet intern {{file|datenbank_sichern.py||}}).<br />
* {{code|ebkusrestore}}: Für jede Instanz einzeln oder für alle zusammen die Datenbank aus eine Sicherungsdatei initialisieren (verwendet intern {{file| datenbank_initialisieren.py||}}).<br />
Z.B.<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl all start<br />
* Starting EBKuS demo [ OK ] <br />
* Starting EBKuS muster_efb [ OK ] <br />
* Starting EBKuS demo_braunschweig [ OK ] <br />
Jedes Skript hat eingebaute Hilfe:<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl --help<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl -h<br />
<br />
<br />
<br />
<br />
<br />
<!--<br />
<br />
Schritte:<br />
<br />
#`Installationsverzeichnis`_ einrichten, z.B. {{code|/home/user/ebinst}}:<br />
mkdir /home/user/ebinst<br />
#In das `Distributionsverzeichnis`_ gehen (z.B. {{code|/home/user/ebkus-cd/ebkus-3.3}}; man könnte hier auch direkt von der CD arbeiten):<br />
cd /home/user/ebkus-cd/ebkus-3.3<br />
#EBKuS-Konfiguration erzeugen:<br />
python install.py --config /home/user/ebinst<br />
#Erzeugte Konfigurationsdatei {{code|/home/user/ebinst/ebkus/ebkus.conf}}anpassen (siehe `Konfiguration`_).<br />
#EBKuS und alle in der Konfigurationsdatei definierten Instanzen installieren und konfigurieren:<br />
python install.py /home/user/ebinst<br />
Für jede in der Konfiguration definierten Instanz gibt es dann ein `Instanzverzeichnis`_:<br />
<br />
<blockquote>{{code|/home/user/ebinst/ebkus/}}''Instanzname''<br />
<br />
</blockquote><br />
Die Meldungen des Installationsskriptes stehen auch in der Datei {{code|/home/user/ebinst/install.log}}.<br />
<br />
#(als {{code|root}}) Die in Schritt 5. erzeugte Datei {{code|/home/user/ebinst/ebkus/ebkus_httpd.conf}} in die Apache-Konfigurationsdatei (bei SuSE z.B. /etc/httpd/httpd.conf) inkludieren, z.B. indem Sie dort am Ende die folgende Zeile eintragen:<br />
Include /home/user/ebinst/ebkus/ebkus_httpd.conf<br />
#(als {{code|root}}) Den Apache-Webserver neustarten, damit die modifizierte Konfiguration berücksichtigt wird, z.B. bei SuSE:<br />
rcapache restart<br />
#Eine konfigurierte EBKuS-Instanz testen, z.B. die Instanz demo:<br />
cd /home/user/ebinst/ebkus/demo <br />
./start.py --console<br />
Der gestartete Server gibt Meldungen auf die Konsole aus.<br />
<br />
#Über einen Browser mit der Instanz {{code|demo}} arbeiten (anstatt {{code|demo}} auch mit jeder anderen in der `Konfiguration`_definierten Instanz):<br />
https://localhost/ebkus/demo/cgi/do/login<br />
Die Login-Maske kann auch über eine vorgeschaltete Eingangsseite erreicht werden, die für jede Instanz generiert wird:<br />
<br />
https://localhost/ebkus/demo/index.html<br />
Diese Seite kann mit einem HTML-Editor gemäß den lokalen Bedürfnissen erweitert oder verändert werden. Die zu editierende Datei ist im `Instanzverzeichnis`_ unter {{code|htdocs/index.html}} zu finden.<br />
<br />
Als Administrator anmelden: Benutzer {{code|Admin}}, Passwort {{code|Admin}}. Als angemeldeter Administrator können Sie weitere Benutzer anlegen.<br />
<br />
Die Instanzen {{code|demo}} bzw. {{code|demo_berlin}} enthalten bereits Beispieldaten, mit denen Sie experimentieren können. Sie können sich also gleich als Bearbeiter bzw. als Verwaltungskraft anmelden, z.B. Benutzer {{code|test}}, Passwort {{code|test}} bzw. Benutzer {{code|verw}}, Passwort {{code|verw}}.<br />
<br />
Falls Sie in der Konfiguration den Parameter ''server_name'' mit einer in Ihrem Netzwerk gültigen IP-Adresse oder einem gültigen Namen belegt haben, können Sie auch von anderen Rechnern im Netzwerk auf eine EBKuS-Instanz zugreifen, z.B.:<br />
<br />
https://192.168.1.92/ebkus/demo/index.html https://192.168.1.92/ebkus/demo/cgi/do/login<br />
#(als {{code|root}}) Die Instanz in die Bootsequenz des Servers aufnehmen, so dass beim Hochfahren des Rechners der EBKuS-Server für die Instanz automatisch gestartet wird:<br />
cd /home/user/ebinst/ebkus/demo cp ebkus_demo /etc/init.d<br />
Die Links für die Run-Level manuell setzen oder, z.B. bei SuSE, den Run-Level-Editor verwenden.<br />
<br />
#In einer Produktionsinstanz die Anwendung einrichten, siehe Einrichtung der Anwendung im Handbuch.<br />
<br />
<br />
<br />
<br />
- Apache richtig löschen, so dass frische Konfig kommt:<br />
<br />
- sudo dpkg --purge --force-remove-reinstreq apache2.2-common<br />
<br />
So geht richtiges uninstall mit Konfiguration:<br />
apt-get remove ––purge *paketname*<br />
<br />
<br />
<br />
- download mit wget auf dem ubuntu server<br />
<br />
<br />
<br />
== Apache Konfiguration ==<br />
<br />
cd /etc/apache2/mods-enabled<br />
sudo ln -s ../mods-available/ssl.conf ssl.conf<br />
sudo ln -s ../mods-available/ssl.load ssl.load<br />
<br />
cd /etc/apache2/sites-enabled<br />
sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl<br />
http://ebkus.org/wiki/Linux_Installation#MySQL<br />
http://ebkus.org/wiki/Linux_Installation#Apache_2<br />
<br />
--></div>Ebkushttps://www.ebkus.org/wiki/Linux_InstallationLinux Installation2020-08-19T08:18:44Z<p>Ebkus: </p>
<hr />
<div>Gültig ab: EBKuS 4.10<br />
<br />
Die folgende Anleitung habe ich mit "Debian GNU/Linux 10 (buster)" getestet; vermutlich funktioniert das auch auf anderen Ubuntu bzw. Debian-basierten Gnu/Linux-Distributionen.<br />
<br />
Die Installation im folgenden Beispiel erfolgt unter dem User {{code|ebkus}} auf einem Rechner mit dem Namen {{code|ebvm}}. Der User {{code|ebkus}} benötigt Superuserrechte ({{code|sudo}}). Es wird angenommen, dass eine Internetverbindung besteht (zur Installation von Software mit {{code|apt-get}}).<br />
<br />
Die Installation erfolgt ausschließlich über die Kommandozeile. Damit funktioniert sie auch auf reinen Servern, die keine GUI haben.<br />
<br />
Bitte auch die [[Windows Installation]] beachten, da sind einige betriebssystemunabhängige Punkte ausführlicher dargestellt als hier.<br />
<br />
=== Voraussetzungen ===<br />
<br />
Folgende Voraussetzungen müssen erfüllt sein, damit EBKuS installiert werden kann:<br />
<br />
==== Python 2.7 ====<br />
<br />
Ist auf solche Systemen normalerweise bereits installiert, ansonsten:<br />
<br />
ebkus@ebvm:~$ sudo apt-get install python2.7<br />
<br />
Die Python Version sollte 2.7.13 oder höher sein, optimalerweise<br />
2.7.18, welches die letzte Python-2-Version darstellt.<br />
Python 2 wird nicht mehr weiterentwickelt wird. EBKuS ist noch nicht<br />
auf Python 3 portiert.<br />
<br />
==== MySQL ====<br />
<br />
Es sollte eine MySQL 5.*-Version zur Verfügung stehen, z.B. 5.1, 5.6<br />
oder 5.7. Zur Installation auf Debian 10 siehe zum Beispiel<br />
https://tecadmin.net/install-mysql-on-debian-10-buster/<br />
Kurz zusammengefasst wie folgt:<br />
<br />
1. System auf den neuesten Stand bringen:<br />
<br />
ebkus@ebvm:~$ sudo apt update <br />
ebkus@ebvm:~$ sudo apt upgrade<br />
<br />
2. PPA von MySQL einrichten und MySQL-Installation konfigurieren:<br />
<br />
ebkus@ebvm:~$ wget <nowiki>http://repo.mysql.com/mysql-apt-config_0.8.15-1_all.deb</nowiki><br />
ebkus@ebvm:~$ sudo dpkg -i mysql-apt-config_0.8.15-1_all.deb<br />
<br />
Beim letzten Schritt unbedingt ein MySQL 5 auswählen, also 5.6<br />
oder 5.7! EBKuS wurde noch nicht auf höheren Versionen getestet.<br />
<br />
3. MySQL installieren:<br />
<br />
ebkus@ebvm:~$ sudo apt update <br />
ebkus@ebvm:~$ sudo apt install mysql-server<br />
<br />
Bei der Installation muss ein Passwort für den Datenbank-User {{code|root}} angegeben werden, das später in die {{file|ebkus.conf}} eingetragen werden muss. Nach einer erfolgreichen Installation kann man sich mit dem Befehl<br />
<br />
ebkus@ebvm:~$ mysql -uroot -p''Passwort''<br />
Welcome to the MySQL monitor. Commands end with ; or \g.<br />
...<br />
mysql><br />
<br />
mit der Datenbank verbinden.<br />
<br />
Falls der Standardport 3306 für MySQL nicht zur Verfügung steht, muss die Datei {{file|/etc/mysql/my.cnf}} angepasst werden.<br />
<br />
==== Python-MySQLdb ====<br />
<br />
Den Datenbankadapter für Python-MySQL installieren:<br />
ebkus@ebvm:~$ sudo apt-get install python-mysqldb<br />
Nach erfolgreicher Installation kann man Python aufrufen und MySQLdb importieren:<br />
ebkus@ebvm:~$ python<br />
Python 2.7.16 (default, Oct 10 2019, 22:02:15)<br />
...<br />
>>> import MySQLdb<br />
>>><br />
<br />
==== Apache 2 ====<br />
<br />
Den Webserver installieren:<br />
ebkus@ebvm:~$ sudo apt-get install apache2<br />
Nach der erfolgreichen Installation erhält man mit einem Browser mit der Adresse <nowiki>http://localhost/</nowiki> eine Seite mit '''It works!'''. Oder man installiert z.B. {{code|wget}} und erhält mit der genannten Adresse die entsprechende HTML-Datei {{file|index.html}}:<br />
ebkus@ebvm:~$ sudo apt-get install wget<br />
ebkus@ebvm:~$ wget <nowiki>http://localhost/</nowiki><br />
<br />
Falls der Webserver nicht auf den Standardports 80 und 443 laufen soll, muss die Datei {{file|/etc/apache2/ports.conf}} angepasst werden, ebenso die {{file|ebkus.conf}} (siehe [[Konfiguration]])<br />
<br />
Um den Webserver zu konfigurieren, müssen das ssl-Modul und das<br />
cgi-Modul aktiviert werden:<br />
ebkus@ebvm:~$ sudo a2enmod ssl<br />
ebkus@ebvm:~$ sudo a2enmod cgi<br />
<br />
Außerdem muss die von EBKuS generierte Apache-Konfigurationsdatei eingebunden werden:<br />
ebkus@ebvm:~$ cd /etc/apache2/sites-enabled<br />
ebkus@ebvm:/etc/apache2/sites-enabled$ sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl.conf<br />
Die Datei {{file|ebkus_httpd.conf}} existiert zu diesem Zeitpunkt noch nicht, sie wird bei der Installation ({{file|install.py}}) und bei jeder Änderung von Instanzen ({{file|configure.py}}) neu generiert. Sie definiert einen Virtual Host für den Webserver, über den alle EBKuS-Instanzen angesprochen werden.<br />
<br />
'''Dateirechte:''' Alle Verzeichnisse, die in einem Pfad zu einer Datei stehen, die vom Webserver gelesen werden soll, müssen das Leserecht und das Ausführungsrecht besitzen. Wenn das Installationsverzeichnis wie im Beispiel im Homeverzeichnis eines Benutzers steht, müssen diese Rechte evt. explizit vergeben werden:<br />
ebkus@ebvm:~$ sudo chmod go+rx /home/ebkus <br />
Den vom Installationsskript erzeugten Verzeichnissen und Dateien werden diese Rechte automatisch gegeben.<br />
<br />
<br />
==== EBKuS ====<br />
<br />
Die neueste<br />
[http://www.ebkus.org/alle_downloads.html EBKuS-Software]<br />
herunterladen, auspacken und in das Distributionsverzeichnis<br />
gehen, z.B.: <br />
ebkus@ebkusvm1:~$ wget https://ebkus.org/downloads/ebkus-4.10/ebkus-4.10-src.zip<br />
ebkus@ebkusvm1:~$ unzip ebkus-4.10-src.zip<br />
ebkus@ebkusvm1:~$ cd EBKuS-4.10<br />
ebkus@ebkusvm1:~/EBKuS-4.10$<br />
<br />
=== Installation ===<br />
<br />
==== Erstkonfiguration ====<br />
<br />
Erstkonfiguration erzeugen:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ ./install.py -c ~/ebkus_installation<br />
Die EBKuS-Konfigurationsdatei {{file|/home/ebkus/ebkus_installation/ebkus/ebkus.conf}} kann nun weiter bearbeitet und für die eigentliche Installation verwendet werden.<br />
<br />
==== Systemkonfiguration ====<br />
<br />
System-[[Konfiguration]] anpassen, insbesondere:<br />
* Passwort für Datenbank-User {{code|root}} eintragen (Parameter {{konfig|database_admin_password}})<br />
* {{konfig|server_name}}, entweder IP-Nummer oder Name (FQDN)<br />
* Evt. Standardports {{konfig|server_https_port}} und {{konfig|server_http_port}} anpassen<br />
* {{konfig| server_admin}}<br />
* Im Abschnitt {{code|openssl}} Angaben zur Region und Organisation<br />
<br />
==== Instanzkonfiguration ====<br />
<br />
Instanz-[[Konfiguration]] anpassen:<br />
* {{konfig|instance_name}}, optional {{konfig|instance_title}}<br />
* {{konfig|initial_content}}, falls eine initiale Datenbank vorhanden ist (z.B. aus einer früheren Installation)<br />
* {{konfig|port}}<br />
<br />
==== Installation ====<br />
<br />
Installation:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ ./install.py ~/ebkus_installation<br />
Bei der Installation wird man unter Umständen nach dem Passwort des (Linux-)Users gefragt, dasselbe, das man bei einem vorangestellten {{code|sudo}} angeben muss. Damit können die start/stop-Skripte in die Bootsequenz ({{file|/etc/init.d/}}) eingetragen werden<br />
<br />
Nach der Installation (und auch nach jeder Umkonfigurierung mit {{file|configure.py}}) muss der Webserver neu gestartet werden:<br />
ebkus@ebvm:~$ sudo service apache2 restart<br />
* Restarting web server apache2 [ OK ]<br />
Ansonsten wird die neu generierte Webserver-Konfiguration in {{file|ebkus_httpd.conf}} nicht wirksam.<br />
<br />
==== Migration ====<br />
<br />
Falls wie [[Windows_Installation#Migration|hier]] beschrieben eine Menge von bestehenden Instanzen in die neue Installation übernommen werden soll:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ ./install.py -p ~/ebkus_preconfig ~/ebkus_installation<br />
Im Verzeichnis {{file|~/ebkus_preconfig}} muss dann eine gültige {{file|ebkus.conf}} liegen sowie eine Sicherungsdatei für jede Instanz, die in der Konfiguration über den Parameter {{konfig|initial_content}} eingebunden wird.<br />
<br />
=== Dienste ===<br />
<br />
Im Unterschied zur [[Windows Installation|Windows]] werden bei der Installation und der Konfigurierung keine Dienste gestartet oder gestoppt. Es werden jedoch Skripte in {{file|/etc/init.d}} generiert, mit denen die EBKuS-Server hoch und runtergefahren werden. Beim booten des Systems geschieht dies automatisch, d.h. nach einem Reboot steht EBKuS automatisch zur Verfügung.<br />
<br />
Für den Systemadministrator gibt es folgende Skripte, die nach der Installation im Homeverzeichnis stehen:<br />
* {{code|ebkusctl}}: Damit kann jede Instanz einzeln oder auch alle Instanzen gemeinsam hoch- und runtergefahren werden sowie deren Status abgefragt werden. Dieses Skript verwendet intern die generierten Skripte in {{file|/etc/init.d}}.<br />
* {{code|ebkusdump}}: Für jede Instanz einzeln oder für alle zusammen eine Sicherungsdatei erzeugen (verwendet intern {{file|datenbank_sichern.py||}}).<br />
* {{code|ebkusrestore}}: Für jede Instanz einzeln oder für alle zusammen die Datenbank aus eine Sicherungsdatei initialisieren (verwendet intern {{file| datenbank_initialisieren.py||}}).<br />
Z.B.<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl all start<br />
* Starting EBKuS demo [ OK ] <br />
* Starting EBKuS muster_efb [ OK ] <br />
* Starting EBKuS demo_braunschweig [ OK ] <br />
Jedes Skript hat eingebaute Hilfe:<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl --help<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl -h<br />
<br />
<br />
<br />
<br />
<br />
<!--<br />
<br />
Schritte:<br />
<br />
#`Installationsverzeichnis`_ einrichten, z.B. {{code|/home/user/ebinst}}:<br />
mkdir /home/user/ebinst<br />
#In das `Distributionsverzeichnis`_ gehen (z.B. {{code|/home/user/ebkus-cd/ebkus-3.3}}; man könnte hier auch direkt von der CD arbeiten):<br />
cd /home/user/ebkus-cd/ebkus-3.3<br />
#EBKuS-Konfiguration erzeugen:<br />
python install.py --config /home/user/ebinst<br />
#Erzeugte Konfigurationsdatei {{code|/home/user/ebinst/ebkus/ebkus.conf}}anpassen (siehe `Konfiguration`_).<br />
#EBKuS und alle in der Konfigurationsdatei definierten Instanzen installieren und konfigurieren:<br />
python install.py /home/user/ebinst<br />
Für jede in der Konfiguration definierten Instanz gibt es dann ein `Instanzverzeichnis`_:<br />
<br />
<blockquote>{{code|/home/user/ebinst/ebkus/}}''Instanzname''<br />
<br />
</blockquote><br />
Die Meldungen des Installationsskriptes stehen auch in der Datei {{code|/home/user/ebinst/install.log}}.<br />
<br />
#(als {{code|root}}) Die in Schritt 5. erzeugte Datei {{code|/home/user/ebinst/ebkus/ebkus_httpd.conf}} in die Apache-Konfigurationsdatei (bei SuSE z.B. /etc/httpd/httpd.conf) inkludieren, z.B. indem Sie dort am Ende die folgende Zeile eintragen:<br />
Include /home/user/ebinst/ebkus/ebkus_httpd.conf<br />
#(als {{code|root}}) Den Apache-Webserver neustarten, damit die modifizierte Konfiguration berücksichtigt wird, z.B. bei SuSE:<br />
rcapache restart<br />
#Eine konfigurierte EBKuS-Instanz testen, z.B. die Instanz demo:<br />
cd /home/user/ebinst/ebkus/demo <br />
./start.py --console<br />
Der gestartete Server gibt Meldungen auf die Konsole aus.<br />
<br />
#Über einen Browser mit der Instanz {{code|demo}} arbeiten (anstatt {{code|demo}} auch mit jeder anderen in der `Konfiguration`_definierten Instanz):<br />
https://localhost/ebkus/demo/cgi/do/login<br />
Die Login-Maske kann auch über eine vorgeschaltete Eingangsseite erreicht werden, die für jede Instanz generiert wird:<br />
<br />
https://localhost/ebkus/demo/index.html<br />
Diese Seite kann mit einem HTML-Editor gemäß den lokalen Bedürfnissen erweitert oder verändert werden. Die zu editierende Datei ist im `Instanzverzeichnis`_ unter {{code|htdocs/index.html}} zu finden.<br />
<br />
Als Administrator anmelden: Benutzer {{code|Admin}}, Passwort {{code|Admin}}. Als angemeldeter Administrator können Sie weitere Benutzer anlegen.<br />
<br />
Die Instanzen {{code|demo}} bzw. {{code|demo_berlin}} enthalten bereits Beispieldaten, mit denen Sie experimentieren können. Sie können sich also gleich als Bearbeiter bzw. als Verwaltungskraft anmelden, z.B. Benutzer {{code|test}}, Passwort {{code|test}} bzw. Benutzer {{code|verw}}, Passwort {{code|verw}}.<br />
<br />
Falls Sie in der Konfiguration den Parameter ''server_name'' mit einer in Ihrem Netzwerk gültigen IP-Adresse oder einem gültigen Namen belegt haben, können Sie auch von anderen Rechnern im Netzwerk auf eine EBKuS-Instanz zugreifen, z.B.:<br />
<br />
https://192.168.1.92/ebkus/demo/index.html https://192.168.1.92/ebkus/demo/cgi/do/login<br />
#(als {{code|root}}) Die Instanz in die Bootsequenz des Servers aufnehmen, so dass beim Hochfahren des Rechners der EBKuS-Server für die Instanz automatisch gestartet wird:<br />
cd /home/user/ebinst/ebkus/demo cp ebkus_demo /etc/init.d<br />
Die Links für die Run-Level manuell setzen oder, z.B. bei SuSE, den Run-Level-Editor verwenden.<br />
<br />
#In einer Produktionsinstanz die Anwendung einrichten, siehe Einrichtung der Anwendung im Handbuch.<br />
<br />
<br />
<br />
<br />
- Apache richtig löschen, so dass frische Konfig kommt:<br />
<br />
- sudo dpkg --purge --force-remove-reinstreq apache2.2-common<br />
<br />
So geht richtiges uninstall mit Konfiguration:<br />
apt-get remove ––purge *paketname*<br />
<br />
<br />
<br />
- download mit wget auf dem ubuntu server<br />
<br />
<br />
<br />
== Apache Konfiguration ==<br />
<br />
cd /etc/apache2/mods-enabled<br />
sudo ln -s ../mods-available/ssl.conf ssl.conf<br />
sudo ln -s ../mods-available/ssl.load ssl.load<br />
<br />
cd /etc/apache2/sites-enabled<br />
sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl<br />
http://ebkus.org/wiki/Linux_Installation#MySQL<br />
http://ebkus.org/wiki/Linux_Installation#Apache_2<br />
<br />
--></div>Ebkushttps://www.ebkus.org/wiki/Linux_InstallationLinux Installation2020-08-19T08:13:39Z<p>Ebkus: </p>
<hr />
<div>Gültig ab: EBKuS 4.10<br />
<br />
Die folgende Anleitung habe ich mit "Debian GNU/Linux 10 (buster)" getestet; vermutlich funktioniert das auch auf anderen Ubuntu bzw. Debian-basierten Gnu/Linux-Distributionen.<br />
<br />
Die Installation im folgenden Beispiel erfolgt unter dem User {{code|ebkus}} auf einem Rechner mit dem Namen {{code|ebvm}}. Der User {{code|ebkus}} benötigt Superuserrechte ({{code|sudo}}). Es wird angenommen, dass eine Internetverbindung besteht (zur Installation von Software mit {{code|apt-get}}).<br />
<br />
Die Installation erfolgt ausschließlich über die Kommandozeile. Damit funktioniert sie auch auf reinen Servern, die keine GUI haben.<br />
<br />
Bitte auch die [[Windows Installation]] beachten, da sind einige betriebssystemunabhängige Punkte ausführlicher dargestellt als hier.<br />
<br />
=== Voraussetzungen ===<br />
<br />
Folgende Voraussetzungen müssen erfüllt sein, damit EBKuS installiert werden kann:<br />
<br />
==== Python 2.7 ====<br />
<br />
Ist auf solche Systemen normalerweise bereits installiert, ansonsten:<br />
<br />
ebkus@ebvm:~$ sudo apt-get install python2.7<br />
<br />
Die Python Version sollte 2.7.13 oder höher sein, optimalerweise<br />
2.7.18, welches die letzte Python-2-Version darstellt.<br />
Python 2 wird nicht mehr weiterentwickelt wird. EBKuS ist noch nicht<br />
auf Python 3 portiert.<br />
<br />
==== MySQL ====<br />
<br />
Es sollte eine MySQL 5.*-Version zur Verfügung stehen, z.B. 5.1, 5.6<br />
oder 5.7. Zur Installation auf Debian 10 siehe zum Beispiel<br />
https://tecadmin.net/install-mysql-on-debian-10-buster/<br />
Kurz zusammengefasst wie folgt:<br />
<br />
1. System auf den neuesten Stand bringen:<br />
<br />
ebkus@ebvm:~$ sudo apt update <br />
ebkus@ebvm:~$ sudo apt upgrade<br />
<br />
2. PPA von MySQL einrichten und MySQL-Installation konfigurieren:<br />
<br />
ebkus@ebvm:~$ wget <nowiki>http://repo.mysql.com/mysql-apt-config_0.8.15-1_all.deb</nowiki><br />
ebkus@ebvm:~$ sudo dpkg -i mysql-apt-config_0.8.15-1_all.deb<br />
<br />
Beim letzten Schritt unbedingt ein MySQL 5 auswählen, also 5.6<br />
oder 5.7! EBKuS wurde noch nicht auf höheren Versionen getestet.<br />
<br />
3. MySQL installieren:<br />
<br />
ebkus@ebvm:~$ sudo apt update <br />
ebkus@ebvm:~$ sudo apt install mysql-server<br />
<br />
Bei der Installation muss ein Passwort für den Datenbank-User {{code|root}} angegeben werden, das später in die {{file|ebkus.conf}} eingetragen werden muss. Nach einer erfolgreichen Installation kann man sich mit dem Befehl<br />
<br />
ebkus@ebvm:~$ mysql -uroot -p''Passwort''<br />
Welcome to the MySQL monitor. Commands end with ; or \g.<br />
...<br />
mysql><br />
<br />
mit der Datenbank verbinden.<br />
<br />
Falls der Standardport 3306 für MySQL nicht zur Verfügung steht, muss die Datei {{file|/etc/mysql/my.cnf}} angepasst werden.<br />
<br />
==== Python-MySQLdb ====<br />
<br />
Den Datenbankadapter für Python-MySQL installieren:<br />
ebkus@ebvm:~$ sudo apt-get install python-mysqldb<br />
Nach erfolgreicher Installation kann man Python aufrufen und MySQLdb importieren:<br />
ebkus@ebvm:~$ python<br />
Python 2.7.16 (default, Oct 10 2019, 22:02:15)<br />
...<br />
>>> import MySQLdb<br />
>>><br />
<br />
==== Apache 2 ====<br />
<br />
Den Webserver installieren:<br />
ebkus@ebvm:~$ sudo apt-get install apache2<br />
Nach der erfolgreichen Installation erhält man mit einem Browser mit der Adresse <nowiki>http://localhost/</nowiki> eine Seite mit '''It works!'''. Oder man installiert z.B. {{code|wget}} und erhält mit der genannten Adresse die entsprechende HTML-Datei {{file|index.html}}:<br />
ebkus@ebvm:~$ sudo apt-get install wget<br />
ebkus@ebvm:~$ wget <nowiki>http://localhost/</nowiki><br />
<br />
Falls der Webserver nicht auf den Standardports 80 und 443 laufen soll, muss die Datei {{file|/etc/apache2/ports.conf}} angepasst werden, ebenso die {{file|ebkus.conf}} (siehe [[Konfiguration]])<br />
<br />
Um den Webserver zu konfigurieren, müssen das ssl-Modul und das<br />
cgi-Modul aktiviert werden:<br />
ebkus@ebvm:~$ sudo a2enmod ssl<br />
ebkus@ebvm:~$ sudo a2enmod cgi<br />
<br />
Außerdem muss die von EBKuS generierte Apache-Konfigurationsdatei eingebunden werden:<br />
ebkus@ebvm:~$ cd /etc/apache2/sites-enabled<br />
ebkus@ebvm:/etc/apache2/sites-enabled$ sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl.conf<br />
Die Datei {{file|ebkus_httpd.conf}} existiert zu diesem Zeitpunkt noch nicht, sie wird bei der Installation ({{file|install.py}}) und bei jeder Änderung von Instanzen ({{file|configure.py}}) neu generiert. Sie definiert einen Virtual Host für den Webserver, über den alle EBKuS-Instanzen angesprochen werden.<br />
<br />
'''Dateirechte:''' Alle Verzeichnisse, die in einem Pfad zu einer Datei stehen, die vom Webserver gelesen werden soll, müssen das Leserecht und das Ausführungsrecht besitzen. Wenn das Installationsverzeichnis wie im Beispiel im Homeverzeichnis eines Benutzers steht, müssen diese Rechte evt. explizit vergeben werden:<br />
ebkus@ebvm:~$ sudo chmod go+rx /home/ebkus <br />
Den vom Installationsskript erzeugten Verzeichnissen und Dateien werden diese Rechte automatisch gegeben.<br />
<br />
<br />
==== EBKuS ====<br />
<br />
Die neueste [http://www.ebkus.org/alle_downloads.html EBKuS-Software] herunterladen (zusammen mit evt. vorhandenen<br />
Patches!), auspacken und in das Distributionsverzeichnis gehen, z.B.:<br />
ebkus@ebkusvm1:~$ wget http://www.efb-berlin.de/ebkus/ebkus-4.5/ebkus-4.5-src.zip<br />
ebkus@ebkusvm1:~$ unzip ebkus-4.5-src.zip<br />
ebkus@ebkusvm1:~$ cd EBKuS-4.5<br />
ebkus@ebkusvm1:~/EBKuS-4.5$<br />
<br />
=== Installation ===<br />
<br />
==== Erstkonfiguration ====<br />
<br />
Erstkonfiguration erzeugen:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ ./install.py -c ~/ebkus_installation<br />
Die EBKuS-Konfigurationsdatei {{file|/home/ebkus/ebkus_installation/ebkus/ebkus.conf}} kann nun weiter bearbeitet und für die eigentliche Installation verwendet werden.<br />
<br />
==== Systemkonfiguration ====<br />
<br />
System-[[Konfiguration]] anpassen, insbesondere:<br />
* Passwort für Datenbank-User {{code|root}} eintragen (Parameter {{konfig|database_admin_password}})<br />
* {{konfig|server_name}}, entweder IP-Nummer oder Name (FQDN)<br />
* Evt. Standardports {{konfig|server_https_port}} und {{konfig|server_http_port}} anpassen<br />
* {{konfig| server_admin}}<br />
* Im Abschnitt {{code|openssl}} Angaben zur Region und Organisation<br />
<br />
==== Instanzkonfiguration ====<br />
<br />
Instanz-[[Konfiguration]] anpassen:<br />
* {{konfig|instance_name}}, optional {{konfig|instance_title}}<br />
* {{konfig|initial_content}}, falls eine initiale Datenbank vorhanden ist (z.B. aus einer früheren Installation)<br />
* {{konfig|port}}<br />
<br />
==== Installation ====<br />
<br />
Installation:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ ./install.py ~/ebkus_installation<br />
Bei der Installation wird man unter Umständen nach dem Passwort des (Linux-)Users gefragt, dasselbe, das man bei einem vorangestellten {{code|sudo}} angeben muss. Damit können die start/stop-Skripte in die Bootsequenz ({{file|/etc/init.d/}}) eingetragen werden<br />
<br />
Nach der Installation (und auch nach jeder Umkonfigurierung mit {{file|configure.py}}) muss der Webserver neu gestartet werden:<br />
ebkus@ebvm:~$ sudo service apache2 restart<br />
* Restarting web server apache2 [ OK ]<br />
Ansonsten wird die neu generierte Webserver-Konfiguration in {{file|ebkus_httpd.conf}} nicht wirksam.<br />
<br />
==== Migration ====<br />
<br />
Falls wie [[Windows_Installation#Migration|hier]] beschrieben eine Menge von bestehenden Instanzen in die neue Installation übernommen werden soll:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ ./install.py -p ~/ebkus_preconfig ~/ebkus_installation<br />
Im Verzeichnis {{file|~/ebkus_preconfig}} muss dann eine gültige {{file|ebkus.conf}} liegen sowie eine Sicherungsdatei für jede Instanz, die in der Konfiguration über den Parameter {{konfig|initial_content}} eingebunden wird.<br />
<br />
=== Dienste ===<br />
<br />
Im Unterschied zur [[Windows Installation|Windows]] werden bei der Installation und der Konfigurierung keine Dienste gestartet oder gestoppt. Es werden jedoch Skripte in {{file|/etc/init.d}} generiert, mit denen die EBKuS-Server hoch und runtergefahren werden. Beim booten des Systems geschieht dies automatisch, d.h. nach einem Reboot steht EBKuS automatisch zur Verfügung.<br />
<br />
Für den Systemadministrator gibt es folgende Skripte, die nach der Installation im Homeverzeichnis stehen:<br />
* {{code|ebkusctl}}: Damit kann jede Instanz einzeln oder auch alle Instanzen gemeinsam hoch- und runtergefahren werden sowie deren Status abgefragt werden. Dieses Skript verwendet intern die generierten Skripte in {{file|/etc/init.d}}.<br />
* {{code|ebkusdump}}: Für jede Instanz einzeln oder für alle zusammen eine Sicherungsdatei erzeugen (verwendet intern {{file|datenbank_sichern.py||}}).<br />
* {{code|ebkusrestore}}: Für jede Instanz einzeln oder für alle zusammen die Datenbank aus eine Sicherungsdatei initialisieren (verwendet intern {{file| datenbank_initialisieren.py||}}).<br />
Z.B.<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl all start<br />
* Starting EBKuS demo [ OK ] <br />
* Starting EBKuS muster_efb [ OK ] <br />
* Starting EBKuS demo_braunschweig [ OK ] <br />
Jedes Skript hat eingebaute Hilfe:<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl --help<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl -h<br />
<br />
<br />
<br />
<br />
<br />
<!--<br />
<br />
Schritte:<br />
<br />
#`Installationsverzeichnis`_ einrichten, z.B. {{code|/home/user/ebinst}}:<br />
mkdir /home/user/ebinst<br />
#In das `Distributionsverzeichnis`_ gehen (z.B. {{code|/home/user/ebkus-cd/ebkus-3.3}}; man könnte hier auch direkt von der CD arbeiten):<br />
cd /home/user/ebkus-cd/ebkus-3.3<br />
#EBKuS-Konfiguration erzeugen:<br />
python install.py --config /home/user/ebinst<br />
#Erzeugte Konfigurationsdatei {{code|/home/user/ebinst/ebkus/ebkus.conf}}anpassen (siehe `Konfiguration`_).<br />
#EBKuS und alle in der Konfigurationsdatei definierten Instanzen installieren und konfigurieren:<br />
python install.py /home/user/ebinst<br />
Für jede in der Konfiguration definierten Instanz gibt es dann ein `Instanzverzeichnis`_:<br />
<br />
<blockquote>{{code|/home/user/ebinst/ebkus/}}''Instanzname''<br />
<br />
</blockquote><br />
Die Meldungen des Installationsskriptes stehen auch in der Datei {{code|/home/user/ebinst/install.log}}.<br />
<br />
#(als {{code|root}}) Die in Schritt 5. erzeugte Datei {{code|/home/user/ebinst/ebkus/ebkus_httpd.conf}} in die Apache-Konfigurationsdatei (bei SuSE z.B. /etc/httpd/httpd.conf) inkludieren, z.B. indem Sie dort am Ende die folgende Zeile eintragen:<br />
Include /home/user/ebinst/ebkus/ebkus_httpd.conf<br />
#(als {{code|root}}) Den Apache-Webserver neustarten, damit die modifizierte Konfiguration berücksichtigt wird, z.B. bei SuSE:<br />
rcapache restart<br />
#Eine konfigurierte EBKuS-Instanz testen, z.B. die Instanz demo:<br />
cd /home/user/ebinst/ebkus/demo <br />
./start.py --console<br />
Der gestartete Server gibt Meldungen auf die Konsole aus.<br />
<br />
#Über einen Browser mit der Instanz {{code|demo}} arbeiten (anstatt {{code|demo}} auch mit jeder anderen in der `Konfiguration`_definierten Instanz):<br />
https://localhost/ebkus/demo/cgi/do/login<br />
Die Login-Maske kann auch über eine vorgeschaltete Eingangsseite erreicht werden, die für jede Instanz generiert wird:<br />
<br />
https://localhost/ebkus/demo/index.html<br />
Diese Seite kann mit einem HTML-Editor gemäß den lokalen Bedürfnissen erweitert oder verändert werden. Die zu editierende Datei ist im `Instanzverzeichnis`_ unter {{code|htdocs/index.html}} zu finden.<br />
<br />
Als Administrator anmelden: Benutzer {{code|Admin}}, Passwort {{code|Admin}}. Als angemeldeter Administrator können Sie weitere Benutzer anlegen.<br />
<br />
Die Instanzen {{code|demo}} bzw. {{code|demo_berlin}} enthalten bereits Beispieldaten, mit denen Sie experimentieren können. Sie können sich also gleich als Bearbeiter bzw. als Verwaltungskraft anmelden, z.B. Benutzer {{code|test}}, Passwort {{code|test}} bzw. Benutzer {{code|verw}}, Passwort {{code|verw}}.<br />
<br />
Falls Sie in der Konfiguration den Parameter ''server_name'' mit einer in Ihrem Netzwerk gültigen IP-Adresse oder einem gültigen Namen belegt haben, können Sie auch von anderen Rechnern im Netzwerk auf eine EBKuS-Instanz zugreifen, z.B.:<br />
<br />
https://192.168.1.92/ebkus/demo/index.html https://192.168.1.92/ebkus/demo/cgi/do/login<br />
#(als {{code|root}}) Die Instanz in die Bootsequenz des Servers aufnehmen, so dass beim Hochfahren des Rechners der EBKuS-Server für die Instanz automatisch gestartet wird:<br />
cd /home/user/ebinst/ebkus/demo cp ebkus_demo /etc/init.d<br />
Die Links für die Run-Level manuell setzen oder, z.B. bei SuSE, den Run-Level-Editor verwenden.<br />
<br />
#In einer Produktionsinstanz die Anwendung einrichten, siehe Einrichtung der Anwendung im Handbuch.<br />
<br />
<br />
<br />
<br />
- Apache richtig löschen, so dass frische Konfig kommt:<br />
<br />
- sudo dpkg --purge --force-remove-reinstreq apache2.2-common<br />
<br />
So geht richtiges uninstall mit Konfiguration:<br />
apt-get remove ––purge *paketname*<br />
<br />
<br />
<br />
- download mit wget auf dem ubuntu server<br />
<br />
<br />
<br />
== Apache Konfiguration ==<br />
<br />
cd /etc/apache2/mods-enabled<br />
sudo ln -s ../mods-available/ssl.conf ssl.conf<br />
sudo ln -s ../mods-available/ssl.load ssl.load<br />
<br />
cd /etc/apache2/sites-enabled<br />
sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl<br />
http://ebkus.org/wiki/Linux_Installation#MySQL<br />
http://ebkus.org/wiki/Linux_Installation#Apache_2<br />
<br />
--></div>Ebkushttps://www.ebkus.org/wiki/Linux_InstallationLinux Installation2020-08-19T07:31:52Z<p>Ebkus: </p>
<hr />
<div>Gültig ab: EBKuS 4.10<br />
<br />
Die folgende Anleitung habe ich mit "Debian GNU/Linux 10 (buster)" getestet; vermutlich funktioniert das auch auf anderen Ubuntu bzw. Debian-basierten Gnu/Linux-Distributionen.<br />
<br />
Die Installation im folgenden Beispiel erfolgt unter dem User {{code|ebkus}} auf einem Rechner mit dem Namen {{code|ebvm}}. Der User {{code|ebkus}} benötigt Superuserrechte ({{code|sudo}}). Es wird angenommen, dass eine Internetverbindung besteht (zur Installation von Software mit {{code|apt-get}}).<br />
<br />
Die Installation erfolgt ausschließlich über die Kommandozeile. Damit funktioniert sie auch auf reinen Servern, die keine GUI haben.<br />
<br />
Bitte auch die [[Windows Installation]] beachten, da sind einige betriebssystemunabhängige Punkte ausführlicher dargestellt als hier.<br />
<br />
=== Voraussetzungen ===<br />
<br />
Folgende Voraussetzungen müssen erfüllt sein, damit EBKuS installiert werden kann:<br />
<br />
==== Python 2.7 ====<br />
<br />
Ist auf solche Systemen normalerweise bereits installiert, ansonsten:<br />
<br />
ebkus@ebvm:~$ sudo apt-get install python2.7<br />
<br />
Die Python Version sollte 2.7.13 oder höher sein, optimalerweise<br />
2.7.18, welches die letzte Python-2-Version darstellt.<br />
Python 2 wird nicht mehr weiterentwickelt wird. EBKuS ist noch nicht<br />
auf Python 3 portiert.<br />
<br />
==== MySQL ====<br />
<br />
Es sollte eine MySQL 5.*-Version zur Verfügung stehen, z.B. 5.1, 5.6<br />
oder 5.7. Zur Installation auf Debian 10 siehe zum Beispiel<br />
https://tecadmin.net/install-mysql-on-debian-10-buster/<br />
Kurz zusammengefasst wie folgt:<br />
<br />
1. System auf den neuesten Stand bringen:<br />
<br />
ebkus@ebvm:~$ sudo apt update <br />
ebkus@ebvm:~$ sudo apt upgrade<br />
<br />
2. PPA von MySQL einrichten und MySQL-Installation konfigurieren:<br />
<br />
ebkus@ebvm:~$ wget <nowiki>http://repo.mysql.com/mysql-apt-config_0.8.15-1_all.deb</nowiki><br />
ebkus@ebvm:~$ sudo dpkg -i mysql-apt-config_0.8.15-1_all.deb<br />
<br />
Beim letzten Schritt unbedingt ein MySQL 5 auswählen, also 5.6<br />
oder 5.7! EBKuS wurde noch nicht auf höheren Versionen getestet.<br />
<br />
3. MySQL installieren:<br />
<br />
ebkus@ebvm:~$ sudo apt update <br />
ebkus@ebvm:~$ sudo apt install mysql-server<br />
<br />
Bei der Installation muss ein Passwort für den Datenbank-User {{code|root}} angegeben werden, das später in die {{file|ebkus.conf}} eingetragen werden muss. Nach einer erfolgreichen Installation kann man sich mit dem Befehl<br />
<br />
ebkus@ebvm:~$ mysql -uroot -p''Passwort''<br />
Welcome to the MySQL monitor. Commands end with ; or \g.<br />
...<br />
mysql><br />
<br />
mit der Datenbank verbinden.<br />
<br />
Falls der Standardport 3306 für MySQL nicht zur Verfügung steht, muss die Datei {{file|/etc/mysql/my.cnf}} angepasst werden.<br />
<br />
==== Python-MySQLdb ====<br />
<br />
Den Datenbankadapter für Python-MySQL installieren:<br />
ebkus@ebvm:~$ sudo apt-get install python-mysqldb<br />
Nach erfolgreicher Installation kann man Python aufrufen und MySQLdb importieren:<br />
ebkus@ebvm:~$ python<br />
Python 2.7.16 (default, Oct 10 2019, 22:02:15)<br />
...<br />
>>> import MySQLdb<br />
>>><br />
<br />
==== Apache 2 ====<br />
<br />
Den Webserver installieren:<br />
ebkus@ebvm:~$ sudo apt-get install apache2<br />
Nach der erfolgreichen Installation erhält man mit einem Browser mit der Adresse <nowiki>http://localhost/</nowiki> eine Seite mit '''It works!'''. Oder man installiert z.B. {{code|wget}} und erhält mit der genannten Adresse die entsprechende HTML-Datei {{file|index.html}}:<br />
ebkus@ebvm:~$ sudo apt-get install wget<br />
ebkus@ebvm:~$ wget <nowiki>http://localhost/</nowiki><br />
<br />
Falls der Webserver nicht auf den Standardports 80 und 443 laufen soll, muss die Datei {{file|/etc/apache2/ports.conf}} angepasst werden, ebenso die {{file|ebkus.conf}} (siehe [[Konfiguration]])<br />
<br />
Um den Webserver zu konfigurieren, müssen das ssl-Modul und das<br />
cgi-Modul aktiviert werden:<br />
ebkus@ebvm:~$ sudo a2enmod ssl<br />
ebkus@ebvm:~$ sudo a2enmod cgi<br />
<br />
Außerdem muss die von EBKuS generierte Apache-Konfigurationsdatei eingebunden werden:<br />
ebkus@ebvm:~$ cd /etc/apache2/sites-enabled<br />
ebkus@ebvm:/etc/apache2/sites-enabled$ sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl.conf<br />
Die Datei {{file|ebkus_httpd.conf}} existiert zu diesem Zeitpunkt noch nicht, sie wird bei der Installation ({{file|install.py}}) und bei jeder Änderung von Instanzen ({{file|configure.py}}) neu generiert. Sie definiert einen Virtual Host für den Webserver, über den alle EBKuS-Instanzen angesprochen werden.<br />
<br />
'''Dateirechte:''' Alle Verzeichnisse, die in einem Pfad zu einer Datei stehen, die vom Webserver gelesen werden soll, müssen das Leserecht und das Ausführungsrecht besitzen. Wenn das Installationsverzeichnis wie im Beispiel im Homeverzeichnis eines Benutzers steht, müssen diese Rechte evt. explizit vergeben werden:<br />
ebkus@ebvm:~$ sudo chmod go+rx /home/ebkus <br />
Den vom Installationsskript erzeugten Verzeichnissen und Dateien werden diese Rechte automatisch gegeben.<br />
<br />
<br />
==== Reportlab ====<br />
<br />
Falls keine Internetverbindung besteht, muss [http://www.efb-berlin.de/ebkus/ebkus-3.3/linux/ReportLab_1_19.zip diese] Datei bei der Installation im Downloadverzeichnis stehen, ansonsten wird sie bei der Installation automatisch heruntergeladen.<br />
<br />
==== EBKuS ====<br />
<br />
Die neueste [http://www.ebkus.org/alle_downloads.html EBKuS-Software] herunterladen (zusammen mit evt. vorhandenen<br />
Patches!), auspacken und in das Distributionsverzeichnis gehen, z.B.:<br />
ebkus@ebkusvm1:~$ wget http://www.efb-berlin.de/ebkus/ebkus-4.5/ebkus-4.5-src.zip<br />
ebkus@ebkusvm1:~$ unzip ebkus-4.5-src.zip<br />
ebkus@ebkusvm1:~$ cd EBKuS-4.5<br />
ebkus@ebkusvm1:~/EBKuS-4.5$<br />
<br />
=== Installation ===<br />
<br />
==== Erstkonfiguration ====<br />
<br />
Erstkonfiguration erzeugen:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ ./install.py -c ~/ebkus_installation<br />
Die EBKuS-Konfigurationsdatei {{file|/home/ebkus/ebkus_installation/ebkus/ebkus.conf}} kann nun weiter bearbeitet und für die eigentliche Installation verwendet werden.<br />
<br />
==== Systemkonfiguration ====<br />
<br />
System-[[Konfiguration]] anpassen, insbesondere:<br />
* Passwort für Datenbank-User {{code|root}} eintragen (Parameter {{konfig|database_admin_password}})<br />
* {{konfig|server_name}}, entweder IP-Nummer oder Name (FQDN)<br />
* Evt. Standardports {{konfig|server_https_port}} und {{konfig|server_http_port}} anpassen<br />
* {{konfig| server_admin}}<br />
* Im Abschnitt {{code|openssl}} Angaben zur Region und Organisation<br />
<br />
==== Instanzkonfiguration ====<br />
<br />
Instanz-[[Konfiguration]] anpassen:<br />
* {{konfig|instance_name}}, optional {{konfig|instance_title}}<br />
* {{konfig|initial_content}}, falls eine initiale Datenbank vorhanden ist (z.B. aus einer früheren Installation)<br />
* {{konfig|port}}<br />
<br />
==== Installation ====<br />
<br />
Installation:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ ./install.py ~/ebkus_installation<br />
Bei der Installation wird man unter Umständen nach dem Passwort des (Linux-)Users gefragt, dasselbe, das man bei einem vorangestellten {{code|sudo}} angeben muss. Damit können die start/stop-Skripte in die Bootsequenz ({{file|/etc/init.d/}}) eingetragen werden<br />
<br />
Nach der Installation (und auch nach jeder Umkonfigurierung mit {{file|configure.py}}) muss der Webserver neu gestartet werden:<br />
ebkus@ebvm:~$ sudo service apache2 restart<br />
* Restarting web server apache2 [ OK ]<br />
Ansonsten wird die neu generierte Webserver-Konfiguration in {{file|ebkus_httpd.conf}} nicht wirksam.<br />
<br />
==== Migration ====<br />
<br />
Falls wie [[Windows_Installation#Migration|hier]] beschrieben eine Menge von bestehenden Instanzen in die neue Installation übernommen werden soll:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ ./install.py -p ~/ebkus_preconfig ~/ebkus_installation<br />
Im Verzeichnis {{file|~/ebkus_preconfig}} muss dann eine gültige {{file|ebkus.conf}} liegen sowie eine Sicherungsdatei für jede Instanz, die in der Konfiguration über den Parameter {{konfig|initial_content}} eingebunden wird.<br />
<br />
=== Dienste ===<br />
<br />
Im Unterschied zur [[Windows Installation|Windows]] werden bei der Installation und der Konfigurierung keine Dienste gestartet oder gestoppt. Es werden jedoch Skripte in {{file|/etc/init.d}} generiert, mit denen die EBKuS-Server hoch und runtergefahren werden. Beim booten des Systems geschieht dies automatisch, d.h. nach einem Reboot steht EBKuS automatisch zur Verfügung.<br />
<br />
Für den Systemadministrator gibt es folgende Skripte, die nach der Installation im Homeverzeichnis stehen:<br />
* {{code|ebkusctl}}: Damit kann jede Instanz einzeln oder auch alle Instanzen gemeinsam hoch- und runtergefahren werden sowie deren Status abgefragt werden. Dieses Skript verwendet intern die generierten Skripte in {{file|/etc/init.d}}.<br />
* {{code|ebkusdump}}: Für jede Instanz einzeln oder für alle zusammen eine Sicherungsdatei erzeugen (verwendet intern {{file|datenbank_sichern.py||}}).<br />
* {{code|ebkusrestore}}: Für jede Instanz einzeln oder für alle zusammen die Datenbank aus eine Sicherungsdatei initialisieren (verwendet intern {{file| datenbank_initialisieren.py||}}).<br />
Z.B.<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl all start<br />
* Starting EBKuS demo [ OK ] <br />
* Starting EBKuS muster_efb [ OK ] <br />
* Starting EBKuS demo_braunschweig [ OK ] <br />
Jedes Skript hat eingebaute Hilfe:<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl --help<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl -h<br />
<br />
<br />
<br />
<br />
<br />
<!--<br />
<br />
Schritte:<br />
<br />
#`Installationsverzeichnis`_ einrichten, z.B. {{code|/home/user/ebinst}}:<br />
mkdir /home/user/ebinst<br />
#In das `Distributionsverzeichnis`_ gehen (z.B. {{code|/home/user/ebkus-cd/ebkus-3.3}}; man könnte hier auch direkt von der CD arbeiten):<br />
cd /home/user/ebkus-cd/ebkus-3.3<br />
#EBKuS-Konfiguration erzeugen:<br />
python install.py --config /home/user/ebinst<br />
#Erzeugte Konfigurationsdatei {{code|/home/user/ebinst/ebkus/ebkus.conf}}anpassen (siehe `Konfiguration`_).<br />
#EBKuS und alle in der Konfigurationsdatei definierten Instanzen installieren und konfigurieren:<br />
python install.py /home/user/ebinst<br />
Für jede in der Konfiguration definierten Instanz gibt es dann ein `Instanzverzeichnis`_:<br />
<br />
<blockquote>{{code|/home/user/ebinst/ebkus/}}''Instanzname''<br />
<br />
</blockquote><br />
Die Meldungen des Installationsskriptes stehen auch in der Datei {{code|/home/user/ebinst/install.log}}.<br />
<br />
#(als {{code|root}}) Die in Schritt 5. erzeugte Datei {{code|/home/user/ebinst/ebkus/ebkus_httpd.conf}} in die Apache-Konfigurationsdatei (bei SuSE z.B. /etc/httpd/httpd.conf) inkludieren, z.B. indem Sie dort am Ende die folgende Zeile eintragen:<br />
Include /home/user/ebinst/ebkus/ebkus_httpd.conf<br />
#(als {{code|root}}) Den Apache-Webserver neustarten, damit die modifizierte Konfiguration berücksichtigt wird, z.B. bei SuSE:<br />
rcapache restart<br />
#Eine konfigurierte EBKuS-Instanz testen, z.B. die Instanz demo:<br />
cd /home/user/ebinst/ebkus/demo <br />
./start.py --console<br />
Der gestartete Server gibt Meldungen auf die Konsole aus.<br />
<br />
#Über einen Browser mit der Instanz {{code|demo}} arbeiten (anstatt {{code|demo}} auch mit jeder anderen in der `Konfiguration`_definierten Instanz):<br />
https://localhost/ebkus/demo/cgi/do/login<br />
Die Login-Maske kann auch über eine vorgeschaltete Eingangsseite erreicht werden, die für jede Instanz generiert wird:<br />
<br />
https://localhost/ebkus/demo/index.html<br />
Diese Seite kann mit einem HTML-Editor gemäß den lokalen Bedürfnissen erweitert oder verändert werden. Die zu editierende Datei ist im `Instanzverzeichnis`_ unter {{code|htdocs/index.html}} zu finden.<br />
<br />
Als Administrator anmelden: Benutzer {{code|Admin}}, Passwort {{code|Admin}}. Als angemeldeter Administrator können Sie weitere Benutzer anlegen.<br />
<br />
Die Instanzen {{code|demo}} bzw. {{code|demo_berlin}} enthalten bereits Beispieldaten, mit denen Sie experimentieren können. Sie können sich also gleich als Bearbeiter bzw. als Verwaltungskraft anmelden, z.B. Benutzer {{code|test}}, Passwort {{code|test}} bzw. Benutzer {{code|verw}}, Passwort {{code|verw}}.<br />
<br />
Falls Sie in der Konfiguration den Parameter ''server_name'' mit einer in Ihrem Netzwerk gültigen IP-Adresse oder einem gültigen Namen belegt haben, können Sie auch von anderen Rechnern im Netzwerk auf eine EBKuS-Instanz zugreifen, z.B.:<br />
<br />
https://192.168.1.92/ebkus/demo/index.html https://192.168.1.92/ebkus/demo/cgi/do/login<br />
#(als {{code|root}}) Die Instanz in die Bootsequenz des Servers aufnehmen, so dass beim Hochfahren des Rechners der EBKuS-Server für die Instanz automatisch gestartet wird:<br />
cd /home/user/ebinst/ebkus/demo cp ebkus_demo /etc/init.d<br />
Die Links für die Run-Level manuell setzen oder, z.B. bei SuSE, den Run-Level-Editor verwenden.<br />
<br />
#In einer Produktionsinstanz die Anwendung einrichten, siehe Einrichtung der Anwendung im Handbuch.<br />
<br />
<br />
<br />
<br />
- Apache richtig löschen, so dass frische Konfig kommt:<br />
<br />
- sudo dpkg --purge --force-remove-reinstreq apache2.2-common<br />
<br />
So geht richtiges uninstall mit Konfiguration:<br />
apt-get remove ––purge *paketname*<br />
<br />
<br />
<br />
- download mit wget auf dem ubuntu server<br />
<br />
<br />
<br />
== Apache Konfiguration ==<br />
<br />
cd /etc/apache2/mods-enabled<br />
sudo ln -s ../mods-available/ssl.conf ssl.conf<br />
sudo ln -s ../mods-available/ssl.load ssl.load<br />
<br />
cd /etc/apache2/sites-enabled<br />
sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl<br />
http://ebkus.org/wiki/Linux_Installation#MySQL<br />
http://ebkus.org/wiki/Linux_Installation#Apache_2<br />
<br />
--></div>Ebkushttps://www.ebkus.org/wiki/Linux_InstallationLinux Installation2020-08-19T07:23:51Z<p>Ebkus: </p>
<hr />
<div>Gültig ab: EBKuS 4.10<br />
<br />
Die folgende Anleitung habe ich mit "Debian GNU/Linux 10 (buster)" getestet; vermutlich funktioniert das auch auf anderen Ubuntu bzw. Debian-basierten Gnu/Linux-Distributionen.<br />
<br />
Die Installation im folgenden Beispiel erfolgt unter dem User {{code|ebkus}} auf einem Rechner mit dem Namen {{code|ebvm}}. Der User {{code|ebkus}} benötigt Superuserrechte ({{code|sudo}}). Es wird angenommen, dass eine Internetverbindung besteht (zur Installation von Software mit {{code|apt-get}}).<br />
<br />
Die Installation erfolgt ausschließlich über die Kommandozeile. Damit funktioniert sie auch auf reinen Servern, die keine GUI haben.<br />
<br />
Bitte auch die [[Windows Installation]] beachten, da sind einige betriebssystemunabhängige Punkte ausführlicher dargestellt als hier.<br />
<br />
=== Voraussetzungen ===<br />
<br />
Folgende Voraussetzungen müssen erfüllt sein, damit EBKuS installiert werden kann:<br />
<br />
==== Python 2.7 ====<br />
<br />
Ist auf solche Systemen normalerweise bereits installiert, ansonsten:<br />
<br />
ebkus@ebvm:~$ sudo apt-get install python2.7<br />
<br />
Die Python Version sollte 2.7.13 oder höher sein, optimalerweise<br />
2.7.18, welches die letzte Python-2-Version darstellt.<br />
Python 2 wird nicht mehr weiterentwickelt wird. EBKuS ist noch nicht<br />
auf Python 3 portiert.<br />
<br />
==== MySQL ====<br />
<br />
Es sollte eine MySQL 5.* zur Verfügung stehen, z.B. 5.1, 5.6<br />
oder 5.7. Zur Installation auf Debian 10 siehe zum Beispiel<br />
https://tecadmin.net/install-mysql-on-debian-10-buster/<br />
Kurz zusammengefasst wie folgt:<br />
<br />
1. System auf den neuesten Stand bringen:<br />
<br />
ebkus@ebvm:~$ sudo apt update <br />
ebkus@ebvm:~$ sudo apt upgrade<br />
<br />
2. PPA von MySQL einrichten und MySQL-Installation konfigurieren:<br />
<br />
ebkus@ebvm:~$ wget http://repo.mysql.com/mysql-apt-config_0.8.15-1_all.deb<br />
ebkus@ebvm:~$ sudo dpkg -i mysql-apt-config_0.8.15-1_all.deb<br />
<br />
Beim letzten Schritt unbedingt ein MySQL 5 auswählen, also 5.6<br />
oder 5.7! EBKuS wurde noch nicht auf höheren Versionen getestet.<br />
<br />
3. MySQL installieren:<br />
<br />
ebkus@ebvm:~$ sudo apt update <br />
ebkus@ebvm:~$ sudo apt install mysql-server<br />
<br />
Bei der Installation muss ein Passwort für den Datenbank-User {{code|root}} angegeben werden, das später in die {{file|ebkus.conf}} eingetragen werden muss. Nach einer erfolgreichen Installation kann man sich mit dem Befehl<br />
<br />
ebkus@ebvm:~$ mysql -uroot -p''Passwort''<br />
Welcome to the MySQL monitor. Commands end with ; or \g.<br />
...<br />
mysql><br />
<br />
mit der Datenbank verbinden.<br />
<br />
Falls der Standardport 3306 für MySQL nicht zur Verfügung steht, muss die Datei {{file|/etc/mysql/my.cnf}} angepasst werden.<br />
<br />
==== Python-MySQLdb ====<br />
<br />
Den Datenbankadapter für Python-MySQL installieren:<br />
ebkus@ebvm:~$ sudo apt-get install python-mysqldb<br />
Nach erfolgreicher Installation kann man Python aufrufen und MySQLdb importieren:<br />
ebkus@ebvm:~$ python<br />
Python 2.6.5 (r265:79063, Apr 16 2010, 13:09:56)<br />
...<br />
>>> import MySQLdb<br />
>>><br />
<br />
==== Apache 2 ====<br />
<br />
Den Webserver installieren:<br />
ebkus@ebvm:~$ sudo apt-get install apache2<br />
Nach der erfolgreichen Installation erhält man mit einem Browser mit der Adresse <nowiki>http://localhost/</nowiki> eine Seite mit '''It works!'''. Oder man installiert z.B. {{code|wget}} und erhält mit der genannten Adresse die entsprechende HTML-Datei {{file|index.html}}:<br />
ebkus@ebvm:~$ sudo apt-get install wget<br />
ebkus@ebvm:~$ wget <nowiki>http://localhost/</nowiki><br />
<br />
Falls der Webserver nicht auf den Standardports 80 und 443 laufen soll, muss die Datei {{file|/etc/apache2/ports.conf}} angepasst werden, ebenso die {{file|ebkus.conf}} (siehe [[Konfiguration]])<br />
<br />
Um den Webserver zu konfigurieren, müssen das ssl-Modul und das<br />
cgi-Modul aktiviert werden:<br />
ebkus@ebvm:~$ sudo a2enmod ssl<br />
ebkus@ebvm:~$ sudo a2enmod cgi<br />
<br />
Außerdem muss die von EBKuS generierte Apache-Konfigurationsdatei eingebunden werden:<br />
ebkus@ebvm:~$ cd /etc/apache2/sites-enabled<br />
ebkus@ebvm:/etc/apache2/sites-enabled$ sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl.conf<br />
Die Datei {{file|ebkus_httpd.conf}} existiert zu diesem Zeitpunkt noch nicht, sie wird bei der Installation ({{file|install.py}}) und bei jeder Änderung von Instanzen ({{file|configure.py}}) neu generiert. Sie definiert einen Virtual Host für den Webserver, über den alle EBKuS-Instanzen angesprochen werden.<br />
<br />
'''Dateirechte:''' Alle Verzeichnisse, die in einem Pfad zu einer Datei stehen, die vom Webserver gelesen werden soll, müssen das Leserecht und das Ausführungsrecht besitzen. Wenn das Installationsverzeichnis wie im Beispiel im Homeverzeichnis eines Benutzers steht, müssen diese Rechte evt. explizit vergeben werden:<br />
ebkus@ebvm:~$ sudo chmod go+rx /home/ebkus <br />
Den vom Installationsskript erzeugten Verzeichnissen und Dateien werden diese Rechte automatisch gegeben.<br />
<br />
<br />
==== Reportlab ====<br />
<br />
Falls keine Internetverbindung besteht, muss [http://www.efb-berlin.de/ebkus/ebkus-3.3/linux/ReportLab_1_19.zip diese] Datei bei der Installation im Downloadverzeichnis stehen, ansonsten wird sie bei der Installation automatisch heruntergeladen.<br />
<br />
==== EBKuS ====<br />
<br />
Die neueste [http://www.ebkus.org/alle_downloads.html EBKuS-Software] herunterladen (zusammen mit evt. vorhandenen<br />
Patches!), auspacken und in das Distributionsverzeichnis gehen, z.B.:<br />
ebkus@ebkusvm1:~$ wget http://www.efb-berlin.de/ebkus/ebkus-4.5/ebkus-4.5-src.zip<br />
ebkus@ebkusvm1:~$ unzip ebkus-4.5-src.zip<br />
ebkus@ebkusvm1:~$ cd EBKuS-4.5<br />
ebkus@ebkusvm1:~/EBKuS-4.5$<br />
<br />
=== Installation ===<br />
<br />
==== Erstkonfiguration ====<br />
<br />
Erstkonfiguration erzeugen:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ ./install.py -c ~/ebkus_installation<br />
Die EBKuS-Konfigurationsdatei {{file|/home/ebkus/ebkus_installation/ebkus/ebkus.conf}} kann nun weiter bearbeitet und für die eigentliche Installation verwendet werden.<br />
<br />
==== Systemkonfiguration ====<br />
<br />
System-[[Konfiguration]] anpassen, insbesondere:<br />
* Passwort für Datenbank-User {{code|root}} eintragen (Parameter {{konfig|database_admin_password}})<br />
* {{konfig|server_name}}, entweder IP-Nummer oder Name (FQDN)<br />
* Evt. Standardports {{konfig|server_https_port}} und {{konfig|server_http_port}} anpassen<br />
* {{konfig| server_admin}}<br />
* Im Abschnitt {{code|openssl}} Angaben zur Region und Organisation<br />
<br />
==== Instanzkonfiguration ====<br />
<br />
Instanz-[[Konfiguration]] anpassen:<br />
* {{konfig|instance_name}}, optional {{konfig|instance_title}}<br />
* {{konfig|initial_content}}, falls eine initiale Datenbank vorhanden ist (z.B. aus einer früheren Installation)<br />
* {{konfig|port}}<br />
<br />
==== Installation ====<br />
<br />
Installation:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ ./install.py ~/ebkus_installation<br />
Bei der Installation wird man unter Umständen nach dem Passwort des (Linux-)Users gefragt, dasselbe, das man bei einem vorangestellten {{code|sudo}} angeben muss. Damit können die start/stop-Skripte in die Bootsequenz ({{file|/etc/init.d/}}) eingetragen werden<br />
<br />
Nach der Installation (und auch nach jeder Umkonfigurierung mit {{file|configure.py}}) muss der Webserver neu gestartet werden:<br />
ebkus@ebvm:~$ sudo service apache2 restart<br />
* Restarting web server apache2 [ OK ]<br />
Ansonsten wird die neu generierte Webserver-Konfiguration in {{file|ebkus_httpd.conf}} nicht wirksam.<br />
<br />
==== Migration ====<br />
<br />
Falls wie [[Windows_Installation#Migration|hier]] beschrieben eine Menge von bestehenden Instanzen in die neue Installation übernommen werden soll:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ ./install.py -p ~/ebkus_preconfig ~/ebkus_installation<br />
Im Verzeichnis {{file|~/ebkus_preconfig}} muss dann eine gültige {{file|ebkus.conf}} liegen sowie eine Sicherungsdatei für jede Instanz, die in der Konfiguration über den Parameter {{konfig|initial_content}} eingebunden wird.<br />
<br />
=== Dienste ===<br />
<br />
Im Unterschied zur [[Windows Installation|Windows]] werden bei der Installation und der Konfigurierung keine Dienste gestartet oder gestoppt. Es werden jedoch Skripte in {{file|/etc/init.d}} generiert, mit denen die EBKuS-Server hoch und runtergefahren werden. Beim booten des Systems geschieht dies automatisch, d.h. nach einem Reboot steht EBKuS automatisch zur Verfügung.<br />
<br />
Für den Systemadministrator gibt es folgende Skripte, die nach der Installation im Homeverzeichnis stehen:<br />
* {{code|ebkusctl}}: Damit kann jede Instanz einzeln oder auch alle Instanzen gemeinsam hoch- und runtergefahren werden sowie deren Status abgefragt werden. Dieses Skript verwendet intern die generierten Skripte in {{file|/etc/init.d}}.<br />
* {{code|ebkusdump}}: Für jede Instanz einzeln oder für alle zusammen eine Sicherungsdatei erzeugen (verwendet intern {{file|datenbank_sichern.py||}}).<br />
* {{code|ebkusrestore}}: Für jede Instanz einzeln oder für alle zusammen die Datenbank aus eine Sicherungsdatei initialisieren (verwendet intern {{file| datenbank_initialisieren.py||}}).<br />
Z.B.<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl all start<br />
* Starting EBKuS demo [ OK ] <br />
* Starting EBKuS muster_efb [ OK ] <br />
* Starting EBKuS demo_braunschweig [ OK ] <br />
Jedes Skript hat eingebaute Hilfe:<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl --help<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl -h<br />
<br />
<br />
<br />
<br />
<br />
<!--<br />
<br />
Schritte:<br />
<br />
#`Installationsverzeichnis`_ einrichten, z.B. {{code|/home/user/ebinst}}:<br />
mkdir /home/user/ebinst<br />
#In das `Distributionsverzeichnis`_ gehen (z.B. {{code|/home/user/ebkus-cd/ebkus-3.3}}; man könnte hier auch direkt von der CD arbeiten):<br />
cd /home/user/ebkus-cd/ebkus-3.3<br />
#EBKuS-Konfiguration erzeugen:<br />
python install.py --config /home/user/ebinst<br />
#Erzeugte Konfigurationsdatei {{code|/home/user/ebinst/ebkus/ebkus.conf}}anpassen (siehe `Konfiguration`_).<br />
#EBKuS und alle in der Konfigurationsdatei definierten Instanzen installieren und konfigurieren:<br />
python install.py /home/user/ebinst<br />
Für jede in der Konfiguration definierten Instanz gibt es dann ein `Instanzverzeichnis`_:<br />
<br />
<blockquote>{{code|/home/user/ebinst/ebkus/}}''Instanzname''<br />
<br />
</blockquote><br />
Die Meldungen des Installationsskriptes stehen auch in der Datei {{code|/home/user/ebinst/install.log}}.<br />
<br />
#(als {{code|root}}) Die in Schritt 5. erzeugte Datei {{code|/home/user/ebinst/ebkus/ebkus_httpd.conf}} in die Apache-Konfigurationsdatei (bei SuSE z.B. /etc/httpd/httpd.conf) inkludieren, z.B. indem Sie dort am Ende die folgende Zeile eintragen:<br />
Include /home/user/ebinst/ebkus/ebkus_httpd.conf<br />
#(als {{code|root}}) Den Apache-Webserver neustarten, damit die modifizierte Konfiguration berücksichtigt wird, z.B. bei SuSE:<br />
rcapache restart<br />
#Eine konfigurierte EBKuS-Instanz testen, z.B. die Instanz demo:<br />
cd /home/user/ebinst/ebkus/demo <br />
./start.py --console<br />
Der gestartete Server gibt Meldungen auf die Konsole aus.<br />
<br />
#Über einen Browser mit der Instanz {{code|demo}} arbeiten (anstatt {{code|demo}} auch mit jeder anderen in der `Konfiguration`_definierten Instanz):<br />
https://localhost/ebkus/demo/cgi/do/login<br />
Die Login-Maske kann auch über eine vorgeschaltete Eingangsseite erreicht werden, die für jede Instanz generiert wird:<br />
<br />
https://localhost/ebkus/demo/index.html<br />
Diese Seite kann mit einem HTML-Editor gemäß den lokalen Bedürfnissen erweitert oder verändert werden. Die zu editierende Datei ist im `Instanzverzeichnis`_ unter {{code|htdocs/index.html}} zu finden.<br />
<br />
Als Administrator anmelden: Benutzer {{code|Admin}}, Passwort {{code|Admin}}. Als angemeldeter Administrator können Sie weitere Benutzer anlegen.<br />
<br />
Die Instanzen {{code|demo}} bzw. {{code|demo_berlin}} enthalten bereits Beispieldaten, mit denen Sie experimentieren können. Sie können sich also gleich als Bearbeiter bzw. als Verwaltungskraft anmelden, z.B. Benutzer {{code|test}}, Passwort {{code|test}} bzw. Benutzer {{code|verw}}, Passwort {{code|verw}}.<br />
<br />
Falls Sie in der Konfiguration den Parameter ''server_name'' mit einer in Ihrem Netzwerk gültigen IP-Adresse oder einem gültigen Namen belegt haben, können Sie auch von anderen Rechnern im Netzwerk auf eine EBKuS-Instanz zugreifen, z.B.:<br />
<br />
https://192.168.1.92/ebkus/demo/index.html https://192.168.1.92/ebkus/demo/cgi/do/login<br />
#(als {{code|root}}) Die Instanz in die Bootsequenz des Servers aufnehmen, so dass beim Hochfahren des Rechners der EBKuS-Server für die Instanz automatisch gestartet wird:<br />
cd /home/user/ebinst/ebkus/demo cp ebkus_demo /etc/init.d<br />
Die Links für die Run-Level manuell setzen oder, z.B. bei SuSE, den Run-Level-Editor verwenden.<br />
<br />
#In einer Produktionsinstanz die Anwendung einrichten, siehe Einrichtung der Anwendung im Handbuch.<br />
<br />
<br />
<br />
<br />
- Apache richtig löschen, so dass frische Konfig kommt:<br />
<br />
- sudo dpkg --purge --force-remove-reinstreq apache2.2-common<br />
<br />
So geht richtiges uninstall mit Konfiguration:<br />
apt-get remove ––purge *paketname*<br />
<br />
<br />
<br />
- download mit wget auf dem ubuntu server<br />
<br />
<br />
<br />
== Apache Konfiguration ==<br />
<br />
cd /etc/apache2/mods-enabled<br />
sudo ln -s ../mods-available/ssl.conf ssl.conf<br />
sudo ln -s ../mods-available/ssl.load ssl.load<br />
<br />
cd /etc/apache2/sites-enabled<br />
sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl<br />
http://ebkus.org/wiki/Linux_Installation#MySQL<br />
http://ebkus.org/wiki/Linux_Installation#Apache_2<br />
<br />
--></div>Ebkushttps://www.ebkus.org/wiki/Linux_InstallationLinux Installation2020-08-19T07:02:06Z<p>Ebkus: </p>
<hr />
<div>Gültig ab: EBKuS 4.10<br />
<br />
Die folgende Anleitung habe ich mit "Debian GNU/Linux 10 (buster)" getestet; vermutlich funktioniert das auch auf anderen Ubuntu bzw. Debian-basierten Gnu/Linux-Distributionen.<br />
<br />
Die Installation im folgenden Beispiel erfolgt unter dem User {{code|ebkus}} auf einem Rechner mit dem Namen {{code|ebvm}}. Der User {{code|ebkus}} benötigt Superuserrechte ({{code|sudo}}). Es wird angenommen, dass eine Internetverbindung besteht (zur Installation von Software mit {{code|apt-get}}).<br />
<br />
Die Installation erfolgt ausschließlich über die Kommandozeile. Damit funktioniert sie auch auf reinen Servern, die keine GUI haben.<br />
<br />
Bitte auch die [[Windows Installation]] beachten, da sind einige betriebssystemunabhängige Punkte ausführlicher dargestellt als hier.<br />
<br />
=== Voraussetzungen ===<br />
<br />
Folgende Voraussetzungen müssen erfüllt sein, damit EBKuS installiert werden kann:<br />
<br />
==== Python 2.7 ====<br />
<br />
Ist auf solche Systemen normalerweise bereits installiert, ansonsten:<br />
<br />
ebkus@ebvm:~$ sudo apt-get install python2.7<br />
<br />
Die Python Version sollte 2.7.13 oder höher sein, optimalerweise<br />
2.7.18, welches die letzte Python-2-Version darstellt.<br />
Python 2 wird nicht mehr weiterentwickelt wird. EBKuS ist noch nicht<br />
auf Python 3 portiert.<br />
<br />
==== MySQL ====<br />
<br />
Bei Ubuntu 10.04 LTS wird MySQL 5.1.XX installiert. Mit der nächsthöheren MySQL-Version 5.5 ist EBKuS noch nicht getestet!<br />
<br />
Die Datenbank installieren mit:<br />
ebkus@ebvm:~$ sudo apt-get install mysql-server mysql-common mysql-client<br />
Bei der Installation muss ein Passwort für den Datenbank-User {{code|root}} angegeben werden, das später in die {{file|ebkus.conf}} eingetragen werden muss. Nach einer erfolgreichen Installation kann man sich mit dem Befehl<br />
ebkus@ebvm:~$ mysql -uroot -p''Passwort''<br />
Welcome to the MySQL monitor. Commands end with ; or \g.<br />
...<br />
mysql><br />
mit der Datenbank verbinden.<br />
<br />
Falls der Standardport 3306 für MySQL nicht zur Verfügung steht, muss die Datei {{file|/etc/mysql/my.cnf}} angepasst werden.<br />
<br />
==== Python-MySQLdb ====<br />
<br />
Den Datenbankadapter für Python-MySQL installieren:<br />
ebkus@ebvm:~$ sudo apt-get install python-mysqldb<br />
Nach erfolgreicher Installation kann man Python aufrufen und MySQLdb importieren:<br />
ebkus@ebvm:~$ python<br />
Python 2.6.5 (r265:79063, Apr 16 2010, 13:09:56)<br />
...<br />
>>> import MySQLdb<br />
>>><br />
<br />
==== Apache 2 ====<br />
<br />
Den Webserver installieren:<br />
ebkus@ebvm:~$ sudo apt-get install apache2<br />
Nach der erfolgreichen Installation erhält man mit einem Browser mit der Adresse <nowiki>http://localhost/</nowiki> eine Seite mit '''It works!'''. Oder man installiert z.B. {{code|wget}} und erhält mit der genannten Adresse die entsprechende HTML-Datei {{file|index.html}}:<br />
ebkus@ebvm:~$ sudo apt-get install wget<br />
ebkus@ebvm:~$ wget <nowiki>http://localhost/</nowiki><br />
<br />
Falls der Webserver nicht auf den Standardports 80 und 443 laufen soll, muss die Datei {{file|/etc/apache2/ports.conf}} angepasst werden, ebenso die {{file|ebkus.conf}} (siehe [[Konfiguration]])<br />
<br />
Um den Webserver zu konfigurieren, müssen das ssl-Modul und das<br />
cgi-Modul aktiviert werden:<br />
ebkus@ebvm:~$ sudo a2enmod ssl<br />
ebkus@ebvm:~$ sudo a2enmod cgi<br />
<br />
Außerdem muss die von EBKuS generierte Apache-Konfigurationsdatei eingebunden werden:<br />
ebkus@ebvm:~$ cd /etc/apache2/sites-enabled<br />
ebkus@ebvm:/etc/apache2/sites-enabled$ sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl.conf<br />
Die Datei {{file|ebkus_httpd.conf}} existiert zu diesem Zeitpunkt noch nicht, sie wird bei der Installation ({{file|install.py}}) und bei jeder Änderung von Instanzen ({{file|configure.py}}) neu generiert. Sie definiert einen Virtual Host für den Webserver, über den alle EBKuS-Instanzen angesprochen werden.<br />
<br />
'''Dateirechte:''' Alle Verzeichnisse, die in einem Pfad zu einer Datei stehen, die vom Webserver gelesen werden soll, müssen das Leserecht und das Ausführungsrecht besitzen. Wenn das Installationsverzeichnis wie im Beispiel im Homeverzeichnis eines Benutzers steht, müssen diese Rechte evt. explizit vergeben werden:<br />
ebkus@ebvm:~$ sudo chmod go+rx /home/ebkus <br />
Den vom Installationsskript erzeugten Verzeichnissen und Dateien werden diese Rechte automatisch gegeben.<br />
<br />
<br />
==== Reportlab ====<br />
<br />
Falls keine Internetverbindung besteht, muss [http://www.efb-berlin.de/ebkus/ebkus-3.3/linux/ReportLab_1_19.zip diese] Datei bei der Installation im Downloadverzeichnis stehen, ansonsten wird sie bei der Installation automatisch heruntergeladen.<br />
<br />
==== EBKuS ====<br />
<br />
Die neueste [http://www.ebkus.org/alle_downloads.html EBKuS-Software] herunterladen (zusammen mit evt. vorhandenen<br />
Patches!), auspacken und in das Distributionsverzeichnis gehen, z.B.:<br />
ebkus@ebkusvm1:~$ wget http://www.efb-berlin.de/ebkus/ebkus-4.5/ebkus-4.5-src.zip<br />
ebkus@ebkusvm1:~$ unzip ebkus-4.5-src.zip<br />
ebkus@ebkusvm1:~$ cd EBKuS-4.5<br />
ebkus@ebkusvm1:~/EBKuS-4.5$<br />
<br />
=== Installation ===<br />
<br />
==== Erstkonfiguration ====<br />
<br />
Erstkonfiguration erzeugen:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ ./install.py -c ~/ebkus_installation<br />
Die EBKuS-Konfigurationsdatei {{file|/home/ebkus/ebkus_installation/ebkus/ebkus.conf}} kann nun weiter bearbeitet und für die eigentliche Installation verwendet werden.<br />
<br />
==== Systemkonfiguration ====<br />
<br />
System-[[Konfiguration]] anpassen, insbesondere:<br />
* Passwort für Datenbank-User {{code|root}} eintragen (Parameter {{konfig|database_admin_password}})<br />
* {{konfig|server_name}}, entweder IP-Nummer oder Name (FQDN)<br />
* Evt. Standardports {{konfig|server_https_port}} und {{konfig|server_http_port}} anpassen<br />
* {{konfig| server_admin}}<br />
* Im Abschnitt {{code|openssl}} Angaben zur Region und Organisation<br />
<br />
==== Instanzkonfiguration ====<br />
<br />
Instanz-[[Konfiguration]] anpassen:<br />
* {{konfig|instance_name}}, optional {{konfig|instance_title}}<br />
* {{konfig|initial_content}}, falls eine initiale Datenbank vorhanden ist (z.B. aus einer früheren Installation)<br />
* {{konfig|port}}<br />
<br />
==== Installation ====<br />
<br />
Installation:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ ./install.py ~/ebkus_installation<br />
Bei der Installation wird man unter Umständen nach dem Passwort des (Linux-)Users gefragt, dasselbe, das man bei einem vorangestellten {{code|sudo}} angeben muss. Damit können die start/stop-Skripte in die Bootsequenz ({{file|/etc/init.d/}}) eingetragen werden<br />
<br />
Nach der Installation (und auch nach jeder Umkonfigurierung mit {{file|configure.py}}) muss der Webserver neu gestartet werden:<br />
ebkus@ebvm:~$ sudo service apache2 restart<br />
* Restarting web server apache2 [ OK ]<br />
Ansonsten wird die neu generierte Webserver-Konfiguration in {{file|ebkus_httpd.conf}} nicht wirksam.<br />
<br />
==== Migration ====<br />
<br />
Falls wie [[Windows_Installation#Migration|hier]] beschrieben eine Menge von bestehenden Instanzen in die neue Installation übernommen werden soll:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ ./install.py -p ~/ebkus_preconfig ~/ebkus_installation<br />
Im Verzeichnis {{file|~/ebkus_preconfig}} muss dann eine gültige {{file|ebkus.conf}} liegen sowie eine Sicherungsdatei für jede Instanz, die in der Konfiguration über den Parameter {{konfig|initial_content}} eingebunden wird.<br />
<br />
=== Dienste ===<br />
<br />
Im Unterschied zur [[Windows Installation|Windows]] werden bei der Installation und der Konfigurierung keine Dienste gestartet oder gestoppt. Es werden jedoch Skripte in {{file|/etc/init.d}} generiert, mit denen die EBKuS-Server hoch und runtergefahren werden. Beim booten des Systems geschieht dies automatisch, d.h. nach einem Reboot steht EBKuS automatisch zur Verfügung.<br />
<br />
Für den Systemadministrator gibt es folgende Skripte, die nach der Installation im Homeverzeichnis stehen:<br />
* {{code|ebkusctl}}: Damit kann jede Instanz einzeln oder auch alle Instanzen gemeinsam hoch- und runtergefahren werden sowie deren Status abgefragt werden. Dieses Skript verwendet intern die generierten Skripte in {{file|/etc/init.d}}.<br />
* {{code|ebkusdump}}: Für jede Instanz einzeln oder für alle zusammen eine Sicherungsdatei erzeugen (verwendet intern {{file|datenbank_sichern.py||}}).<br />
* {{code|ebkusrestore}}: Für jede Instanz einzeln oder für alle zusammen die Datenbank aus eine Sicherungsdatei initialisieren (verwendet intern {{file| datenbank_initialisieren.py||}}).<br />
Z.B.<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl all start<br />
* Starting EBKuS demo [ OK ] <br />
* Starting EBKuS muster_efb [ OK ] <br />
* Starting EBKuS demo_braunschweig [ OK ] <br />
Jedes Skript hat eingebaute Hilfe:<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl --help<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl -h<br />
<br />
<br />
<br />
<br />
<br />
<!--<br />
<br />
Schritte:<br />
<br />
#`Installationsverzeichnis`_ einrichten, z.B. {{code|/home/user/ebinst}}:<br />
mkdir /home/user/ebinst<br />
#In das `Distributionsverzeichnis`_ gehen (z.B. {{code|/home/user/ebkus-cd/ebkus-3.3}}; man könnte hier auch direkt von der CD arbeiten):<br />
cd /home/user/ebkus-cd/ebkus-3.3<br />
#EBKuS-Konfiguration erzeugen:<br />
python install.py --config /home/user/ebinst<br />
#Erzeugte Konfigurationsdatei {{code|/home/user/ebinst/ebkus/ebkus.conf}}anpassen (siehe `Konfiguration`_).<br />
#EBKuS und alle in der Konfigurationsdatei definierten Instanzen installieren und konfigurieren:<br />
python install.py /home/user/ebinst<br />
Für jede in der Konfiguration definierten Instanz gibt es dann ein `Instanzverzeichnis`_:<br />
<br />
<blockquote>{{code|/home/user/ebinst/ebkus/}}''Instanzname''<br />
<br />
</blockquote><br />
Die Meldungen des Installationsskriptes stehen auch in der Datei {{code|/home/user/ebinst/install.log}}.<br />
<br />
#(als {{code|root}}) Die in Schritt 5. erzeugte Datei {{code|/home/user/ebinst/ebkus/ebkus_httpd.conf}} in die Apache-Konfigurationsdatei (bei SuSE z.B. /etc/httpd/httpd.conf) inkludieren, z.B. indem Sie dort am Ende die folgende Zeile eintragen:<br />
Include /home/user/ebinst/ebkus/ebkus_httpd.conf<br />
#(als {{code|root}}) Den Apache-Webserver neustarten, damit die modifizierte Konfiguration berücksichtigt wird, z.B. bei SuSE:<br />
rcapache restart<br />
#Eine konfigurierte EBKuS-Instanz testen, z.B. die Instanz demo:<br />
cd /home/user/ebinst/ebkus/demo <br />
./start.py --console<br />
Der gestartete Server gibt Meldungen auf die Konsole aus.<br />
<br />
#Über einen Browser mit der Instanz {{code|demo}} arbeiten (anstatt {{code|demo}} auch mit jeder anderen in der `Konfiguration`_definierten Instanz):<br />
https://localhost/ebkus/demo/cgi/do/login<br />
Die Login-Maske kann auch über eine vorgeschaltete Eingangsseite erreicht werden, die für jede Instanz generiert wird:<br />
<br />
https://localhost/ebkus/demo/index.html<br />
Diese Seite kann mit einem HTML-Editor gemäß den lokalen Bedürfnissen erweitert oder verändert werden. Die zu editierende Datei ist im `Instanzverzeichnis`_ unter {{code|htdocs/index.html}} zu finden.<br />
<br />
Als Administrator anmelden: Benutzer {{code|Admin}}, Passwort {{code|Admin}}. Als angemeldeter Administrator können Sie weitere Benutzer anlegen.<br />
<br />
Die Instanzen {{code|demo}} bzw. {{code|demo_berlin}} enthalten bereits Beispieldaten, mit denen Sie experimentieren können. Sie können sich also gleich als Bearbeiter bzw. als Verwaltungskraft anmelden, z.B. Benutzer {{code|test}}, Passwort {{code|test}} bzw. Benutzer {{code|verw}}, Passwort {{code|verw}}.<br />
<br />
Falls Sie in der Konfiguration den Parameter ''server_name'' mit einer in Ihrem Netzwerk gültigen IP-Adresse oder einem gültigen Namen belegt haben, können Sie auch von anderen Rechnern im Netzwerk auf eine EBKuS-Instanz zugreifen, z.B.:<br />
<br />
https://192.168.1.92/ebkus/demo/index.html https://192.168.1.92/ebkus/demo/cgi/do/login<br />
#(als {{code|root}}) Die Instanz in die Bootsequenz des Servers aufnehmen, so dass beim Hochfahren des Rechners der EBKuS-Server für die Instanz automatisch gestartet wird:<br />
cd /home/user/ebinst/ebkus/demo cp ebkus_demo /etc/init.d<br />
Die Links für die Run-Level manuell setzen oder, z.B. bei SuSE, den Run-Level-Editor verwenden.<br />
<br />
#In einer Produktionsinstanz die Anwendung einrichten, siehe Einrichtung der Anwendung im Handbuch.<br />
<br />
<br />
<br />
<br />
- Apache richtig löschen, so dass frische Konfig kommt:<br />
<br />
- sudo dpkg --purge --force-remove-reinstreq apache2.2-common<br />
<br />
So geht richtiges uninstall mit Konfiguration:<br />
apt-get remove ––purge *paketname*<br />
<br />
<br />
<br />
- download mit wget auf dem ubuntu server<br />
<br />
<br />
<br />
== Apache Konfiguration ==<br />
<br />
cd /etc/apache2/mods-enabled<br />
sudo ln -s ../mods-available/ssl.conf ssl.conf<br />
sudo ln -s ../mods-available/ssl.load ssl.load<br />
<br />
cd /etc/apache2/sites-enabled<br />
sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl<br />
http://ebkus.org/wiki/Linux_Installation#MySQL<br />
http://ebkus.org/wiki/Linux_Installation#Apache_2<br />
<br />
--></div>Ebkushttps://www.ebkus.org/wiki/Windows_InstallationWindows Installation2020-08-18T11:11:35Z<p>Ebkus: </p>
<hr />
<div>Gültig ab: EBKuS 4.4.1<br />
<br />
Die Software, mit der frühere Versionen von EBKuS auf Windows<br />
automatisch installiert wurden, ist inzwischen in die Jahre<br />
gekommen. Ab Version 4.4.1 ist nun auch eine automatische<br />
Installation mit neuerer Software möglich. Dazu ist eine komplette<br />
Neuinstallation erforderlich. Der parallele Betrieb von alter und<br />
neuer Software ist nicht möglich.<br />
<br />
=== Benötigte Software ===<br />
<br />
* [https://www.python.org/ftp/python/2.7.18/python-2.7.18.msi Python 2.7.18]<br />
* [https://ebkus.org/downloads/win32/MySQL-python-1.2.3.win32-py2.7.exe MySQL-python-1.2.3]<br />
* [https://github.com/mhammond/pywin32/releases/download/b228/pywin32-228.win32-py2.7.exe pywin32-228]<br />
* [http://ftp.gwdg.de/pub/misc/mysql/Downloads/MySQL-5.1/mysql-essential-5.1.73-win32.msi MySQL 5.1.73]<br />
* [https://archive.apache.org/dist/httpd/binaries/win32/httpd-2.2.25-win32-x86-openssl-0.9.8y.msi Apache 2.2]<br />
<br />
Alle benötigten Dateien befinden sich auch auf dem [https://ebkus.org/downloads/win32/ EBKuS FTP-Server]. <br />
Nur die ersten drei müssen manuell heruntergeladen<br />
und installiert werden. Die übrigen werden bei Bedarf automatisch<br />
heruntergeladen (sofern eine Internetverbindung besteht, ansonsten siehe unten).<br />
<br />
Natürlich muss noch die neueste <br />
[http://www.ebkus.org/alle_downloads.html EBKuS-Software]<br />
selbst heruntergeladen werden. <br />
<br />
=== Sonstige Voraussetzungen ===<br />
<br />
* '''Betriebssystem''': Erfolgreich getestet auf Windows 2000 Professional, Windows XP Professional, Windows 7 Professional und Windows Server 2008.<br />
* Die von einer EBKuS-Installation verwendeten '''Ports''' dürfen nicht anderweitig verwendete werden:<br />
** Port 443 für den Apache-Webserver mit SSL-Verschlüsselung (kann mit der Konfigurationsvariablen {{konfig|server_https_port}} verändert werden)<br />
** Port 80 für den Apache-Webserver ohne SSL-Verschlüsselung (kann mit der Konfigurationsvariablen {{konfig|server_http_port}} verändert werden). Dieser Port wird allerdings von der Anwendung nicht benötigt; man kann damit aber überprüfen, ob der Webserver installiert ist unabhängig von EBKuS-Instanzen.<br />
** Port 3306 für den MySQL-Datenbankserver <br />
** Die in der {{file|ebkus.conf||}} explizit genannten Ports für die EBKuS-Instanzen<br />
* '''Administratorrechte''' für die Installation. Insbesondere muss bei neueren Windows-Systemen die Kommandozeile explizit mit Administratorrechten aufgerufen werden (rechtsklicken, mit Administratorrechten ausführen). Sonst gelingt die Einrichtung der Dienste nicht.<br />
* Die von EBKuS verwendeten '''Namen für Dienste''' dürfen nicht in Gebrauch sein: {{code|Apache, MySQL}} sowie die mit {{code|EBKuS}} beginnenden Namen für die Instanzen.<br />
* Keine Reste in der Registry von früheren Installationsversuchen :-)<br />
<br />
=== Python installieren ===<br />
<br />
Zuerst Python<br />
* {{code|python-2.7.18.msi}}<br />
und dann PyWin und MySQL-python<br />
* {{code|pywin32-228.win32-py2.7.exe}}<br />
* {{code|MySQL-python-1.2.3.win32-py2.7.exe}}<br />
installieren. Standardinstallation für alle Benutzer. Zur Kontrolle kann man {{pfad4|Start|Programme|Python 2.7|Python (command line)}} aufrufen und dort folgende Eingaben machen:<br />
>>> import win32service<br />
>>><br />
>>> import MySQLdb<br />
>>><br />
Beide Importe müssen ohne Fehlermeldungen funktionieren.<br />
<br />
=== Nur Erstkonfiguration erzeugen ===<br />
<br />
Die Beispiele gehen davon aus, dass die heruntergeladene EBKuS-Software im Verzeichnis {{file|C:\EBKuS-4.4.1}} liegt.<br />
<br />
Wenn man die Option {{code|-c}} bzw. {{code|--config}} des {{code|install-py}}-Skripts verwendet, wird lediglich die Konfigurationsdatei {{file|c:\ebkus_installation\ebkus\ebkus.conf}} erzeugt und nichts weiter installiert. <br />
C:\>cd EBKuS-4.4.1<br />
C:\EBKuS-4.4.1>install.py -c c:\ebkus_installation<br />
Die so entstandene {{file|c:\ebkus_installation\ebkus\ebkus.conf}} kann nun weiter bearbeitet und in der eigentlichen Installation verwendet werden.<br />
<br />
=== Vollautomatische Testinstallation ===<br />
<br />
Falls die oben genannten Voraussetzungen erfüllt sind (insbesondere freie Standardports 80 und 443), kann man eine vollautomatische Erstinstallation vornehmen (Eingabeaufforderung mit Administratorrechten ausführen!):<br />
C:\>cd EBKuS-4.4.1<br />
C:\EBKuS-4.4.1>install.py c:\ebkus_installation<br />
Den Fortgang der Installation sieht man auf der Konsole und in der Datei {{file|c:\ebkus_installation\install.log}}.<br />
<br />
Wenn alles gut gegangen ist, erhält man eine funktionierende EBKuS-Installation mit zwei Instanzen, {{code|demo}} und {{code|muster_efb}}. Es gibt dann 4 neue Windows-Dienste: Apache, MySQL, EBKuS-demo und EBKuS-muster_efb. Den Zugriff auf die Instanzen erhält man über die URL {{code|<nowiki>https://localhost/ebkus/demo/</nowiki>}} bzw. {{code|.../muster_efb/}}.<br />
<br />
Die dabei entstandene Datei {{file|c:\ebkus_installation\ebkus\ebkus.conf}} sollte man sichern, da sie den Ausgangspunkt für die endgültige Installation darstellt.<br />
<br />
Die Testinstallation kann dann ganz oder teilweise wieder deinstalliert werden:<br />
C:\EBKuS-4.4.1>uninstall.py --all c:\ebkus_installation<br />
bzw.<br />
C:\EBKuS-4.4.1>uninstall.py c:\ebkus_installation ebkus<br />
Im ersten Fall wird auch der Webserver und die Datenbank deinstalliert, im zweiten nur die eigentliche EBKuS-Installation mitsamt allen Instanzen.<br />
<br />
=== Installation mit vorhandenem Webserver und Datenbank ===<br />
<br />
Mit<br />
C:\EBKuS-4.4.1>install.py --no_mysql --no_apache c:\ebkus_installation<br />
kann man eine Installation durchführen, wenn Apache und MySQL bereits vorhanden sind und nicht durch die EBKuS-Installation bereitgestellt werden sollen. Das Vorgehen ist dann ähnlich der [[Linux_Installation]]. Es muss manuell dafür gesorgt werden, dass die generierte Datei {{file|ebkus_httpd.conf}} in die Apachekonfiguration eingebunden wird, z.B. durch die Zeile <br />
Include c:\ebkus_installation\ebkus\ebkus_httpd.conf<br />
am Ende der Apache {{file|httpd.conf}}. Außerdem muss man nach der Installation und der Umkonfigurierung den Webserver manuell neu starten, damit er die neue Konfiguration übernimmt.<br />
<br />
=== Anpassen der Konfiguration ===<br />
<br />
In der Konfigurationsdatei {{file|ebkus.conf}} gibt es die Systemabschnitte {{code|DEFAULT, ebkus, apache}} und {{code|openssl}} sowie je einen Abschnitt für jede zu installierende Instanz.<br />
<br />
Dokumentation aller Konfigurationsvariablen siehe [[Konfiguration]].<br />
<br />
==== Systemabschnitte ====<br />
<br />
Im Abschnitt {{code|apache}} muss für die Variable {{konfig|server_name}} der Name angegeben werden, unter dem der Rechner im Netz ansprechbar ist (FQDN), ersatzweise die IP-Adresse. Der Name bzw. die IP-Adresse ist Bestandteil der URL, unter der EBKuS angesprochen wird. Der Standardwert ist hier {{code|localhost}}, womit EBKuS nur auf dem lokalen Rechner erreichbar wäre.<br />
<br />
Falls die Standardports 80 und 443 nicht für EBKuS zur Verfügung stehen, müssen hier alternative freie Ports eingetragen werden. {{konfig|server_http_port}} dient nur zur Kontrolle des Apache Webservers ({{code|<nowiki>http://localhost/</nowiki>}} liefert "It works!"). Falls eine Alternative für {{konfig|server_https_port}} eingetragen wird, muss der Port in der URL aufgeführt werden, um die Anwendung anzusprechen.<br />
<br />
Des weiteren kann die Email-Adresse des Systemadministrators bei {{konfig| server_admin}} eingetragen werden (die evt. auf Fehlerseiten des Servers erscheint). Im Abschnitt {{code|openssl}} sollten die regionalen und organisatorischen Angaben angepasst werden, da sie auf dem erzeugten Zertifikat erscheinen (das man sich z.B. im Browser ansehen kann).<br />
<br />
Sie können ein Passwort setzen für die Datenbankuser {{code|root}} (der Instanzdatenbanken löschen und erstellen kann):<br />
C:\>cd ebkus_installation\mysql5.1\bin<br />
C:\ebkus_installation\mysql5.1\bin>mysqladmin.exe -uroot password ''Neues Passwort''<br />
Dies muss dem Konfigurationsparameter {{konfig|database_admin_password}} zugewiesen werden.<br />
<br />
Alle anderen Werte in den Systemabschnitten sollten nur in Ausnahmefällen verändert werden.<br />
<br />
==== Instanzen ====<br />
<br />
Der Name des Abschnitts muss identisch sein mit dem Wert der Variablen {{konfig|instance_name}}. Der Name muss mit einem Buchstaben beginnen und darf neben Ziffern und Buchstaben nur das Sonderzeichen '_' enthalten.<br />
<br />
Mit der Variablen {{konfig|initial_content}} kann man einer Instanz eine Datei mit einem Datenbankdump (Sicherungsdatei) zuweisen, mit dem die Instanz initialisiert wird:<br />
initial_content: C:\backup\demo_braunschweig_backup_v4.4.1_2011-06-17_02-10-00.zip<br />
bzw.<br />
initial_content: demo_braunschweig_backup_v4.4.1_2011-06-17_02-10-00.zip<br />
Wenn nur der Dateiname angegeben ist, muss die Datei im Homeverzeichnis liegen ({{file|c:\ebkus_installation\ebkus\}}).<br />
Damit ist es möglich, eine Instanz aus einer bestehenden Installation in eine Neuinstallation zu migrieren (siehe unten). <br />
<br />
Jede Instanz benötigt einen eigenen freien Port (Variable {{konfig|port}}).<br />
<br />
=== Installation ohne Internetzugang ===<br />
<br />
Wenn alle [http://www.ebkus.org/alle_downloads.html benötigte Software für Windows 32 bit] in das Verzeichnis {{file|c:\ebkus_installation\download}} kopiert werden, wird kein Internetzugang benötigt. <br />
<br />
Alternativ kann beim ersten Aufruf von {{code|install.py}} ein Downloadverzeichnis angegeben werden, in dem sich die Installationsdateien befinden müssen:<br />
C:\EBKuS-4.5>install.py -d c:\ebkus_download c:\ebkus_installation<br />
Wenn bereits eine {{file|ebkus.conf}} existiert, wird das in der Variable {{konfig|download_dir}} definierte Verzeichnis verwendet und die Option {{code|-d}} kann entfallen.<br />
<br />
=== Migration ===<br />
<br />
Die Migration beinhaltet die Übernahme der Instanzen aus einer bestehenden EBKuS-Installation in eine Neuinstallation mit der neuen Software. Die EBKuS-Version der bestehenden Installation muss mindestens 4.2 sein; ältere müssen erst im Rahmen der bestehenden Installation updatet werden.<br />
<br />
==== Vorbereitung ====<br />
<br />
Für die Migration muss eine für die Neuinstallation gültige {{file|ebkus.conf}} bereitgestellt werden sowie eine Sicherungsdatei für jede zu migrierende Instanz. Die Sicherungsdatei wird in der alten Installation mit dem Skript {{code|datenbank_sichern.py --zip ''Verzeichnis''}} erzeugt.<br />
Die Zuordnung wird wie oben beschrieben für jede Instanz über die Konfigurationsvariable {{konfig|initial_content}} vorgenommen (nur Dateiname, ohne Pfadangabe). Ansonsten werden die Konfigurationen der Instanzen aus der alten {{file|ebkus.conf}} übernommen. Die Systemabschnitte für die neue {{file|ebkus.conf}} werden wie oben beschrieben aus der Testinstallation bzw. der Erstkonfiguration übernommen.<br />
<br />
==== Neuinstallation ====<br />
<br />
Die neu erstellte {{file|ebkus.conf}} wird zusammen mit den Sicherungsdateien in ein Verzeichnis kopiert, z.B. {{file|c:\ebkus_preconfig}}.<br />
<br />
Dem {{code|install.py}}-Skript wird das Verzeichnis mit der Option {{code|-p}} übergeben:<br />
C:\EBKuS-4.5>install.py -p c:\ebkus_preconfig c:\ebkus_installation<br />
Vor der Installation wird dann der Inhalt dieses Verzeichnisses in das Homeverzeichnis kopiert, so dass die Installation durch die neue {{file|ebkus.conf}} gesteuert wird. <br />
<br />
=== Einzelne Instanzen ===<br />
<br />
==== Entfernen ====<br />
<br />
Mit Hilfe des {{code|uninstall.py}}-Skripts lassen sich auch einzelne Instanzen entfernen.<br />
C:\EBKuS-4.5>uninstall.py c:\ebkus_installation ''Instanzname''<br />
Das {{code|uninstall.py}}-Skript kann auch aus dem Homeverzeichnis aufgerufen werden.<br />
<br />
Wichtig: Den Konfigurationsabschnitt der Instanz in der {{file|ebkus.conf}} erst nach der erfolgreichen Deinstallation entfernen! Sonst ist Handarbeit angesagt.<br />
<br />
==== Hinzufügen ====<br />
<br />
Als erstes muss in der {{file|ebkus.conf}} ein Abschnitt für die neu zu erstellende Instanz erstellt werden, evt. mit Angabe einer Sicherungsdatei oder eines SQL-Dumps für die Initialisierung der Datenbank der Instanz (Variable {{konfig|initial_content}}). <br />
<br />
Die Instanz kann dann mit<br />
C:\>cd ebkus_installation\ebkus<br />
C:\ebkus_installation\ebkus>configure.py ''Instanzname''<br />
eingerichtet werden. <br />
<br />
Wenn keine Datei zur Initialisierung angegeben wird, wird eine Datenbank mit den Standardmerkmalskatalogen und einem evt. konfigurierten Straßenkatalog erstellt. Wenn der Instanzname mit {{code|demo}} beginnt, werden zusätzlich Demodaten generiert.<br />
<br />
=== Mögliche Probleme ===<br />
<br />
* Windows-Dienste werden nicht automatisch installiert: die Konsole muss als Administrator ausgeführt werden.<br />
* Nicht vollständig deinstallierte Dienste: notfalls mit {{code|sc delete ''Name''}} entfernen. Wenn der Name dann trotzdem noch in der Liste der Dienste auftaucht mit dem Zustand {{code|Deaktiviert}}, muss ein Neustart gemacht werden.<br />
* Übrig gebliebene Reste in der Registry von früheren Installationen, z.B. des MySQL-Servers. Diese müssen notfalls manuell beseitigt werden.<br />
* Instanz lässt sich nicht mit Sicherungsdatei initialisieren: Die Sicherungsdatei muss von einer Instanz mit demselben Namen stammen.<br />
* Automatischer Download klappt nicht: Falls der Internetzugang über einen Proxy erfolgt, muss man möglicherweise (ich habs nicht probiert) manuell herunterladen und die Dateien im Downloadverzeichnis ablegen.<br />
* Firefox akzeptiert das von EBKuS gelieferte Zertifikat (wg. doppelter Seriennummer oder so ähnlich): Zertifikate in Firefox löschen über {{pfad5|Einstellungen|Erweitert|Zertifikate|Zertifikate anzeigen|Löschen}}. Die EBKuS-Zertifikate stehen unter dem Namen EFB bzw. unter dem Namen, der in der {{file|ebkus.conf}} als {{konfig|organisation}} (im Abschnitt {{konfig|openssl}}) eingetragen wurde.<br />
<br />
=== Tipps ===<br />
<br />
* Das {{code|install.py}}-Skript lässt sich wiederholt ausführen. Eine bestehende MySQL- und Apache-Installation wird nicht wiederholt. Vorhandene Instanzdatenbanken bleiben ebenfalls intakt. Evt. neu hinzugekommenen Instanzkonfigurationen werden ausgeführt, d.h. die neue Instanz wird eingerichtet. (Löschen einer Instanz jedoch immer mit {{code|uninstall.py}}!) Alle zu generierenden Dateien werden neu generiert, so dass z.B. auf diese Weise Port-Änderungen oder die Änderung des Servernamens durchgeführt werden können.<br />
* Wenn das {{code|install.py}}-Skript mit der Option {{code|-u}} bzw. {{code|--update}} wiederholt wird, werden zusätzlich alle EBKuS-Dateien aus der Distribution in das Homeverzeichnis kopiert. <br />
* Hilfe für alle Skripte erhält man mit der Option {{code|--help}} oder kurz {{code|-h}}:<br />
C:\EBKuS-4.5>install.py --help<br />
C:\EBKuS-4.5>uninstall.py -h<br />
C:\ebkus_installation\ebkus>configure.py -h<br />
C:\ebkus_installation\ebkus\demo>dienst.py -h<br />
* Falls Änderungen an generierten Dateien nötig sind (z.B. Apache- oder MySQL-Konfiguration) ist es wenig sinnvoll, diese selbst zu verändern, da man dann nicht mehr die Möglichkeit hat, die Installationsskripte zu verwenden. Besser ist is es, die Templates selber anzupassen. Alle Templates (Vorlagen) für generierte Dateien finden sich im Verzeichnis {{file|templates}} im Homeverzeichnis.</div>Ebkushttps://www.ebkus.org/wiki/Linux_InstallationLinux Installation2020-08-18T11:11:33Z<p>Ebkus: </p>
<hr />
<div>Gültig ab: EBKuS 4.4.1<br />
<br />
Die folgende Anleitung habe ich mit '''Ubuntu 10.04.2 LTS''' getestet; vermutlich funktioniert das auch auf anderen Ubuntu bzw. Debian-basierten Gnu/Linux-Distributionen.<br />
<br />
Die Installation im folgenden Beispiel erfolgt unter dem User {{code|ebkus}} auf einem Rechner mit dem Namen {{code|ebvm}}. Der User {{code|ebkus}} benötigt Superuserrechte ({{code|sudo}}). Es wird angenommen, dass eine Internetverbindung besteht (zur Installation von Software mit {{code|apt-get}}).<br />
<br />
Die Installation erfolgt ausschließlich über die Kommandozeile. Damit funktioniert sie auch auf reinen Servern, die keine GUI haben.<br />
<br />
Bitte auch die [[Windows Installation]] beachten, da sind einige betriebssystemunabhängige Punkte ausführlicher dargestellt als hier.<br />
<br />
=== Voraussetzungen ===<br />
<br />
Folgende Voraussetzungen müssen erfüllt sein, damit EBKuS installiert werden kann:<br />
<br />
==== Python ====<br />
<br />
Ist auf solche Systemen normalerweise bereits installiert, ansonsten:<br />
ebkus@ebvm:~$ sudo apt-get install python2.6<br />
Es kann auch Python 2.7 sein, wenn das in der Distribution angeboten wird, jedoch '''nicht''' Python 3.0 oder höher.<br />
<br />
==== MySQL ====<br />
<br />
Bei Ubuntu 10.04 LTS wird MySQL 5.1.XX installiert. Mit der nächsthöheren MySQL-Version 5.5 ist EBKuS noch nicht getestet!<br />
<br />
Die Datenbank installieren mit:<br />
ebkus@ebvm:~$ sudo apt-get install mysql-server mysql-common mysql-client<br />
Bei der Installation muss ein Passwort für den Datenbank-User {{code|root}} angegeben werden, das später in die {{file|ebkus.conf}} eingetragen werden muss. Nach einer erfolgreichen Installation kann man sich mit dem Befehl<br />
ebkus@ebvm:~$ mysql -uroot -p''Passwort''<br />
Welcome to the MySQL monitor. Commands end with ; or \g.<br />
...<br />
mysql><br />
mit der Datenbank verbinden.<br />
<br />
Falls der Standardport 3306 für MySQL nicht zur Verfügung steht, muss die Datei {{file|/etc/mysql/my.cnf}} angepasst werden.<br />
<br />
==== Python-MySQLdb ====<br />
<br />
Den Datenbankadapter für Python-MySQL installieren:<br />
ebkus@ebvm:~$ sudo apt-get install python-mysqldb<br />
Nach erfolgreicher Installation kann man Python aufrufen und MySQLdb importieren:<br />
ebkus@ebvm:~$ python<br />
Python 2.6.5 (r265:79063, Apr 16 2010, 13:09:56)<br />
...<br />
>>> import MySQLdb<br />
>>><br />
<br />
==== Apache 2 ====<br />
<br />
Den Webserver installieren:<br />
ebkus@ebvm:~$ sudo apt-get install apache2<br />
Nach der erfolgreichen Installation erhält man mit einem Browser mit der Adresse <nowiki>http://localhost/</nowiki> eine Seite mit '''It works!'''. Oder man installiert z.B. {{code|wget}} und erhält mit der genannten Adresse die entsprechende HTML-Datei {{file|index.html}}:<br />
ebkus@ebvm:~$ sudo apt-get install wget<br />
ebkus@ebvm:~$ wget <nowiki>http://localhost/</nowiki><br />
<br />
Falls der Webserver nicht auf den Standardports 80 und 443 laufen soll, muss die Datei {{file|/etc/apache2/ports.conf}} angepasst werden, ebenso die {{file|ebkus.conf}} (siehe [[Konfiguration]])<br />
<br />
Um den Webserver zu konfigurieren, müssen das ssl-Modul und das<br />
cgi-Modul aktiviert werden:<br />
ebkus@ebvm:~$ sudo a2enmod ssl<br />
ebkus@ebvm:~$ sudo a2enmod cgi<br />
<br />
Außerdem muss die von EBKuS generierte Apache-Konfigurationsdatei eingebunden werden:<br />
ebkus@ebvm:~$ cd /etc/apache2/sites-enabled<br />
ebkus@ebvm:/etc/apache2/sites-enabled$ sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl.conf<br />
Die Datei {{file|ebkus_httpd.conf}} existiert zu diesem Zeitpunkt noch nicht, sie wird bei der Installation ({{file|install.py}}) und bei jeder Änderung von Instanzen ({{file|configure.py}}) neu generiert. Sie definiert einen Virtual Host für den Webserver, über den alle EBKuS-Instanzen angesprochen werden.<br />
<br />
'''Dateirechte:''' Alle Verzeichnisse, die in einem Pfad zu einer Datei stehen, die vom Webserver gelesen werden soll, müssen das Leserecht und das Ausführungsrecht besitzen. Wenn das Installationsverzeichnis wie im Beispiel im Homeverzeichnis eines Benutzers steht, müssen diese Rechte evt. explizit vergeben werden:<br />
ebkus@ebvm:~$ sudo chmod go+rx /home/ebkus <br />
Den vom Installationsskript erzeugten Verzeichnissen und Dateien werden diese Rechte automatisch gegeben.<br />
<br />
<br />
==== Reportlab ====<br />
<br />
Falls keine Internetverbindung besteht, muss [http://www.efb-berlin.de/ebkus/ebkus-3.3/linux/ReportLab_1_19.zip diese] Datei bei der Installation im Downloadverzeichnis stehen, ansonsten wird sie bei der Installation automatisch heruntergeladen.<br />
<br />
==== EBKuS ====<br />
<br />
Die neueste [http://www.ebkus.org/alle_downloads.html EBKuS-Software] herunterladen (zusammen mit evt. vorhandenen<br />
Patches!), auspacken und in das Distributionsverzeichnis gehen, z.B.:<br />
ebkus@ebkusvm1:~$ wget http://www.efb-berlin.de/ebkus/ebkus-4.5/ebkus-4.5-src.zip<br />
ebkus@ebkusvm1:~$ unzip ebkus-4.5-src.zip<br />
ebkus@ebkusvm1:~$ cd EBKuS-4.5<br />
ebkus@ebkusvm1:~/EBKuS-4.5$<br />
<br />
=== Installation ===<br />
<br />
==== Erstkonfiguration ====<br />
<br />
Erstkonfiguration erzeugen:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ ./install.py -c ~/ebkus_installation<br />
Die EBKuS-Konfigurationsdatei {{file|/home/ebkus/ebkus_installation/ebkus/ebkus.conf}} kann nun weiter bearbeitet und für die eigentliche Installation verwendet werden.<br />
<br />
==== Systemkonfiguration ====<br />
<br />
System-[[Konfiguration]] anpassen, insbesondere:<br />
* Passwort für Datenbank-User {{code|root}} eintragen (Parameter {{konfig|database_admin_password}})<br />
* {{konfig|server_name}}, entweder IP-Nummer oder Name (FQDN)<br />
* Evt. Standardports {{konfig|server_https_port}} und {{konfig|server_http_port}} anpassen<br />
* {{konfig| server_admin}}<br />
* Im Abschnitt {{code|openssl}} Angaben zur Region und Organisation<br />
<br />
==== Instanzkonfiguration ====<br />
<br />
Instanz-[[Konfiguration]] anpassen:<br />
* {{konfig|instance_name}}, optional {{konfig|instance_title}}<br />
* {{konfig|initial_content}}, falls eine initiale Datenbank vorhanden ist (z.B. aus einer früheren Installation)<br />
* {{konfig|port}}<br />
<br />
==== Installation ====<br />
<br />
Installation:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ ./install.py ~/ebkus_installation<br />
Bei der Installation wird man unter Umständen nach dem Passwort des (Linux-)Users gefragt, dasselbe, das man bei einem vorangestellten {{code|sudo}} angeben muss. Damit können die start/stop-Skripte in die Bootsequenz ({{file|/etc/init.d/}}) eingetragen werden<br />
<br />
Nach der Installation (und auch nach jeder Umkonfigurierung mit {{file|configure.py}}) muss der Webserver neu gestartet werden:<br />
ebkus@ebvm:~$ sudo service apache2 restart<br />
* Restarting web server apache2 [ OK ]<br />
Ansonsten wird die neu generierte Webserver-Konfiguration in {{file|ebkus_httpd.conf}} nicht wirksam.<br />
<br />
==== Migration ====<br />
<br />
Falls wie [[Windows_Installation#Migration|hier]] beschrieben eine Menge von bestehenden Instanzen in die neue Installation übernommen werden soll:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ ./install.py -p ~/ebkus_preconfig ~/ebkus_installation<br />
Im Verzeichnis {{file|~/ebkus_preconfig}} muss dann eine gültige {{file|ebkus.conf}} liegen sowie eine Sicherungsdatei für jede Instanz, die in der Konfiguration über den Parameter {{konfig|initial_content}} eingebunden wird.<br />
<br />
=== Dienste ===<br />
<br />
Im Unterschied zur [[Windows Installation|Windows]] werden bei der Installation und der Konfigurierung keine Dienste gestartet oder gestoppt. Es werden jedoch Skripte in {{file|/etc/init.d}} generiert, mit denen die EBKuS-Server hoch und runtergefahren werden. Beim booten des Systems geschieht dies automatisch, d.h. nach einem Reboot steht EBKuS automatisch zur Verfügung.<br />
<br />
Für den Systemadministrator gibt es folgende Skripte, die nach der Installation im Homeverzeichnis stehen:<br />
* {{code|ebkusctl}}: Damit kann jede Instanz einzeln oder auch alle Instanzen gemeinsam hoch- und runtergefahren werden sowie deren Status abgefragt werden. Dieses Skript verwendet intern die generierten Skripte in {{file|/etc/init.d}}.<br />
* {{code|ebkusdump}}: Für jede Instanz einzeln oder für alle zusammen eine Sicherungsdatei erzeugen (verwendet intern {{file|datenbank_sichern.py||}}).<br />
* {{code|ebkusrestore}}: Für jede Instanz einzeln oder für alle zusammen die Datenbank aus eine Sicherungsdatei initialisieren (verwendet intern {{file| datenbank_initialisieren.py||}}).<br />
Z.B.<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl all start<br />
* Starting EBKuS demo [ OK ] <br />
* Starting EBKuS muster_efb [ OK ] <br />
* Starting EBKuS demo_braunschweig [ OK ] <br />
Jedes Skript hat eingebaute Hilfe:<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl --help<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl -h<br />
<br />
<br />
<br />
<br />
<br />
<!--<br />
<br />
Schritte:<br />
<br />
#`Installationsverzeichnis`_ einrichten, z.B. {{code|/home/user/ebinst}}:<br />
mkdir /home/user/ebinst<br />
#In das `Distributionsverzeichnis`_ gehen (z.B. {{code|/home/user/ebkus-cd/ebkus-3.3}}; man könnte hier auch direkt von der CD arbeiten):<br />
cd /home/user/ebkus-cd/ebkus-3.3<br />
#EBKuS-Konfiguration erzeugen:<br />
python install.py --config /home/user/ebinst<br />
#Erzeugte Konfigurationsdatei {{code|/home/user/ebinst/ebkus/ebkus.conf}}anpassen (siehe `Konfiguration`_).<br />
#EBKuS und alle in der Konfigurationsdatei definierten Instanzen installieren und konfigurieren:<br />
python install.py /home/user/ebinst<br />
Für jede in der Konfiguration definierten Instanz gibt es dann ein `Instanzverzeichnis`_:<br />
<br />
<blockquote>{{code|/home/user/ebinst/ebkus/}}''Instanzname''<br />
<br />
</blockquote><br />
Die Meldungen des Installationsskriptes stehen auch in der Datei {{code|/home/user/ebinst/install.log}}.<br />
<br />
#(als {{code|root}}) Die in Schritt 5. erzeugte Datei {{code|/home/user/ebinst/ebkus/ebkus_httpd.conf}} in die Apache-Konfigurationsdatei (bei SuSE z.B. /etc/httpd/httpd.conf) inkludieren, z.B. indem Sie dort am Ende die folgende Zeile eintragen:<br />
Include /home/user/ebinst/ebkus/ebkus_httpd.conf<br />
#(als {{code|root}}) Den Apache-Webserver neustarten, damit die modifizierte Konfiguration berücksichtigt wird, z.B. bei SuSE:<br />
rcapache restart<br />
#Eine konfigurierte EBKuS-Instanz testen, z.B. die Instanz demo:<br />
cd /home/user/ebinst/ebkus/demo <br />
./start.py --console<br />
Der gestartete Server gibt Meldungen auf die Konsole aus.<br />
<br />
#Über einen Browser mit der Instanz {{code|demo}} arbeiten (anstatt {{code|demo}} auch mit jeder anderen in der `Konfiguration`_definierten Instanz):<br />
https://localhost/ebkus/demo/cgi/do/login<br />
Die Login-Maske kann auch über eine vorgeschaltete Eingangsseite erreicht werden, die für jede Instanz generiert wird:<br />
<br />
https://localhost/ebkus/demo/index.html<br />
Diese Seite kann mit einem HTML-Editor gemäß den lokalen Bedürfnissen erweitert oder verändert werden. Die zu editierende Datei ist im `Instanzverzeichnis`_ unter {{code|htdocs/index.html}} zu finden.<br />
<br />
Als Administrator anmelden: Benutzer {{code|Admin}}, Passwort {{code|Admin}}. Als angemeldeter Administrator können Sie weitere Benutzer anlegen.<br />
<br />
Die Instanzen {{code|demo}} bzw. {{code|demo_berlin}} enthalten bereits Beispieldaten, mit denen Sie experimentieren können. Sie können sich also gleich als Bearbeiter bzw. als Verwaltungskraft anmelden, z.B. Benutzer {{code|test}}, Passwort {{code|test}} bzw. Benutzer {{code|verw}}, Passwort {{code|verw}}.<br />
<br />
Falls Sie in der Konfiguration den Parameter ''server_name'' mit einer in Ihrem Netzwerk gültigen IP-Adresse oder einem gültigen Namen belegt haben, können Sie auch von anderen Rechnern im Netzwerk auf eine EBKuS-Instanz zugreifen, z.B.:<br />
<br />
https://192.168.1.92/ebkus/demo/index.html https://192.168.1.92/ebkus/demo/cgi/do/login<br />
#(als {{code|root}}) Die Instanz in die Bootsequenz des Servers aufnehmen, so dass beim Hochfahren des Rechners der EBKuS-Server für die Instanz automatisch gestartet wird:<br />
cd /home/user/ebinst/ebkus/demo cp ebkus_demo /etc/init.d<br />
Die Links für die Run-Level manuell setzen oder, z.B. bei SuSE, den Run-Level-Editor verwenden.<br />
<br />
#In einer Produktionsinstanz die Anwendung einrichten, siehe Einrichtung der Anwendung im Handbuch.<br />
<br />
<br />
<br />
<br />
- Apache richtig löschen, so dass frische Konfig kommt:<br />
<br />
- sudo dpkg --purge --force-remove-reinstreq apache2.2-common<br />
<br />
So geht richtiges uninstall mit Konfiguration:<br />
apt-get remove ––purge *paketname*<br />
<br />
<br />
<br />
- download mit wget auf dem ubuntu server<br />
<br />
<br />
<br />
== Apache Konfiguration ==<br />
<br />
cd /etc/apache2/mods-enabled<br />
sudo ln -s ../mods-available/ssl.conf ssl.conf<br />
sudo ln -s ../mods-available/ssl.load ssl.load<br />
<br />
cd /etc/apache2/sites-enabled<br />
sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl<br />
http://ebkus.org/wiki/Linux_Installation#MySQL<br />
http://ebkus.org/wiki/Linux_Installation#Apache_2<br />
<br />
--></div>Ebkushttps://www.ebkus.org/wiki/Windows_InstallationWindows Installation2019-01-31T20:51:26Z<p>Ebkus: </p>
<hr />
<div>Gültig ab: EBKuS 4.4.1<br />
<br />
Die Software, mit der frühere Versionen von EBKuS auf Windows<br />
automatisch installiert wurden, ist inzwischen in die Jahre<br />
gekommen. Ab Version 4.4.1 ist nun auch eine automatische<br />
Installation mit neuerer Software möglich. Dazu ist eine komplette<br />
Neuinstallation erforderlich. Der parallele Betrieb von alter und<br />
neuer Software ist nicht möglich.<br />
<br />
=== Benötigte Software ===<br />
<br />
* [https://www.python.org/downloads/release/python-2712/ Python 2.7.12]<br />
* [http://www.codegood.com/downloads MySQL-python-1.2.3]<br />
* [http://sourceforge.net/projects/pywin32/files/pywin32/Build220/ pywin32-220]<br />
* [http://download.softagency.net/MySQL/Downloads/MySQL-5.1/ MySQL 5.1.73]<br />
* [https://archive.apache.org/dist/httpd/binaries/win32/ Apache 2.2]<br />
* [http://www.reportlab.com/ftp/ Reportlab 1.19]<br />
<br />
Alle benötigten Dateien befinden sich auch auf dem [http://www.ebkus.org/alle_downloads.html EBKuS FTP-Server]. <br />
Nur die ersten drei müssen manuell heruntergeladen<br />
und installiert werden. Die übrigen werden bei Bedarf automatisch<br />
heruntergeladen (sofern eine Internetverbindung besteht, ansonsten siehe unten).<br />
<br />
[http://www.ebkus.org/alle_downloads.html Dort] findet sich auch die Software für 64 bit, die ebenfalls funktioniert, aber manuell installiert werden muss, da sie nicht von den Installationsskripten unterstützt wird.<br />
<br />
Natürlich muss noch die neueste <br />
[http://www.ebkus.org/alle_downloads.html EBKuS-Software]<br />
selbst heruntergeladen werden. <br />
<br />
=== Sonstige Voraussetzungen ===<br />
<br />
* '''Betriebssystem''': Erfolgreich getestet auf Windows 2000 Professional, Windows XP Professional, Windows 7 Professional und Windows Server 2008.<br />
* Die von einer EBKuS-Installation verwendeten '''Ports''' dürfen nicht anderweitig verwendete werden:<br />
** Port 443 für den Apache-Webserver mit SSL-Verschlüsselung (kann mit der Konfigurationsvariablen {{konfig|server_https_port}} verändert werden)<br />
** Port 80 für den Apache-Webserver ohne SSL-Verschlüsselung (kann mit der Konfigurationsvariablen {{konfig|server_http_port}} verändert werden). Dieser Port wird allerdings von der Anwendung nicht benötigt; man kann damit aber überprüfen, ob der Webserver installiert ist unabhängig von EBKuS-Instanzen.<br />
** Port 3306 für den MySQL-Datenbankserver <br />
** Die in der {{file|ebkus.conf||}} explizit genannten Ports für die EBKuS-Instanzen<br />
* '''Administratorrechte''' für die Installation. Insbesondere muss bei neueren Windows-Systemen die Kommandozeile explizit mit Administratorrechten aufgerufen werden (rechtsklicken, mit Administratorrechten ausführen). Sonst gelingt die Einrichtung der Dienste nicht.<br />
* Die von EBKuS verwendeten '''Namen für Dienste''' dürfen nicht in Gebrauch sein: {{code|Apache, MySQL}} sowie die mit {{code|EBKuS}} beginnenden Namen für die Instanzen.<br />
* Keine Reste in der Registry von früheren Installationsversuchen :-)<br />
<br />
=== Python installieren ===<br />
<br />
Zuerst Python<br />
* {{code|python-2.7.12.msi}}<br />
und dann PyWin und MySQL-python<br />
* {{code|pywin32-220.win32-py2.7.exe}}<br />
* {{code|MySQL-python-1.2.3.win32-py2.7.exe}}<br />
installieren. Standardinstallation für alle Benutzer. Zur Kontrolle kann man {{pfad4|Start|Programme|Python 2.7|Python (command line)}} aufrufen und dort folgende Eingaben machen:<br />
>>> import win32service<br />
>>><br />
>>> import MySQLdb<br />
>>><br />
Beide Importe müssen ohne Fehlermeldungen funktionieren.<br />
<br />
=== Nur Erstkonfiguration erzeugen ===<br />
<br />
Die Beispiele gehen davon aus, dass die heruntergeladene EBKuS-Software im Verzeichnis {{file|C:\EBKuS-4.4.1}} liegt.<br />
<br />
Wenn man die Option {{code|-c}} bzw. {{code|--config}} des {{code|install-py}}-Skripts verwendet, wird lediglich die Konfigurationsdatei {{file|c:\ebkus_installation\ebkus\ebkus.conf}} erzeugt und nichts weiter installiert. <br />
C:\>cd EBKuS-4.4.1<br />
C:\EBKuS-4.4.1>install.py -c c:\ebkus_installation<br />
Die so entstandene {{file|c:\ebkus_installation\ebkus\ebkus.conf}} kann nun weiter bearbeitet und in der eigentlichen Installation verwendet werden.<br />
<br />
=== Vollautomatische Testinstallation ===<br />
<br />
Falls die oben genannten Voraussetzungen erfüllt sind (insbesondere freie Standardports 80 und 443), kann man eine vollautomatische Erstinstallation vornehmen (Eingabeaufforderung mit Administratorrechten ausführen!):<br />
C:\>cd EBKuS-4.4.1<br />
C:\EBKuS-4.4.1>install.py c:\ebkus_installation<br />
Den Fortgang der Installation sieht man auf der Konsole und in der Datei {{file|c:\ebkus_installation\install.log}}.<br />
<br />
Wenn alles gut gegangen ist, erhält man eine funktionierende EBKuS-Installation mit zwei Instanzen, {{code|demo}} und {{code|muster_efb}}. Es gibt dann 4 neue Windows-Dienste: Apache, MySQL, EBKuS-demo und EBKuS-muster_efb. Den Zugriff auf die Instanzen erhält man über die URL {{code|<nowiki>https://localhost/ebkus/demo/</nowiki>}} bzw. {{code|.../muster_efb/}}.<br />
<br />
Die dabei entstandene Datei {{file|c:\ebkus_installation\ebkus\ebkus.conf}} sollte man sichern, da sie den Ausgangspunkt für die endgültige Installation darstellt.<br />
<br />
Die Testinstallation kann dann ganz oder teilweise wieder deinstalliert werden:<br />
C:\EBKuS-4.4.1>uninstall.py --all c:\ebkus_installation<br />
bzw.<br />
C:\EBKuS-4.4.1>uninstall.py c:\ebkus_installation ebkus<br />
Im ersten Fall wird auch der Webserver und die Datenbank deinstalliert, im zweiten nur die eigentliche EBKuS-Installation mitsamt allen Instanzen.<br />
<br />
=== Installation mit vorhandenem Webserver und Datenbank ===<br />
<br />
Mit<br />
C:\EBKuS-4.4.1>install.py --no_mysql --no_apache c:\ebkus_installation<br />
kann man eine Installation durchführen, wenn Apache und MySQL bereits vorhanden sind und nicht durch die EBKuS-Installation bereitgestellt werden sollen. Das Vorgehen ist dann ähnlich der [[Linux_Installation]]. Es muss manuell dafür gesorgt werden, dass die generierte Datei {{file|ebkus_httpd.conf}} in die Apachekonfiguration eingebunden wird, z.B. durch die Zeile <br />
Include c:\ebkus_installation\ebkus\ebkus_httpd.conf<br />
am Ende der Apache {{file|httpd.conf}}. Außerdem muss man nach der Installation und der Umkonfigurierung den Webserver manuell neu starten, damit er die neue Konfiguration übernimmt.<br />
<br />
=== Anpassen der Konfiguration ===<br />
<br />
In der Konfigurationsdatei {{file|ebkus.conf}} gibt es die Systemabschnitte {{code|DEFAULT, ebkus, apache}} und {{code|openssl}} sowie je einen Abschnitt für jede zu installierende Instanz.<br />
<br />
Dokumentation aller Konfigurationsvariablen siehe [[Konfiguration]].<br />
<br />
==== Systemabschnitte ====<br />
<br />
Im Abschnitt {{code|apache}} muss für die Variable {{konfig|server_name}} der Name angegeben werden, unter dem der Rechner im Netz ansprechbar ist (FQDN), ersatzweise die IP-Adresse. Der Name bzw. die IP-Adresse ist Bestandteil der URL, unter der EBKuS angesprochen wird. Der Standardwert ist hier {{code|localhost}}, womit EBKuS nur auf dem lokalen Rechner erreichbar wäre.<br />
<br />
Falls die Standardports 80 und 443 nicht für EBKuS zur Verfügung stehen, müssen hier alternative freie Ports eingetragen werden. {{konfig|server_http_port}} dient nur zur Kontrolle des Apache Webservers ({{code|<nowiki>http://localhost/</nowiki>}} liefert "It works!"). Falls eine Alternative für {{konfig|server_https_port}} eingetragen wird, muss der Port in der URL aufgeführt werden, um die Anwendung anzusprechen.<br />
<br />
Des weiteren kann die Email-Adresse des Systemadministrators bei {{konfig| server_admin}} eingetragen werden (die evt. auf Fehlerseiten des Servers erscheint). Im Abschnitt {{code|openssl}} sollten die regionalen und organisatorischen Angaben angepasst werden, da sie auf dem erzeugten Zertifikat erscheinen (das man sich z.B. im Browser ansehen kann).<br />
<br />
Sie können ein Passwort setzen für die Datenbankuser {{code|root}} (der Instanzdatenbanken löschen und erstellen kann):<br />
C:\>cd ebkus_installation\mysql5.1\bin<br />
C:\ebkus_installation\mysql5.1\bin>mysqladmin.exe -uroot password ''Neues Passwort''<br />
Dies muss dem Konfigurationsparameter {{konfig|database_admin_password}} zugewiesen werden.<br />
<br />
Alle anderen Werte in den Systemabschnitten sollten nur in Ausnahmefällen verändert werden.<br />
<br />
==== Instanzen ====<br />
<br />
Der Name des Abschnitts muss identisch sein mit dem Wert der Variablen {{konfig|instance_name}}. Der Name muss mit einem Buchstaben beginnen und darf neben Ziffern und Buchstaben nur das Sonderzeichen '_' enthalten.<br />
<br />
Mit der Variablen {{konfig|initial_content}} kann man einer Instanz eine Datei mit einem Datenbankdump (Sicherungsdatei) zuweisen, mit dem die Instanz initialisiert wird:<br />
initial_content: C:\backup\demo_braunschweig_backup_v4.4.1_2011-06-17_02-10-00.zip<br />
bzw.<br />
initial_content: demo_braunschweig_backup_v4.4.1_2011-06-17_02-10-00.zip<br />
Wenn nur der Dateiname angegeben ist, muss die Datei im Homeverzeichnis liegen ({{file|c:\ebkus_installation\ebkus\}}).<br />
Damit ist es möglich, eine Instanz aus einer bestehenden Installation in eine Neuinstallation zu migrieren (siehe unten). <br />
<br />
Jede Instanz benötigt einen eigenen freien Port (Variable {{konfig|port}}).<br />
<br />
=== Installation ohne Internetzugang ===<br />
<br />
Wenn alle [http://www.ebkus.org/alle_downloads.html benötigte Software für Windows 32 bit] in das Verzeichnis {{file|c:\ebkus_installation\download}} kopiert werden, wird kein Internetzugang benötigt. <br />
<br />
Alternativ kann beim ersten Aufruf von {{code|install.py}} ein Downloadverzeichnis angegeben werden, in dem sich die Installationsdateien befinden müssen:<br />
C:\EBKuS-4.5>install.py -d c:\ebkus_download c:\ebkus_installation<br />
Wenn bereits eine {{file|ebkus.conf}} existiert, wird das in der Variable {{konfig|download_dir}} definierte Verzeichnis verwendet und die Option {{code|-d}} kann entfallen.<br />
<br />
=== Migration ===<br />
<br />
Die Migration beinhaltet die Übernahme der Instanzen aus einer bestehenden EBKuS-Installation in eine Neuinstallation mit der neuen Software. Die EBKuS-Version der bestehenden Installation muss mindestens 4.2 sein; ältere müssen erst im Rahmen der bestehenden Installation updatet werden.<br />
<br />
==== Vorbereitung ====<br />
<br />
Für die Migration muss eine für die Neuinstallation gültige {{file|ebkus.conf}} bereitgestellt werden sowie eine Sicherungsdatei für jede zu migrierende Instanz. Die Sicherungsdatei wird in der alten Installation mit dem Skript {{code|datenbank_sichern.py --zip ''Verzeichnis''}} erzeugt.<br />
Die Zuordnung wird wie oben beschrieben für jede Instanz über die Konfigurationsvariable {{konfig|initial_content}} vorgenommen (nur Dateiname, ohne Pfadangabe). Ansonsten werden die Konfigurationen der Instanzen aus der alten {{file|ebkus.conf}} übernommen. Die Systemabschnitte für die neue {{file|ebkus.conf}} werden wie oben beschrieben aus der Testinstallation bzw. der Erstkonfiguration übernommen.<br />
<br />
==== Neuinstallation ====<br />
<br />
Die neu erstellte {{file|ebkus.conf}} wird zusammen mit den Sicherungsdateien in ein Verzeichnis kopiert, z.B. {{file|c:\ebkus_preconfig}}.<br />
<br />
Dem {{code|install.py}}-Skript wird das Verzeichnis mit der Option {{code|-p}} übergeben:<br />
C:\EBKuS-4.5>install.py -p c:\ebkus_preconfig c:\ebkus_installation<br />
Vor der Installation wird dann der Inhalt dieses Verzeichnisses in das Homeverzeichnis kopiert, so dass die Installation durch die neue {{file|ebkus.conf}} gesteuert wird. <br />
<br />
=== Einzelne Instanzen ===<br />
<br />
==== Entfernen ====<br />
<br />
Mit Hilfe des {{code|uninstall.py}}-Skripts lassen sich auch einzelne Instanzen entfernen.<br />
C:\EBKuS-4.5>uninstall.py c:\ebkus_installation ''Instanzname''<br />
Das {{code|uninstall.py}}-Skript kann auch aus dem Homeverzeichnis aufgerufen werden.<br />
<br />
Wichtig: Den Konfigurationsabschnitt der Instanz in der {{file|ebkus.conf}} erst nach der erfolgreichen Deinstallation entfernen! Sonst ist Handarbeit angesagt.<br />
<br />
==== Hinzufügen ====<br />
<br />
Als erstes muss in der {{file|ebkus.conf}} ein Abschnitt für die neu zu erstellende Instanz erstellt werden, evt. mit Angabe einer Sicherungsdatei oder eines SQL-Dumps für die Initialisierung der Datenbank der Instanz (Variable {{konfig|initial_content}}). <br />
<br />
Die Instanz kann dann mit<br />
C:\>cd ebkus_installation\ebkus<br />
C:\ebkus_installation\ebkus>configure.py ''Instanzname''<br />
eingerichtet werden. <br />
<br />
Wenn keine Datei zur Initialisierung angegeben wird, wird eine Datenbank mit den Standardmerkmalskatalogen und einem evt. konfigurierten Straßenkatalog erstellt. Wenn der Instanzname mit {{code|demo}} beginnt, werden zusätzlich Demodaten generiert.<br />
<br />
=== Mögliche Probleme ===<br />
<br />
* Windows-Dienste werden nicht automatisch installiert: die Konsole muss als Administrator ausgeführt werden.<br />
* Nicht vollständig deinstallierte Dienste: notfalls mit {{code|sc delete ''Name''}} entfernen. Wenn der Name dann trotzdem noch in der Liste der Dienste auftaucht mit dem Zustand {{code|Deaktiviert}}, muss ein Neustart gemacht werden.<br />
* Übrig gebliebene Reste in der Registry von früheren Installationen, z.B. des MySQL-Servers. Diese müssen notfalls manuell beseitigt werden.<br />
* Instanz lässt sich nicht mit Sicherungsdatei initialisieren: Die Sicherungsdatei muss von einer Instanz mit demselben Namen stammen.<br />
* Automatischer Download klappt nicht: Falls der Internetzugang über einen Proxy erfolgt, muss man möglicherweise (ich habs nicht probiert) manuell herunterladen und die Dateien im Downloadverzeichnis ablegen.<br />
* Firefox akzeptiert das von EBKuS gelieferte Zertifikat (wg. doppelter Seriennummer oder so ähnlich): Zertifikate in Firefox löschen über {{pfad5|Einstellungen|Erweitert|Zertifikate|Zertifikate anzeigen|Löschen}}. Die EBKuS-Zertifikate stehen unter dem Namen EFB bzw. unter dem Namen, der in der {{file|ebkus.conf}} als {{konfig|organisation}} (im Abschnitt {{konfig|openssl}}) eingetragen wurde.<br />
<br />
=== Tipps ===<br />
<br />
* Das {{code|install.py}}-Skript lässt sich wiederholt ausführen. Eine bestehende MySQL- und Apache-Installation wird nicht wiederholt. Vorhandene Instanzdatenbanken bleiben ebenfalls intakt. Evt. neu hinzugekommenen Instanzkonfigurationen werden ausgeführt, d.h. die neue Instanz wird eingerichtet. (Löschen einer Instanz jedoch immer mit {{code|uninstall.py}}!) Alle zu generierenden Dateien werden neu generiert, so dass z.B. auf diese Weise Port-Änderungen oder die Änderung des Servernamens durchgeführt werden können.<br />
* Wenn das {{code|install.py}}-Skript mit der Option {{code|-u}} bzw. {{code|--update}} wiederholt wird, werden zusätzlich alle EBKuS-Dateien aus der Distribution in das Homeverzeichnis kopiert. <br />
* Hilfe für alle Skripte erhält man mit der Option {{code|--help}} oder kurz {{code|-h}}:<br />
C:\EBKuS-4.5>install.py --help<br />
C:\EBKuS-4.5>uninstall.py -h<br />
C:\ebkus_installation\ebkus>configure.py -h<br />
C:\ebkus_installation\ebkus\demo>dienst.py -h<br />
* Falls Änderungen an generierten Dateien nötig sind (z.B. Apache- oder MySQL-Konfiguration) ist es wenig sinnvoll, diese selbst zu verändern, da man dann nicht mehr die Möglichkeit hat, die Installationsskripte zu verwenden. Besser ist is es, die Templates selber anzupassen. Alle Templates (Vorlagen) für generierte Dateien finden sich im Verzeichnis {{file|templates}} im Homeverzeichnis.</div>Ebkushttps://www.ebkus.org/wiki/Linux_InstallationLinux Installation2015-05-30T22:43:30Z<p>Ebkus: </p>
<hr />
<div>Gültig ab: EBKuS 4.4.1<br />
<br />
Die folgende Anleitung habe ich mit '''Ubuntu 10.04.2 LTS''' getestet; vermutlich funktioniert das auch auf anderen Ubuntu bzw. Debian-basierten Gnu/Linux-Distributionen.<br />
<br />
Die Installation im folgenden Beispiel erfolgt unter dem User {{code|ebkus}} auf einem Rechner mit dem Namen {{code|ebvm}}. Der User {{code|ebkus}} benötigt Superuserrechte ({{code|sudo}}). Es wird angenommen, dass eine Internetverbindung besteht (zur Installation von Software mit {{code|apt-get}}).<br />
<br />
Die Installation erfolgt ausschließlich über die Kommandozeile. Damit funktioniert sie auch auf reinen Servern, die keine GUI haben.<br />
<br />
Bitte auch die [[Windows Installation]] beachten, da sind einige betriebssystemunabhängige Punkte ausführlicher dargestellt als hier.<br />
<br />
=== Voraussetzungen ===<br />
<br />
Folgende Voraussetzungen müssen erfüllt sein, damit EBKuS installiert werden kann:<br />
<br />
==== Python ====<br />
<br />
Ist auf solche Systemen normalerweise bereits installiert, ansonsten:<br />
ebkus@ebvm:~$ sudo apt-get install python2.6<br />
Es kann auch Python 2.7 sein, wenn das in der Distribution angeboten wird, jedoch '''nicht''' Python 3.0 oder höher.<br />
<br />
==== MySQL ====<br />
<br />
Bei Ubuntu 10.04 LTS wird MySQL 5.1.XX installiert. Mit der nächsthöheren MySQL-Version 5.5 ist EBKuS noch nicht getestet!<br />
<br />
Die Datenbank installieren mit:<br />
ebkus@ebvm:~$ sudo apt-get install mysql-server mysql-common mysql-client<br />
Bei der Installation muss ein Passwort für den Datenbank-User {{code|root}} angegeben werden, das später in die {{file|ebkus.conf}} eingetragen werden muss. Nach einer erfolgreichen Installation kann man sich mit dem Befehl<br />
ebkus@ebvm:~$ mysql -uroot -p''Passwort''<br />
Welcome to the MySQL monitor. Commands end with ; or \g.<br />
...<br />
mysql><br />
mit der Datenbank verbinden.<br />
<br />
Falls der Standardport 3306 für MySQL nicht zur Verfügung steht, muss die Datei {{file|/etc/mysql/my.cnf}} angepasst werden.<br />
<br />
==== Python-MySQLdb ====<br />
<br />
Den Datenbankadapter für Python-MySQL installieren:<br />
ebkus@ebvm:~$ sudo apt-get install python-mysqldb<br />
Nach erfolgreicher Installation kann man Python aufrufen und MySQLdb importieren:<br />
ebkus@ebvm:~$ python<br />
Python 2.6.5 (r265:79063, Apr 16 2010, 13:09:56)<br />
...<br />
>>> import MySQLdb<br />
>>><br />
<br />
==== Apache 2 ====<br />
<br />
Den Webserver installieren:<br />
ebkus@ebvm:~$ sudo apt-get install apache2<br />
Nach der erfolgreichen Installation erhält man mit einem Browser mit der Adresse <nowiki>http://localhost/</nowiki> eine Seite mit '''It works!'''. Oder man installiert z.B. {{code|wget}} und erhält mit der genannten Adresse die entsprechende HTML-Datei {{file|index.html}}:<br />
ebkus@ebvm:~$ sudo apt-get install wget<br />
ebkus@ebvm:~$ wget <nowiki>http://localhost/</nowiki><br />
<br />
Falls der Webserver nicht auf den Standardports 80 und 443 laufen soll, muss die Datei {{file|/etc/apache2/ports.conf}} angepasst werden, ebenso die {{file|ebkus.conf}} (siehe [[Konfiguration]])<br />
<br />
Um den Webserver zu konfigurieren, müssen das ssl-Modul und das<br />
version-Modul aktiviert werden:<br />
ebkus@ebvm:~$ sudo a2enmod ssl version<br />
Außerdem muss die von EBKuS generierte Apache-Konfigurationsdatei eingebunden werden:<br />
ebkus@ebvm:~$ cd /etc/apache2/sites-enabled<br />
ebkus@ebvm:/etc/apache2/sites-enabled$ sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl<br />
Die Datei {{file|ebkus_httpd.conf}} existiert zu diesem Zeitpunkt noch nicht, sie wird bei der Installation ({{file|install.py}}) und bei jeder Änderung von Instanzen ({{file|configure.py}}) neu generiert. Sie definiert einen Virtual Host für den Webserver, über den alle EBKuS-Instanzen angesprochen werden.<br />
<br />
'''Dateirechte:''' Alle Verzeichnisse, die in einem Pfad zu einer Datei stehen, die vom Webserver gelesen werden soll, müssen das Leserecht und das Ausführungsrecht besitzen. Wenn das Installationsverzeichnis wie im Beispiel im Homeverzeichnis eines Benutzers steht, müssen diese Rechte evt. explizit vergeben werden:<br />
ebkus@ebvm:~$ sudo chmod go+rx /home/ebkus <br />
Den vom Installationsskript erzeugten Verzeichnissen und Dateien werden diese Rechte automatisch gegeben.<br />
<br />
<br />
==== Reportlab ====<br />
<br />
Falls keine Internetverbindung besteht, muss [http://www.efb-berlin.de/ebkus/ebkus-3.3/linux/ReportLab_1_19.zip diese] Datei bei der Installation im Downloadverzeichnis stehen, ansonsten wird sie bei der Installation automatisch heruntergeladen.<br />
<br />
==== EBKuS ====<br />
<br />
Die neueste [http://www.ebkus.org/alle_downloads.html EBKuS-Software] herunterladen (zusammen mit evt. vorhandenen<br />
Patches!), auspacken und in das Distributionsverzeichnis gehen, z.B.:<br />
ebkus@ebkusvm1:~$ wget http://www.efb-berlin.de/ebkus/ebkus-4.5/ebkus-4.5-src.zip<br />
ebkus@ebkusvm1:~$ unzip ebkus-4.5-src.zip<br />
ebkus@ebkusvm1:~$ cd EBKuS-4.5<br />
ebkus@ebkusvm1:~/EBKuS-4.5$<br />
<br />
=== Installation ===<br />
<br />
==== Erstkonfiguration ====<br />
<br />
Erstkonfiguration erzeugen:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ ./install.py -c ~/ebkus_installation<br />
Die EBKuS-Konfigurationsdatei {{file|/home/ebkus/ebkus_installation/ebkus/ebkus.conf}} kann nun weiter bearbeitet und für die eigentliche Installation verwendet werden.<br />
<br />
==== Systemkonfiguration ====<br />
<br />
System-[[Konfiguration]] anpassen, insbesondere:<br />
* Passwort für Datenbank-User {{code|root}} eintragen (Parameter {{konfig|database_admin_password}})<br />
* {{konfig|server_name}}, entweder IP-Nummer oder Name (FQDN)<br />
* Evt. Standardports {{konfig|server_https_port}} und {{konfig|server_http_port}} anpassen<br />
* {{konfig| server_admin}}<br />
* Im Abschnitt {{code|openssl}} Angaben zur Region und Organisation<br />
<br />
==== Instanzkonfiguration ====<br />
<br />
Instanz-[[Konfiguration]] anpassen:<br />
* {{konfig|instance_name}}, optional {{konfig|instance_title}}<br />
* {{konfig|initial_content}}, falls eine initiale Datenbank vorhanden ist (z.B. aus einer früheren Installation)<br />
* {{konfig|port}}<br />
<br />
==== Installation ====<br />
<br />
Installation:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ ./install.py ~/ebkus_installation<br />
Bei der Installation wird man unter Umständen nach dem Passwort des (Linux-)Users gefragt, dasselbe, das man bei einem vorangestellten {{code|sudo}} angeben muss. Damit können die start/stop-Skripte in die Bootsequenz ({{file|/etc/init.d/}}) eingetragen werden<br />
<br />
Nach der Installation (und auch nach jeder Umkonfigurierung mit {{file|configure.py}}) muss der Webserver neu gestartet werden:<br />
ebkus@ebvm:~$ sudo service apache2 restart<br />
* Restarting web server apache2 [ OK ]<br />
Ansonsten wird die neu generierte Webserver-Konfiguration in {{file|ebkus_httpd.conf}} nicht wirksam.<br />
<br />
==== Migration ====<br />
<br />
Falls wie [[Windows_Installation#Migration|hier]] beschrieben eine Menge von bestehenden Instanzen in die neue Installation übernommen werden soll:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ ./install.py -p ~/ebkus_preconfig ~/ebkus_installation<br />
Im Verzeichnis {{file|~/ebkus_preconfig}} muss dann eine gültige {{file|ebkus.conf}} liegen sowie eine Sicherungsdatei für jede Instanz, die in der Konfiguration über den Parameter {{konfig|initial_content}} eingebunden wird.<br />
<br />
=== Dienste ===<br />
<br />
Im Unterschied zur [[Windows Installation|Windows]] werden bei der Installation und der Konfigurierung keine Dienste gestartet oder gestoppt. Es werden jedoch Skripte in {{file|/etc/init.d}} generiert, mit denen die EBKuS-Server hoch und runtergefahren werden. Beim booten des Systems geschieht dies automatisch, d.h. nach einem Reboot steht EBKuS automatisch zur Verfügung.<br />
<br />
Für den Systemadministrator gibt es folgende Skripte, die nach der Installation im Homeverzeichnis stehen:<br />
* {{code|ebkusctl}}: Damit kann jede Instanz einzeln oder auch alle Instanzen gemeinsam hoch- und runtergefahren werden sowie deren Status abgefragt werden. Dieses Skript verwendet intern die generierten Skripte in {{file|/etc/init.d}}.<br />
* {{code|ebkusdump}}: Für jede Instanz einzeln oder für alle zusammen eine Sicherungsdatei erzeugen (verwendet intern {{file|datenbank_sichern.py||}}).<br />
* {{code|ebkusrestore}}: Für jede Instanz einzeln oder für alle zusammen die Datenbank aus eine Sicherungsdatei initialisieren (verwendet intern {{file| datenbank_initialisieren.py||}}).<br />
Z.B.<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl all start<br />
* Starting EBKuS demo [ OK ] <br />
* Starting EBKuS muster_efb [ OK ] <br />
* Starting EBKuS demo_braunschweig [ OK ] <br />
Jedes Skript hat eingebaute Hilfe:<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl --help<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl -h<br />
<br />
<br />
<br />
<br />
<br />
<!--<br />
<br />
Schritte:<br />
<br />
#`Installationsverzeichnis`_ einrichten, z.B. {{code|/home/user/ebinst}}:<br />
mkdir /home/user/ebinst<br />
#In das `Distributionsverzeichnis`_ gehen (z.B. {{code|/home/user/ebkus-cd/ebkus-3.3}}; man könnte hier auch direkt von der CD arbeiten):<br />
cd /home/user/ebkus-cd/ebkus-3.3<br />
#EBKuS-Konfiguration erzeugen:<br />
python install.py --config /home/user/ebinst<br />
#Erzeugte Konfigurationsdatei {{code|/home/user/ebinst/ebkus/ebkus.conf}}anpassen (siehe `Konfiguration`_).<br />
#EBKuS und alle in der Konfigurationsdatei definierten Instanzen installieren und konfigurieren:<br />
python install.py /home/user/ebinst<br />
Für jede in der Konfiguration definierten Instanz gibt es dann ein `Instanzverzeichnis`_:<br />
<br />
<blockquote>{{code|/home/user/ebinst/ebkus/}}''Instanzname''<br />
<br />
</blockquote><br />
Die Meldungen des Installationsskriptes stehen auch in der Datei {{code|/home/user/ebinst/install.log}}.<br />
<br />
#(als {{code|root}}) Die in Schritt 5. erzeugte Datei {{code|/home/user/ebinst/ebkus/ebkus_httpd.conf}} in die Apache-Konfigurationsdatei (bei SuSE z.B. /etc/httpd/httpd.conf) inkludieren, z.B. indem Sie dort am Ende die folgende Zeile eintragen:<br />
Include /home/user/ebinst/ebkus/ebkus_httpd.conf<br />
#(als {{code|root}}) Den Apache-Webserver neustarten, damit die modifizierte Konfiguration berücksichtigt wird, z.B. bei SuSE:<br />
rcapache restart<br />
#Eine konfigurierte EBKuS-Instanz testen, z.B. die Instanz demo:<br />
cd /home/user/ebinst/ebkus/demo <br />
./start.py --console<br />
Der gestartete Server gibt Meldungen auf die Konsole aus.<br />
<br />
#Über einen Browser mit der Instanz {{code|demo}} arbeiten (anstatt {{code|demo}} auch mit jeder anderen in der `Konfiguration`_definierten Instanz):<br />
https://localhost/ebkus/demo/cgi/do/login<br />
Die Login-Maske kann auch über eine vorgeschaltete Eingangsseite erreicht werden, die für jede Instanz generiert wird:<br />
<br />
https://localhost/ebkus/demo/index.html<br />
Diese Seite kann mit einem HTML-Editor gemäß den lokalen Bedürfnissen erweitert oder verändert werden. Die zu editierende Datei ist im `Instanzverzeichnis`_ unter {{code|htdocs/index.html}} zu finden.<br />
<br />
Als Administrator anmelden: Benutzer {{code|Admin}}, Passwort {{code|Admin}}. Als angemeldeter Administrator können Sie weitere Benutzer anlegen.<br />
<br />
Die Instanzen {{code|demo}} bzw. {{code|demo_berlin}} enthalten bereits Beispieldaten, mit denen Sie experimentieren können. Sie können sich also gleich als Bearbeiter bzw. als Verwaltungskraft anmelden, z.B. Benutzer {{code|test}}, Passwort {{code|test}} bzw. Benutzer {{code|verw}}, Passwort {{code|verw}}.<br />
<br />
Falls Sie in der Konfiguration den Parameter ''server_name'' mit einer in Ihrem Netzwerk gültigen IP-Adresse oder einem gültigen Namen belegt haben, können Sie auch von anderen Rechnern im Netzwerk auf eine EBKuS-Instanz zugreifen, z.B.:<br />
<br />
https://192.168.1.92/ebkus/demo/index.html https://192.168.1.92/ebkus/demo/cgi/do/login<br />
#(als {{code|root}}) Die Instanz in die Bootsequenz des Servers aufnehmen, so dass beim Hochfahren des Rechners der EBKuS-Server für die Instanz automatisch gestartet wird:<br />
cd /home/user/ebinst/ebkus/demo cp ebkus_demo /etc/init.d<br />
Die Links für die Run-Level manuell setzen oder, z.B. bei SuSE, den Run-Level-Editor verwenden.<br />
<br />
#In einer Produktionsinstanz die Anwendung einrichten, siehe Einrichtung der Anwendung im Handbuch.<br />
<br />
<br />
<br />
<br />
- Apache richtig löschen, so dass frische Konfig kommt:<br />
<br />
- sudo dpkg --purge --force-remove-reinstreq apache2.2-common<br />
<br />
So geht richtiges uninstall mit Konfiguration:<br />
apt-get remove ––purge *paketname*<br />
<br />
<br />
<br />
- download mit wget auf dem ubuntu server<br />
<br />
<br />
<br />
== Apache Konfiguration ==<br />
<br />
cd /etc/apache2/mods-enabled<br />
sudo ln -s ../mods-available/ssl.conf ssl.conf<br />
sudo ln -s ../mods-available/ssl.load ssl.load<br />
<br />
cd /etc/apache2/sites-enabled<br />
sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl<br />
http://ebkus.org/wiki/Linux_Installation#MySQL<br />
http://ebkus.org/wiki/Linux_Installation#Apache_2<br />
<br />
--></div>Ebkushttps://www.ebkus.org/wiki/Linux_InstallationLinux Installation2015-05-30T22:43:11Z<p>Ebkus: </p>
<hr />
<div>Gültig ab: EBKuS 4.4.1<br />
<br />
Die folgende Anleitung habe ich mit '''Ubuntu 10.04.2 LTS''' getestet; vermutlich funktioniert das auch auf anderen Ubuntu bzw. Debian-basierten Gnu/Linux-Distributionen.<br />
<br />
Die Installation im folgenden Beispiel erfolgt unter dem User {{code|ebkus}} auf einem Rechner mit dem Namen {{code|ebvm}}. Der User {{code|ebkus}} benötigt Superuserrechte ({{code|sudo}}). Es wird angenommen, dass eine Internetverbindung besteht (zur Installation von Software mit {{code|apt-get}}).<br />
<br />
Die Installation erfolgt ausschließlich über die Kommandozeile. Damit funktioniert sie auch auf reinen Servern, die keine GUI haben.<br />
<br />
Bitte auch die [[Windows Installation]] beachten, da sind einige betriebssystemunabhängige Punkte ausführlicher dargestellt als hier.<br />
<br />
=== Voraussetzungen ===<br />
<br />
Folgende Voraussetzungen müssen erfüllt sein, damit EBKuS installiert werden kann:<br />
<br />
==== Python ====<br />
<br />
Ist auf solche Systemen normalerweise bereits installiert, ansonsten:<br />
ebkus@ebvm:~$ sudo apt-get install python2.6<br />
Es kann auch Python 2.7 sein, wenn das in der Distribution angeboten wird, jedoch '''nicht''' Python 3.0 oder höher.<br />
<br />
==== MySQL ====<br />
<br />
Bei Ubuntu 10.04 LTS wird MySQL 5.1.XX installiert. Mit der nächsthöheren MySQL-Version 5.5 ist EBKuS noch nicht getestet!<br />
<br />
Die Datenbank installieren mit:<br />
ebkus@ebvm:~$ sudo apt-get install mysql-server mysql-common mysql-client<br />
Bei der Installation muss ein Passwort für den Datenbank-User {{code|root}} angegeben werden, das später in die {{file|ebkus.conf}} eingetragen werden muss. Nach einer erfolgreichen Installation kann man sich mit dem Befehl<br />
ebkus@ebvm:~$ mysql -uroot -p''Passwort''<br />
Welcome to the MySQL monitor. Commands end with ; or \g.<br />
...<br />
mysql><br />
mit der Datenbank verbinden.<br />
<br />
Falls der Standardport 3306 für MySQL nicht zur Verfügung steht, muss die Datei {{file|/etc/mysql/my.cnf}} angepasst werden.<br />
<br />
==== Python-MySQLdb ====<br />
<br />
Den Datenbankadapter für Python-MySQL installieren:<br />
ebkus@ebvm:~$ sudo apt-get install python-mysqldb<br />
Nach erfolgreicher Installation kann man Python aufrufen und MySQLdb importieren:<br />
ebkus@ebvm:~$ python<br />
Python 2.6.5 (r265:79063, Apr 16 2010, 13:09:56)<br />
...<br />
>>> import MySQLdb<br />
>>><br />
<br />
==== Apache 2 ====<br />
<br />
Den Webserver installieren:<br />
ebkus@ebvm:~$ sudo apt-get install apache2<br />
Nach der erfolgreichen Installation erhält man mit einem Browser mit der Adresse <nowiki>http://localhost/</nowiki> eine Seite mit '''It works!'''. Oder man installiert z.B. {{code|wget}} und erhält mit der genannten Adresse die entsprechende HTML-Datei {{file|index.html}}:<br />
ebkus@ebvm:~$ sudo apt-get install wget<br />
ebkus@ebvm:~$ wget <nowiki>http://localhost/</nowiki><br />
<br />
Falls der Webserver nicht auf den Standardports 80 und 443 laufen soll, muss die Datei {{file|/etc/apache2/ports.conf}} angepasst werden, ebenso die {{file|ebkus.conf}} (siehe [[Konfiguration]])<br />
<br />
Um den Webserver zu konfigurieren, müssen das ssl-Modul und das<br />
version-Modul aktiviert werden:<br />
ebkus@ebvm:~$ sudo a2enmod ssl version<br />
Außerdem muss die von EBKuS generierte Apache-Konfigurationsdatei eingebunden werden:<br />
ebkus@ebvm:~$ cd /etc/apache2/sites-enabled<br />
ebkus@ebvm:/etc/apache2/sites-enabled$ sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl<br />
Die Datei {{file|ebkus_httpd.conf}} existiert zu diesem Zeitpunkt noch nicht, sie wird bei der Installation ({{file|install.py}}) und bei jeder Änderung von Instanzen ({{file|configure.py}}) neu generiert. Sie definiert einen Virtual Host für den Webserver, über den alle EBKuS-Instanzen angesprochen werden.<br />
<br />
'''Dateirechte:''' Alle Verzeichnisse, die in einem Pfad zu einer Datei stehen, die vom Webserver gelesen werden soll, müssen das Leserecht und das Ausführungsrecht besitzen. Wenn das Installationsverzeichnis wie im Beispiel im Homeverzeichnis eines Benutzers steht, müssen diese Rechte evt. explizit vergeben werden:<br />
ebkus@ebvm:~$ sudo chmod go+rx /home/ebkus <br />
Den vom Installationsskript erzeugten Verzeichnissen und Dateien werden diese Rechte automatisch gegeben.<br />
<br />
<br />
==== Reportlab ====<br />
<br />
Falls keine Internetverbindung besteht, muss [http://www.efb-berlin.de/ebkus/ebkus-3.3/linux/ReportLab_1_19.zip diese] Datei bei der Installation im Downloadverzeichnis stehen, ansonsten wird sie bei der Installation automatisch heruntergeladen.<br />
<br />
==== EBKuS ====<br />
<br />
Die neueste [http://www.ebkus.org/alle_downloads.html EBKuS-Software] herunterladen (zusammen mit evt. vorhandenen<br />
Patches!), auspacken und in das Distributionsverzeichnis gehen, z.B.:<br />
ebkus@ebkusvm1:~$ wget http://www.efb-berlin.de/ebkus/ebkus-4.5/ebkus-4.5-src.zip<br />
ebkus@ebkusvm1:~$ unzip ebkus-4.5-src.zip<br />
ebkus@ebkusvm1:~$ cd EBKuS-4.5<br />
ebkus@ebkusvm1:~/EBKuS-4.5$<br />
<br />
=== Installation ===<br />
<br />
==== Erstkonfiguration ====<br />
<br />
Erstkonfiguration erzeugen:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ ./install.py -c ~/ebkus_installation<br />
Die EBKuS-Konfigurationsdatei {{file|/home/ebkus/ebkus_installation/ebkus/ebkus.conf}} kann nun weiter bearbeitet und für die eigentliche Installation verwendet werden.<br />
<br />
==== Systemkonfiguration ====<br />
<br />
System-[[Konfiguration]] anpassen, insbesondere:<br />
* Passwort für Datenbank-User {{code|root}} eintragen (Parameter {{konfig|database_admin_password}})<br />
* {{konfig|server_name}}, entweder IP-Nummer oder Name (FQDN)<br />
* Evt. Standardports {{konfig|server_https_port}} und {{konfig|server_http_port}} anpassen<br />
* {{konfig| server_admin}}<br />
* Im Abschnitt {{code|openssl}} Angaben zur Region und Organisation<br />
<br />
==== Instanzkonfiguration ====<br />
<br />
Instanz-[[Konfiguration]] anpassen:<br />
* {{konfig|instance_name}}, optional {{konfig|instance_title}}<br />
* {{konfig|initial_content}}, falls eine initiale Datenbank vorhanden ist (z.B. aus einer früheren Installation)<br />
* {{konfig|port}}<br />
<br />
==== Installation ====<br />
<br />
Installation:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ ./install.py ~/ebkus_installation<br />
Bei der Installation wird man unter Umständen nach dem Passwort des (Linux-)Users gefragt, dasselbe, das man bei einem vorangestellten {{code|sudo}} angeben muss. Damit können die start/stop-Skripte in die Bootsequenz ({{file|/etc/init.d/}}) eingetragen werden<br />
<br />
Nach der Installation (und auch nach jeder Umkonfigurierung mit {{file|configure.py}}) muss der Webserver neu gestartet werden:<br />
ebkus@ebvm:~$ sudo service apache2 restart<br />
* Restarting web server apache2 [ OK ]<br />
Ansonsten wird die neu generierte Webserver-Konfiguration in {{file|ebkus_httpd.conf}} nicht wirksam.<br />
<br />
==== Migration ====<br />
<br />
Falls wie [[Windows_Installation#Migration|hier]] beschrieben eine Menge von bestehenden Instanzen in die neue Installation übernommen werden soll:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ ./install.py -p ~/ebkus_preconfig ~/ebkus_installation<br />
Im Verzeichnis {{file|~/ebkus_preconfig}} muss dann eine gültige {{file|ebkus.conf}} liegen sowie eine Sicherungsdatei für jede Instanz, die in der Konfiguration über den Parameter {{konfig|initial_content}} eingebunden wird.<br />
<br />
=== Dienste ===<br />
<br />
Im Unterschied zur [[Windows Installation|Windows]] werden bei der Installation und der Konfigurierung keine Dienste gestartet oder gestoppt. Es werden jedoch Skripte in {{file|/etc/init.d}} generiert, mit denen die EBKuS-Server hoch und runtergefahren werden. Beim booten des Systems geschieht dies automatisch, d.h. nach einem Reboot steht EBKuS automatisch zur Verfügung.<br />
<br />
Für den Systemadministrator gibt es folgende Skripte, die nach der Installation im Homeverzeichnis stehen:<br />
* {{code|ebkusctl}}: Damit kann jede Instanz einzeln oder auch alle Instanzen gemeinsam hoch- und runtergefahren werden sowie deren Status abgefragt werden. Dieses Skript verwendet intern die generierten Skripte in {{file|/etc/init.d}}.<br />
* {{code|ebkusdump}}: Für jede Instanz einzeln oder für alle zusammen eine Sicherungsdatei erzeugen (verwendet intern {{file|datenbank_sichern.py||}}).<br />
* {{code|ebkusrestore}}: Für jede Instanz einzeln oder für alle zusammen die Datenbank aus eine Sicherungsdatei initialisieren (verwendet intern {{file| datenbank_initialisieren.py||}}).<br />
Z.B.<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl all start<br />
* Starting EBKuS demo [ OK ] <br />
* Starting EBKuS muster_efb [ OK ] <br />
* Starting EBKuS demo_braunschweig [ OK ] <br />
Jedes Skript hat eingebaute Hilfe:<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl --help<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl -h<br />
<br />
<br />
<br />
<br />
<br />
<!--<br />
<br />
Schrittee:<br />
<br />
#`Installationsverzeichnis`_ einrichten, z.B. {{code|/home/user/ebinst}}:<br />
mkdir /home/user/ebinst<br />
#In das `Distributionsverzeichnis`_ gehen (z.B. {{code|/home/user/ebkus-cd/ebkus-3.3}}; man könnte hier auch direkt von der CD arbeiten):<br />
cd /home/user/ebkus-cd/ebkus-3.3<br />
#EBKuS-Konfiguration erzeugen:<br />
python install.py --config /home/user/ebinst<br />
#Erzeugte Konfigurationsdatei {{code|/home/user/ebinst/ebkus/ebkus.conf}}anpassen (siehe `Konfiguration`_).<br />
#EBKuS und alle in der Konfigurationsdatei definierten Instanzen installieren und konfigurieren:<br />
python install.py /home/user/ebinst<br />
Für jede in der Konfiguration definierten Instanz gibt es dann ein `Instanzverzeichnis`_:<br />
<br />
<blockquote>{{code|/home/user/ebinst/ebkus/}}''Instanzname''<br />
<br />
</blockquote><br />
Die Meldungen des Installationsskriptes stehen auch in der Datei {{code|/home/user/ebinst/install.log}}.<br />
<br />
#(als {{code|root}}) Die in Schritt 5. erzeugte Datei {{code|/home/user/ebinst/ebkus/ebkus_httpd.conf}} in die Apache-Konfigurationsdatei (bei SuSE z.B. /etc/httpd/httpd.conf) inkludieren, z.B. indem Sie dort am Ende die folgende Zeile eintragen:<br />
Include /home/user/ebinst/ebkus/ebkus_httpd.conf<br />
#(als {{code|root}}) Den Apache-Webserver neustarten, damit die modifizierte Konfiguration berücksichtigt wird, z.B. bei SuSE:<br />
rcapache restart<br />
#Eine konfigurierte EBKuS-Instanz testen, z.B. die Instanz demo:<br />
cd /home/user/ebinst/ebkus/demo <br />
./start.py --console<br />
Der gestartete Server gibt Meldungen auf die Konsole aus.<br />
<br />
#Über einen Browser mit der Instanz {{code|demo}} arbeiten (anstatt {{code|demo}} auch mit jeder anderen in der `Konfiguration`_definierten Instanz):<br />
https://localhost/ebkus/demo/cgi/do/login<br />
Die Login-Maske kann auch über eine vorgeschaltete Eingangsseite erreicht werden, die für jede Instanz generiert wird:<br />
<br />
https://localhost/ebkus/demo/index.html<br />
Diese Seite kann mit einem HTML-Editor gemäß den lokalen Bedürfnissen erweitert oder verändert werden. Die zu editierende Datei ist im `Instanzverzeichnis`_ unter {{code|htdocs/index.html}} zu finden.<br />
<br />
Als Administrator anmelden: Benutzer {{code|Admin}}, Passwort {{code|Admin}}. Als angemeldeter Administrator können Sie weitere Benutzer anlegen.<br />
<br />
Die Instanzen {{code|demo}} bzw. {{code|demo_berlin}} enthalten bereits Beispieldaten, mit denen Sie experimentieren können. Sie können sich also gleich als Bearbeiter bzw. als Verwaltungskraft anmelden, z.B. Benutzer {{code|test}}, Passwort {{code|test}} bzw. Benutzer {{code|verw}}, Passwort {{code|verw}}.<br />
<br />
Falls Sie in der Konfiguration den Parameter ''server_name'' mit einer in Ihrem Netzwerk gültigen IP-Adresse oder einem gültigen Namen belegt haben, können Sie auch von anderen Rechnern im Netzwerk auf eine EBKuS-Instanz zugreifen, z.B.:<br />
<br />
https://192.168.1.92/ebkus/demo/index.html https://192.168.1.92/ebkus/demo/cgi/do/login<br />
#(als {{code|root}}) Die Instanz in die Bootsequenz des Servers aufnehmen, so dass beim Hochfahren des Rechners der EBKuS-Server für die Instanz automatisch gestartet wird:<br />
cd /home/user/ebinst/ebkus/demo cp ebkus_demo /etc/init.d<br />
Die Links für die Run-Level manuell setzen oder, z.B. bei SuSE, den Run-Level-Editor verwenden.<br />
<br />
#In einer Produktionsinstanz die Anwendung einrichten, siehe Einrichtung der Anwendung im Handbuch.<br />
<br />
<br />
<br />
<br />
- Apache richtig löschen, so dass frische Konfig kommt:<br />
<br />
- sudo dpkg --purge --force-remove-reinstreq apache2.2-common<br />
<br />
So geht richtiges uninstall mit Konfiguration:<br />
apt-get remove ––purge *paketname*<br />
<br />
<br />
<br />
- download mit wget auf dem ubuntu server<br />
<br />
<br />
<br />
== Apache Konfiguration ==<br />
<br />
cd /etc/apache2/mods-enabled<br />
sudo ln -s ../mods-available/ssl.conf ssl.conf<br />
sudo ln -s ../mods-available/ssl.load ssl.load<br />
<br />
cd /etc/apache2/sites-enabled<br />
sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl<br />
http://ebkus.org/wiki/Linux_Installation#MySQL<br />
http://ebkus.org/wiki/Linux_Installation#Apache_2<br />
<br />
--></div>Ebkushttps://www.ebkus.org/wiki/Linux_InstallationLinux Installation2015-03-04T20:09:00Z<p>Ebkus: </p>
<hr />
<div>Gültig ab: EBKuS 4.4.1<br />
<br />
Die folgende Anleitung habe ich mit '''Ubuntu 10.04.2 LTS''' getestet; vermutlich funktioniert das auch auf anderen Ubuntu bzw. Debian-basierten Gnu/Linux-Distributionen.<br />
<br />
Die Installation im folgenden Beispiel erfolgt unter dem User {{code|ebkus}} auf einem Rechner mit dem Namen {{code|ebvm}}. Der User {{code|ebkus}} benötigt Superuserrechte ({{code|sudo}}). Es wird angenommen, dass eine Internetverbindung besteht (zur Installation von Software mit {{code|apt-get}}).<br />
<br />
Die Installation erfolgt ausschließlich über die Kommandozeile. Damit funktioniert sie auch auf reinen Servern, die keine GUI haben.<br />
<br />
Bitte auch die [[Windows Installation]] beachten, da sind einige betriebssystemunabhängige Punkte ausführlicher dargestellt als hier.<br />
<br />
=== Voraussetzungen ===<br />
<br />
Folgende Voraussetzungen müssen erfüllt sein, damit EBKuS installiert werden kann:<br />
<br />
==== Python ====<br />
<br />
Ist auf solche Systemen normalerweise bereits installiert, ansonsten:<br />
ebkus@ebvm:~$ sudo apt-get install python2.6<br />
Es kann auch Python 2.7 sein, wenn das in der Distribution angeboten wird, jedoch '''nicht''' Python 3.0 oder höher.<br />
<br />
==== MySQL ====<br />
<br />
Bei Ubuntu 10.04 LTS wird MySQL 5.1.XX installiert. Mit der nächsthöheren MySQL-Version 5.5 ist EBKuS noch nicht getestet!<br />
<br />
Die Datenbank installieren mit:<br />
ebkus@ebvm:~$ sudo apt-get install mysql-server mysql-common mysql-client<br />
Bei der Installation muss ein Passwort für den Datenbank-User {{code|root}} angegeben werden, das später in die {{file|ebkus.conf}} eingetragen werden muss. Nach einer erfolgreichen Installation kann man sich mit dem Befehl<br />
ebkus@ebvm:~$ mysql -uroot -p''Passwort''<br />
Welcome to the MySQL monitor. Commands end with ; or \g.<br />
...<br />
mysql><br />
mit der Datenbank verbinden.<br />
<br />
Falls der Standardport 3306 für MySQL nicht zur Verfügung steht, muss die Datei {{file|/etc/mysql/my.cnf}} angepasst werden.<br />
<br />
==== Python-MySQLdb ====<br />
<br />
Den Datenbankadapter für Python-MySQL installieren:<br />
ebkus@ebvm:~$ sudo apt-get install python-mysqldb<br />
Nach erfolgreicher Installation kann man Python aufrufen und MySQLdb importieren:<br />
ebkus@ebvm:~$ python<br />
Python 2.6.5 (r265:79063, Apr 16 2010, 13:09:56)<br />
...<br />
>>> import MySQLdb<br />
>>><br />
<br />
==== Apache 2 ====<br />
<br />
Den Webserver installieren:<br />
ebkus@ebvm:~$ sudo apt-get install apache2<br />
Nach der erfolgreichen Installation erhält man mit einem Browser mit der Adresse <nowiki>http://localhost/</nowiki> eine Seite mit '''It works!'''. Oder man installiert z.B. {{code|wget}} und erhält mit der genannten Adresse die entsprechende HTML-Datei {{file|index.html}}:<br />
ebkus@ebvm:~$ sudo apt-get install wget<br />
ebkus@ebvm:~$ wget <nowiki>http://localhost/</nowiki><br />
<br />
Falls der Webserver nicht auf den Standardports 80 und 443 laufen soll, muss die Datei {{file|/etc/apache2/ports.conf}} angepasst werden, ebenso die {{file|ebkus.conf}} (siehe [[Konfiguration]])<br />
<br />
Um den Webserver zu konfigurieren, müssen das ssl-Modul und das<br />
version-Modul aktiviert werden:<br />
ebkus@ebvm:~$ sudo a2enmod ssl version<br />
Außerdem muss die von EBKuS generierte Apache-Konfigurationsdatei eingebunden werden:<br />
ebkus@ebvm:~$ cd /etc/apache2/sites-enabled<br />
ebkus@ebvm:/etc/apache2/sites-enabled$ sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl<br />
Die Datei {{file|ebkus_httpd.conf}} existiert zu diesem Zeitpunkt noch nicht, sie wird bei der Installation ({{file|install.py}}) und bei jeder Änderung von Instanzen ({{file|configure.py}}) neu generiert. Sie definiert einen Virtual Host für den Webserver, über den alle EBKuS-Instanzen angesprochen werden.<br />
<br />
'''Dateirechte:''' Alle Verzeichnisse, die in einem Pfad zu einer Datei stehen, die vom Webserver gelesen werden soll, müssen das Leserecht und das Ausführungsrecht besitzen. Wenn das Installationsverzeichnis wie im Beispiel im Homeverzeichnis eines Benutzers steht, müssen diese Rechte evt. explizit vergeben werden:<br />
ebkus@ebvm:~$ sudo chmod go+rx /home/ebkus <br />
Den vom Installationsskript erzeugten Verzeichnissen und Dateien werden diese Rechte automatisch gegeben.<br />
<br />
<br />
==== Reportlab ====<br />
<br />
Falls keine Internetverbindung besteht, muss [http://www.efb-berlin.de/ebkus/ebkus-3.3/linux/ReportLab_1_19.zip diese] Datei bei der Installation im Downloadverzeichnis stehen, ansonsten wird sie bei der Installation automatisch heruntergeladen.<br />
<br />
==== EBKuS ====<br />
<br />
Die neueste [http://www.ebkus.org/alle_downloads.html EBKuS-Software] herunterladen (zusammen mit evt. vorhandenen<br />
Patches!), auspacken und in das Distributionsverzeichnis gehen, z.B.:<br />
ebkus@ebkusvm1:~$ wget http://www.efb-berlin.de/ebkus/ebkus-4.5/ebkus-4.5-src.zip<br />
ebkus@ebkusvm1:~$ unzip ebkus-4.5-src.zip<br />
ebkus@ebkusvm1:~$ cd EBKuS-4.5<br />
ebkus@ebkusvm1:~/EBKuS-4.5$<br />
<br />
=== Installation ===<br />
<br />
==== Erstkonfiguration ====<br />
<br />
Erstkonfiguration erzeugen:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ ./install.py -c ~/ebkus_installation<br />
Die EBKuS-Konfigurationsdatei {{file|/home/ebkus/ebkus_installation/ebkus/ebkus.conf}} kann nun weiter bearbeitet und für die eigentliche Installation verwendet werden.<br />
<br />
==== Systemkonfiguration ====<br />
<br />
System-[[Konfiguration]] anpassen, insbesondere:<br />
* Passwort für Datenbank-User {{code|root}} eintragen (Parameter {{konfig|database_admin_password}})<br />
* {{konfig|server_name}}, entweder IP-Nummer oder Name (FQDN)<br />
* Evt. Standardports {{konfig|server_https_port}} und {{konfig|server_http_port}} anpassen<br />
* {{konfig| server_admin}}<br />
* Im Abschnitt {{code|openssl}} Angaben zur Region und Organisation<br />
<br />
==== Instanzkonfiguration ====<br />
<br />
Instanz-[[Konfiguration]] anpassen:<br />
* {{konfig|instance_name}}, optional {{konfig|instance_title}}<br />
* {{konfig|initial_content}}, falls eine initiale Datenbank vorhanden ist (z.B. aus einer früheren Installation)<br />
* {{konfig|port}}<br />
<br />
==== Installation ====<br />
<br />
Installation:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ ./install.py ~/ebkus_installation<br />
Bei der Installation wird man unter Umständen nach dem Passwort des (Linux-)Users gefragt, dasselbe, das man bei einem vorangestellten {{code|sudo}} angeben muss. Damit können die start/stop-Skripte in die Bootsequenz ({{file|/etc/init.d/}}) eingetragen werden<br />
<br />
Nach der Installation (und auch nach jeder Umkonfigurierung mit {{file|configure.py}}) muss der Webserver neu gestartet werden:<br />
ebkus@ebvm:~$ sudo service apache2 restart<br />
* Restarting web server apache2 [ OK ]<br />
Ansonsten wird die neu generierte Webserver-Konfiguration in {{file|ebkus_httpd.conf}} nicht wirksam.<br />
<br />
==== Migration ====<br />
<br />
Falls wie [[Windows_Installation#Migration|hier]] beschrieben eine Menge von bestehenden Instanzen in die neue Installation übernommen werden soll:<br />
ebkus@ebkusvm1:~/EBKuS-4.5$ ./install.py -p ~/ebkus_preconfig ~/ebkus_installation<br />
Im Verzeichnis {{file|~/ebkus_preconfig}} muss dann eine gültige {{file|ebkus.conf}} liegen sowie eine Sicherungsdatei für jede Instanz, die in der Konfiguration über den Parameter {{konfig|initial_content}} eingebunden wird.<br />
<br />
=== Dienste ===<br />
<br />
Im Unterschied zur [[Windows Installation|Windows]] werden bei der Installation und der Konfigurierung keine Dienste gestartet oder gestoppt. Es werden jedoch Skripte in {{file|/etc/init.d}} generiert, mit denen die EBKuS-Server hoch und runtergefahren werden. Beim booten des Systems geschieht dies automatisch, d.h. nach einem Reboot steht EBKuS automatisch zur Verfügung.<br />
<br />
Für den Systemadministrator gibt es folgende Skripte, die nach der Installation im Homeverzeichnis stehen:<br />
* {{code|ebkusctl}}: Damit kann jede Instanz einzeln oder auch alle Instanzen gemeinsam hoch- und runtergefahren werden sowie deren Status abgefragt werden. Dieses Skript verwendet intern die generierten Skripte in {{file|/etc/init.d}}.<br />
* {{code|ebkusdump}}: Für jede Instanz einzeln oder für alle zusammen eine Sicherungsdatei erzeugen (verwendet intern {{file|datenbank_sichern.py||}}).<br />
* {{code|ebkusrestore}}: Für jede Instanz einzeln oder für alle zusammen die Datenbank aus eine Sicherungsdatei initialisieren (verwendet intern {{file| datenbank_initialisieren.py||}}).<br />
Z.B.<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl all start<br />
* Starting EBKuS demo [ OK ] <br />
* Starting EBKuS muster_efb [ OK ] <br />
* Starting EBKuS demo_braunschweig [ OK ] <br />
Jedes Skript hat eingebaute Hilfe:<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl --help<br />
ebkus@ebvm:~/ebkus_installation/ebkus$ ebkusctl -h<br />
<br />
<br />
<br />
<br />
<br />
<!--<br />
<br />
Schritte:<br />
<br />
#`Installationsverzeichnis`_ einrichten, z.B. {{code|/home/user/ebinst}}:<br />
mkdir /home/user/ebinst<br />
#In das `Distributionsverzeichnis`_ gehen (z.B. {{code|/home/user/ebkus-cd/ebkus-3.3}}; man könnte hier auch direkt von der CD arbeiten):<br />
cd /home/user/ebkus-cd/ebkus-3.3<br />
#EBKuS-Konfiguration erzeugen:<br />
python install.py --config /home/user/ebinst<br />
#Erzeugte Konfigurationsdatei {{code|/home/user/ebinst/ebkus/ebkus.conf}}anpassen (siehe `Konfiguration`_).<br />
#EBKuS und alle in der Konfigurationsdatei definierten Instanzen installieren und konfigurieren:<br />
python install.py /home/user/ebinst<br />
Für jede in der Konfiguration definierten Instanz gibt es dann ein `Instanzverzeichnis`_:<br />
<br />
<blockquote>{{code|/home/user/ebinst/ebkus/}}''Instanzname''<br />
<br />
</blockquote><br />
Die Meldungen des Installationsskriptes stehen auch in der Datei {{code|/home/user/ebinst/install.log}}.<br />
<br />
#(als {{code|root}}) Die in Schritt 5. erzeugte Datei {{code|/home/user/ebinst/ebkus/ebkus_httpd.conf}} in die Apache-Konfigurationsdatei (bei SuSE z.B. /etc/httpd/httpd.conf) inkludieren, z.B. indem Sie dort am Ende die folgende Zeile eintragen:<br />
Include /home/user/ebinst/ebkus/ebkus_httpd.conf<br />
#(als {{code|root}}) Den Apache-Webserver neustarten, damit die modifizierte Konfiguration berücksichtigt wird, z.B. bei SuSE:<br />
rcapache restart<br />
#Eine konfigurierte EBKuS-Instanz testen, z.B. die Instanz demo:<br />
cd /home/user/ebinst/ebkus/demo <br />
./start.py --console<br />
Der gestartete Server gibt Meldungen auf die Konsole aus.<br />
<br />
#Über einen Browser mit der Instanz {{code|demo}} arbeiten (anstatt {{code|demo}} auch mit jeder anderen in der `Konfiguration`_definierten Instanz):<br />
https://localhost/ebkus/demo/cgi/do/login<br />
Die Login-Maske kann auch über eine vorgeschaltete Eingangsseite erreicht werden, die für jede Instanz generiert wird:<br />
<br />
https://localhost/ebkus/demo/index.html<br />
Diese Seite kann mit einem HTML-Editor gemäß den lokalen Bedürfnissen erweitert oder verändert werden. Die zu editierende Datei ist im `Instanzverzeichnis`_ unter {{code|htdocs/index.html}} zu finden.<br />
<br />
Als Administrator anmelden: Benutzer {{code|Admin}}, Passwort {{code|Admin}}. Als angemeldeter Administrator können Sie weitere Benutzer anlegen.<br />
<br />
Die Instanzen {{code|demo}} bzw. {{code|demo_berlin}} enthalten bereits Beispieldaten, mit denen Sie experimentieren können. Sie können sich also gleich als Bearbeiter bzw. als Verwaltungskraft anmelden, z.B. Benutzer {{code|test}}, Passwort {{code|test}} bzw. Benutzer {{code|verw}}, Passwort {{code|verw}}.<br />
<br />
Falls Sie in der Konfiguration den Parameter ''server_name'' mit einer in Ihrem Netzwerk gültigen IP-Adresse oder einem gültigen Namen belegt haben, können Sie auch von anderen Rechnern im Netzwerk auf eine EBKuS-Instanz zugreifen, z.B.:<br />
<br />
https://192.168.1.92/ebkus/demo/index.html https://192.168.1.92/ebkus/demo/cgi/do/login<br />
#(als {{code|root}}) Die Instanz in die Bootsequenz des Servers aufnehmen, so dass beim Hochfahren des Rechners der EBKuS-Server für die Instanz automatisch gestartet wird:<br />
cd /home/user/ebinst/ebkus/demo cp ebkus_demo /etc/init.d<br />
Die Links für die Run-Level manuell setzen oder, z.B. bei SuSE, den Run-Level-Editor verwenden.<br />
<br />
#In einer Produktionsinstanz die Anwendung einrichten, siehe Einrichtung der Anwendung im Handbuch.<br />
<br />
<br />
<br />
<br />
- Apache richtig löschen, so dass frische Konfig kommt:<br />
<br />
- sudo dpkg --purge --force-remove-reinstreq apache2.2-common<br />
<br />
So geht richtiges uninstall mit Konfiguration:<br />
apt-get remove ––purge *paketname*<br />
<br />
<br />
<br />
- download mit wget auf dem ubuntu server<br />
<br />
<br />
<br />
== Apache Konfiguration ==<br />
<br />
cd /etc/apache2/mods-enabled<br />
sudo ln -s ../mods-available/ssl.conf ssl.conf<br />
sudo ln -s ../mods-available/ssl.load ssl.load<br />
<br />
cd /etc/apache2/sites-enabled<br />
sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl<br />
http://ebkus.org/wiki/Linux_Installation#MySQL<br />
http://ebkus.org/wiki/Linux_Installation#Apache_2<br />
<br />
--></div>Ebkushttps://www.ebkus.org/wiki/HauptseiteHauptseite2015-02-13T13:13:22Z<p>Ebkus: </p>
<hr />
<div>== EBKuS-Dokumentation ==<br />
<br />
Auf diesem Wiki soll im Laufe der Zeit die gesamte EBKuS-Dokumentation erscheinen. <br />
<br />
Bis jetzt gibt es folgende Seiten:<br />
<br />
* [[Windows Installation]]<br />
* [[Linux Installation]]<br />
* [[Konfiguration]]<br />
* [[Zeitangaben (Fallbeginn, usw.)]]<br />
* [[Beratungskontakte]]<br />
<br />
<!--<br />
Was soll alles auf die Hauptseite?<br />
<br />
Ein Kasten mit allen entscheidenden Links:<br />
<br />
Download<br />
Demo<br />
Dokumentation<br />
System (evt: Systemadministration)<br />
Installation<br />
VM<br />
Wartung<br />
Updates<br />
Anwendungsbetreuung (evt: Fachadministration)<br />
Einrichtung<br />
Administration<br />
Anwenderhandbuch (evt: Anwendung)<br />
Entwicklung<br />
<br />
Glossar<br />
<br />
<br />
<br />
--></div>Ebkushttps://www.ebkus.org/wiki/BeratungskontakteBeratungskontakte2015-02-13T13:13:15Z<p>Ebkus: </p>
<hr />
<div>drei Varianten:<br />
* keine Beratungskontakte<br />
* Standardberatungskontakte<br />
* Beratungskontakte Braunschweig<br />
<br />
zwei Konfigurationsvariablen.<br />
<br />
Es sollte von Anfang an nur eine Variante gewählt und dann auch<br />
beibehalten werden!<br />
<br />
=== Unterschied zwischen Standardberatungskontakte und Beratungskontakte Braunschweig ===<br />
<br />
* unterschiedliche Formulare zur Erfassung<br />
* unterschiedliche Konfiguration<br />
* unterschiedliche Daten in der Datenbank<br />
<br />
=== Auswertung Beratungskontaktzeiten ===<br />
<br />
Kommentar zur count-Methode in beratungskontakt.py:<br />
<br />
<pre><br />
Kontaktzeiten auszählen.<br />
Ergebnis ist abhängig von Berechtigungen:<br />
- verw: alle Mitarbeiter der spezifierten Stellen<br />
Summe über alle Mitarbeiter der spezifizierten Stellen<br />
- bearb: der Mitarbeiter selber<br />
<br />
Berechnung der Summen für einen Mitarbeiter:<br />
- es gelten grundsätzlich die Zeiten, die ein Mitarbeiter aufwendet,<br />
unabhängig davon, wieviele Klienten betroffen sind. Es wird also jede<br />
Zeile der Beratungskontakt-Tabelle, in der der Mitarbeiter aufgeführt ist,<br />
berücksichtigt.<br />
- Berechnung der Summe für die Beratungsstelle:<br />
es wird ebenso wie bei Mitarbeitern die Summe des Aufwandes der Beratungsstelle<br />
berechnet. Dh die Summe für die Stelle ist gleich der Summe aus allen<br />
Mitarbeitern.<br />
Der Aufwand pro Klient spielt hingegen keine Rolle.<br />
<br />
- Für beide Berechnungen gilt: Jede Zeile der Beratungskontakt-Tabelle geht so<br />
oft in die Summierung ein, wie die Anzahl der am Kontakt beteiligten Mitarbeiter.<br />
<br />
Daraus ergibt sich, dass die Aufwände unabhängig davon sind, wieviel Gruppenarbeit<br />
gemacht wird. <br />
<br />
Die pro Klient aufgewendete Zeit geht hingegen nur in die Bundesstatistik ein.<br />
Die Summe der Kontakte in der Bundesstatistik<br />
ist um so höher, je mehr Gruppenarbeit gemacht wird, bei gleichem Zeiteinsatz von<br />
Mitarbeitern.<br />
</pre><br />
<br />
Es werden nur Mitarbeiter berücksichtigt, die aktuell den Status<br />
'im Dienst' haben. Evt. ändern???<br />
<br />
=== Wie werden Beratungskontakte für die Bundesstatisik ausgewertet? ===<br />
<br />
=== Wie werden Beratungskontakte in der Fach- und Bundesstatistik ausgewertet? ===</div>Ebkushttps://www.ebkus.org/wiki/BeratungskontakteBeratungskontakte2015-02-13T13:03:03Z<p>Ebkus: </p>
<hr />
<div>drei Varianten:<br />
* keine Beratungskontakte<br />
* Standardberatungskontakte<br />
* Beratungskontakte Braunschweig<br />
<br />
zwei Konfigurationsvariablen.<br />
<br />
Es sollte von Anfang an nur eine Variante gewählt und dann auch<br />
beibehalten werden!<br />
<br />
=== Unterschied zwischen Standardberatungskontakte und Beratungskontakte Braunschweig ===<br />
<br />
* unterschiedliche Formulare zur Erfassung<br />
* unterschiedliche Konfiguration<br />
* unterschiedliche Daten in der Datenbank<br />
<br />
=== Auswertung Beratungskontaktzeiten ===<br />
<br />
Kommentar zur count-Methode in beratungskontakt.py:<br />
<br />
<pre><br />
Kontaktzeiten auszählen.<br />
Ergebnis ist abhängig von Berechtigungen:<br />
- verw: alle Mitarbeiter der spezifierten Stellen<br />
Summe über alle Mitarbeiter der spezifizierten Stellen<br />
- bearb: der Mitarbeiter selber<br />
<br />
Berechnung der Summen für einen Mitarbeiter:<br />
- es gelten grundsätzlich die Zeiten, die ein Mitarbeiter aufwendet,<br />
unabhängig davon, wieviele Klienten betroffen sind. Es wird also jede<br />
Zeile der Beratungskontakt-Tabelle, in der der Mitarbeiter aufgeführt ist,<br />
berücksichtigt.<br />
- Berechnung der Summe für die Beratungsstelle:<br />
es wird ebenso wie bei Mitarbeitern die Summe des Aufwandes der Beratungsstelle<br />
berechnet. Dh die Summe für die Stelle ist gleich der Summe aus allen<br />
Mitarbeitern.<br />
Der Aufwand pro Klient spielt hingegen keine Rolle.<br />
<br />
- Für beide Berechnungen gilt: Jede Zeile der Beratungskontakt-Tabelle geht so<br />
oft in die Summierung ein, wie die Anzahl der am Kontakt beteiligten Mitarbeiter.<br />
<br />
Daraus ergibt sich, dass die Aufwände unabhängig davon sind, wieviel Gruppenarbeit<br />
gemacht wird. <br />
<br />
Die pro Klient aufgewendete Zeit geht hingegen nur in die Bundesstatistik ein.<br />
Die Summe der Kontakte in der Bundesstatistik<br />
ist um so höher, je mehr Gruppenarbeit gemacht wird, bei gleichem Zeiteinsatz von<br />
Mitarbeitern.<br />
</pre><br />
<br />
=== Wie werden Beratungskontakte für die Bundesstatisik ausgewertet? ===<br />
<br />
=== Wie werden Beratungskontakte in der Fach- und Bundesstatistik ausgewertet? ===</div>Ebkushttps://www.ebkus.org/wiki/BeratungskontakteBeratungskontakte2015-02-13T13:00:32Z<p>Ebkus: Die Seite wurde neu angelegt: „drei Varianten: * keine Beratungskontakte * Standardberatungskontakte * Beratungskontakte Braunschweig zwei Konfigurationsvariablen. Es sollte von Anfang an nur…“</p>
<hr />
<div>drei Varianten:<br />
* keine Beratungskontakte<br />
* Standardberatungskontakte<br />
* Beratungskontakte Braunschweig<br />
<br />
zwei Konfigurationsvariablen.<br />
<br />
Es sollte von Anfang an nur eine Variante gewählt und dann auch<br />
beibehalten werden!<br />
<br />
=== Unterschied zwischen Standardberatungskontakte und Beratungskontakte Braunschweig ===<br />
<br />
* unterschiedliche Formulare zur Erfassung<br />
* unterschiedliche Konfiguration<br />
* unterschiedliche Daten in der Datenbank<br />
<br />
=== Auswertung Beratungskontaktzeiten ===<br />
<br />
Kommentar zur count-Methode in beratungskontakt.py:<br />
Kontaktzeiten auszählen.<br />
Ergebnis ist abhängig von Berechtigungen:<br />
- verw: alle Mitarbeiter der spezifierten Stellen<br />
Summe über alle Mitarbeiter der spezifizierten Stellen<br />
- bearb: der Mitarbeiter selber<br />
<br />
Berechnung der Summen für einen Mitarbeiter:<br />
- es gelten grundsätzlich die Zeiten, die ein Mitarbeiter aufwendet,<br />
unabhängig davon, wieviele Klienten betroffen sind. Es wird also jede<br />
Zeile der Beratungskontakt-Tabelle, in der der Mitarbeiter aufgeführt ist,<br />
berücksichtigt.<br />
- Berechnung der Summe für die Beratungsstelle:<br />
es wird ebenso wie bei Mitarbeitern die Summe des Aufwandes der Beratungsstelle<br />
berechnet. Dh die Summe für die Stelle ist gleich der Summe aus allen<br />
Mitarbeitern.<br />
Der Aufwand pro Klient spielt hingegen keine Rolle.<br />
<br />
- Für beide Berechnungen gilt: Jede Zeile der Beratungskontakt-Tabelle geht so<br />
oft in die Summierung ein, wie die Anzahl der am Kontakt beteiligten Mitarbeiter.<br />
<br />
Daraus ergibt sich, dass die Aufwände unabhängig davon sind, wieviel Gruppenarbeit<br />
gemacht wird. <br />
<br />
Die pro Klient aufgewendete Zeit geht hingegen nur in die Bundesstatistik ein.<br />
Die Summe der Kontakte in der Bundesstatistik<br />
ist um so höher, je mehr Gruppenarbeit gemacht wird, bei gleichem Zeiteinsatz von<br />
Mitarbeitern.<br />
<br />
<br />
=== Wie werden Beratungskontakte für die Bundesstatisik ausgewertet? ===<br />
<br />
=== Wie werden Beratungskontakte in der Fach- und Bundesstatistik ausgewertet? ===</div>Ebkushttps://www.ebkus.org/wiki/KonfigurationKonfiguration2014-07-03T14:28:36Z<p>Ebkus: </p>
<hr />
<div>Die zentrale Konfigurationsdatei für eine EBKuS-Installation ist eine Textdatei namens <code>ebkus.conf</code> und befindet sich im Homeverzeichnis ({{file|ebkus}} im Installationsverzeichnis).<br />
<br />
Als Ausgangspunkt für die eigene Konfiguration dient die vom Installationsskript {{code|install.py}} aus einer Vorlage generierte Konfigurationsdatei. Die meisten Parameter (= Konfigurationvariable) sind darin bereits korrekt gesetzt.<br />
<br />
<br />
== Aufbau von <code>ebkus.conf</code> ==<br />
<br />
Zeilen, die leer sind oder mit dem Kommentarzeichen <code>#</code> beginnen, werden ignoriert, z.B.:<br />
<br />
<pre>#ebkus_home: %(install_dir)s\ebkus</pre><br />
<br />
In diesem Fall hat der Parameter den in der Tabelle genannten Standardwert.<br />
<br />
Zeilen, die nur aus einem Namen in eckigen Klammern bestehen, leiten eine Sektion ein, z.B.:<br />
<br />
<pre>[apache]</pre><br />
Die übrigen Zeilen weisen einem Parameter einen Wert zu. Sie beginnen mit dem Namen des Parameters, gefolgt von einem Doppelpunkt, gefolgt von dem Wert. Vor oder nach dem Doppelpunkt können Leerzeichen stehen. Beispiel:<br />
<br />
<pre>install_dir: C:\ebkus_installation</pre><br />
Werte können eine Syntax enthalten, die es erlaubt, vorher definierte Parameter in einen aktuellen Wert einzubeziehen (''Parametersubstitution''), z.B.:<br />
<br />
<pre>ebkus_home: %(install_dir)s\ebkus</pre><br />
Hier wird der Wert von <code>install_dir</code> in den Wert von <code>ebkus_home</code> einbezogen. Das ist genauso, als ob man gleich<br />
<br />
<pre>ebkus_home: C:\ebkus_installation\ebkus</pre><br />
definiert hätte. <code>%(</code>''parameter''<code>)s</code> wird durch den Wert von ''parameter'' ersetzt.<br />
<br />
Jede gültige Konfigurationsdatei muss die folgenden Sektionen aufweisen:<br />
<br />
*<code>[DEFAULT]</code><br />
*<code>[ebkus]</code><br />
*<code>[apache]</code><br />
*<code>[openssl]</code><br />
*eine Sektion für jede Instanz: <code>[</code>''Instanzname''<code>]</code><br />
<br />
Die möglichen Parameter für jede Sektion sind in den folgenden Tabellen aufgeführt.<br />
<br />
Alle Parameter außer denen, die in den Tabelle rot markiert sind, haben einen Standardwert (manchmal auch ''Defaultwert'' genannt), der in der Tabelle in der Spalte Standardwert angegeben ist. Ein Parameter hat diesen Wert, wenn er in der Konfiguration fehlt oder auskommentiert ist.<br />
<br />
Wie man sieht, können Parametersubstitutionen auch bei Standardwerten stattfinden. Der Wert des notwendige Parameter ''install_dir'' findet dadurch Eingang in weitere Parameter (''ebkus_home'', ''instance_home''), ohne dass diese explizit in der Konfiguration aufgeführt sind.<br />
<br />
''Anmerkung zu den Tabellen'': In einigen Fällen ist der angegebene Parameter bzw. Standardwert aus layout-technischen Gründen auf mehrere Zeilen verteilt, obwohl er eigentlich ohne Leerzeichen hintereinanderweg in einer Zeile stehen müsste.<br />
<br />
Wir unterscheiden ''Systemparameter'' von ''fachlichen Parametern''. Erstere betreffen den technischen Betrieb von EBKuS und werden von den Systemadministratoren (IT) bei der Installation eingerichtet. Fachparameter können ebenso wie Systemparameter in der {{file|ebkus.conf}} in der Instanzsektion gesetzt werden, außerdem kann aber auch der Anwendungsbetreuer über {{pfad2|Administratorhauptmenü|Allgemeine Konfiguration}} weitere Veränderungen vornehmen. Die vom Anwendungsbetreuer vorgenommenen Änderungen haben stets Vorrang über den Angaben in der {{file|ebkus.conf}}.<br />
<br />
<br />
== Systemparameter ==<br />
<br />
=== <nowiki>[DEFAULT]</nowiki> ===<br />
<br />
Die generierte Konfigurationsdatei enthält die korrekten Werte.<br />
<br />
Der Parameter {{konfig|install_dir}} bezeichnet das Installationsverzeichnis und muss immer in der Konfiguration definiert werden. Es bildet den Bezugspunkt für alle weiteren Pfade. Standardmäßig ist {{konfig|ebkus_home}} das Verzeichnis <code>ebkus</code> im Installationsverzeichnis; das sollte nicht verändert werden.<br />
<br />
Die in der Sektion <code>[DEFAULT]</code> definierten Parameter können in allen anderen Sektionen im Rahmen der Parametersubstitution als Teil eine Wertes verwendet werden (z.B. in der Definition von {{konfig|instance_home}}). Ansonsten stehen nur die Parameter derselben Sektion zur Verfügung.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|install_dir}}<br />
|style="background-color:orangered;"|{{code|}}<br />
|Installationsverzeichnis<br />
|-<br />
|{{konfig|ebkus_home}}<br />
|{{konfig|install_dir}}/ebkus<br />
|Homeverzeichnis<br />
|}<br />
<br />
<br />
=== <nowiki>[ebkus]</nowiki> ===<br />
<br />
Die generierte Konfigurationsdatei enthält in der Regel die korrekten Werte.<br />
<br />
Die {{konfig|database_admin_*}}-Parameter erlauben den Installationsskripten, neue Datenbanken für Instanzen einzurichten und diese bei der Deinstallation auch wieder zu entfernen.<br />
<br />
Falls aus Sicherheitsgründen erwünscht, kann hier ein Passwort für den Administratorzugriff auf MySQL eingetragen werden. Geschieht dies unter Windows vor der automatischen Installation von MySQL, wird bei der automatischen Installation der Administratorzugriff mit diesem Passwort eingerichtet.<br />
<br />
Falls das Passwort für den Administratorzugriff nicht im Klartext in der Konfigurationsdatei stehen soll, kann stattdessen <code>ASK</code>eingetragen werden. Dann fragen alle Skripte, die den Administratorzugriff benötigen, interaktiv nach dem Passwort, ohne es irgendwo zu speichern.<br />
<br />
Da MySQL standardmäßig nur von dem lokalen Rechner erreichbar ist, und dieser ohnehin nur für dem Administrator zugänglich ist, ist die zusätzliche Absicherung durch ein Passwort oft nicht nötig.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|download_dir}}<br />
|{{konfig|install_dir}}/download<br />
|Downloadverzeichnis. Dort steht die zu installierende Software, die im Bedarfsfall heruntergeladen wird.<br />
|-<br />
|{{konfig|database_admin_host}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer des Rechners, auf dem MySQL läuft. Muss angegeben werden, wenn das nicht der lokale Rechner ist.<br />
|-<br />
|{{konfig|database_admin_user}}<br />
|{{code|root}}<br />
|MySQL-Benutzer mit Administratorrechten<br />
|-<br />
|{{konfig|database_admin_password}}<br />
|{{code|}}<br />
|Dessen Passwort. Wenn hier ``ASK`` steht, wird das Passwort bei Bedarf interaktiv abgefragt.<br />
<br />
|-<br />
|{{konfig|mysql_dir}}<br />
|{{code|}}<br />
|Verzeichnis, in dem die MySQL-Programme mysql, mysqldump, etc. stehen. Muss angegeben werden, wenn MySQL-Programme nicht im Pfad stehen.<br />
<br />
|-<br />
|{{konfig|python_executable}}<br />
|<br />
|Vollständiger Pfad des Python-Executable, mit dem EBKuS ausgeführt wird<br />
|}<br />
<br />
<br />
=== <nowiki>[apache]</nowiki> ===<br />
<br />
Für den Parameter {{konfig|server_name}} muss unbedingt der Name oder die IP-Nummer des Rechners eingetragen werden, auf dem der Apache-Webserver läuft. Die generierte Konfigurationsdatei setzt den Standardwert <code>localhost</code>, womit EBKuS nur auf dem lokalen Rechner zugänglich ist.<br />
<br />
Für den Parameter {{konfig|server_admin}} sollte eine sinnvolle Email-Adresse eingetragen werden. Sie taucht in Apache-Fehlermeldungen auf (die allerdings normalerweise nicht vorkommen sollten).<br />
<br />
Alle übrigen Werte können in der Regel von der generierten Konfigurationsdatei übernommen werden.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|apache_log_dir}}<br />
|{{konfig|ebkus_home}}/log<br />
|Verzeichnis, in dem der Apache-Webserver Log-Dateien anlegt<br />
|-<br />
|{{konfig|server_admin}}<br />
|{{code|admin@localhost}}<br />
|Email-Adresse des Serveradministrators, die auf evt. Fehlerseiten des Servers erscheint.<br />
<br />
|-<br />
|{{konfig|server_name}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer des Rechners, auf dem der Apache-Webserver läuft.<br />
**Muss** explizit eingetragen werden, sonst kann EBKuS nur auf dem lokalen Rechner verwendet werden!<br />
<br />
|-<br />
|{{konfig|server_https_port}}<br />
|{{code|443}}<br />
|Port für verschlüsselte Verbindungen. Die EBKuS-Anwendung wird ausschließlich über diesen Port abgewickelt. Wenn der Standardport {{code|443}} nicht zur Verfügung steht, kann hier ein alternativer Port angegeben werden. Dieser muss dann als Teil der URL aufgeführt werden, z.B. für den Alternativport {{code|500}}: {{code|<nowiki>https://192.168.1.73:500/ebkus/demo/</nowiki>}}.<br />
<br />
|-<br />
|{{konfig|server_https_port}}<br />
|{{code|80}}<br />
|Port für unverschlüsselte Verbindungen. Die EBKuS-Anwendung verwendet diesen Port nicht. Dient nur zur Kontrolle des Apache Webservers: {{code|<nowiki>http://localhost/</nowiki>}} liefert "It works!". Wird hier der Port {{code|8080}} angegeben, müsste man {{code|<nowiki>http://localhost:8080/</nowiki>}} schreiben.<br />
<br />
|-<br />
|{{konfig|ssl_certificate_file}}<br />
|{{konfig|ebkus_home}}/ebkus_ssl_certificates/ebkusserver.cert<br />
|Vollständiger Pfad der SSL-Zertifikat-Datei<br />
<br />
<br />
|-<br />
|{{konfig|ssl_certificate_key_file}}<br />
|{{konfig|ebkus_home}}/ebkus_ssl_certificates/ebkusserver.key<br />
|Vollständiger Pfad der SSL-Schlüssel-Datei<br />
|}<br />
<br />
<br />
=== <nowiki>[openssl]</nowiki> ===<br />
<br />
Die Anwendung ist voll funktionsfähig mit den Werten aus der generierten Konfigurationsdatei; es empfiehlt sich jedoch, die organisatorischen Angaben für das SSL-Zertifikat anzupassen.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|openssl_executable}}<br />
|{{code|openssl}}<br />
|Falls openssl nicht im Pfad steht, muss der hier der vollständige Pfad zum Executable stehen<br />
<br />
|-<br />
|{{konfig|output_password}}<br />
|{{code|polo}}<br />
|Wird zur automatischen Zertifikatgenerierung benötigt<br />
<br />
|-<br />
|{{konfig|staat}}<br />
|{{code|DE}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|-<br />
|{{konfig|land}}<br />
|{{code|Berlin}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|-<br />
|{{konfig|ort}}<br />
|{{code|Berlin}}<br />
|Erscheint im SSL-Zertifikat<br />
|-<br />
|{{konfig|organisation}}<br />
|{{code|EFB}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|-<br />
|{{konfig|organisationseinheit}}<br />
|{{code|EFB}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|}<br />
<br />
<br />
=== <nowiki>[</nowiki>''Instanz''<nowiki>]</nowiki> ===<br />
<br />
<br />
Im Rahmen einer EBKuS-Installation auf einem Server können mehrere Instanzen einer EBKuS-Anwendung eingerichtet werden. Jede Instanz<br />
<br />
*hat einen Namen ({{konfig|instance_name}})<br />
*ist über eine eigene URL ansprechbar (<code>https://</code>'''server_name'''<code>/ebkus/</code>'''instance_name'''<code>/index.html</code>)<br />
*hat eine eigene Datenbank im Rahmen einer MySQL-Installation ({{konfig|database_name}}, {{konfig|database_user}}, {{konfig|database_password}})<br />
*hat ein eigenes Verzeichnis ({{konfig|instance_home}})<br />
*hat einen eigenen EBKuS-Server, der vom Apache-Webserver über eine eigene Portnummer angesprochen wird ({{konfig|port}})<br />
*hat eine eigene Log-Datei ({{konfig|log_file}})<br />
<br />
<br />
Für jede gewünschte Instanz wird eine Sektion in der Konfigurationsdatei angelegt. Die Sektionsüberschrift wird aus dem Namen der Instanz in eckigen Klammern gebildet. Der Name sollte mit einem Buchstaben beginnen und ansonsten nur Buchstaben, Ziffern und Unterstriche (<code>_</code>) enthalten (keine Leerzeichen!). Ein zusätzlicher Name für die Instanz ohne diese Einschränkung lässt sich über den Parameter {{konfig|instance_title}} einrichten (siehe unten).<br />
<br />
Falls der Instanzname mit <code>demo</code> beginnt, werden bei der Installation der Datenbank automatisch Demodaten erzeugt. Neben dem Benutzer <code>Admin</code> (Passwort: <code>Admin</code>) gibt es dann auch den Benutzer <code>test</code> (Passwort: <code>test</code>) und <code>verw</code>(Passwort: <code>verw</code>).<br />
<br />
Jede Sektion kann die in der Tabelle aufgeführten Parameter definieren. Erforderlich ist Wiederholung des Instanznamen als Wert von {{konfig|instance_name}}, ferner die Angabe einer eigenen, eindeutigen Portnummer, {{konfig|port}}. Für alle anderen Parameter können die Standardwerte genommen werden.<br />
<br />
Natürlich muss man {{konfig|berliner_version}} auf <code>true</code> setzen, wenn man die Berliner Version mit Berliner Straßenkatalog haben möchte; EBKuS-spezifische Fehlermeldungen sollten außerdem eine sinnvolle Telefonnummer bzw. Email-Adresse des Anwendungsbetreuers haben ({{konfig|admin_tel}}, {{konfig|admin_email}}).<br />
<br />
Die Parameter {{konfig|host}} und {{konfig|database_host}} müssen nur dann angepasst werden, wenn der EBKuS-Server bzw. die MySQL-Datenbank nicht auf demselben Rechner laufen wie der Apache-Webserver.<br />
<br />
Die bei der Installation generierte Konfigurationsdatei definiert vier Instanzen (2 davon auskommentiert):<br />
<br />
*<code>demo</code>: Demodaten, kein Straßenkatalog<br />
*<code>muster_efb</code>: keine Demodaten, kein Straßenkatalog. Beispiel für eine Produktionsinstanz, die vom Anwendungsbetreuer eingerichtet werden muss (siehe Einrichtung der Anwendung im Handbuch).<br />
<br />
Auskommentiert:<br />
*<code>demo_berlin</code>: Demodaten, Berliner Straßenkatalog (kleiner Ausschnitt, nur Straßen, deren Namen mit 'K' beginnen)<br />
*<code>demo_braunschweig</code>: Demodaten, Straßenkatalog mit Straßen aus Braunschweig, Gifhorn, Wolfenbüttel und Wolfsburg.<br />
<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
<br />
<br />
|-<br />
|{{konfig|instance_name}}<br />
|style="background-color:orangered;"|{{code|}}<br />
|Name der Instanz. Muss angegeben werden und dem Namen des Abschnitts (in eckigen Klammern) identisch sein. Darf keine Sonderzeichen außer den Unterstrich ('_') enthalten.<br />
<br />
<br />
|-<br />
|{{konfig|instance_home}}<br />
|{{konfig|ebkus_home}}/{{konfig|instance_name}}<br />
|Instanzverzeichnis. Liegt im Homeverzeichnis. Sollte nicht verändert werden.<br />
<br />
|-<br />
|{{konfig|initial_content}}<br />
|{{code|}}<br />
|Hier kann eine Datei angegeben werden, mit der die Instanzdatenbank initialisiert werden kann. Diese Datei wird immer dann geladen, wenn bei der Installation der Instanz ({{code|install.py}} oder {{code|configure.py}}) keine funktionierende Datenbank für die Instanz vorgefunden wird. Wenn keine Datei angegeben ist, wird eine neue Datenbank mit dem Merkmalskatalog ({{file|sql/merkmale_standard.py}}) und evt. einem Straßenkatalog erstellt. Wenn kein vollständiger Pfad für die Datei angegeben wird, muss die Datei im Homeverzeichnis liegen. Zulässige Dateien sind die mit dem Skript {{code|datenbank_sichern.py}} erzeugte Dateien sowie sonstige passende SQL-Dumps.<br />
<br />
|-<br />
|{{konfig|berliner_version}}<br />
|{{code|false}}<br />
|Wenn hier {{code|true}} steht, wird die Berliner EBKuS-Version verwendet mit Berliner Straßenkatalog. <br />
<br />
|-<br />
|{{konfig|database_host}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer, auf dem der Datenbankserver läuft.<br />
<br />
|-<br />
|{{konfig|database_name}}<br />
|{{konfig|instance_name}}<br />
|Name der Instanzdatenbank<br />
<br />
<br />
|-<br />
|{{konfig|database_user}}<br />
|{{konfig|instance_name}}<br />
|Benutzername der Instanzdatenbank<br />
<br />
|-<br />
|{{konfig|database_password}}<br />
|{{konfig|instance_name}}<br />
|Passwort der Instanzdatenbank<br />
<br />
<br />
|-<br />
|{{konfig|gemeindeschluessel_von_plz}}<br />
|{{code|}}<br />
|Definiert die Teilmenge der amtlichen Gemeindeschlüssel für die Bundesstatistik. Im Normalfall muss hier nichts eingetragen werden.<br />
<br /><br />
In der Bundesstatistik soll der amtliche Gemeindeschlüssel für den Wohnort des Klienten eingetragen werden, wenn der Wohnort des Klienten außerhalb des Kreises der Beratungsstelle liegt. Um die Menge der Daten zu begrenzen, kann hier über die Anfangsziffern der Postleitzahl eine Teilmenge definiert werden. Wenn mehrere Ziffernfolgen angegeben werden, müssen diese mit <code>;</code> getrennt werden.<br /><br /> Beispiele: <ul> <li>Alle Gemeindeschlüssel verwenden, außer die Postleitzahl der Gemeinde beginnt mit '9': <pre> 0;1;2;3;4;5;6;7;8 </pre> </li> <li>Große Teile Niedersachsens: <pre> 29;30;31;37;38 </pre> </li> <li>Nördliches Niedersachsen und Schleswig Holstein: <pre> 2 </pre> </li> <li>Berlin und Umgebung: <pre> 10;12;13;14;15;16 </pre> </li> <li>Bleibt die Variable leer, werden alle Gemeindeschlüssel verwendet. </li> </ul> Wenn es bei der Erkennung von Gemeindeschluesseln zu vielen Fehlern kommt, beispielsweise wegen unterschiedlicher Schreibweisen von Orten, kann man selber eine Datei <code>EBKUS_HOME/sql/gemeindeschluessel.csv</code> erstellen, bestehend aus einer Tabelle mit den Spalten <code>plz, ort ags</code>. Als Vorlage kann die Datei <code>EBKUS_HOME/sql/gemeindeschluessel_cache.csv</code> dienen, die automatisch erzeugt wird, wenn die Konfigurationsvariable <code>gemeindeschluessel_von_plz</code> einen Wert hat. <br />
|-<br />
|{{konfig|host}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer des Rechners, auf der EBKuS-Server der Instanz läuft.<br />
<br />
<br />
|-<br />
|{{konfig|keine_bundesstatistik}}<br />
|{{code|false}}<br />
|Falls hier {{code|true}} steht, wird die Bundesstatistik aus der Anwendung ausgeblendet. Es kann keine Bundesstatistik ausgefüllt werden und steht auch nicht für Statistik und Export zur Verfügung.<br />
<br />
|-<br />
|{{konfig|log_file}}<br />
|{{konfig|instance_home}}{{code|/}}{{konfig|instance_name}}{{code|.log}}<br />
|Name der Datei, in die der EBKuS-Server Meldungen schreibt<br />
<br />
|-<br />
|{{konfig|log_level}}<br />
|{{code|INFO}}<br />
|Legt fest, wie "geschwätzig" der EBKuS-Server ist. Muss einer der folgenden Werte sein, in aufsteigender Wortfülle: {{code|CRITICAL, ERROR, WARNING, INFO, DEBUG}} ({{code|DEBUG}} ist nur für die Fehlersuche geeignet, da sehr viel ausgegeben wird.)<br />
<br />
|-<br />
|{{konfig|port}}<br />
|style="background-color:orangered;"|{{code|}}<br />
|Portnummer über die der EBKuS-Server angesprochen wird. Muss angegeben werden. Jede Instanz muss eine unterschiedliche Portnummer erhalten.<br />
|}<br />
<br />
<br />
==== Konfiguration für externe Anwendungen ====<br />
<br />
Die folgenden Konfigurationsvariablen bewirken, dass auf der Klientenkarte ein Kasten mit maximal vier Buttons erscheint, die in einem neuen Tab/Fenster eine URL aufrufen, die Felder des aktuellen (letzten) Falles bzw. des angemeldeten Mitarbeiters als Bestandteile haben kann:<br />
# Kein Kasten, wenn diese Variable keinen Wert hat.<br />
extern_fieldset_label: Externe Anwendung<br />
# Position auf der Klientenkarte<br />
extern_fieldset_position: 6<br />
# Maximal vier Buttons, für jeden eine Bezeichnung und eine Url.<br />
# Ein Button kommt nur zustande, wenn sowohl Label als auch Url<br />
# einen Wert haben. <br />
extern_button1_label: GoogleWeb<br />
extern_button1_url: <nowiki>http://www.google.com/search?q=$$fall_id$$_$$fall_akte__ort$$</nowiki><br />
extern_button2_label: GoogleMaps<br />
extern_button2_url: <nowiki>http://www.google.com/maps?q=$$mitarbeiter_na$$</nowiki><br />
extern_button3_label: GoogleImages<br />
extern_button3_url: <nowiki>http://www.google.com/images?q=$$fall_akte__ort$$</nowiki><br />
extern_button4_label: GoogleNews<br />
extern_button4_url: http://www.google.com/news?q=$$fall_fn$$</nowiki><br />
<br />
Urls können Abschnitte der folgenden Form enthalten:<br />
{{code|$$<fall oder mitarbeiter>_<feld>$$}}<br />
Der ganze Abschnitt wird durch den Wert von {{code|<feld>}} ersetzt, <br />
wobei entweder im Fall-Objekt oder im Mitarbeiter-Objekt <br />
nachgeschlagen wird. <br />
Beispiele:<br />
{{code|$$fall_id$$}}, {{code|$$mitarbeiter_na$$}}, {{code|$$fall_akte__ort$$}}<br />
<br />
Im Beispiel oben werden als externe Anwendungen verschiedene Google-Dienst aufgerufen, wobei als Parameter Daten aus dem aktuellen Fall übergeben werden.<br />
(Das Beispiel ist nicht sinnvoll und dient nur der Illustration des Mechanismus.)<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|extern_fieldset_label}}<br />
|{{code|}}<br />
|Bezeichnung für den Kasten mit den Buttons für die externen Anwendungen<br />
<br />
|-<br />
|{{konfig|extern_fieldset_position}}<br />
|{{code|2}}<br />
|Position auf der Klientenkarte (Gezählt werden die umrandeten Kästen mit einer Bezeichnung: Klientendaten, Bezugspersonen, Leistungen, etc.)<br />
|-<br />
|{{konfig|extern_buttonX_label}}<br />
|{{code|}}<br />
|Name der externen Anwendung<br />
<br />
<br />
|-<br />
|{{konfig|extern_buttonX_url}}<br />
|{{code|}}<br />
|URL der externen Anwendung mit Platzhaltern für die zu übernehmenden Parameter<br />
<br />
|}<br />
<br />
{{konfig|X}} kann 1,2,3 oder 4 sein.<br />
<br />
<br />
== Fachliche Parameter ==<br />
<br />
Die hier beschriebenen Einstellungen können auch vom Anwendungsbetreuer über {{pfad2|Administratorhauptmenü|Allgemeine Konfiguration}} vorgenommen werden.<br />
<br />
<br />
=== <nowiki>[</nowiki>''Instanz''<nowiki>]</nowiki> ===<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|admin_email}}<br />
|{{code|Keine Angabe}}<br />
|Email-Adresse des Anwendungsbetreuers.<br />
<br />
Wird in Fehlermeldungen genannt.<br />
|-<br />
|{{konfig|admin_name}}<br />
|{{code|Keine Angabe}}<br />
|Name des Anwendungsbetreuers.<br />
<br />
Wird in Fehlermeldungen genannt.<br />
|-<br />
|{{konfig|admin_tel}}<br />
|{{code|Keine Angabe}}<br />
|Telefonnummer des Anwendungsbetreuers.<br />
<br />
Wird in Fehlermeldungen genannt.<br />
|-<br />
|{{konfig|anmeldungsdaten_}} {{konfig|obligatorisch}}<br />
|{{code|false}}<br />
|Falls <code>true</code> werden die Anmeldungsdaten obligatorisch im Aufnahmeformular erhoben anstatt optional in einer getrennten Maske.<br />
<br />
Die entsprechenden Pflichfelder sind dabei auszufüllen. Eine spätere Bearbeitung der Anmeldungsdaten erfolgt wie bisher in einer eigenständigen Maske (analog der späteren Bearbeitung einer Leistung).<br />
|-<br />
|{{konfig|anmeldeprobleme_und_}} {{konfig|beschaeftigung_bei_}}{{konfig|anmeldung_erfassen}}<br />
|{{code|false}}<br />
|Falls <code>true</code> werden Probleme bei der Anmeldung und Beschäftigung schon bei der Anmeldung erfasst und später für die Fachstatistik übernommen.<br />
<br />
Die Auswahlfelder 'Beschäftigung Jugendliche(r)', 'Beschäftigungsverhältnis Mutter', 'Beschäftigungsverhältnis Vater' und das Mehrfachauswahlfeld 'Problem(e) bei der Anmeldung' aus der Fachstatistik werden in den Kasten Anmeldekontakt als Pflichtfelder aufgenommen. Es ist jedoch in jedem Fall möglich 'Keine Angabe' auszuwählen (genau wie in der Fachstatistik selbst). Die Daten werden mit dem Fall (nicht mit der Akte bzw. den Stammdaten) gespeichert. Wenn eine Fachstatistik angelegt wird, werden die Daten übernommen.<br />
|-<br />
|{{konfig|beratungskontakte}}<br />
|{{code|false}}<br />
|Falls <code>true</code> können in der Klientenakte einzelne Beratungskontakte eingetragen werden. Die Summen werden in die Bundesstatistik und in die Fachstatistik als Vorgabe übernommen.<br />
|-<br />
|{{konfig|beratungskontakte_bs}}<br />
|{{code|false}}<br />
|Falls <code>true</code> treten Anpassungen speziell für Braunschweig in Kraft.<br />
<br />
Die Variable <code>beratungskontakte</code> muss ebenfalls auf <code>true</code> stehen.<br />
|-<br />
|{{konfig|cache_on}}<br />
|{{code|true}}<br />
|Falls <code>true</code> wird der Objektcache eingeschaltet, sonst bleibt er abgeschaltet.<br />
<br />
Normalerweise ist der Cache an, aber es kann in seltenen Fällen zu Fehlern kommen, die verschwinden, wenn er abgeschaltet wird. Auf die inhaltlichen Abläufe hat das keine Auswirkungen, <br />
allenfalls auf die Performance.<br />
|-????<br />
|{{konfig|erinnern_nach_wochen_ohne_kontakt}}<br />
|{{code|0}}<br />
|Anzahl der Wochen ohne Kontakt nach der ein offener Fall in die Erinnerungsfunktion aufgenommen wird.<br />
<br />
Wenn hier eine Zahl zwischen 1 und 99 steht, wird die Erinnerungsfunktion aktiviert. Auf einem zusätzlichen Button im Hauptmenü steht dann die Anzahl der offenen Fälle, mit denen es länger als die angegebene Anzahl von Wochen keinen Kontakt gegeben hat. Nach dem Betätigen des Buttons erscheint eine Liste dieser Fälle. Jeder Fall kann als erledigt markiert werden, worauf er künftig normalerweiser nicht mehr in der Liste erscheint. Für die gesamte Liste gibt es aber eine Option, alle Fälle einschließlich der erledigten anzuzeigen. Die 'Erledigt'-Markierung kann dann auch wieder rückgängig gemacht werden.<br />
<br />
Es muss hier die Ziffer 0 stehen, wenn die Erinnerungsfunktion deaktiviert bleiben soll.<br />
|-<br />
|{{konfig|fachstatistik_akte_}} {{konfig|diskrepanz_nicht_zulassen}}<br />
|{{code|false}}<br />
|Falls <code>true</code> werden Diskrepanzen zwischen Fachstatistik und Akte nicht zugelassen.<br />
<br />
Die entsprechenden Items in der Fachstatistik zeigen die Werte aus der Akte und sind nicht modifizierbar. Eine Diskrepanz kann so gar nicht entstehen. Allerdings muss bei Änderungen in der Akte die Fachstatistik neu abgespeichert werden, damit die Änderungen übernommen und für die Statistik wirksam werden.<br /> Betroffen sind nur die Items 'Familienstatus', 'Empfohlen von' und 'Erbrachte Leistungen in der Fachstatistik', deren Werte im Normalfall aus der Akte vorbelegt werden.<br />
|-<br />
|{{konfig|fallunabhaengige}} {{konfig|_aktivitaeten_bs}}<br />
|{{code|false}}<br />
|Falls <code>true</code> können fallunabhängige Aktivitäten eingetragen und ausgewertet werden. Speziell für Braunschweig. <br />
|-<br />
|{{konfig|fallbeginn_bei_}}{{konfig|erster_leistung}}<br />
|{{code|false}}<br />
|Bei Neumelde- und Abschlusszahlen sowie Klienten pro Mitarbeiter wird der Fallbeginn ab dem Datum der erste Leistung definiert anstatt ab dem Anmeldedatum.<br />
|-<br />
|{{konfig|fallbeginn_waehlbar}}<br />
|{{code|false}}<br />
|Bei Neumelde- und Abschlusszahlen sowie Klienten pro Mitarbeiter kann ein Häkchen gesetzt werden, um den Fallbeginn ab erster Leistung zu definieren.<br />
|-<br />
|{{konfig|instance_title}}<br />
|{{konfig|instance_name}}<br />
|Langname für die Instanz.<br />
<br />
Erscheint bei der Anmeldung und in der Statuszeile.<br />
|-<br />
|{{konfig|jgh_gemeindeschluessel}}<br />
|{{code|}}<br />
|Die letzten drei Ziffern des [http://de.wikipedia.org/wiki/Amtlicher_Gemeindeschl%C3%BCssel Amtlichen Gemeindeschlüssels] oder das Wort "blank".<br />
<br />
Standardmäßig setzt EBKuS für diese drei Ziffern (Spalte 7-9 des Exportdatensatzes) drei mal die Ziffer 0 ein. Unseres Wissens werden diese Daten für die<br />
Bundesstatistik allerdings nicht ausgewertet. Bei Bedarf kann hier das Wort "blank" angegeben werden, dann erscheinen im Datensatz drei Leerzeichen, oder es können drei Ziffern<br />
eingegeben werden, die dann in den Datensatz eingefügt werden.<br />
|-<br />
|{{konfig|leistungsende_in_}}<br />
{{konfig|zukunft_erlaubt}}<br />
|{{code|false}}<br />
|Beim Eintrag einer Leistung darf für das Ende ein Datum, das in der Zukunft liegt, eingetragen werden.<br />
<br />
Der Abschluss des Falls ist erst möglich, wenn alle Leistungen beendet sind.<br />
|-<br />
|{{konfig|loeschfrist}}<br />
|{{code|36}}<br />
|Löschfrist in Monaten.<br />
<br />
Akten, die älter sind, können vom Administrator gelöscht werden.<br />
|-<br />
|{{konfig|log_query_laenger_als}}<br />
|{{code|0}}<br />
|Falls größer 0, Datenbankqueries in die Logdatei schreiben, die länger dauern als die angegeben Zahl in Millisekunden.<br />
<br />
Wenn 0 eingetragen wird, werden keine Datenbankqueries protokolliert. Alle Datenbankqueries können mit <code>log_level=DEBUG</code> erfasst werden. Nützlich zur Diagnose von Performanceproblemen.<br />
|-<br />
|{{konfig|meldung_vom_admin}}<br />
|{{code|}}<br />
|Inhalt wird als Meldung vom Administrator unübersehbar auf jeder EBKuS-Seite über der Statuszeile ausgegeben.<br />
<br />
Damit kann der Administrator Meldungen an alle aktiven EBKuS-Nutzer ausgeben, z.B. um einen Ausfall von EBKuS wegen Wartungsarbeiten anzukündigen. <br />
|-<br />
|{{konfig|neumeldungen_nach_region}}<br />
|{{code|}}<br />
|Definiert eine Tabelle ''Neumeldungen nach Region'' unter ''Neumelde- und Abschlusszahlen''.<br />
<br />
Die Regionen, für die in der Tabelle die Neumeldungen ausgezählt werden sollen, müssen unter {{pfad4|Hauptmenü|Statistikabfrage|Teilmenge|Neu}} als Teilmengendefinitionen eingeführt werden. Der Namen der gewünschten Definitionen werden durch <code>;</code> getrennt aufgeführt. <br /><br /> Beispiel: <ul> <li> <pre> Gifhorn und Samtgemeinde Meinersen; Braunschweig 38120 und 38112 </pre> </li> </ul> "Gifhorn und Samtgemeinde Meinersen" ist eine Teilmengendefinition mit der Definition: <code>( ort = 'Gifhorn' ODER samtgemeinde = 'Meinersen' )</code>. "Braunschweig 38120 und 38112" ist eine Teilmengendefinition mit der Definition: <code>( ort = 'Braunschweig' UND plz = '38112' oder '38120' )</code>. <br /><br /> <br />
|-<br />
|{{konfig|session_time}}<br />
|{{code|120}}<br />
|Länge einer Session in Minuten. <br />
<br />
Nach dieser Zeit wird ein Benutzer automatisch abgemeldet, wenn er keine Eingaben mehr macht.<br />
|-<br />
|{{konfig|sql_abfrage}}<br />
|{{code|false}}<br />
|Falls <code>true</code> steht die Maske zum Absetzen von SQL-Abfragen vom Administrationsmenü aus zur Verfügung. <br />
<br />
|-<br />
|{{konfig|strassenkatalog}}<br />
|{{code|}}<br />
|Falls diese Variable nicht leer ist, wird bei der Adresseingabe der Straßenkatalog verwendet.<br />
<br />
Der eigentliche Wert der Variable spielt nur bei der Erstinstallation der Instanz eine Rolle.<br />Eine Instanz ohne Straßenkatalog kann auch später noch für die Verwendung mit Straßenkatalog eingerichtet werden, indem der Straßenkatalog über {{pfad2|Administratorhauptmenü|Straßenkatalog importieren}} importiert wird und der Variable {{konfig|strassenkatalog}} ein beliebiger Wert zugewiesen wird, beispielsweise der Ortsname.<br />
|-<br />
|{{konfig|strassenkatalog_}} {{konfig|vollstaendig}}<br />
|{{code|false}}<br />
|Falls <code>true</code> wird angenommen, dass der Straßenkatalog Einträge für jede einzelne Hausnummer enthält.<br />
<br />
Ansonsten wird angenommen, dass lediglich Einträge für ganze Straßen bzw. für bestimmte Intervalle von Hausnummern vorhanden sind.<br />
|-<br />
|{{konfig|strassensuche}}<br />
|{{code|}}<br />
|Bestimmt die Anzeige von Zusatzinformationen aus dem Straßenkatalog bei der Darstellung und Eingabe von Adressen.<br />
<br />
Zulässige Werte sind: <code>ort bezirk ortsteil samtgemeinde</code>.<br /><br /> Beispiele: <ul> <li>In Berlin gibt es nur einen Ort im Straßenkatalog, nämlich 'Berlin'. Das Feld <code>ort</code> ist daher nicht nötig. Ortsteil und Samtgemeinde haben im Straßenkatalog keine Werte, Bezirk allerdings schon. Der sinnvolle Wert für Berlin ist also <pre> bezirk </pre> </li> <li>In Gifhorn gibt es mehrere Orte im Straßenkatalog. Sowohl Ortsteile und Samtgemeinden spielen eine Rolle und sind im Straßenkatalog erfasst, Bezirke jedoch nicht. Der sinnvolle Wert hier ist also <pre> ort ortsteil samtgemeinde </pre> </li> <li>Wenn es nur einen Ort gibt und weder Bezirke, Ortsteile oder Samtgemeinden im Straßenkatalog erfasst sind, sollte die Variable leer bleiben. </ul> <br /><br />Irrelevant, wenn kein Straßenkatalog verwendet wird.<br />
|-<br />
|{{konfig|warnung_bei_fachstatistik_}} {{konfig|akte_diskrepanz}}<br />
|{{code|false}}<br />
|Falls <code>true</code> wird beim Speichern der Fachstatistik auf eine Diskrepanz zwischen Akte und Fachstatistik hingewiesen, falls vorhanden.<br />
<br />
Wenn man bei dem dann zur Verfügung stehendem Item "Diskrepanz zur Akte zulassen" ein Häkchen setzt, kann man trotzdem speichern.<br /> Betroffen sind nur die Items 'Familienstatus', 'Empfohlen von' und 'Erbrachte Leistungen in der Fachstatistik', deren Werte im Normalfall aus der Akte vorbelegt werden.<br />
|-<br />
|{{konfig|wiederaufnahmefrist}}<br />
|{{code|1}}<br />
|Anzahl der Monate, innerhalb derer ein abgeschlossener Fall wiederaufgenommen werden kann ("z.d.A. rückgängig").<br />
<br />
Danach muss ein neuer Fall angelegt werden.<br />
|-<br />
|{{konfig|wohnt_nicht_ausserhalb}}<br />
|{{code|}}<br />
|Definiert die Teilmenge der Adressen, die im Sinne der Bundesstatistik in die Zuständigkeit der Beratungsstelle fallen.<br />
<br />
Aufgrund der hier angegebenen Kriterien wird entschieden, ob der Klient in der Bundesstatistik als ausserhalb des Zuständigkeitsbereichs der Beratungsstelle wohnend angegeben wird. Als mögliche Kriterien kommen in Frage: <code>plz,ort,ortsteil,samtgemeinde,bezirk,plraum</code>. Die Kriterien <code>ortsteil,samtgemeinde,bezirk</code> sind nur sinnvoll, wenn ein Straßenkatalog verwendet wird und dieser auch entsprechende Angaben enthält. <br /><br /> Die Kriterien werden wie folgt in der angegebenen Reihenfolge abgearbeitet: <ul> <li>Wenn die Klientenadresse keinen Wert für das Kriterium aufweist, wird zum nächsten Kriterium übergegangen. </li> <li>Falls die Klientenadresse einen Wert hat und im Kriterium genannt wird, wohnt er nicht außerhalb. Ist der Wert im Kriterium nicht genannt, wohnt er außerhalb. In beiden Fällen werden die weiteren Kriterien nicht mehr betrachtet. </li> <li>Falls aufgrund fehlender Werte (oder fehlender Kriterien) kein Kriterium angewendet werden konnte, wird standardmäßig angenommen, dass der Klient nicht außerhalb wohnt. </li> </ul> Beispiele: <ul> <li> <pre> bezirk: Friedrichshain-Kreuzberg; ort: Berlin </pre> In Berlin enthalten alle mit dem Straßenkatalog abgeglichene Adressen einen Wert für den Bezirk. Da jede Beratungsstelle genau für einen Bezirk zuständig ist, kann auf dieser Basis entschieden werden. Falls eine Adresse nicht mit dem Straßenkatalog abgeglichen wurde, kann der Ort als Kriterium herangezogen werden, da in diesem Fall für Bezirk keine Angaben vorliegen. </li> <li> Falls kein Straßenkatalog verwendet wird, kann nur der Ort, die Postleitzahl oder evt. der Planungsraum (falls solche definiert sind und routinemäßig mit den Klientenadressen zusammen erfasst werden) als Kriterium verwendet werden, z.B. (fiktiv!): <pre> plz: 12345;23456;34567 </pre> Adressen mit diesen Postleitzahlen werden als nicht außerhalb wohnend betrachtet, alle anderen als außerhalb. Falls die Klientenadresse keine 5-stellige PLZ enthält, gilt der Wert als fehlend. Ungenauigkeiten werden in Kauf genommen, da die Region der Zuständigkeit nicht immer exakt mit den Regionen der Postleitzahlen übereinstimmt. </li> <li> <pre> samtgemeinde: Name1;Name2;Name3; plz: 12345;23456 </pre> Analog zum Berliner Beispiel würde hier auch zunächst das Kriterium Samtgemeinde versucht, das aber nur nach einem Abgleich mit dem Straßenkatalog bekannt ist. Für die nicht abgeglichenen Adressen wird dann die Postleitzahl herangezogen. In seltenen Fällen kann das zu Fehlern führen, da die Bereiche der Postleitzahlen manchmal nicht mit den Bereichen der Zuständigkeit exakt übereinstimmen. </li> </ul> Falls das Ergebnis "wohnt außerhalb" ist, wird automatisch ein entsprechender Eintrag in die Bundesstatistik vorgenommen, der beim Ausfüllen oben im Kasten "Falldaten" angezeigt wird. Wenn möglich wird der <strong>amtliche Gemeindeschlüssel</strong> eingetragen. Wenn dieser nicht gefunden wird, wird Postleitzahl und Wohnort angegeben. <br /><br /> <strong>Syntax</strong> wie in den Beispielen. Rund um die Trenner <code>;</code> und <code>:</code> dürfen Leerzeichen stehen. Es können auch mehrere Zeilen verwendet werden. <br /><br /> Unter (Berater-) {{pfad5|Hauptmenü|Statistik|Teilmenge|Neu|Neue Bedingung}}" finden Sie für jedes Kriterium die Menge der möglichen Werte. <br /><br /> Zur <strong>Testen</strong> gibt es unter {{pfad3|Aministratorhauptmenü|Bundesstatistik|Exportieren}} einen neuen Punkt ''Adressen außerhalb prüfen''. Sie können dort in einer Tabelle sehen, welche Adressen als außerhalb klassifiziert werden. <br />
|}</div>Ebkushttps://www.ebkus.org/wiki/KonfigurationKonfiguration2014-07-03T14:26:07Z<p>Ebkus: </p>
<hr />
<div>Die zentrale Konfigurationsdatei für eine EBKuS-Installation ist eine Textdatei namens <code>ebkus.conf</code> und befindet sich im Homeverzeichnis ({{file|ebkus}} im Installationsverzeichnis).<br />
<br />
Als Ausgangspunkt für die eigene Konfiguration dient die vom Installationsskript {{code|install.py}} aus einer Vorlage generierte Konfigurationsdatei. Die meisten Parameter (= Konfigurationvariable) sind darin bereits korrekt gesetzt.<br />
<br />
<br />
== Aufbau von <code>ebkus.conf</code> ==<br />
<br />
Zeilen, die leer sind oder mit dem Kommentarzeichen <code>#</code> beginnen, werden ignoriert, z.B.:<br />
<br />
<pre>#ebkus_home: %(install_dir)s\ebkus</pre><br />
<br />
In diesem Fall hat der Parameter den in der Tabelle genannten Standardwert.<br />
<br />
Zeilen, die nur aus einem Namen in eckigen Klammern bestehen, leiten eine Sektion ein, z.B.:<br />
<br />
<pre>[apache]</pre><br />
Die übrigen Zeilen weisen einem Parameter einen Wert zu. Sie beginnen mit dem Namen des Parameters, gefolgt von einem Doppelpunkt, gefolgt von dem Wert. Vor oder nach dem Doppelpunkt können Leerzeichen stehen. Beispiel:<br />
<br />
<pre>install_dir: C:\ebkus_installation</pre><br />
Werte können eine Syntax enthalten, die es erlaubt, vorher definierte Parameter in einen aktuellen Wert einzubeziehen (''Parametersubstitution''), z.B.:<br />
<br />
<pre>ebkus_home: %(install_dir)s\ebkus</pre><br />
Hier wird der Wert von <code>install_dir</code> in den Wert von <code>ebkus_home</code> einbezogen. Das ist genauso, als ob man gleich<br />
<br />
<pre>ebkus_home: C:\ebkus_installation\ebkus</pre><br />
definiert hätte. <code>%(</code>''parameter''<code>)s</code> wird durch den Wert von ''parameter'' ersetzt.<br />
<br />
Jede gültige Konfigurationsdatei muss die folgenden Sektionen aufweisen:<br />
<br />
*<code>[DEFAULT]</code><br />
*<code>[ebkus]</code><br />
*<code>[apache]</code><br />
*<code>[openssl]</code><br />
*eine Sektion für jede Instanz: <code>[</code>''Instanzname''<code>]</code><br />
<br />
Die möglichen Parameter für jede Sektion sind in den folgenden Tabellen aufgeführt.<br />
<br />
Alle Parameter außer denen, die in den Tabelle rot markiert sind, haben einen Standardwert (manchmal auch ''Defaultwert'' genannt), der in der Tabelle in der Spalte Standardwert angegeben ist. Ein Parameter hat diesen Wert, wenn er in der Konfiguration fehlt oder auskommentiert ist.<br />
<br />
Wie man sieht, können Parametersubstitutionen auch bei Standardwerten stattfinden. Der Wert des notwendige Parameter ''install_dir'' findet dadurch Eingang in weitere Parameter (''ebkus_home'', ''instance_home''), ohne dass diese explizit in der Konfiguration aufgeführt sind.<br />
<br />
''Anmerkung zu den Tabellen'': In einigen Fällen ist der angegebene Parameter bzw. Standardwert aus layout-technischen Gründen auf mehrere Zeilen verteilt, obwohl er eigentlich ohne Leerzeichen hintereinanderweg in einer Zeile stehen müsste.<br />
<br />
Wir unterscheiden ''Systemparameter'' von ''fachlichen Parametern''. Erstere betreffen den technischen Betrieb von EBKuS und werden von den Systemadministratoren (IT) bei der Installation eingerichtet. Fachparameter können ebenso wie Systemparameter in der {{file|ebkus.conf}} in der Instanzsektion gesetzt werden, außerdem kann aber auch der Anwendungsbetreuer über {{pfad2|Administratorhauptmenü|Allgemeine Konfiguration}} weitere Veränderungen vornehmen. Die vom Anwendungsbetreuer vorgenommenen Änderungen haben stets Vorrang über den Angaben in der {{file|ebkus.conf}}.<br />
<br />
<br />
== Systemparameter ==<br />
<br />
=== <nowiki>[DEFAULT]</nowiki> ===<br />
<br />
Die generierte Konfigurationsdatei enthält die korrekten Werte.<br />
<br />
Der Parameter {{konfig|install_dir}} bezeichnet das Installationsverzeichnis und muss immer in der Konfiguration definiert werden. Es bildet den Bezugspunkt für alle weiteren Pfade. Standardmäßig ist {{konfig|ebkus_home}} das Verzeichnis <code>ebkus</code> im Installationsverzeichnis; das sollte nicht verändert werden.<br />
<br />
Die in der Sektion <code>[DEFAULT]</code> definierten Parameter können in allen anderen Sektionen im Rahmen der Parametersubstitution als Teil eine Wertes verwendet werden (z.B. in der Definition von {{konfig|instance_home}}). Ansonsten stehen nur die Parameter derselben Sektion zur Verfügung.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|install_dir}}<br />
|style="background-color:orangered;"|{{code|}}<br />
|Installationsverzeichnis<br />
|-<br />
|{{konfig|ebkus_home}}<br />
|{{konfig|install_dir}}/ebkus<br />
|Homeverzeichnis<br />
|}<br />
<br />
<br />
=== <nowiki>[ebkus]</nowiki> ===<br />
<br />
Die generierte Konfigurationsdatei enthält in der Regel die korrekten Werte.<br />
<br />
Die {{konfig|database_admin_*}}-Parameter erlauben den Installationsskripten, neue Datenbanken für Instanzen einzurichten und diese bei der Deinstallation auch wieder zu entfernen.<br />
<br />
Falls aus Sicherheitsgründen erwünscht, kann hier ein Passwort für den Administratorzugriff auf MySQL eingetragen werden. Geschieht dies unter Windows vor der automatischen Installation von MySQL, wird bei der automatischen Installation der Administratorzugriff mit diesem Passwort eingerichtet.<br />
<br />
Falls das Passwort für den Administratorzugriff nicht im Klartext in der Konfigurationsdatei stehen soll, kann stattdessen <code>ASK</code>eingetragen werden. Dann fragen alle Skripte, die den Administratorzugriff benötigen, interaktiv nach dem Passwort, ohne es irgendwo zu speichern.<br />
<br />
Da MySQL standardmäßig nur von dem lokalen Rechner erreichbar ist, und dieser ohnehin nur für dem Administrator zugänglich ist, ist die zusätzliche Absicherung durch ein Passwort oft nicht nötig.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|download_dir}}<br />
|{{konfig|install_dir}}/download<br />
|Downloadverzeichnis. Dort steht die zu installierende Software, die im Bedarfsfall heruntergeladen wird.<br />
|-<br />
|{{konfig|database_admin_host}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer des Rechners, auf dem MySQL läuft. Muss angegeben werden, wenn das nicht der lokale Rechner ist.<br />
|-<br />
|{{konfig|database_admin_user}}<br />
|{{code|root}}<br />
|MySQL-Benutzer mit Administratorrechten<br />
|-<br />
|{{konfig|database_admin_password}}<br />
|{{code|}}<br />
|Dessen Passwort. Wenn hier ``ASK`` steht, wird das Passwort bei Bedarf interaktiv abgefragt.<br />
<br />
|-<br />
|{{konfig|mysql_dir}}<br />
|{{code|}}<br />
|Verzeichnis, in dem die MySQL-Programme mysql, mysqldump, etc. stehen. Muss angegeben werden, wenn MySQL-Programme nicht im Pfad stehen.<br />
<br />
|-<br />
|{{konfig|python_executable}}<br />
|<br />
|Vollständiger Pfad des Python-Executable, mit dem EBKuS ausgeführt wird<br />
|}<br />
<br />
<br />
=== <nowiki>[apache]</nowiki> ===<br />
<br />
Für den Parameter {{konfig|server_name}} muss unbedingt der Name oder die IP-Nummer des Rechners eingetragen werden, auf dem der Apache-Webserver läuft. Die generierte Konfigurationsdatei setzt den Standardwert <code>localhost</code>, womit EBKuS nur auf dem lokalen Rechner zugänglich ist.<br />
<br />
Für den Parameter {{konfig|server_admin}} sollte eine sinnvolle Email-Adresse eingetragen werden. Sie taucht in Apache-Fehlermeldungen auf (die allerdings normalerweise nicht vorkommen sollten).<br />
<br />
Alle übrigen Werte können in der Regel von der generierten Konfigurationsdatei übernommen werden.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|apache_log_dir}}<br />
|{{konfig|ebkus_home}}/log<br />
|Verzeichnis, in dem der Apache-Webserver Log-Dateien anlegt<br />
|-<br />
|{{konfig|server_admin}}<br />
|{{code|admin@localhost}}<br />
|Email-Adresse des Serveradministrators, die auf evt. Fehlerseiten des Servers erscheint.<br />
<br />
|-<br />
|{{konfig|server_name}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer des Rechners, auf dem der Apache-Webserver läuft.<br />
**Muss** explizit eingetragen werden, sonst kann EBKuS nur auf dem lokalen Rechner verwendet werden!<br />
<br />
|-<br />
|{{konfig|server_https_port}}<br />
|{{code|443}}<br />
|Port für verschlüsselte Verbindungen. Die EBKuS-Anwendung wird ausschließlich über diesen Port abgewickelt. Wenn der Standardport {{code|443}} nicht zur Verfügung steht, kann hier ein alternativer Port angegeben werden. Dieser muss dann als Teil der URL aufgeführt werden, z.B. für den Alternativport {{code|500}}: {{code|<nowiki>https://192.168.1.73:500/ebkus/demo/</nowiki>}}.<br />
<br />
|-<br />
|{{konfig|server_https_port}}<br />
|{{code|80}}<br />
|Port für unverschlüsselte Verbindungen. Die EBKuS-Anwendung verwendet diesen Port nicht. Dient nur zur Kontrolle des Apache Webservers: {{code|<nowiki>http://localhost/</nowiki>}} liefert "It works!". Wird hier der Port {{code|8080}} angegeben, müsste man {{code|<nowiki>http://localhost:8080/</nowiki>}} schreiben.<br />
<br />
|-<br />
|{{konfig|ssl_certificate_file}}<br />
|{{konfig|ebkus_home}}/ebkus_ssl_certificates/ebkusserver.cert<br />
|Vollständiger Pfad der SSL-Zertifikat-Datei<br />
<br />
<br />
|-<br />
|{{konfig|ssl_certificate_key_file}}<br />
|{{konfig|ebkus_home}}/ebkus_ssl_certificates/ebkusserver.key<br />
|Vollständiger Pfad der SSL-Schlüssel-Datei<br />
|}<br />
<br />
<br />
=== <nowiki>[openssl]</nowiki> ===<br />
<br />
Die Anwendung ist voll funktionsfähig mit den Werten aus der generierten Konfigurationsdatei; es empfiehlt sich jedoch, die organisatorischen Angaben für das SSL-Zertifikat anzupassen.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|openssl_executable}}<br />
|{{code|openssl}}<br />
|Falls openssl nicht im Pfad steht, muss der hier der vollständige Pfad zum Executable stehen<br />
<br />
|-<br />
|{{konfig|output_password}}<br />
|{{code|polo}}<br />
|Wird zur automatischen Zertifikatgenerierung benötigt<br />
<br />
|-<br />
|{{konfig|staat}}<br />
|{{code|DE}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|-<br />
|{{konfig|land}}<br />
|{{code|Berlin}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|-<br />
|{{konfig|ort}}<br />
|{{code|Berlin}}<br />
|Erscheint im SSL-Zertifikat<br />
|-<br />
|{{konfig|organisation}}<br />
|{{code|EFB}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|-<br />
|{{konfig|organisationseinheit}}<br />
|{{code|EFB}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|}<br />
<br />
<br />
=== <nowiki>[</nowiki>''Instanz''<nowiki>]</nowiki> ===<br />
<br />
<br />
Im Rahmen einer EBKuS-Installation auf einem Server können mehrere Instanzen einer EBKuS-Anwendung eingerichtet werden. Jede Instanz<br />
<br />
*hat einen Namen ({{konfig|instance_name}})<br />
*ist über eine eigene URL ansprechbar (<code>https://</code>'''server_name'''<code>/ebkus/</code>'''instance_name'''<code>/index.html</code>)<br />
*hat eine eigene Datenbank im Rahmen einer MySQL-Installation ({{konfig|database_name}}, {{konfig|database_user}}, {{konfig|database_password}})<br />
*hat ein eigenes Verzeichnis ({{konfig|instance_home}})<br />
*hat einen eigenen EBKuS-Server, der vom Apache-Webserver über eine eigene Portnummer angesprochen wird ({{konfig|port}})<br />
*hat eine eigene Log-Datei ({{konfig|log_file}})<br />
<br />
<br />
Für jede gewünschte Instanz wird eine Sektion in der Konfigurationsdatei angelegt. Die Sektionsüberschrift wird aus dem Namen der Instanz in eckigen Klammern gebildet. Der Name sollte mit einem Buchstaben beginnen und ansonsten nur Buchstaben, Ziffern und Unterstriche (<code>_</code>) enthalten (keine Leerzeichen!). Ein zusätzlicher Name für die Instanz ohne diese Einschränkung lässt sich über den Parameter {{konfig|instance_title}} einrichten (siehe unten).<br />
<br />
Falls der Instanzname mit <code>demo</code> beginnt, werden bei der Installation der Datenbank automatisch Demodaten erzeugt. Neben dem Benutzer <code>Admin</code> (Passwort: <code>Admin</code>) gibt es dann auch den Benutzer <code>test</code> (Passwort: <code>test</code>) und <code>verw</code>(Passwort: <code>verw</code>).<br />
<br />
Jede Sektion kann die in der Tabelle aufgeführten Parameter definieren. Erforderlich ist Wiederholung des Instanznamen als Wert von {{konfig|instance_name}}, ferner die Angabe einer eigenen, eindeutigen Portnummer, {{konfig|port}}. Für alle anderen Parameter können die Standardwerte genommen werden.<br />
<br />
Natürlich muss man {{konfig|berliner_version}} auf <code>true</code> setzen, wenn man die Berliner Version mit Berliner Straßenkatalog haben möchte; EBKuS-spezifische Fehlermeldungen sollten außerdem eine sinnvolle Telefonnummer bzw. Email-Adresse des Anwendungsbetreuers haben ({{konfig|admin_tel}}, {{konfig|admin_email}}).<br />
<br />
Die Parameter {{konfig|host}} und {{konfig|database_host}} müssen nur dann angepasst werden, wenn der EBKuS-Server bzw. die MySQL-Datenbank nicht auf demselben Rechner laufen wie der Apache-Webserver.<br />
<br />
Die bei der Installation generierte Konfigurationsdatei definiert vier Instanzen (2 davon auskommentiert):<br />
<br />
*<code>demo</code>: Demodaten, kein Straßenkatalog<br />
*<code>muster_efb</code>: keine Demodaten, kein Straßenkatalog. Beispiel für eine Produktionsinstanz, die vom Anwendungsbetreuer eingerichtet werden muss (siehe Einrichtung der Anwendung im Handbuch).<br />
<br />
Auskommentiert:<br />
*<code>demo_berlin</code>: Demodaten, Berliner Straßenkatalog (kleiner Ausschnitt, nur Straßen, deren Namen mit 'K' beginnen)<br />
*<code>demo_braunschweig</code>: Demodaten, Straßenkatalog mit Straßen aus Braunschweig, Gifhorn, Wolfenbüttel und Wolfsburg.<br />
<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
<br />
<br />
|-<br />
|{{konfig|instance_name}}<br />
|style="background-color:orangered;"|{{code|}}<br />
|Name der Instanz. Muss angegeben werden und dem Namen des Abschnitts (in eckigen Klammern) identisch sein. Darf keine Sonderzeichen außer den Unterstrich ('_') enthalten.<br />
<br />
<br />
|-<br />
|{{konfig|instance_home}}<br />
|{{konfig|ebkus_home}}/{{konfig|instance_name}}<br />
|Instanzverzeichnis. Liegt im Homeverzeichnis. Sollte nicht verändert werden.<br />
<br />
|-<br />
|{{konfig|initial_content}}<br />
|{{code|}}<br />
|Hier kann eine Datei angegeben werden, mit der die Instanzdatenbank initialisiert werden kann. Diese Datei wird immer dann geladen, wenn bei der Installation der Instanz ({{code|install.py}} oder {{code|configure.py}}) keine funktionierende Datenbank für die Instanz vorgefunden wird. Wenn keine Datei angegeben ist, wird eine neue Datenbank mit dem Merkmalskatalog ({{file|sql/merkmale_standard.py}}) und evt. einem Straßenkatalog erstellt. Wenn kein vollständiger Pfad für die Datei angegeben wird, muss die Datei im Homeverzeichnis liegen. Zulässige Dateien sind die mit dem Skript {{code|datenbank_sichern.py}} erzeugte Dateien sowie sonstige passende SQL-Dumps.<br />
<br />
|-<br />
|{{konfig|berliner_version}}<br />
|{{code|false}}<br />
|Wenn hier {{code|true}} steht, wird die Berliner EBKuS-Version verwendet mit Berliner Straßenkatalog. <br />
<br />
|-<br />
|{{konfig|database_host}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer, auf dem der Datenbankserver läuft.<br />
<br />
|-<br />
|{{konfig|database_name}}<br />
|{{konfig|instance_name}}<br />
|Name der Instanzdatenbank<br />
<br />
<br />
|-<br />
|{{konfig|database_user}}<br />
|{{konfig|instance_name}}<br />
|Benutzername der Instanzdatenbank<br />
<br />
|-<br />
|{{konfig|database_password}}<br />
|{{konfig|instance_name}}<br />
|Passwort der Instanzdatenbank<br />
<br />
<br />
|-<br />
|{{konfig|gemeindeschluessel_von_plz}}<br />
|{{code|}}<br />
|Definiert die Teilmenge der amtlichen Gemeindeschlüssel für die Bundesstatistik. Im Normalfall muss hier nichts eingetragen werden.<br />
<br /><br />
In der Bundesstatistik soll der amtliche Gemeindeschlüssel für den Wohnort des Klienten eingetragen werden, wenn der Wohnort des Klienten außerhalb des Kreises der Beratungsstelle liegt. Um die Menge der Daten zu begrenzen, kann hier über die Anfangsziffern der Postleitzahl eine Teilmenge definiert werden. Wenn mehrere Ziffernfolgen angegeben werden, müssen diese mit <code>;</code> getrennt werden.<br /><br /> Beispiele: <ul> <li>Alle Gemeindeschlüssel verwenden, außer die Postleitzahl der Gemeinde beginnt mit '9': <pre> 0;1;2;3;4;5;6;7;8 </pre> </li> <li>Große Teile Niedersachsens: <pre> 29;30;31;37;38 </pre> </li> <li>Nördliches Niedersachsen und Schleswig Holstein: <pre> 2 </pre> </li> <li>Berlin und Umgebung: <pre> 10;12;13;14;15;16 </pre> </li> <li>Bleibt die Variable leer, werden alle Gemeindeschlüssel verwendet. </li> </ul> Wenn es bei der Erkennung von Gemeindeschluesseln zu vielen Fehlern kommt, beispielsweise wegen unterschiedlicher Schreibweisen von Orten, kann man selber eine Datei <code>EBKUS_HOME/sql/gemeindeschluessel.csv</code> erstellen, bestehend aus einer Tabelle mit den Spalten <code>plz, ort ags</code>. Als Vorlage kann die Datei <code>EBKUS_HOME/sql/gemeindeschluessel_cache.csv</code> dienen, die automatisch erzeugt wird, wenn die Konfigurationsvariable <code>gemeindeschluessel_von_plz</code> einen Wert hat. <br />
|-<br />
|{{konfig|host}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer des Rechners, auf der EBKuS-Server der Instanz läuft.<br />
<br />
<br />
|-<br />
|{{konfig|keine_bundesstatistik}}<br />
|{{code|false}}<br />
|Falls hier {{code|true}} steht, wird die Bundesstatistik aus der Anwendung ausgeblendet. Es kann keine Bundesstatistik ausgefüllt werden und steht auch nicht für Statistik und Export zur Verfügung.<br />
<br />
|-<br />
|{{konfig|log_file}}<br />
|{{konfig|instance_home}}{{code|/}}{{konfig|instance_name}}{{code|.log}}<br />
|Name der Datei, in die der EBKuS-Server Meldungen schreibt<br />
<br />
|-<br />
|{{konfig|log_level}}<br />
|{{code|INFO}}<br />
|Legt fest, wie "geschwätzig" der EBKuS-Server ist. Muss einer der folgenden Werte sein, in aufsteigender Wortfülle: {{code|CRITICAL, ERROR, WARNING, INFO, DEBUG}} ({{code|DEBUG}} ist nur für die Fehlersuche geeignet, da sehr viel ausgegeben wird.)<br />
<br />
|-<br />
|{{konfig|port}}<br />
|style="background-color:orangered;"|{{code|}}<br />
|Portnummer über die der EBKuS-Server angesprochen wird. Muss angegeben werden. Jede Instanz muss eine unterschiedliche Portnummer erhalten.<br />
|}<br />
<br />
<br />
==== Konfiguration für externe Anwendungen ====<br />
<br />
Die folgenden Konfigurationsvariablen bewirken, dass auf der Klientenkarte ein Kasten mit maximal vier Buttons erscheint, die in einem neuen Tab/Fenster eine URL aufrufen, die Felder des aktuellen (letzten) Falles bzw. des angemeldeten Mitarbeiters als Bestandteile haben kann:<br />
# Kein Kasten, wenn diese Variable keinen Wert hat.<br />
extern_fieldset_label: Externe Anwendung<br />
# Position auf der Klientenkarte<br />
extern_fieldset_position: 6<br />
# Maximal vier Buttons, für jeden eine Bezeichnung und eine Url.<br />
# Ein Button kommt nur zustande, wenn sowohl Label als auch Url<br />
# einen Wert haben. <br />
extern_button1_label: GoogleWeb<br />
extern_button1_url: <nowiki>http://www.google.com/search?q=$$fall_id$$_$$fall_akte__ort$$</nowiki><br />
extern_button2_label: GoogleMaps<br />
extern_button2_url: <nowiki>http://www.google.com/maps?q=$$mitarbeiter_na$$</nowiki><br />
extern_button3_label: GoogleImages<br />
extern_button3_url: <nowiki>http://www.google.com/images?q=$$fall_akte__ort$$</nowiki><br />
extern_button4_label: GoogleNews<br />
extern_button4_url: http://www.google.com/news?q=$$fall_fn$$</nowiki><br />
<br />
Urls können Abschnitte der folgenden Form enthalten:<br />
{{code|$$<fall oder mitarbeiter>_<feld>$$}}<br />
Der ganze Abschnitt wird durch den Wert von {{code|<feld>}} ersetzt, <br />
wobei entweder im Fall-Objekt oder im Mitarbeiter-Objekt <br />
nachgeschlagen wird. <br />
Beispiele:<br />
{{code|$$fall_id$$}}, {{code|$$mitarbeiter_na$$}}, {{code|$$fall_akte__ort$$}}<br />
<br />
Im Beispiel oben werden als externe Anwendungen verschiedene Google-Dienst aufgerufen, wobei als Parameter Daten aus dem aktuellen Fall übergeben werden.<br />
(Das Beispiel ist nicht sinnvoll und dient nur der Illustration des Mechanismus.)<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|extern_fieldset_label}}<br />
|{{code|}}<br />
|Bezeichnung für den Kasten mit den Buttons für die externen Anwendungen<br />
<br />
|-<br />
|{{konfig|extern_fieldset_position}}<br />
|{{code|2}}<br />
|Position auf der Klientenkarte (Gezählt werden die umrandeten Kästen mit einer Bezeichnung: Klientendaten, Bezugspersonen, Leistungen, etc.)<br />
|-<br />
|{{konfig|extern_buttonX_label}}<br />
|{{code|}}<br />
|Name der externen Anwendung<br />
<br />
<br />
|-<br />
|{{konfig|extern_buttonX_url}}<br />
|{{code|}}<br />
|URL der externen Anwendung mit Platzhaltern für die zu übernehmenden Parameter<br />
<br />
|}<br />
<br />
{{konfig|X}} kann 1,2,3 oder 4 sein.<br />
<br />
<br />
== Fachliche Parameter ==<br />
<br />
Die hier beschriebenen Einstellungen können auch vom Anwendungsbetreuer über {{pfad2|Administratorhauptmenü|Allgemeine Konfiguration}} vorgenommen werden.<br />
<br />
<br />
=== <nowiki>[</nowiki>''Instanz''<nowiki>]</nowiki> ===<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|admin_email}}<br />
|{{code|Keine Angabe}}<br />
|Email-Adresse des Anwendungsbetreuers.<br />
<br />
Wird in Fehlermeldungen genannt.<br />
|-<br />
|{{konfig|admin_name}}<br />
|{{code|Keine Angabe}}<br />
|Name des Anwendungsbetreuers.<br />
<br />
Wird in Fehlermeldungen genannt.<br />
|-<br />
|{{konfig|admin_tel}}<br />
|{{code|Keine Angabe}}<br />
|Telefonnummer des Anwendungsbetreuers.<br />
<br />
Wird in Fehlermeldungen genannt.<br />
|-<br />
|{{konfig|anmeldungsdaten_}} {{konfig|obligatorisch}}<br />
|{{code|false}}<br />
|Falls <code>true</code> werden die Anmeldungsdaten obligatorisch im Aufnahmeformular erhoben anstatt optional in einer getrennten Maske.<br />
<br />
Die entsprechenden Pflichfelder sind dabei auszufüllen. Eine spätere Bearbeitung der Anmeldungsdaten erfolgt wie bisher in einer eigenständigen Maske (analog der späteren Bearbeitung einer Leistung).<br />
|-<br />
|{{konfig|anmeldeprobleme_und_}} {{konfig|beschaeftigung_bei_}}{{konfig|anmeldung_erfassen}}<br />
|{{code|false}}<br />
|Falls <code>true</code> werden Probleme bei der Anmeldung und Beschäftigung schon bei der Anmeldung erfasst und später für die Fachstatistik übernommen.<br />
<br />
Die Auswahlfelder 'Beschäftigung Jugendliche(r)', 'Beschäftigungsverhältnis Mutter', 'Beschäftigungsverhältnis Vater' und das Mehrfachauswahlfeld 'Problem(e) bei der Anmeldung' aus der Fachstatistik werden in den Kasten Anmeldekontakt als Pflichtfelder aufgenommen. Es ist jedoch in jedem Fall möglich 'Keine Angabe' auszuwählen (genau wie in der Fachstatistik selbst). Die Daten werden mit dem Fall (nicht mit der Akte bzw. den Stammdaten) gespeichert. Wenn eine Fachstatistik angelegt wird, werden die Daten übernommen.<br />
|-<br />
|{{konfig|beratungskontakte}}<br />
|{{code|false}}<br />
|Falls <code>true</code> können in der Klientenakte einzelne Beratungskontakte eingetragen werden. Die Summen werden in die Bundesstatistik und in die Fachstatistik als Vorgabe übernommen.<br />
|-<br />
|{{konfig|beratungskontakte_bs}}<br />
|{{code|false}}<br />
|Falls <code>true</code> treten Anpassungen speziell für Braunschweig in Kraft.<br />
<br />
Die Variable <code>beratungskontakte</code> muss ebenfalls auf <code>true</code> stehen.<br />
|-<br />
|{{konfig|cache_on}}<br />
|{{code|true}}<br />
|Falls <code>true</code> wird der Objektcache eingeschaltet, sonst bleibt er abgeschaltet.<br />
<br />
Normalerweise ist der Cache an, aber es kann in seltenen Fällen zu Fehlern kommen, die verschwinden, wenn er abgeschaltet wird. Auf die inhaltlichen Abläufe hat das keine Auswirkungen, <br />
allenfalls auf die Performance.<br />
|-????<br />
|{{konfig|erinnern_nach_wochen_ohne_kontakt}}<br />
|{{code|0}}<br />
|Anzahl der Wochen ohne Kontakt nach der ein offener Fall in die Erinnerungsfunktion aufgenommen wird.<br />
<br />
Wenn hier eine Zahl zwischen 1 und 99 steht, wird die Erinnerungsfunktion aktiviert. Auf einem zusätzlichen Button im Hauptmenü steht dann die Anzahl der offenen Fälle, mit denen es länger als die angegebene Anzahl von Wochen keinen Kontakt gegeben hat. Nach dem Betätigen des Buttons erscheint eine Liste dieser Fälle. Jeder Fall kann als erledigt markiert werden, worauf er künftig normalerweiser nicht mehr in der Liste erscheint. Für die gesamte Liste gibt es aber eine Option, alle Fälle einschließlich der erledigten anzuzeigen. Die 'Erledigt'-Markierung kann dann auch wieder rückgängig gemacht werden.<br />
<br />
Es muss hier die Ziffer 0 stehen, wenn die Erinnerungsfunktion deaktiviert bleiben soll.<br />
|-<br />
|{{konfig|fachstatistik_akte_}} {{konfig|diskrepanz_nicht_zulassen}}<br />
|{{code|false}}<br />
|Falls <code>true</code> werden Diskrepanzen zwischen Fachstatistik und Akte nicht zugelassen.<br />
<br />
Die entsprechenden Items in der Fachstatistik zeigen die Werte aus der Akte und sind nicht modifizierbar. Eine Diskrepanz kann so gar nicht entstehen. Allerdings muss bei Änderungen in der Akte die Fachstatistik neu abgespeichert werden, damit die Änderungen übernommen und für die Statistik wirksam werden.<br /> Betroffen sind nur die Items 'Familienstatus', 'Empfohlen von' und 'Erbrachte Leistungen in der Fachstatistik', deren Werte im Normalfall aus der Akte vorbelegt werden.<br />
|-<br />
|{{konfig|fallunabhaengige}} {{konfig|_aktivitaeten_bs}}<br />
|{{code|false}}<br />
|Falls <code>true</code> können fallunabhängige Aktivitäten eingetragen und ausgewertet werden. Speziell für Braunschweig. <br />
|-<br />
|{{konfig|fallbeginn_bei_}}{{konfig|erster_leistung}}<br />
|{{code|false}}<br />
|Bei Neumelde- und Abschlusszahlen sowie Klienten pro Mitarbeiter wird der Fallbeginn ab dem Datum der erste Leistung definiert anstatt ab dem Anmeldedatum.<br />
|-<br />
|{{konfig|fallbeginn_waehlbar}}<br />
|{{code|false}}<br />
|Bei Neumelde- und Abschlusszahlen sowie Klienten pro Mitarbeiter kann ein Häkchen gesetzt werden, um den Fallbeginn ab erster Leistung zu definieren.<br />
|-<br />
|{{konfig|instance_title}}<br />
|{{konfig|instance_name}}<br />
|Langname für die Instanz.<br />
<br />
Erscheint bei der Anmeldung und in der Statuszeile.<br />
|-<br />
|{{konfig|jgh_gemeindeschluessel}}<br />
|{{code|}}<br />
|Die letzten drei Ziffern des [http://de.wikipedia.org/wiki/Amtlicher_Gemeindeschl%C3%BCssel" Amtlichen Gemeindeschlüssels] oder das Wort "blank".<br />
<br />
Standardmäßig setzt EBKuS für diese drei Ziffern (Spalte 7-9 des Exportdatensatzes) drei mal die Ziffer 0 ein. Unseres Wissens werden diese Daten für die<br />
Bundesstatistik allerdings nicht ausgewertet. Bei Bedarf kann hier das Wort "blank" angegeben werden, dann erscheinen im Datensatz drei Leerzeichen, oder es können drei Ziffern<br />
eingegeben werden, die dann in den Datensatz eingefügt werden.<br />
|-<br />
|{{konfig|leistungsende_in_}}<br />
{{konfig|zukunft_erlaubt}}<br />
|{{code|false}}<br />
|Beim Eintrag einer Leistung darf für das Ende ein Datum, das in der Zukunft liegt, eingetragen werden.<br />
<br />
Der Abschluss des Falls ist erst möglich, wenn alle Leistungen beendet sind.<br />
|-<br />
|{{konfig|loeschfrist}}<br />
|{{code|36}}<br />
|Löschfrist in Monaten.<br />
<br />
Akten, die älter sind, können vom Administrator gelöscht werden.<br />
|-<br />
|{{konfig|log_query_laenger_als}}<br />
|{{code|0}}<br />
|Falls größer 0, Datenbankqueries in die Logdatei schreiben, die länger dauern als die angegeben Zahl in Millisekunden.<br />
<br />
Wenn 0 eingetragen wird, werden keine Datenbankqueries protokolliert. Alle Datenbankqueries können mit <code>log_level=DEBUG</code> erfasst werden. Nützlich zur Diagnose von Performanceproblemen.<br />
|-<br />
|{{konfig|meldung_vom_admin}}<br />
|{{code|}}<br />
|Inhalt wird als Meldung vom Administrator unübersehbar auf jeder EBKuS-Seite über der Statuszeile ausgegeben.<br />
<br />
Damit kann der Administrator Meldungen an alle aktiven EBKuS-Nutzer ausgeben, z.B. um einen Ausfall von EBKuS wegen Wartungsarbeiten anzukündigen. <br />
|-<br />
|{{konfig|neumeldungen_nach_region}}<br />
|{{code|}}<br />
|Definiert eine Tabelle ''Neumeldungen nach Region'' unter ''Neumelde- und Abschlusszahlen''.<br />
<br />
Die Regionen, für die in der Tabelle die Neumeldungen ausgezählt werden sollen, müssen unter {{pfad4|Hauptmenü|Statistikabfrage|Teilmenge|Neu}} als Teilmengendefinitionen eingeführt werden. Der Namen der gewünschten Definitionen werden durch <code>;</code> getrennt aufgeführt. <br /><br /> Beispiel: <ul> <li> <pre> Gifhorn und Samtgemeinde Meinersen; Braunschweig 38120 und 38112 </pre> </li> </ul> "Gifhorn und Samtgemeinde Meinersen" ist eine Teilmengendefinition mit der Definition: <code>( ort = 'Gifhorn' ODER samtgemeinde = 'Meinersen' )</code>. "Braunschweig 38120 und 38112" ist eine Teilmengendefinition mit der Definition: <code>( ort = 'Braunschweig' UND plz = '38112' oder '38120' )</code>. <br /><br /> <br />
|-<br />
|{{konfig|session_time}}<br />
|{{code|120}}<br />
|Länge einer Session in Minuten. <br />
<br />
Nach dieser Zeit wird ein Benutzer automatisch abgemeldet, wenn er keine Eingaben mehr macht.<br />
|-<br />
|{{konfig|sql_abfrage}}<br />
|{{code|false}}<br />
|Falls <code>true</code> steht die Maske zum Absetzen von SQL-Abfragen vom Administrationsmenü aus zur Verfügung. <br />
<br />
|-<br />
|{{konfig|strassenkatalog}}<br />
|{{code|}}<br />
|Falls diese Variable nicht leer ist, wird bei der Adresseingabe der Straßenkatalog verwendet.<br />
<br />
Der eigentliche Wert der Variable spielt nur bei der Erstinstallation der Instanz eine Rolle.<br />Eine Instanz ohne Straßenkatalog kann auch später noch für die Verwendung mit Straßenkatalog eingerichtet werden, indem der Straßenkatalog über {{pfad2|Administratorhauptmenü|Straßenkatalog importieren}} importiert wird und der Variable {{konfig|strassenkatalog}} ein beliebiger Wert zugewiesen wird, beispielsweise der Ortsname.<br />
|-<br />
|{{konfig|strassenkatalog_}} {{konfig|vollstaendig}}<br />
|{{code|false}}<br />
|Falls <code>true</code> wird angenommen, dass der Straßenkatalog Einträge für jede einzelne Hausnummer enthält.<br />
<br />
Ansonsten wird angenommen, dass lediglich Einträge für ganze Straßen bzw. für bestimmte Intervalle von Hausnummern vorhanden sind.<br />
|-<br />
|{{konfig|strassensuche}}<br />
|{{code|}}<br />
|Bestimmt die Anzeige von Zusatzinformationen aus dem Straßenkatalog bei der Darstellung und Eingabe von Adressen.<br />
<br />
Zulässige Werte sind: <code>ort bezirk ortsteil samtgemeinde</code>.<br /><br /> Beispiele: <ul> <li>In Berlin gibt es nur einen Ort im Straßenkatalog, nämlich 'Berlin'. Das Feld <code>ort</code> ist daher nicht nötig. Ortsteil und Samtgemeinde haben im Straßenkatalog keine Werte, Bezirk allerdings schon. Der sinnvolle Wert für Berlin ist also <pre> bezirk </pre> </li> <li>In Gifhorn gibt es mehrere Orte im Straßenkatalog. Sowohl Ortsteile und Samtgemeinden spielen eine Rolle und sind im Straßenkatalog erfasst, Bezirke jedoch nicht. Der sinnvolle Wert hier ist also <pre> ort ortsteil samtgemeinde </pre> </li> <li>Wenn es nur einen Ort gibt und weder Bezirke, Ortsteile oder Samtgemeinden im Straßenkatalog erfasst sind, sollte die Variable leer bleiben. </ul> <br /><br />Irrelevant, wenn kein Straßenkatalog verwendet wird.<br />
|-<br />
|{{konfig|warnung_bei_fachstatistik_}} {{konfig|akte_diskrepanz}}<br />
|{{code|false}}<br />
|Falls <code>true</code> wird beim Speichern der Fachstatistik auf eine Diskrepanz zwischen Akte und Fachstatistik hingewiesen, falls vorhanden.<br />
<br />
Wenn man bei dem dann zur Verfügung stehendem Item "Diskrepanz zur Akte zulassen" ein Häkchen setzt, kann man trotzdem speichern.<br /> Betroffen sind nur die Items 'Familienstatus', 'Empfohlen von' und 'Erbrachte Leistungen in der Fachstatistik', deren Werte im Normalfall aus der Akte vorbelegt werden.<br />
|-<br />
|{{konfig|wiederaufnahmefrist}}<br />
|{{code|1}}<br />
|Anzahl der Monate, innerhalb derer ein abgeschlossener Fall wiederaufgenommen werden kann ("z.d.A. rückgängig").<br />
<br />
Danach muss ein neuer Fall angelegt werden.<br />
|-<br />
|{{konfig|wohnt_nicht_ausserhalb}}<br />
|{{code|}}<br />
|Definiert die Teilmenge der Adressen, die im Sinne der Bundesstatistik in die Zuständigkeit der Beratungsstelle fallen.<br />
<br />
Aufgrund der hier angegebenen Kriterien wird entschieden, ob der Klient in der Bundesstatistik als ausserhalb des Zuständigkeitsbereichs der Beratungsstelle wohnend angegeben wird. Als mögliche Kriterien kommen in Frage: <code>plz,ort,ortsteil,samtgemeinde,bezirk,plraum</code>. Die Kriterien <code>ortsteil,samtgemeinde,bezirk</code> sind nur sinnvoll, wenn ein Straßenkatalog verwendet wird und dieser auch entsprechende Angaben enthält. <br /><br /> Die Kriterien werden wie folgt in der angegebenen Reihenfolge abgearbeitet: <ul> <li>Wenn die Klientenadresse keinen Wert für das Kriterium aufweist, wird zum nächsten Kriterium übergegangen. </li> <li>Falls die Klientenadresse einen Wert hat und im Kriterium genannt wird, wohnt er nicht außerhalb. Ist der Wert im Kriterium nicht genannt, wohnt er außerhalb. In beiden Fällen werden die weiteren Kriterien nicht mehr betrachtet. </li> <li>Falls aufgrund fehlender Werte (oder fehlender Kriterien) kein Kriterium angewendet werden konnte, wird standardmäßig angenommen, dass der Klient nicht außerhalb wohnt. </li> </ul> Beispiele: <ul> <li> <pre> bezirk: Friedrichshain-Kreuzberg; ort: Berlin </pre> In Berlin enthalten alle mit dem Straßenkatalog abgeglichene Adressen einen Wert für den Bezirk. Da jede Beratungsstelle genau für einen Bezirk zuständig ist, kann auf dieser Basis entschieden werden. Falls eine Adresse nicht mit dem Straßenkatalog abgeglichen wurde, kann der Ort als Kriterium herangezogen werden, da in diesem Fall für Bezirk keine Angaben vorliegen. </li> <li> Falls kein Straßenkatalog verwendet wird, kann nur der Ort, die Postleitzahl oder evt. der Planungsraum (falls solche definiert sind und routinemäßig mit den Klientenadressen zusammen erfasst werden) als Kriterium verwendet werden, z.B. (fiktiv!): <pre> plz: 12345;23456;34567 </pre> Adressen mit diesen Postleitzahlen werden als nicht außerhalb wohnend betrachtet, alle anderen als außerhalb. Falls die Klientenadresse keine 5-stellige PLZ enthält, gilt der Wert als fehlend. Ungenauigkeiten werden in Kauf genommen, da die Region der Zuständigkeit nicht immer exakt mit den Regionen der Postleitzahlen übereinstimmt. </li> <li> <pre> samtgemeinde: Name1;Name2;Name3; plz: 12345;23456 </pre> Analog zum Berliner Beispiel würde hier auch zunächst das Kriterium Samtgemeinde versucht, das aber nur nach einem Abgleich mit dem Straßenkatalog bekannt ist. Für die nicht abgeglichenen Adressen wird dann die Postleitzahl herangezogen. In seltenen Fällen kann das zu Fehlern führen, da die Bereiche der Postleitzahlen manchmal nicht mit den Bereichen der Zuständigkeit exakt übereinstimmen. </li> </ul> Falls das Ergebnis "wohnt außerhalb" ist, wird automatisch ein entsprechender Eintrag in die Bundesstatistik vorgenommen, der beim Ausfüllen oben im Kasten "Falldaten" angezeigt wird. Wenn möglich wird der <strong>amtliche Gemeindeschlüssel</strong> eingetragen. Wenn dieser nicht gefunden wird, wird Postleitzahl und Wohnort angegeben. <br /><br /> <strong>Syntax</strong> wie in den Beispielen. Rund um die Trenner <code>;</code> und <code>:</code> dürfen Leerzeichen stehen. Es können auch mehrere Zeilen verwendet werden. <br /><br /> Unter (Berater-) {{pfad5|Hauptmenü|Statistik|Teilmenge|Neu|Neue Bedingung}}" finden Sie für jedes Kriterium die Menge der möglichen Werte. <br /><br /> Zur <strong>Testen</strong> gibt es unter {{pfad3|Aministratorhauptmenü|Bundesstatistik|Exportieren}} einen neuen Punkt ''Adressen außerhalb prüfen''. Sie können dort in einer Tabelle sehen, welche Adressen als außerhalb klassifiziert werden. <br />
|}</div>Ebkushttps://www.ebkus.org/wiki/KonfigurationKonfiguration2014-07-03T14:23:46Z<p>Ebkus: </p>
<hr />
<div>Die zentrale Konfigurationsdatei für eine EBKuS-Installation ist eine Textdatei namens <code>ebkus.conf</code> und befindet sich im Homeverzeichnis ({{file|ebkus}} im Installationsverzeichnis).<br />
<br />
Als Ausgangspunkt für die eigene Konfiguration dient die vom Installationsskript {{code|install.py}} aus einer [http://svn.berlios.de/wsvn/ebkus/ebkus-3/trunk/templates/ebkus.conf.template Vorlage] generierte Konfigurationsdatei. Die meisten Parameter (= Konfigurationvariable) sind darin bereits korrekt gesetzt.<br />
<br />
<br />
== Aufbau von <code>ebkus.conf</code> ==<br />
<br />
Zeilen, die leer sind oder mit dem Kommentarzeichen <code>#</code> beginnen, werden ignoriert, z.B.:<br />
<br />
<pre>#ebkus_home: %(install_dir)s\ebkus</pre><br />
<br />
In diesem Fall hat der Parameter den in der Tabelle genannten Standardwert.<br />
<br />
Zeilen, die nur aus einem Namen in eckigen Klammern bestehen, leiten eine Sektion ein, z.B.:<br />
<br />
<pre>[apache]</pre><br />
Die übrigen Zeilen weisen einem Parameter einen Wert zu. Sie beginnen mit dem Namen des Parameters, gefolgt von einem Doppelpunkt, gefolgt von dem Wert. Vor oder nach dem Doppelpunkt können Leerzeichen stehen. Beispiel:<br />
<br />
<pre>install_dir: C:\ebkus_installation</pre><br />
Werte können eine Syntax enthalten, die es erlaubt, vorher definierte Parameter in einen aktuellen Wert einzubeziehen (''Parametersubstitution''), z.B.:<br />
<br />
<pre>ebkus_home: %(install_dir)s\ebkus</pre><br />
Hier wird der Wert von <code>install_dir</code> in den Wert von <code>ebkus_home</code> einbezogen. Das ist genauso, als ob man gleich<br />
<br />
<pre>ebkus_home: C:\ebkus_installation\ebkus</pre><br />
definiert hätte. <code>%(</code>''parameter''<code>)s</code> wird durch den Wert von ''parameter'' ersetzt.<br />
<br />
Jede gültige Konfigurationsdatei muss die folgenden Sektionen aufweisen:<br />
<br />
*<code>[DEFAULT]</code><br />
*<code>[ebkus]</code><br />
*<code>[apache]</code><br />
*<code>[openssl]</code><br />
*eine Sektion für jede Instanz: <code>[</code>''Instanzname''<code>]</code><br />
<br />
Die möglichen Parameter für jede Sektion sind in den folgenden Tabellen aufgeführt.<br />
<br />
Alle Parameter außer denen, die in den Tabelle rot markiert sind, haben einen Standardwert (manchmal auch ''Defaultwert'' genannt), der in der Tabelle in der Spalte Standardwert angegeben ist. Ein Parameter hat diesen Wert, wenn er in der Konfiguration fehlt oder auskommentiert ist.<br />
<br />
Wie man sieht, können Parametersubstitutionen auch bei Standardwerten stattfinden. Der Wert des notwendige Parameter ''install_dir'' findet dadurch Eingang in weitere Parameter (''ebkus_home'', ''instance_home''), ohne dass diese explizit in der Konfiguration aufgeführt sind.<br />
<br />
''Anmerkung zu den Tabellen'': In einigen Fällen ist der angegebene Parameter bzw. Standardwert aus layout-technischen Gründen auf mehrere Zeilen verteilt, obwohl er eigentlich ohne Leerzeichen hintereinanderweg in einer Zeile stehen müsste.<br />
<br />
Wir unterscheiden ''Systemparameter'' von ''fachlichen Parametern''. Erstere betreffen den technischen Betrieb von EBKuS und werden von den Systemadministratoren (IT) bei der Installation eingerichtet. Fachparameter können ebenso wie Systemparameter in der {{file|ebkus.conf}} in der Instanzsektion gesetzt werden, außerdem kann aber auch der Anwendungsbetreuer über {{pfad2|Administratorhauptmenü|Allgemeine Konfiguration}} weitere Veränderungen vornehmen. Die vom Anwendungsbetreuer vorgenommenen Änderungen haben stets Vorrang über den Angaben in der {{file|ebkus.conf}}.<br />
<br />
<br />
== Systemparameter ==<br />
<br />
=== <nowiki>[DEFAULT]</nowiki> ===<br />
<br />
Die generierte Konfigurationsdatei enthält die korrekten Werte.<br />
<br />
Der Parameter {{konfig|install_dir}} bezeichnet das Installationsverzeichnis und muss immer in der Konfiguration definiert werden. Es bildet den Bezugspunkt für alle weiteren Pfade. Standardmäßig ist {{konfig|ebkus_home}} das Verzeichnis <code>ebkus</code> im Installationsverzeichnis; das sollte nicht verändert werden.<br />
<br />
Die in der Sektion <code>[DEFAULT]</code> definierten Parameter können in allen anderen Sektionen im Rahmen der Parametersubstitution als Teil eine Wertes verwendet werden (z.B. in der Definition von {{konfig|instance_home}}). Ansonsten stehen nur die Parameter derselben Sektion zur Verfügung.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|install_dir}}<br />
|style="background-color:orangered;"|{{code|}}<br />
|Installationsverzeichnis<br />
|-<br />
|{{konfig|ebkus_home}}<br />
|{{konfig|install_dir}}/ebkus<br />
|Homeverzeichnis<br />
|}<br />
<br />
<br />
=== <nowiki>[ebkus]</nowiki> ===<br />
<br />
Die generierte Konfigurationsdatei enthält in der Regel die korrekten Werte.<br />
<br />
Die {{konfig|database_admin_*}}-Parameter erlauben den Installationsskripten, neue Datenbanken für Instanzen einzurichten und diese bei der Deinstallation auch wieder zu entfernen.<br />
<br />
Falls aus Sicherheitsgründen erwünscht, kann hier ein Passwort für den Administratorzugriff auf MySQL eingetragen werden. Geschieht dies unter Windows vor der automatischen Installation von MySQL, wird bei der automatischen Installation der Administratorzugriff mit diesem Passwort eingerichtet.<br />
<br />
Falls das Passwort für den Administratorzugriff nicht im Klartext in der Konfigurationsdatei stehen soll, kann stattdessen <code>ASK</code>eingetragen werden. Dann fragen alle Skripte, die den Administratorzugriff benötigen, interaktiv nach dem Passwort, ohne es irgendwo zu speichern.<br />
<br />
Da MySQL standardmäßig nur von dem lokalen Rechner erreichbar ist, und dieser ohnehin nur für dem Administrator zugänglich ist, ist die zusätzliche Absicherung durch ein Passwort oft nicht nötig.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|download_dir}}<br />
|{{konfig|install_dir}}/download<br />
|Downloadverzeichnis. Dort steht die zu installierende Software, die im Bedarfsfall heruntergeladen wird.<br />
|-<br />
|{{konfig|database_admin_host}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer des Rechners, auf dem MySQL läuft. Muss angegeben werden, wenn das nicht der lokale Rechner ist.<br />
|-<br />
|{{konfig|database_admin_user}}<br />
|{{code|root}}<br />
|MySQL-Benutzer mit Administratorrechten<br />
|-<br />
|{{konfig|database_admin_password}}<br />
|{{code|}}<br />
|Dessen Passwort. Wenn hier ``ASK`` steht, wird das Passwort bei Bedarf interaktiv abgefragt.<br />
<br />
|-<br />
|{{konfig|mysql_dir}}<br />
|{{code|}}<br />
|Verzeichnis, in dem die MySQL-Programme mysql, mysqldump, etc. stehen. Muss angegeben werden, wenn MySQL-Programme nicht im Pfad stehen.<br />
<br />
|-<br />
|{{konfig|python_executable}}<br />
|<br />
|Vollständiger Pfad des Python-Executable, mit dem EBKuS ausgeführt wird<br />
|}<br />
<br />
<br />
=== <nowiki>[apache]</nowiki> ===<br />
<br />
Für den Parameter {{konfig|server_name}} muss unbedingt der Name oder die IP-Nummer des Rechners eingetragen werden, auf dem der Apache-Webserver läuft. Die generierte Konfigurationsdatei setzt den Standardwert <code>localhost</code>, womit EBKuS nur auf dem lokalen Rechner zugänglich ist.<br />
<br />
Für den Parameter {{konfig|server_admin}} sollte eine sinnvolle Email-Adresse eingetragen werden. Sie taucht in Apache-Fehlermeldungen auf (die allerdings normalerweise nicht vorkommen sollten).<br />
<br />
Alle übrigen Werte können in der Regel von der generierten Konfigurationsdatei übernommen werden.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|apache_log_dir}}<br />
|{{konfig|ebkus_home}}/log<br />
|Verzeichnis, in dem der Apache-Webserver Log-Dateien anlegt<br />
|-<br />
|{{konfig|server_admin}}<br />
|{{code|admin@localhost}}<br />
|Email-Adresse des Serveradministrators, die auf evt. Fehlerseiten des Servers erscheint.<br />
<br />
|-<br />
|{{konfig|server_name}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer des Rechners, auf dem der Apache-Webserver läuft.<br />
**Muss** explizit eingetragen werden, sonst kann EBKuS nur auf dem lokalen Rechner verwendet werden!<br />
<br />
|-<br />
|{{konfig|server_https_port}}<br />
|{{code|443}}<br />
|Port für verschlüsselte Verbindungen. Die EBKuS-Anwendung wird ausschließlich über diesen Port abgewickelt. Wenn der Standardport {{code|443}} nicht zur Verfügung steht, kann hier ein alternativer Port angegeben werden. Dieser muss dann als Teil der URL aufgeführt werden, z.B. für den Alternativport {{code|500}}: {{code|<nowiki>https://192.168.1.73:500/ebkus/demo/</nowiki>}}.<br />
<br />
|-<br />
|{{konfig|server_https_port}}<br />
|{{code|80}}<br />
|Port für unverschlüsselte Verbindungen. Die EBKuS-Anwendung verwendet diesen Port nicht. Dient nur zur Kontrolle des Apache Webservers: {{code|<nowiki>http://localhost/</nowiki>}} liefert "It works!". Wird hier der Port {{code|8080}} angegeben, müsste man {{code|<nowiki>http://localhost:8080/</nowiki>}} schreiben.<br />
<br />
|-<br />
|{{konfig|ssl_certificate_file}}<br />
|{{konfig|ebkus_home}}/ebkus_ssl_certificates/ebkusserver.cert<br />
|Vollständiger Pfad der SSL-Zertifikat-Datei<br />
<br />
<br />
|-<br />
|{{konfig|ssl_certificate_key_file}}<br />
|{{konfig|ebkus_home}}/ebkus_ssl_certificates/ebkusserver.key<br />
|Vollständiger Pfad der SSL-Schlüssel-Datei<br />
|}<br />
<br />
<br />
=== <nowiki>[openssl]</nowiki> ===<br />
<br />
Die Anwendung ist voll funktionsfähig mit den Werten aus der generierten Konfigurationsdatei; es empfiehlt sich jedoch, die organisatorischen Angaben für das SSL-Zertifikat anzupassen.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|openssl_executable}}<br />
|{{code|openssl}}<br />
|Falls openssl nicht im Pfad steht, muss der hier der vollständige Pfad zum Executable stehen<br />
<br />
|-<br />
|{{konfig|output_password}}<br />
|{{code|polo}}<br />
|Wird zur automatischen Zertifikatgenerierung benötigt<br />
<br />
|-<br />
|{{konfig|staat}}<br />
|{{code|DE}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|-<br />
|{{konfig|land}}<br />
|{{code|Berlin}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|-<br />
|{{konfig|ort}}<br />
|{{code|Berlin}}<br />
|Erscheint im SSL-Zertifikat<br />
|-<br />
|{{konfig|organisation}}<br />
|{{code|EFB}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|-<br />
|{{konfig|organisationseinheit}}<br />
|{{code|EFB}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|}<br />
<br />
<br />
=== <nowiki>[</nowiki>''Instanz''<nowiki>]</nowiki> ===<br />
<br />
<br />
Im Rahmen einer EBKuS-Installation auf einem Server können mehrere Instanzen einer EBKuS-Anwendung eingerichtet werden. Jede Instanz<br />
<br />
*hat einen Namen ({{konfig|instance_name}})<br />
*ist über eine eigene URL ansprechbar (<code>https://</code>'''server_name'''<code>/ebkus/</code>'''instance_name'''<code>/index.html</code>)<br />
*hat eine eigene Datenbank im Rahmen einer MySQL-Installation ({{konfig|database_name}}, {{konfig|database_user}}, {{konfig|database_password}})<br />
*hat ein eigenes Verzeichnis ({{konfig|instance_home}})<br />
*hat einen eigenen EBKuS-Server, der vom Apache-Webserver über eine eigene Portnummer angesprochen wird ({{konfig|port}})<br />
*hat eine eigene Log-Datei ({{konfig|log_file}})<br />
<br />
<br />
Für jede gewünschte Instanz wird eine Sektion in der Konfigurationsdatei angelegt. Die Sektionsüberschrift wird aus dem Namen der Instanz in eckigen Klammern gebildet. Der Name sollte mit einem Buchstaben beginnen und ansonsten nur Buchstaben, Ziffern und Unterstriche (<code>_</code>) enthalten (keine Leerzeichen!). Ein zusätzlicher Name für die Instanz ohne diese Einschränkung lässt sich über den Parameter {{konfig|instance_title}} einrichten (siehe unten).<br />
<br />
Falls der Instanzname mit <code>demo</code> beginnt, werden bei der Installation der Datenbank automatisch Demodaten erzeugt. Neben dem Benutzer <code>Admin</code> (Passwort: <code>Admin</code>) gibt es dann auch den Benutzer <code>test</code> (Passwort: <code>test</code>) und <code>verw</code>(Passwort: <code>verw</code>).<br />
<br />
Jede Sektion kann die in der Tabelle aufgeführten Parameter definieren. Erforderlich ist Wiederholung des Instanznamen als Wert von {{konfig|instance_name}}, ferner die Angabe einer eigenen, eindeutigen Portnummer, {{konfig|port}}. Für alle anderen Parameter können die Standardwerte genommen werden.<br />
<br />
Natürlich muss man {{konfig|berliner_version}} auf <code>true</code> setzen, wenn man die Berliner Version mit Berliner Straßenkatalog haben möchte; EBKuS-spezifische Fehlermeldungen sollten außerdem eine sinnvolle Telefonnummer bzw. Email-Adresse des Anwendungsbetreuers haben ({{konfig|admin_tel}}, {{konfig|admin_email}}).<br />
<br />
Die Parameter {{konfig|host}} und {{konfig|database_host}} müssen nur dann angepasst werden, wenn der EBKuS-Server bzw. die MySQL-Datenbank nicht auf demselben Rechner laufen wie der Apache-Webserver.<br />
<br />
Die bei der Installation generierte Konfigurationsdatei definiert vier Instanzen (2 davon auskommentiert):<br />
<br />
*<code>demo</code>: Demodaten, kein Straßenkatalog<br />
*<code>muster_efb</code>: keine Demodaten, kein Straßenkatalog. Beispiel für eine Produktionsinstanz, die vom Anwendungsbetreuer eingerichtet werden muss (siehe Einrichtung der Anwendung im Handbuch).<br />
<br />
Auskommentiert:<br />
*<code>demo_berlin</code>: Demodaten, Berliner Straßenkatalog (kleiner Ausschnitt, nur Straßen, deren Namen mit 'K' beginnen)<br />
*<code>demo_braunschweig</code>: Demodaten, Straßenkatalog mit Straßen aus Braunschweig, Gifhorn, Wolfenbüttel und Wolfsburg.<br />
<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
<br />
<br />
|-<br />
|{{konfig|instance_name}}<br />
|style="background-color:orangered;"|{{code|}}<br />
|Name der Instanz. Muss angegeben werden und dem Namen des Abschnitts (in eckigen Klammern) identisch sein. Darf keine Sonderzeichen außer den Unterstrich ('_') enthalten.<br />
<br />
<br />
|-<br />
|{{konfig|instance_home}}<br />
|{{konfig|ebkus_home}}/{{konfig|instance_name}}<br />
|Instanzverzeichnis. Liegt im Homeverzeichnis. Sollte nicht verändert werden.<br />
<br />
|-<br />
|{{konfig|initial_content}}<br />
|{{code|}}<br />
|Hier kann eine Datei angegeben werden, mit der die Instanzdatenbank initialisiert werden kann. Diese Datei wird immer dann geladen, wenn bei der Installation der Instanz ({{code|install.py}} oder {{code|configure.py}}) keine funktionierende Datenbank für die Instanz vorgefunden wird. Wenn keine Datei angegeben ist, wird eine neue Datenbank mit dem Merkmalskatalog ({{file|sql/merkmale_standard.py}}) und evt. einem Straßenkatalog erstellt. Wenn kein vollständiger Pfad für die Datei angegeben wird, muss die Datei im Homeverzeichnis liegen. Zulässige Dateien sind die mit dem Skript {{code|datenbank_sichern.py}} erzeugte Dateien sowie sonstige passende SQL-Dumps.<br />
<br />
|-<br />
|{{konfig|berliner_version}}<br />
|{{code|false}}<br />
|Wenn hier {{code|true}} steht, wird die Berliner EBKuS-Version verwendet mit Berliner Straßenkatalog. <br />
<br />
|-<br />
|{{konfig|database_host}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer, auf dem der Datenbankserver läuft.<br />
<br />
|-<br />
|{{konfig|database_name}}<br />
|{{konfig|instance_name}}<br />
|Name der Instanzdatenbank<br />
<br />
<br />
|-<br />
|{{konfig|database_user}}<br />
|{{konfig|instance_name}}<br />
|Benutzername der Instanzdatenbank<br />
<br />
|-<br />
|{{konfig|database_password}}<br />
|{{konfig|instance_name}}<br />
|Passwort der Instanzdatenbank<br />
<br />
<br />
|-<br />
|{{konfig|gemeindeschluessel_von_plz}}<br />
|{{code|}}<br />
|Definiert die Teilmenge der amtlichen Gemeindeschlüssel für die Bundesstatistik. Im Normalfall muss hier nichts eingetragen werden.<br />
<br /><br />
In der Bundesstatistik soll der amtliche Gemeindeschlüssel für den Wohnort des Klienten eingetragen werden, wenn der Wohnort des Klienten außerhalb des Kreises der Beratungsstelle liegt. Um die Menge der Daten zu begrenzen, kann hier über die Anfangsziffern der Postleitzahl eine Teilmenge definiert werden. Wenn mehrere Ziffernfolgen angegeben werden, müssen diese mit <code>;</code> getrennt werden.<br /><br /> Beispiele: <ul> <li>Alle Gemeindeschlüssel verwenden, außer die Postleitzahl der Gemeinde beginnt mit '9': <pre> 0;1;2;3;4;5;6;7;8 </pre> </li> <li>Große Teile Niedersachsens: <pre> 29;30;31;37;38 </pre> </li> <li>Nördliches Niedersachsen und Schleswig Holstein: <pre> 2 </pre> </li> <li>Berlin und Umgebung: <pre> 10;12;13;14;15;16 </pre> </li> <li>Bleibt die Variable leer, werden alle Gemeindeschlüssel verwendet. </li> </ul> Wenn es bei der Erkennung von Gemeindeschluesseln zu vielen Fehlern kommt, beispielsweise wegen unterschiedlicher Schreibweisen von Orten, kann man selber eine Datei <code>EBKUS_HOME/sql/gemeindeschluessel.csv</code> erstellen, bestehend aus einer Tabelle mit den Spalten <code>plz, ort ags</code>. Als Vorlage kann die Datei <code>EBKUS_HOME/sql/gemeindeschluessel_cache.csv</code> dienen, die automatisch erzeugt wird, wenn die Konfigurationsvariable <code>gemeindeschluessel_von_plz</code> einen Wert hat. <br />
|-<br />
|{{konfig|host}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer des Rechners, auf der EBKuS-Server der Instanz läuft.<br />
<br />
<br />
|-<br />
|{{konfig|keine_bundesstatistik}}<br />
|{{code|false}}<br />
|Falls hier {{code|true}} steht, wird die Bundesstatistik aus der Anwendung ausgeblendet. Es kann keine Bundesstatistik ausgefüllt werden und steht auch nicht für Statistik und Export zur Verfügung.<br />
<br />
|-<br />
|{{konfig|log_file}}<br />
|{{konfig|instance_home}}{{code|/}}{{konfig|instance_name}}{{code|.log}}<br />
|Name der Datei, in die der EBKuS-Server Meldungen schreibt<br />
<br />
|-<br />
|{{konfig|log_level}}<br />
|{{code|INFO}}<br />
|Legt fest, wie "geschwätzig" der EBKuS-Server ist. Muss einer der folgenden Werte sein, in aufsteigender Wortfülle: {{code|CRITICAL, ERROR, WARNING, INFO, DEBUG}} ({{code|DEBUG}} ist nur für die Fehlersuche geeignet, da sehr viel ausgegeben wird.)<br />
<br />
|-<br />
|{{konfig|port}}<br />
|style="background-color:orangered;"|{{code|}}<br />
|Portnummer über die der EBKuS-Server angesprochen wird. Muss angegeben werden. Jede Instanz muss eine unterschiedliche Portnummer erhalten.<br />
|}<br />
<br />
<br />
==== Konfiguration für externe Anwendungen ====<br />
<br />
Die folgenden Konfigurationsvariablen bewirken, dass auf der Klientenkarte ein Kasten mit maximal vier Buttons erscheint, die in einem neuen Tab/Fenster eine URL aufrufen, die Felder des aktuellen (letzten) Falles bzw. des angemeldeten Mitarbeiters als Bestandteile haben kann:<br />
# Kein Kasten, wenn diese Variable keinen Wert hat.<br />
extern_fieldset_label: Externe Anwendung<br />
# Position auf der Klientenkarte<br />
extern_fieldset_position: 6<br />
# Maximal vier Buttons, für jeden eine Bezeichnung und eine Url.<br />
# Ein Button kommt nur zustande, wenn sowohl Label als auch Url<br />
# einen Wert haben. <br />
extern_button1_label: GoogleWeb<br />
extern_button1_url: <nowiki>http://www.google.com/search?q=$$fall_id$$_$$fall_akte__ort$$</nowiki><br />
extern_button2_label: GoogleMaps<br />
extern_button2_url: <nowiki>http://www.google.com/maps?q=$$mitarbeiter_na$$</nowiki><br />
extern_button3_label: GoogleImages<br />
extern_button3_url: <nowiki>http://www.google.com/images?q=$$fall_akte__ort$$</nowiki><br />
extern_button4_label: GoogleNews<br />
extern_button4_url: http://www.google.com/news?q=$$fall_fn$$</nowiki><br />
<br />
Urls können Abschnitte der folgenden Form enthalten:<br />
{{code|$$<fall oder mitarbeiter>_<feld>$$}}<br />
Der ganze Abschnitt wird durch den Wert von {{code|<feld>}} ersetzt, <br />
wobei entweder im Fall-Objekt oder im Mitarbeiter-Objekt <br />
nachgeschlagen wird. <br />
Beispiele:<br />
{{code|$$fall_id$$}}, {{code|$$mitarbeiter_na$$}}, {{code|$$fall_akte__ort$$}}<br />
<br />
Im Beispiel oben werden als externe Anwendungen verschiedene Google-Dienst aufgerufen, wobei als Parameter Daten aus dem aktuellen Fall übergeben werden.<br />
(Das Beispiel ist nicht sinnvoll und dient nur der Illustration des Mechanismus.)<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|extern_fieldset_label}}<br />
|{{code|}}<br />
|Bezeichnung für den Kasten mit den Buttons für die externen Anwendungen<br />
<br />
|-<br />
|{{konfig|extern_fieldset_position}}<br />
|{{code|2}}<br />
|Position auf der Klientenkarte (Gezählt werden die umrandeten Kästen mit einer Bezeichnung: Klientendaten, Bezugspersonen, Leistungen, etc.)<br />
|-<br />
|{{konfig|extern_buttonX_label}}<br />
|{{code|}}<br />
|Name der externen Anwendung<br />
<br />
<br />
|-<br />
|{{konfig|extern_buttonX_url}}<br />
|{{code|}}<br />
|URL der externen Anwendung mit Platzhaltern für die zu übernehmenden Parameter<br />
<br />
|}<br />
<br />
{{konfig|X}} kann 1,2,3 oder 4 sein.<br />
<br />
<br />
== Fachliche Parameter ==<br />
<br />
Die hier beschriebenen Einstellungen können auch vom Anwendungsbetreuer über {{pfad2|Administratorhauptmenü|Allgemeine Konfiguration}} vorgenommen werden.<br />
<br />
<br />
=== <nowiki>[</nowiki>''Instanz''<nowiki>]</nowiki> ===<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|admin_email}}<br />
|{{code|Keine Angabe}}<br />
|Email-Adresse des Anwendungsbetreuers.<br />
<br />
Wird in Fehlermeldungen genannt.<br />
|-<br />
|{{konfig|admin_name}}<br />
|{{code|Keine Angabe}}<br />
|Name des Anwendungsbetreuers.<br />
<br />
Wird in Fehlermeldungen genannt.<br />
|-<br />
|{{konfig|admin_tel}}<br />
|{{code|Keine Angabe}}<br />
|Telefonnummer des Anwendungsbetreuers.<br />
<br />
Wird in Fehlermeldungen genannt.<br />
|-<br />
|{{konfig|anmeldungsdaten_}} {{konfig|obligatorisch}}<br />
|{{code|false}}<br />
|Falls <code>true</code> werden die Anmeldungsdaten obligatorisch im Aufnahmeformular erhoben anstatt optional in einer getrennten Maske.<br />
<br />
Die entsprechenden Pflichfelder sind dabei auszufüllen. Eine spätere Bearbeitung der Anmeldungsdaten erfolgt wie bisher in einer eigenständigen Maske (analog der späteren Bearbeitung einer Leistung).<br />
|-<br />
|{{konfig|anmeldeprobleme_und_}} {{konfig|beschaeftigung_bei_}}{{konfig|anmeldung_erfassen}}<br />
|{{code|false}}<br />
|Falls <code>true</code> werden Probleme bei der Anmeldung und Beschäftigung schon bei der Anmeldung erfasst und später für die Fachstatistik übernommen.<br />
<br />
Die Auswahlfelder 'Beschäftigung Jugendliche(r)', 'Beschäftigungsverhältnis Mutter', 'Beschäftigungsverhältnis Vater' und das Mehrfachauswahlfeld 'Problem(e) bei der Anmeldung' aus der Fachstatistik werden in den Kasten Anmeldekontakt als Pflichtfelder aufgenommen. Es ist jedoch in jedem Fall möglich 'Keine Angabe' auszuwählen (genau wie in der Fachstatistik selbst). Die Daten werden mit dem Fall (nicht mit der Akte bzw. den Stammdaten) gespeichert. Wenn eine Fachstatistik angelegt wird, werden die Daten übernommen.<br />
|-<br />
|{{konfig|beratungskontakte}}<br />
|{{code|false}}<br />
|Falls <code>true</code> können in der Klientenakte einzelne Beratungskontakte eingetragen werden. Die Summen werden in die Bundesstatistik und in die Fachstatistik als Vorgabe übernommen.<br />
|-<br />
|{{konfig|beratungskontakte_bs}}<br />
|{{code|false}}<br />
|Falls <code>true</code> treten Anpassungen speziell für Braunschweig in Kraft.<br />
<br />
Die Variable <code>beratungskontakte</code> muss ebenfalls auf <code>true</code> stehen.<br />
|-<br />
|{{konfig|cache_on}}<br />
|{{code|true}}<br />
|Falls <code>true</code> wird der Objektcache eingeschaltet, sonst bleibt er abgeschaltet.<br />
<br />
Normalerweise ist der Cache an, aber es kann in seltenen Fällen zu Fehlern kommen, die verschwinden, wenn er abgeschaltet wird. Auf die inhaltlichen Abläufe hat das keine Auswirkungen, <br />
allenfalls auf die Performance.<br />
|-????<br />
|{{konfig|erinnern_nach_wochen_ohne_kontakt}}<br />
|{{code|0}}<br />
|Anzahl der Wochen ohne Kontakt nach der ein offener Fall in die Erinnerungsfunktion aufgenommen wird.<br />
<br />
Wenn hier eine Zahl zwischen 1 und 99 steht, wird die Erinnerungsfunktion aktiviert. Auf einem zusätzlichen Button im Hauptmenü steht dann die Anzahl der offenen Fälle, mit denen es länger als die angegebene Anzahl von Wochen keinen Kontakt gegeben hat. Nach dem Betätigen des Buttons erscheint eine Liste dieser Fälle. Jeder Fall kann als erledigt markiert werden, worauf er künftig normalerweiser nicht mehr in der Liste erscheint. Für die gesamte Liste gibt es aber eine Option, alle Fälle einschließlich der erledigten anzuzeigen. Die 'Erledigt'-Markierung kann dann auch wieder rückgängig gemacht werden.<br />
<br />
Es muss hier die Ziffer 0 stehen, wenn die Erinnerungsfunktion deaktiviert bleiben soll.<br />
|-<br />
|{{konfig|fachstatistik_akte_}} {{konfig|diskrepanz_nicht_zulassen}}<br />
|{{code|false}}<br />
|Falls <code>true</code> werden Diskrepanzen zwischen Fachstatistik und Akte nicht zugelassen.<br />
<br />
Die entsprechenden Items in der Fachstatistik zeigen die Werte aus der Akte und sind nicht modifizierbar. Eine Diskrepanz kann so gar nicht entstehen. Allerdings muss bei Änderungen in der Akte die Fachstatistik neu abgespeichert werden, damit die Änderungen übernommen und für die Statistik wirksam werden.<br /> Betroffen sind nur die Items 'Familienstatus', 'Empfohlen von' und 'Erbrachte Leistungen in der Fachstatistik', deren Werte im Normalfall aus der Akte vorbelegt werden.<br />
|-<br />
|{{konfig|fallunabhaengige}} {{konfig|_aktivitaeten_bs}}<br />
|{{code|false}}<br />
|Falls <code>true</code> können fallunabhängige Aktivitäten eingetragen und ausgewertet werden. Speziell für Braunschweig. <br />
|-<br />
|{{konfig|fallbeginn_bei_}}{{konfig|erster_leistung}}<br />
|{{code|false}}<br />
|Bei Neumelde- und Abschlusszahlen sowie Klienten pro Mitarbeiter wird der Fallbeginn ab dem Datum der erste Leistung definiert anstatt ab dem Anmeldedatum.<br />
|-<br />
|{{konfig|fallbeginn_waehlbar}}<br />
|{{code|false}}<br />
|Bei Neumelde- und Abschlusszahlen sowie Klienten pro Mitarbeiter kann ein Häkchen gesetzt werden, um den Fallbeginn ab erster Leistung zu definieren.<br />
|-<br />
|{{konfig|instance_title}}<br />
|{{konfig|instance_name}}<br />
|Langname für die Instanz.<br />
<br />
Erscheint bei der Anmeldung und in der Statuszeile.<br />
|-<br />
|{{konfig|jgh_gemeindeschluessel}}<br />
|{{code|}}<br />
|Die letzten drei Ziffern des [http://de.wikipedia.org/wiki/Amtlicher_Gemeindeschl%C3%BCssel" Amtlichen Gemeindeschlüssels] oder das Wort "blank".<br />
<br />
Standardmäßig setzt EBKuS für diese drei Ziffern (Spalte 7-9 des Exportdatensatzes) drei mal die Ziffer 0 ein. Unseres Wissens werden diese Daten für die<br />
Bundesstatistik allerdings nicht ausgewertet. Bei Bedarf kann hier das Wort "blank" angegeben werden, dann erscheinen im Datensatz drei Leerzeichen, oder es können drei Ziffern<br />
eingegeben werden, die dann in den Datensatz eingefügt werden.<br />
|-<br />
|{{konfig|leistungsende_in_}}<br />
{{konfig|zukunft_erlaubt}}<br />
|{{code|false}}<br />
|Beim Eintrag einer Leistung darf für das Ende ein Datum, das in der Zukunft liegt, eingetragen werden.<br />
<br />
Der Abschluss des Falls ist erst möglich, wenn alle Leistungen beendet sind.<br />
|-<br />
|{{konfig|loeschfrist}}<br />
|{{code|36}}<br />
|Löschfrist in Monaten.<br />
<br />
Akten, die älter sind, können vom Administrator gelöscht werden.<br />
|-<br />
|{{konfig|log_query_laenger_als}}<br />
|{{code|0}}<br />
|Falls größer 0, Datenbankqueries in die Logdatei schreiben, die länger dauern als die angegeben Zahl in Millisekunden.<br />
<br />
Wenn 0 eingetragen wird, werden keine Datenbankqueries protokolliert. Alle Datenbankqueries können mit <code>log_level=DEBUG</code> erfasst werden. Nützlich zur Diagnose von Performanceproblemen.<br />
|-<br />
|{{konfig|meldung_vom_admin}}<br />
|{{code|}}<br />
|Inhalt wird als Meldung vom Administrator unübersehbar auf jeder EBKuS-Seite über der Statuszeile ausgegeben.<br />
<br />
Damit kann der Administrator Meldungen an alle aktiven EBKuS-Nutzer ausgeben, z.B. um einen Ausfall von EBKuS wegen Wartungsarbeiten anzukündigen. <br />
|-<br />
|{{konfig|neumeldungen_nach_region}}<br />
|{{code|}}<br />
|Definiert eine Tabelle ''Neumeldungen nach Region'' unter ''Neumelde- und Abschlusszahlen''.<br />
<br />
Die Regionen, für die in der Tabelle die Neumeldungen ausgezählt werden sollen, müssen unter {{pfad4|Hauptmenü|Statistikabfrage|Teilmenge|Neu}} als Teilmengendefinitionen eingeführt werden. Der Namen der gewünschten Definitionen werden durch <code>;</code> getrennt aufgeführt. <br /><br /> Beispiel: <ul> <li> <pre> Gifhorn und Samtgemeinde Meinersen; Braunschweig 38120 und 38112 </pre> </li> </ul> "Gifhorn und Samtgemeinde Meinersen" ist eine Teilmengendefinition mit der Definition: <code>( ort = 'Gifhorn' ODER samtgemeinde = 'Meinersen' )</code>. "Braunschweig 38120 und 38112" ist eine Teilmengendefinition mit der Definition: <code>( ort = 'Braunschweig' UND plz = '38112' oder '38120' )</code>. <br /><br /> <br />
|-<br />
|{{konfig|session_time}}<br />
|{{code|120}}<br />
|Länge einer Session in Minuten. <br />
<br />
Nach dieser Zeit wird ein Benutzer automatisch abgemeldet, wenn er keine Eingaben mehr macht.<br />
|-<br />
|{{konfig|sql_abfrage}}<br />
|{{code|false}}<br />
|Falls <code>true</code> steht die Maske zum Absetzen von SQL-Abfragen vom Administrationsmenü aus zur Verfügung. <br />
<br />
|-<br />
|{{konfig|strassenkatalog}}<br />
|{{code|}}<br />
|Falls diese Variable nicht leer ist, wird bei der Adresseingabe der Straßenkatalog verwendet.<br />
<br />
Der eigentliche Wert der Variable spielt nur bei der Erstinstallation der Instanz eine Rolle.<br />Eine Instanz ohne Straßenkatalog kann auch später noch für die Verwendung mit Straßenkatalog eingerichtet werden, indem der Straßenkatalog über {{pfad2|Administratorhauptmenü|Straßenkatalog importieren}} importiert wird und der Variable {{konfig|strassenkatalog}} ein beliebiger Wert zugewiesen wird, beispielsweise der Ortsname.<br />
|-<br />
|{{konfig|strassenkatalog_}} {{konfig|vollstaendig}}<br />
|{{code|false}}<br />
|Falls <code>true</code> wird angenommen, dass der Straßenkatalog Einträge für jede einzelne Hausnummer enthält.<br />
<br />
Ansonsten wird angenommen, dass lediglich Einträge für ganze Straßen bzw. für bestimmte Intervalle von Hausnummern vorhanden sind.<br />
|-<br />
|{{konfig|strassensuche}}<br />
|{{code|}}<br />
|Bestimmt die Anzeige von Zusatzinformationen aus dem Straßenkatalog bei der Darstellung und Eingabe von Adressen.<br />
<br />
Zulässige Werte sind: <code>ort bezirk ortsteil samtgemeinde</code>.<br /><br /> Beispiele: <ul> <li>In Berlin gibt es nur einen Ort im Straßenkatalog, nämlich 'Berlin'. Das Feld <code>ort</code> ist daher nicht nötig. Ortsteil und Samtgemeinde haben im Straßenkatalog keine Werte, Bezirk allerdings schon. Der sinnvolle Wert für Berlin ist also <pre> bezirk </pre> </li> <li>In Gifhorn gibt es mehrere Orte im Straßenkatalog. Sowohl Ortsteile und Samtgemeinden spielen eine Rolle und sind im Straßenkatalog erfasst, Bezirke jedoch nicht. Der sinnvolle Wert hier ist also <pre> ort ortsteil samtgemeinde </pre> </li> <li>Wenn es nur einen Ort gibt und weder Bezirke, Ortsteile oder Samtgemeinden im Straßenkatalog erfasst sind, sollte die Variable leer bleiben. </ul> <br /><br />Irrelevant, wenn kein Straßenkatalog verwendet wird.<br />
|-<br />
|{{konfig|warnung_bei_fachstatistik_}} {{konfig|akte_diskrepanz}}<br />
|{{code|false}}<br />
|Falls <code>true</code> wird beim Speichern der Fachstatistik auf eine Diskrepanz zwischen Akte und Fachstatistik hingewiesen, falls vorhanden.<br />
<br />
Wenn man bei dem dann zur Verfügung stehendem Item "Diskrepanz zur Akte zulassen" ein Häkchen setzt, kann man trotzdem speichern.<br /> Betroffen sind nur die Items 'Familienstatus', 'Empfohlen von' und 'Erbrachte Leistungen in der Fachstatistik', deren Werte im Normalfall aus der Akte vorbelegt werden.<br />
|-<br />
|{{konfig|wiederaufnahmefrist}}<br />
|{{code|1}}<br />
|Anzahl der Monate, innerhalb derer ein abgeschlossener Fall wiederaufgenommen werden kann ("z.d.A. rückgängig").<br />
<br />
Danach muss ein neuer Fall angelegt werden.<br />
|-<br />
|{{konfig|wohnt_nicht_ausserhalb}}<br />
|{{code|}}<br />
|Definiert die Teilmenge der Adressen, die im Sinne der Bundesstatistik in die Zuständigkeit der Beratungsstelle fallen.<br />
<br />
Aufgrund der hier angegebenen Kriterien wird entschieden, ob der Klient in der Bundesstatistik als ausserhalb des Zuständigkeitsbereichs der Beratungsstelle wohnend angegeben wird. Als mögliche Kriterien kommen in Frage: <code>plz,ort,ortsteil,samtgemeinde,bezirk,plraum</code>. Die Kriterien <code>ortsteil,samtgemeinde,bezirk</code> sind nur sinnvoll, wenn ein Straßenkatalog verwendet wird und dieser auch entsprechende Angaben enthält. <br /><br /> Die Kriterien werden wie folgt in der angegebenen Reihenfolge abgearbeitet: <ul> <li>Wenn die Klientenadresse keinen Wert für das Kriterium aufweist, wird zum nächsten Kriterium übergegangen. </li> <li>Falls die Klientenadresse einen Wert hat und im Kriterium genannt wird, wohnt er nicht außerhalb. Ist der Wert im Kriterium nicht genannt, wohnt er außerhalb. In beiden Fällen werden die weiteren Kriterien nicht mehr betrachtet. </li> <li>Falls aufgrund fehlender Werte (oder fehlender Kriterien) kein Kriterium angewendet werden konnte, wird standardmäßig angenommen, dass der Klient nicht außerhalb wohnt. </li> </ul> Beispiele: <ul> <li> <pre> bezirk: Friedrichshain-Kreuzberg; ort: Berlin </pre> In Berlin enthalten alle mit dem Straßenkatalog abgeglichene Adressen einen Wert für den Bezirk. Da jede Beratungsstelle genau für einen Bezirk zuständig ist, kann auf dieser Basis entschieden werden. Falls eine Adresse nicht mit dem Straßenkatalog abgeglichen wurde, kann der Ort als Kriterium herangezogen werden, da in diesem Fall für Bezirk keine Angaben vorliegen. </li> <li> Falls kein Straßenkatalog verwendet wird, kann nur der Ort, die Postleitzahl oder evt. der Planungsraum (falls solche definiert sind und routinemäßig mit den Klientenadressen zusammen erfasst werden) als Kriterium verwendet werden, z.B. (fiktiv!): <pre> plz: 12345;23456;34567 </pre> Adressen mit diesen Postleitzahlen werden als nicht außerhalb wohnend betrachtet, alle anderen als außerhalb. Falls die Klientenadresse keine 5-stellige PLZ enthält, gilt der Wert als fehlend. Ungenauigkeiten werden in Kauf genommen, da die Region der Zuständigkeit nicht immer exakt mit den Regionen der Postleitzahlen übereinstimmt. </li> <li> <pre> samtgemeinde: Name1;Name2;Name3; plz: 12345;23456 </pre> Analog zum Berliner Beispiel würde hier auch zunächst das Kriterium Samtgemeinde versucht, das aber nur nach einem Abgleich mit dem Straßenkatalog bekannt ist. Für die nicht abgeglichenen Adressen wird dann die Postleitzahl herangezogen. In seltenen Fällen kann das zu Fehlern führen, da die Bereiche der Postleitzahlen manchmal nicht mit den Bereichen der Zuständigkeit exakt übereinstimmen. </li> </ul> Falls das Ergebnis "wohnt außerhalb" ist, wird automatisch ein entsprechender Eintrag in die Bundesstatistik vorgenommen, der beim Ausfüllen oben im Kasten "Falldaten" angezeigt wird. Wenn möglich wird der <strong>amtliche Gemeindeschlüssel</strong> eingetragen. Wenn dieser nicht gefunden wird, wird Postleitzahl und Wohnort angegeben. <br /><br /> <strong>Syntax</strong> wie in den Beispielen. Rund um die Trenner <code>;</code> und <code>:</code> dürfen Leerzeichen stehen. Es können auch mehrere Zeilen verwendet werden. <br /><br /> Unter (Berater-) {{pfad5|Hauptmenü|Statistik|Teilmenge|Neu|Neue Bedingung}}" finden Sie für jedes Kriterium die Menge der möglichen Werte. <br /><br /> Zur <strong>Testen</strong> gibt es unter {{pfad3|Aministratorhauptmenü|Bundesstatistik|Exportieren}} einen neuen Punkt ''Adressen außerhalb prüfen''. Sie können dort in einer Tabelle sehen, welche Adressen als außerhalb klassifiziert werden. <br />
|}</div>Ebkushttps://www.ebkus.org/wiki/KonfigurationKonfiguration2014-07-03T14:22:37Z<p>Ebkus: </p>
<hr />
<div>Die zentrale Konfigurationsdatei für eine EBKuS-Installation ist eine Textdatei namens <code>ebkus.conf</code> und befindet sich im Homeverzeichnis ({{file|ebkus}} im Installationsverzeichnis).<br />
<br />
Als Ausgangspunkt für die eigene Konfiguration dient die vom Installationsskript {{code|install.py}} aus einer [http://svn.berlios.de/wsvn/ebkus/ebkus-3/trunk/templates/ebkus.conf.template Vorlage] generierte Konfigurationsdatei. Die meisten Parameter (= Konfigurationvariable) sind darin bereits korrekt gesetzt.<br />
<br />
<br />
== Aufbau von <code>ebkus.conf</code> ==<br />
<br />
Zeilen, die leer sind oder mit dem Kommentarzeichen <code>#</code> beginnen, werden ignoriert, z.B.:<br />
<br />
<pre>#ebkus_home: %(install_dir)s\ebkus</pre><br />
<br />
In diesem Fall hat der Parameter den in der Tabelle genannten Standardwert.<br />
<br />
Zeilen, die nur aus einem Namen in eckigen Klammern bestehen, leiten eine Sektion ein, z.B.:<br />
<br />
<pre>[apache]</pre><br />
Die übrigen Zeilen weisen einem Parameter einen Wert zu. Sie beginnen mit dem Namen des Parameters, gefolgt von einem Doppelpunkt, gefolgt von dem Wert. Vor oder nach dem Doppelpunkt können Leerzeichen stehen. Beispiel:<br />
<br />
<pre>install_dir: C:\ebkus_installation</pre><br />
Werte können eine Syntax enthalten, die es erlaubt, vorher definierte Parameter in einen aktuellen Wert einzubeziehen (''Parametersubstitution''), z.B.:<br />
<br />
<pre>ebkus_home: %(install_dir)s\ebkus</pre><br />
Hier wird der Wert von <code>install_dir</code> in den Wert von <code>ebkus_home</code> einbezogen. Das ist genauso, als ob man gleich<br />
<br />
<pre>ebkus_home: C:\ebkus_installation\ebkus</pre><br />
definiert hätte. <code>%(</code>''parameter''<code>)s</code> wird durch den Wert von ''parameter'' ersetzt.<br />
<br />
Jede gültige Konfigurationsdatei muss die folgenden Sektionen aufweisen:<br />
<br />
*<code>[DEFAULT]</code><br />
*<code>[ebkus]</code><br />
*<code>[apache]</code><br />
*<code>[openssl]</code><br />
*eine Sektion für jede Instanz: <code>[</code>''Instanzname''<code>]</code><br />
<br />
Die möglichen Parameter für jede Sektion sind in den folgenden Tabellen aufgeführt.<br />
<br />
Alle Parameter außer denen, die in den Tabelle rot markiert sind, haben einen Standardwert (manchmal auch ''Defaultwert'' genannt), der in der Tabelle in der Spalte Standardwert angegeben ist. Ein Parameter hat diesen Wert, wenn er in der Konfiguration fehlt oder auskommentiert ist.<br />
<br />
Wie man sieht, können Parametersubstitutionen auch bei Standardwerten stattfinden. Der Wert des notwendige Parameter ''install_dir'' findet dadurch Eingang in weitere Parameter (''ebkus_home'', ''instance_home''), ohne dass diese explizit in der Konfiguration aufgeführt sind.<br />
<br />
''Anmerkung zu den Tabellen'': In einigen Fällen ist der angegebene Parameter bzw. Standardwert aus layout-technischen Gründen auf mehrere Zeilen verteilt, obwohl er eigentlich ohne Leerzeichen hintereinanderweg in einer Zeile stehen müsste.<br />
<br />
Wir unterscheiden ''Systemparameter'' von ''fachlichen Parametern''. Erstere betreffen den technischen Betrieb von EBKuS und werden von den Systemadministratoren (IT) bei der Installation eingerichtet. Fachparameter können ebenso wie Systemparameter in der {{file|ebkus.conf}} in der Instanzsektion gesetzt werden, außerdem kann aber auch der Anwendungsbetreuer über {{pfad2|Administratorhauptmenü|Allgemeine Konfiguration}} weitere Veränderungen vornehmen. Die vom Anwendungsbetreuer vorgenommenen Änderungen haben stets Vorrang über den Angaben in der {{file|ebkus.conf}}.<br />
<br />
<br />
== Systemparameter ==<br />
<br />
=== <nowiki>[DEFAULT]</nowiki> ===<br />
<br />
Die generierte Konfigurationsdatei enthält die korrekten Werte.<br />
<br />
Der Parameter {{konfig|install_dir}} bezeichnet das Installationsverzeichnis und muss immer in der Konfiguration definiert werden. Es bildet den Bezugspunkt für alle weiteren Pfade. Standardmäßig ist {{konfig|ebkus_home}} das Verzeichnis <code>ebkus</code> im Installationsverzeichnis; das sollte nicht verändert werden.<br />
<br />
Die in der Sektion <code>[DEFAULT]</code> definierten Parameter können in allen anderen Sektionen im Rahmen der Parametersubstitution als Teil eine Wertes verwendet werden (z.B. in der Definition von {{konfig|instance_home}}). Ansonsten stehen nur die Parameter derselben Sektion zur Verfügung.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|install_dir}}<br />
|style="background-color:orangered;"|{{code|}}<br />
|Installationsverzeichnis<br />
|-<br />
|{{konfig|ebkus_home}}<br />
|{{konfig|install_dir}}/ebkus<br />
|Homeverzeichnis<br />
|}<br />
<br />
<br />
=== <nowiki>[ebkus]</nowiki> ===<br />
<br />
Die generierte Konfigurationsdatei enthält in der Regel die korrekten Werte.<br />
<br />
Die {{konfig|database_admin_*}}-Parameter erlauben den Installationsskripten, neue Datenbanken für Instanzen einzurichten und diese bei der Deinstallation auch wieder zu entfernen.<br />
<br />
Falls aus Sicherheitsgründen erwünscht, kann hier ein Passwort für den Administratorzugriff auf MySQL eingetragen werden. Geschieht dies unter Windows vor der automatischen Installation von MySQL, wird bei der automatischen Installation der Administratorzugriff mit diesem Passwort eingerichtet.<br />
<br />
Falls das Passwort für den Administratorzugriff nicht im Klartext in der Konfigurationsdatei stehen soll, kann stattdessen <code>ASK</code>eingetragen werden. Dann fragen alle Skripte, die den Administratorzugriff benötigen, interaktiv nach dem Passwort, ohne es irgendwo zu speichern.<br />
<br />
Da MySQL standardmäßig nur von dem lokalen Rechner erreichbar ist, und dieser ohnehin nur für dem Administrator zugänglich ist, ist die zusätzliche Absicherung durch ein Passwort oft nicht nötig.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|download_dir}}<br />
|{{konfig|install_dir}}/download<br />
|Downloadverzeichnis. Dort steht die zu installierende Software, die im Bedarfsfall heruntergeladen wird.<br />
|-<br />
|{{konfig|database_admin_host}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer des Rechners, auf dem MySQL läuft. Muss angegeben werden, wenn das nicht der lokale Rechner ist.<br />
|-<br />
|{{konfig|database_admin_user}}<br />
|{{code|root}}<br />
|MySQL-Benutzer mit Administratorrechten<br />
|-<br />
|{{konfig|database_admin_password}}<br />
|{{code|}}<br />
|Dessen Passwort. Wenn hier ``ASK`` steht, wird das Passwort bei Bedarf interaktiv abgefragt.<br />
<br />
|-<br />
|{{konfig|mysql_dir}}<br />
|{{code|}}<br />
|Verzeichnis, in dem die MySQL-Programme mysql, mysqldump, etc. stehen. Muss angegeben werden, wenn MySQL-Programme nicht im Pfad stehen.<br />
<br />
|-<br />
|{{konfig|python_executable}}<br />
|<br />
|Vollständiger Pfad des Python-Executable, mit dem EBKuS ausgeführt wird<br />
|}<br />
<br />
<br />
=== <nowiki>[apache]</nowiki> ===<br />
<br />
Für den Parameter {{konfig|server_name}} muss unbedingt der Name oder die IP-Nummer des Rechners eingetragen werden, auf dem der Apache-Webserver läuft. Die generierte Konfigurationsdatei setzt den Standardwert <code>localhost</code>, womit EBKuS nur auf dem lokalen Rechner zugänglich ist.<br />
<br />
Für den Parameter {{konfig|server_admin}} sollte eine sinnvolle Email-Adresse eingetragen werden. Sie taucht in Apache-Fehlermeldungen auf (die allerdings normalerweise nicht vorkommen sollten).<br />
<br />
Alle übrigen Werte können in der Regel von der generierten Konfigurationsdatei übernommen werden.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|apache_log_dir}}<br />
|{{konfig|ebkus_home}}/log<br />
|Verzeichnis, in dem der Apache-Webserver Log-Dateien anlegt<br />
|-<br />
|{{konfig|server_admin}}<br />
|{{code|admin@localhost}}<br />
|Email-Adresse des Serveradministrators, die auf evt. Fehlerseiten des Servers erscheint.<br />
<br />
|-<br />
|{{konfig|server_name}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer des Rechners, auf dem der Apache-Webserver läuft.<br />
**Muss** explizit eingetragen werden, sonst kann EBKuS nur auf dem lokalen Rechner verwendet werden!<br />
<br />
|-<br />
|{{konfig|server_https_port}}<br />
|{{code|443}}<br />
|Port für verschlüsselte Verbindungen. Die EBKuS-Anwendung wird ausschließlich über diesen Port abgewickelt. Wenn der Standardport {{code|443}} nicht zur Verfügung steht, kann hier ein alternativer Port angegeben werden. Dieser muss dann als Teil der URL aufgeführt werden, z.B. für den Alternativport {{code|500}}: {{code|<nowiki>https://192.168.1.73:500/ebkus/demo/</nowiki>}}.<br />
<br />
|-<br />
|{{konfig|server_https_port}}<br />
|{{code|80}}<br />
|Port für unverschlüsselte Verbindungen. Die EBKuS-Anwendung verwendet diesen Port nicht. Dient nur zur Kontrolle des Apache Webservers: {{code|<nowiki>http://localhost/</nowiki>}} liefert "It works!". Wird hier der Port {{code|8080}} angegeben, müsste man {{code|<nowiki>http://localhost:8080/</nowiki>}} schreiben.<br />
<br />
|-<br />
|{{konfig|ssl_certificate_file}}<br />
|{{konfig|ebkus_home}}/ebkus_ssl_certificates/ebkusserver.cert<br />
|Vollständiger Pfad der SSL-Zertifikat-Datei<br />
<br />
<br />
|-<br />
|{{konfig|ssl_certificate_key_file}}<br />
|{{konfig|ebkus_home}}/ebkus_ssl_certificates/ebkusserver.key<br />
|Vollständiger Pfad der SSL-Schlüssel-Datei<br />
|}<br />
<br />
<br />
=== <nowiki>[openssl]</nowiki> ===<br />
<br />
Die Anwendung ist voll funktionsfähig mit den Werten aus der generierten Konfigurationsdatei; es empfiehlt sich jedoch, die organisatorischen Angaben für das SSL-Zertifikat anzupassen.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|openssl_executable}}<br />
|{{code|openssl}}<br />
|Falls openssl nicht im Pfad steht, muss der hier der vollständige Pfad zum Executable stehen<br />
<br />
|-<br />
|{{konfig|output_password}}<br />
|{{code|polo}}<br />
|Wird zur automatischen Zertifikatgenerierung benötigt<br />
<br />
|-<br />
|{{konfig|staat}}<br />
|{{code|DE}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|-<br />
|{{konfig|land}}<br />
|{{code|Berlin}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|-<br />
|{{konfig|ort}}<br />
|{{code|Berlin}}<br />
|Erscheint im SSL-Zertifikat<br />
|-<br />
|{{konfig|organisation}}<br />
|{{code|EFB}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|-<br />
|{{konfig|organisationseinheit}}<br />
|{{code|EFB}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|}<br />
<br />
<br />
=== <nowiki>[</nowiki>''Instanz''<nowiki>]</nowiki> ===<br />
<br />
<br />
Im Rahmen einer EBKuS-Installation auf einem Server können mehrere Instanzen einer EBKuS-Anwendung eingerichtet werden. Jede Instanz<br />
<br />
*hat einen Namen ({{konfig|instance_name}})<br />
*ist über eine eigene URL ansprechbar (<code>https://</code>'''server_name'''<code>/ebkus/</code>'''instance_name'''<code>/index.html</code>)<br />
*hat eine eigene Datenbank im Rahmen einer MySQL-Installation ({{konfig|database_name}}, {{konfig|database_user}}, {{konfig|database_password}})<br />
*hat ein eigenes Verzeichnis ({{konfig|instance_home}})<br />
*hat einen eigenen EBKuS-Server, der vom Apache-Webserver über eine eigene Portnummer angesprochen wird ({{konfig|port}})<br />
*hat eine eigene Log-Datei ({{konfig|log_file}})<br />
<br />
<br />
Für jede gewünschte Instanz wird eine Sektion in der Konfigurationsdatei angelegt. Die Sektionsüberschrift wird aus dem Namen der Instanz in eckigen Klammern gebildet. Der Name sollte mit einem Buchstaben beginnen und ansonsten nur Buchstaben, Ziffern und Unterstriche (<code>_</code>) enthalten (keine Leerzeichen!). Ein zusätzlicher Name für die Instanz ohne diese Einschränkung lässt sich über den Parameter {{konfig|instance_title}} einrichten (siehe unten).<br />
<br />
Falls der Instanzname mit <code>demo</code> beginnt, werden bei der Installation der Datenbank automatisch Demodaten erzeugt. Neben dem Benutzer <code>Admin</code> (Passwort: <code>Admin</code>) gibt es dann auch den Benutzer <code>test</code> (Passwort: <code>test</code>) und <code>verw</code>(Passwort: <code>verw</code>).<br />
<br />
Jede Sektion kann die in der Tabelle aufgeführten Parameter definieren. Erforderlich ist Wiederholung des Instanznamen als Wert von {{konfig|instance_name}}, ferner die Angabe einer eigenen, eindeutigen Portnummer, {{konfig|port}}. Für alle anderen Parameter können die Standardwerte genommen werden.<br />
<br />
Natürlich muss man {{konfig|berliner_version}} auf <code>true</code> setzen, wenn man die Berliner Version mit Berliner Straßenkatalog haben möchte; EBKuS-spezifische Fehlermeldungen sollten außerdem eine sinnvolle Telefonnummer bzw. Email-Adresse des Anwendungsbetreuers haben ({{konfig|admin_tel}}, {{konfig|admin_email}}).<br />
<br />
Die Parameter {{konfig|host}} und {{konfig|database_host}} müssen nur dann angepasst werden, wenn der EBKuS-Server bzw. die MySQL-Datenbank nicht auf demselben Rechner laufen wie der Apache-Webserver.<br />
<br />
Die bei der Installation generierte Konfigurationsdatei definiert vier Instanzen (2 davon auskommentiert):<br />
<br />
*<code>demo</code>: Demodaten, kein Straßenkatalog<br />
*<code>muster_efb</code>: keine Demodaten, kein Straßenkatalog. Beispiel für eine Produktionsinstanz, die vom Anwendungsbetreuer eingerichtet werden muss (siehe Einrichtung der Anwendung im Handbuch).<br />
<br />
Auskommentiert:<br />
*<code>demo_berlin</code>: Demodaten, Berliner Straßenkatalog (kleiner Ausschnitt, nur Straßen, deren Namen mit 'K' beginnen)<br />
*<code>demo_braunschweig</code>: Demodaten, Straßenkatalog mit Straßen aus Braunschweig, Gifhorn, Wolfenbüttel und Wolfsburg.<br />
<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
<br />
<br />
|-<br />
|{{konfig|instance_name}}<br />
|style="background-color:orangered;"|{{code|}}<br />
|Name der Instanz. Muss angegeben werden und dem Namen des Abschnitts (in eckigen Klammern) identisch sein. Darf keine Sonderzeichen außer den Unterstrich ('_') enthalten.<br />
<br />
<br />
|-<br />
|{{konfig|instance_home}}<br />
|{{konfig|ebkus_home}}/{{konfig|instance_name}}<br />
|Instanzverzeichnis. Liegt im Homeverzeichnis. Sollte nicht verändert werden.<br />
<br />
|-<br />
|{{konfig|initial_content}}<br />
|{{code|}}<br />
|Hier kann eine Datei angegeben werden, mit der die Instanzdatenbank initialisiert werden kann. Diese Datei wird immer dann geladen, wenn bei der Installation der Instanz ({{code|install.py}} oder {{code|configure.py}}) keine funktionierende Datenbank für die Instanz vorgefunden wird. Wenn keine Datei angegeben ist, wird eine neue Datenbank mit dem Merkmalskatalog ({{file|sql/merkmale_standard.py}}) und evt. einem Straßenkatalog erstellt. Wenn kein vollständiger Pfad für die Datei angegeben wird, muss die Datei im Homeverzeichnis liegen. Zulässige Dateien sind die mit dem Skript {{code|datenbank_sichern.py}} erzeugte Dateien sowie sonstige passende SQL-Dumps.<br />
<br />
|-<br />
|{{konfig|berliner_version}}<br />
|{{code|false}}<br />
|Wenn hier {{code|true}} steht, wird die Berliner EBKuS-Version verwendet mit Berliner Straßenkatalog. <br />
<br />
|-<br />
|{{konfig|database_host}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer, auf dem der Datenbankserver läuft.<br />
<br />
|-<br />
|{{konfig|database_name}}<br />
|{{konfig|instance_name}}<br />
|Name der Instanzdatenbank<br />
<br />
<br />
|-<br />
|{{konfig|database_user}}<br />
|{{konfig|instance_name}}<br />
|Benutzername der Instanzdatenbank<br />
<br />
|-<br />
|{{konfig|database_password}}<br />
|{{konfig|instance_name}}<br />
|Passwort der Instanzdatenbank<br />
<br />
<br />
|-<br />
|{{konfig|gemeindeschluessel_von_plz}}<br />
|{{code|}}<br />
|Definiert die Teilmenge der amtlichen Gemeindeschlüssel für die Bundesstatistik. Im Normalfall muss hier nichts eingetragen werden.<br />
<br /><br />
In der Bundesstatistik soll der amtliche Gemeindeschlüssel für den Wohnort des Klienten eingetragen werden, wenn der Wohnort des Klienten außerhalb des Kreises der Beratungsstelle liegt. Um die Menge der Daten zu begrenzen, kann hier über die Anfangsziffern der Postleitzahl eine Teilmenge definiert werden. Wenn mehrere Ziffernfolgen angegeben werden, müssen diese mit <code>;</code> getrennt werden.<br /><br /> Beispiele: <ul> <li>Alle Gemeindeschlüssel verwenden, außer die Postleitzahl der Gemeinde beginnt mit '9': <pre> 0;1;2;3;4;5;6;7;8 </pre> </li> <li>Große Teile Niedersachsens: <pre> 29;30;31;37;38 </pre> </li> <li>Nördliches Niedersachsen und Schleswig Holstein: <pre> 2 </pre> </li> <li>Berlin und Umgebung: <pre> 10;12;13;14;15;16 </pre> </li> <li>Bleibt die Variable leer, werden alle Gemeindeschlüssel verwendet. </li> </ul> Wenn es bei der Erkennung von Gemeindeschluesseln zu vielen Fehlern kommt, beispielsweise wegen unterschiedlicher Schreibweisen von Orten, kann man selber eine Datei <code>EBKUS_HOME/sql/gemeindeschluessel.csv</code> erstellen, bestehend aus einer Tabelle mit den Spalten <code>plz, ort ags</code>. Als Vorlage kann die Datei <code>EBKUS_HOME/sql/gemeindeschluessel_cache.csv</code> dienen, die automatisch erzeugt wird, wenn die Konfigurationsvariable <code>gemeindeschluessel_von_plz</code> einen Wert hat. <br />
|-<br />
|{{konfig|host}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer des Rechners, auf der EBKuS-Server der Instanz läuft.<br />
<br />
<br />
|-<br />
|{{konfig|keine_bundesstatistik}}<br />
|{{code|false}}<br />
|Falls hier {{code|true}} steht, wird die Bundesstatistik aus der Anwendung ausgeblendet. Es kann keine Bundesstatistik ausgefüllt werden und steht auch nicht für Statistik und Export zur Verfügung.<br />
<br />
|-<br />
|{{konfig|log_file}}<br />
|{{konfig|instance_home}}{{code|/}}{{konfig|instance_name}}{{code|.log}}<br />
|Name der Datei, in die der EBKuS-Server Meldungen schreibt<br />
<br />
|-<br />
|{{konfig|log_level}}<br />
|{{code|INFO}}<br />
|Legt fest, wie "geschwätzig" der EBKuS-Server ist. Muss einer der folgenden Werte sein, in aufsteigender Wortfülle: {{code|CRITICAL, ERROR, WARNING, INFO, DEBUG}} ({{code|DEBUG}} ist nur für die Fehlersuche geeignet, da sehr viel ausgegeben wird.)<br />
<br />
|-<br />
|{{konfig|port}}<br />
|style="background-color:orangered;"|{{code|}}<br />
|Portnummer über die der EBKuS-Server angesprochen wird. Muss angegeben werden. Jede Instanz muss eine unterschiedliche Portnummer erhalten.<br />
|}<br />
<br />
<br />
==== Konfiguration für externe Anwendungen ====<br />
<br />
Die folgenden Konfigurationsvariablen bewirken, dass auf der Klientenkarte ein Kasten mit maximal vier Buttons erscheint, die in einem neuen Tab/Fenster eine URL aufrufen, die Felder des aktuellen (letzten) Falles bzw. des angemeldeten Mitarbeiters als Bestandteile haben kann:<br />
# Kein Kasten, wenn diese Variable keinen Wert hat.<br />
extern_fieldset_label: Externe Anwendung<br />
# Position auf der Klientenkarte<br />
extern_fieldset_position: 6<br />
# Maximal vier Buttons, für jeden eine Bezeichnung und eine Url.<br />
# Ein Button kommt nur zustande, wenn sowohl Label als auch Url<br />
# einen Wert haben. <br />
extern_button1_label: GoogleWeb<br />
extern_button1_url: <nowiki>http://www.google.com/search?q=$$fall_id$$_$$fall_akte__ort$$</nowiki><br />
extern_button2_label: GoogleMaps<br />
extern_button2_url: <nowiki>http://www.google.com/maps?q=$$mitarbeiter_na$$</nowiki><br />
extern_button3_label: GoogleImages<br />
extern_button3_url: <nowiki>http://www.google.com/images?q=$$fall_akte__ort$$</nowiki><br />
extern_button4_label: GoogleNews<br />
extern_button4_url: http://www.google.com/news?q=$$fall_fn$$</nowiki><br />
<br />
Urls können Abschnitte der folgenden Form enthalten:<br />
{{code|$$<fall oder mitarbeiter>_<feld>$$}}<br />
Der ganze Abschnitt wird durch den Wert von {{code|<feld>}} ersetzt, <br />
wobei entweder im Fall-Objekt oder im Mitarbeiter-Objekt <br />
nachgeschlagen wird. <br />
Beispiele:<br />
{{code|$$fall_id$$}}, {{code|$$mitarbeiter_na$$}}, {{code|$$fall_akte__ort$$}}<br />
<br />
Im Beispiel oben werden als externe Anwendungen verschiedene Google-Dienst aufgerufen, wobei als Parameter Daten aus dem aktuellen Fall übergeben werden.<br />
(Das Beispiel ist nicht sinnvoll und dient nur der Illustration des Mechanismus.)<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|extern_fieldset_label}}<br />
|{{code|}}<br />
|Bezeichnung für den Kasten mit den Buttons für die externen Anwendungen<br />
<br />
|-<br />
|{{konfig|extern_fieldset_position}}<br />
|{{code|2}}<br />
|Position auf der Klientenkarte (Gezählt werden die umrandeten Kästen mit einer Bezeichnung: Klientendaten, Bezugspersonen, Leistungen, etc.)<br />
|-<br />
|{{konfig|extern_buttonX_label}}<br />
|{{code|}}<br />
|Name der externen Anwendung<br />
<br />
<br />
|-<br />
|{{konfig|extern_buttonX_url}}<br />
|{{code|}}<br />
|URL der externen Anwendung mit Platzhaltern für die zu übernehmenden Parameter<br />
<br />
|}<br />
<br />
{{konfig|X}} kann 1,2,3 oder 4 sein.<br />
<br />
<br />
== Fachliche Parameter ==<br />
<br />
Die hier beschriebenen Einstellungen können auch vom Anwendungsbetreuer über {{pfad2|Administratorhauptmenü|Allgemeine Konfiguration}} vorgenommen werden.<br />
<br />
<br />
=== <nowiki>[</nowiki>''Instanz''<nowiki>]</nowiki> ===<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|admin_email}}<br />
|{{code|Keine Angabe}}<br />
|Email-Adresse des Anwendungsbetreuers.<br />
<br />
Wird in Fehlermeldungen genannt.<br />
|-<br />
|{{konfig|admin_name}}<br />
|{{code|Keine Angabe}}<br />
|Name des Anwendungsbetreuers.<br />
<br />
Wird in Fehlermeldungen genannt.<br />
|-<br />
|{{konfig|admin_tel}}<br />
|{{code|Keine Angabe}}<br />
|Telefonnummer des Anwendungsbetreuers.<br />
<br />
Wird in Fehlermeldungen genannt.<br />
|-<br />
|{{konfig|anmeldungsdaten_}} {{konfig|obligatorisch}}<br />
|{{code|false}}<br />
|Falls <code>true</code> werden die Anmeldungsdaten obligatorisch im Aufnahmeformular erhoben anstatt optional in einer getrennten Maske.<br />
<br />
Die entsprechenden Pflichfelder sind dabei auszufüllen. Eine spätere Bearbeitung der Anmeldungsdaten erfolgt wie bisher in einer eigenständigen Maske (analog der späteren Bearbeitung einer Leistung).<br />
|-<br />
|{{konfig|anmeldeprobleme_und_}} {{konfig|beschaeftigung_bei_}}{{konfig|anmeldung_erfassen}}<br />
|{{code|false}}<br />
|Falls <code>true</code> werden Probleme bei der Anmeldung und Beschäftigung schon bei der Anmeldung erfasst und später für die Fachstatistik übernommen.<br />
<br />
Die Auswahlfelder 'Beschäftigung Jugendliche(r)', 'Beschäftigungsverhältnis Mutter', 'Beschäftigungsverhältnis Vater' und das Mehrfachauswahlfeld 'Problem(e) bei der Anmeldung' aus der Fachstatistik werden in den Kasten Anmeldekontakt als Pflichtfelder aufgenommen. Es ist jedoch in jedem Fall möglich 'Keine Angabe' auszuwählen (genau wie in der Fachstatistik selbst). Die Daten werden mit dem Fall (nicht mit der Akte bzw. den Stammdaten) gespeichert. Wenn eine Fachstatistik angelegt wird, werden die Daten übernommen.<br />
|-<br />
|{{konfig|beratungskontakte}}<br />
|{{code|false}}<br />
|Falls <code>true</code> können in der Klientenakte einzelne Beratungskontakte eingetragen werden. Die Summen werden in die Bundesstatistik und in die Fachstatistik als Vorgabe übernommen.<br />
|-<br />
|{{konfig|beratungskontakte_bs}}<br />
|{{code|false}}<br />
|Falls <code>true</code> treten Anpassungen speziell für Braunschweig in Kraft.<br />
<br />
Die Variable <code>beratungskontakte</code> muss ebenfalls auf <code>true</code> stehen.<br />
|-<br />
|{{konfig|cache_on}}<br />
|{{code|true}}<br />
|Falls <code>true</code> wird der Objektcache eingeschaltet, sonst bleibt er abgeschaltet.<br />
<br />
Normalerweise ist der Cache an, aber es kann in seltenen Fällen zu Fehlern kommen, die verschwinden, wenn er abgeschaltet wird. Auf die inhaltlichen Abläufe hat das keine Auswirkungen, <br />
allenfalls auf die Performance.<br />
|-????<br />
|{{konfig|erinnern_nach_wochen_ohne_kontakt}}<br />
|{{code|0}}<br />
|Anzahl der Wochen ohne Kontakt nach der ein offener Fall in die Erinnerungsfunktion aufgenommen wird.<br />
<br />
Wenn hier eine Zahl zwischen 1 und 99 steht, wird die Erinnerungsfunktion aktiviert. Auf einem zusätzlichen Button im Hauptmenü steht dann die Anzahl der offenen Fälle, mit denen es länger als die angegebene Anzahl von Wochen keinen Kontakt gegeben hat. Nach dem Betätigen des Buttons erscheint eine Liste dieser Fälle. Jeder Fall kann als erledigt markiert werden, worauf er künftig normalerweiser nicht mehr in der Liste erscheint. Für die gesamte Liste gibt es aber eine Option, alle Fälle einschließlich der erledigten anzuzeigen. Die 'Erledigt'-Markierung kann dann auch wieder rückgängig gemacht werden.<br />
<br />
Es muss hier die Ziffer 0 stehen, wenn die Erinnerungsfunktion deaktiviert bleiben soll.<br />
|-<br />
|{{konfig|fachstatistik_akte_}} {{konfig|diskrepanz_nicht_zulassen}}<br />
|{{code|false}}<br />
|Falls <code>true</code> werden Diskrepanzen zwischen Fachstatistik und Akte nicht zugelassen.<br />
<br />
Die entsprechenden Items in der Fachstatistik zeigen die Werte aus der Akte und sind nicht modifizierbar. Eine Diskrepanz kann so gar nicht entstehen. Allerdings muss bei Änderungen in der Akte die Fachstatistik neu abgespeichert werden, damit die Änderungen übernommen und für die Statistik wirksam werden.<br /> Betroffen sind nur die Items 'Familienstatus', 'Empfohlen von' und 'Erbrachte Leistungen in der Fachstatistik', deren Werte im Normalfall aus der Akte vorbelegt werden.<br />
|-<br />
|{{konfig|fallunabhaengige}} {{konfig|_aktivitaeten_bs}}<br />
|{{code|false}}<br />
|Falls <code>true</code> können fallunabhängige Aktivitäten eingetragen und ausgewertet werden. Speziell für Braunschweig. <br />
|-<br />
|{{konfig|fallbeginn_bei_}}{{konfig|erster_leistung}}<br />
|{{code|false}}<br />
|Bei Neumelde- und Abschlusszahlen sowie Klienten pro Mitarbeiter wird der Fallbeginn ab dem Datum der erste Leistung definiert anstatt ab dem Anmeldedatum.<br />
|-<br />
|{{konfig|fallbeginn_waehlbar}}<br />
|{{code|false}}<br />
|Bei Neumelde- und Abschlusszahlen sowie Klienten pro Mitarbeiter kann ein Häkchen gesetzt werden, um den Fallbeginn ab erster Leistung zu definieren.<br />
|-<br />
|{{konfig|instance_title}}<br />
|{{konfig|instance_name}}<br />
|Langname für die Instanz.<br />
<br />
Erscheint bei der Anmeldung und in der Statuszeile.<br />
|-<br />
|{{konfig|jgh_gemeindeschluessel}}<br />
|{{code|}}<br />
|Die letzten drei Ziffern des [http://de.wikipedia.org/wiki/Amtlicher_Gemeindeschl%C3%BCssel" Amtlichen Gemeindeschlüssels] oder das Wort "blank".<br />
<br />
Standardmäßig setzt EBKuS für diese drei Ziffern (Spalte 7-9 des Exportdatensatzes) drei mal die Ziffer 0 ein. Unseres Wissens werden diese Daten für die<br />
Bundesstatistik allerdings nicht ausgewertet. Bei Bedarf kann hier das Wort "blank" angegeben werden, dann erscheinen im Datensatz drei Leerzeichen, oder es können drei Ziffern<br />
eingegeben werden, die dann in den Datensatz eingefügt werden.<br />
|-<br />
|{{konfig|leistungsende_in_}}<br />
{{konfig|zukunft_erlaubt}}<br />
|{{code|false}}<br />
|Beim Eintrag einer Leistung darf für das Ende ein Datum, das in der Zukunft liegt, eingetragen werden.<br />
<br />
Der Abschluss des Falls ist erst möglich, wenn alle Leistungen beendet sind.<br />
|-<br />
|{{konfig|loeschfrist}}<br />
|{{code|36}}<br />
|Löschfrist in Monaten.<br />
<br />
Akten, die älter sind, können vom Administrator gelöscht werden.<br />
|-<br />
|{{konfig|log_query_laenger_als}}<br />
|{{code|0}}<br />
|Falls größer 0, Datenbankqueries in die Logdatei schreiben, die länger dauern als die angegeben Zahl in Millisekunden.<br />
<br />
Wenn 0 eingetragen wird, werden keine Datenbankqueries protokolliert. Alle Datenbankqueries können mit <code>log_level=DEBUG<code> erfasst werden. Nützlich zur Diagnose von Performanceproblemen.<br />
|-<br />
|{{konfig|meldung_vom_admin}}<br />
|{{code|}}<br />
|Inhalt wird als Meldung vom Administrator unübersehbar auf jeder EBKuS-Seite über der Statuszeile ausgegeben.<br />
<br />
Damit kann der Administrator Meldungen an alle aktiven EBKuS-Nutzer ausgeben, z.B. um einen Ausfall von EBKuS wegen Wartungsarbeiten anzukündigen. <br />
|-<br />
|{{konfig|neumeldungen_nach_region}}<br />
|{{code|}}<br />
|Definiert eine Tabelle ''Neumeldungen nach Region'' unter ''Neumelde- und Abschlusszahlen''.<br />
<br />
Die Regionen, für die in der Tabelle die Neumeldungen ausgezählt werden sollen, müssen unter {{pfad4|Hauptmenü|Statistikabfrage|Teilmenge|Neu}} als Teilmengendefinitionen eingeführt werden. Der Namen der gewünschten Definitionen werden durch <code>;</code> getrennt aufgeführt. <br /><br /> Beispiel: <ul> <li> <pre> Gifhorn und Samtgemeinde Meinersen; Braunschweig 38120 und 38112 </pre> </li> </ul> "Gifhorn und Samtgemeinde Meinersen" ist eine Teilmengendefinition mit der Definition: <code>( ort = 'Gifhorn' ODER samtgemeinde = 'Meinersen' )</code>. "Braunschweig 38120 und 38112" ist eine Teilmengendefinition mit der Definition: <code>( ort = 'Braunschweig' UND plz = '38112' oder '38120' )</code>. <br /><br /> <br />
|-<br />
|{{konfig|session_time}}<br />
|{{code|120}}<br />
|Länge einer Session in Minuten. <br />
<br />
Nach dieser Zeit wird ein Benutzer automatisch abgemeldet, wenn er keine Eingaben mehr macht.<br />
|-<br />
|{{konfig|sql_abfrage}}<br />
|{{code|false}}<br />
|Falls <code>true</code> steht die Maske zum Absetzen von SQL-Abfragen vom Administrationsmenü aus zur Verfügung. <br />
<br />
|-<br />
|{{konfig|strassenkatalog}}<br />
|{{code|}}<br />
|Falls diese Variable nicht leer ist, wird bei der Adresseingabe der Straßenkatalog verwendet.<br />
<br />
Der eigentliche Wert der Variable spielt nur bei der Erstinstallation der Instanz eine Rolle.<br />Eine Instanz ohne Straßenkatalog kann auch später noch für die Verwendung mit Straßenkatalog eingerichtet werden, indem der Straßenkatalog über {{pfad2|Administratorhauptmenü|Straßenkatalog importieren}} importiert wird und der Variable {{konfig|strassenkatalog}} ein beliebiger Wert zugewiesen wird, beispielsweise der Ortsname.<br />
|-<br />
|{{konfig|strassenkatalog_}} {{konfig|vollstaendig}}<br />
|{{code|false}}<br />
|Falls <code>true</code> wird angenommen, dass der Straßenkatalog Einträge für jede einzelne Hausnummer enthält.<br />
<br />
Ansonsten wird angenommen, dass lediglich Einträge für ganze Straßen bzw. für bestimmte Intervalle von Hausnummern vorhanden sind.<br />
|-<br />
|{{konfig|strassensuche}}<br />
|{{code|}}<br />
|Bestimmt die Anzeige von Zusatzinformationen aus dem Straßenkatalog bei der Darstellung und Eingabe von Adressen.<br />
<br />
Zulässige Werte sind: <code>ort bezirk ortsteil samtgemeinde</code>.<br /><br /> Beispiele: <ul> <li>In Berlin gibt es nur einen Ort im Straßenkatalog, nämlich 'Berlin'. Das Feld <code>ort</code> ist daher nicht nötig. Ortsteil und Samtgemeinde haben im Straßenkatalog keine Werte, Bezirk allerdings schon. Der sinnvolle Wert für Berlin ist also <pre> bezirk </pre> </li> <li>In Gifhorn gibt es mehrere Orte im Straßenkatalog. Sowohl Ortsteile und Samtgemeinden spielen eine Rolle und sind im Straßenkatalog erfasst, Bezirke jedoch nicht. Der sinnvolle Wert hier ist also <pre> ort ortsteil samtgemeinde </pre> </li> <li>Wenn es nur einen Ort gibt und weder Bezirke, Ortsteile oder Samtgemeinden im Straßenkatalog erfasst sind, sollte die Variable leer bleiben. </ul> <br /><br />Irrelevant, wenn kein Straßenkatalog verwendet wird.<br />
|-<br />
|{{konfig|warnung_bei_fachstatistik_}} {{konfig|akte_diskrepanz}}<br />
|{{code|false}}<br />
|Falls <code>true</code> wird beim Speichern der Fachstatistik auf eine Diskrepanz zwischen Akte und Fachstatistik hingewiesen, falls vorhanden.<br />
<br />
Wenn man bei dem dann zur Verfügung stehendem Item "Diskrepanz zur Akte zulassen" ein Häkchen setzt, kann man trotzdem speichern.<br /> Betroffen sind nur die Items 'Familienstatus', 'Empfohlen von' und 'Erbrachte Leistungen in der Fachstatistik', deren Werte im Normalfall aus der Akte vorbelegt werden.<br />
|-<br />
|{{konfig|wiederaufnahmefrist}}<br />
|{{code|1}}<br />
|Anzahl der Monate, innerhalb derer ein abgeschlossener Fall wiederaufgenommen werden kann ("z.d.A. rückgängig").<br />
<br />
Danach muss ein neuer Fall angelegt werden.<br />
|-<br />
|{{konfig|wohnt_nicht_ausserhalb}}<br />
|{{code|}}<br />
|Definiert die Teilmenge der Adressen, die im Sinne der Bundesstatistik in die Zuständigkeit der Beratungsstelle fallen.<br />
<br />
Aufgrund der hier angegebenen Kriterien wird entschieden, ob der Klient in der Bundesstatistik als ausserhalb des Zuständigkeitsbereichs der Beratungsstelle wohnend angegeben wird. Als mögliche Kriterien kommen in Frage: <code>plz,ort,ortsteil,samtgemeinde,bezirk,plraum</code>. Die Kriterien <code>ortsteil,samtgemeinde,bezirk</code> sind nur sinnvoll, wenn ein Straßenkatalog verwendet wird und dieser auch entsprechende Angaben enthält. <br /><br /> Die Kriterien werden wie folgt in der angegebenen Reihenfolge abgearbeitet: <ul> <li>Wenn die Klientenadresse keinen Wert für das Kriterium aufweist, wird zum nächsten Kriterium übergegangen. </li> <li>Falls die Klientenadresse einen Wert hat und im Kriterium genannt wird, wohnt er nicht außerhalb. Ist der Wert im Kriterium nicht genannt, wohnt er außerhalb. In beiden Fällen werden die weiteren Kriterien nicht mehr betrachtet. </li> <li>Falls aufgrund fehlender Werte (oder fehlender Kriterien) kein Kriterium angewendet werden konnte, wird standardmäßig angenommen, dass der Klient nicht außerhalb wohnt. </li> </ul> Beispiele: <ul> <li> <pre> bezirk: Friedrichshain-Kreuzberg; ort: Berlin </pre> In Berlin enthalten alle mit dem Straßenkatalog abgeglichene Adressen einen Wert für den Bezirk. Da jede Beratungsstelle genau für einen Bezirk zuständig ist, kann auf dieser Basis entschieden werden. Falls eine Adresse nicht mit dem Straßenkatalog abgeglichen wurde, kann der Ort als Kriterium herangezogen werden, da in diesem Fall für Bezirk keine Angaben vorliegen. </li> <li> Falls kein Straßenkatalog verwendet wird, kann nur der Ort, die Postleitzahl oder evt. der Planungsraum (falls solche definiert sind und routinemäßig mit den Klientenadressen zusammen erfasst werden) als Kriterium verwendet werden, z.B. (fiktiv!): <pre> plz: 12345;23456;34567 </pre> Adressen mit diesen Postleitzahlen werden als nicht außerhalb wohnend betrachtet, alle anderen als außerhalb. Falls die Klientenadresse keine 5-stellige PLZ enthält, gilt der Wert als fehlend. Ungenauigkeiten werden in Kauf genommen, da die Region der Zuständigkeit nicht immer exakt mit den Regionen der Postleitzahlen übereinstimmt. </li> <li> <pre> samtgemeinde: Name1;Name2;Name3; plz: 12345;23456 </pre> Analog zum Berliner Beispiel würde hier auch zunächst das Kriterium Samtgemeinde versucht, das aber nur nach einem Abgleich mit dem Straßenkatalog bekannt ist. Für die nicht abgeglichenen Adressen wird dann die Postleitzahl herangezogen. In seltenen Fällen kann das zu Fehlern führen, da die Bereiche der Postleitzahlen manchmal nicht mit den Bereichen der Zuständigkeit exakt übereinstimmen. </li> </ul> Falls das Ergebnis "wohnt außerhalb" ist, wird automatisch ein entsprechender Eintrag in die Bundesstatistik vorgenommen, der beim Ausfüllen oben im Kasten "Falldaten" angezeigt wird. Wenn möglich wird der <strong>amtliche Gemeindeschlüssel</strong> eingetragen. Wenn dieser nicht gefunden wird, wird Postleitzahl und Wohnort angegeben. <br /><br /> <strong>Syntax</strong> wie in den Beispielen. Rund um die Trenner <code>;</code> und <code>:</code> dürfen Leerzeichen stehen. Es können auch mehrere Zeilen verwendet werden. <br /><br /> Unter (Berater-) {{pfad5|Hauptmenü|Statistik|Teilmenge|Neu|Neue Bedingung}}" finden Sie für jedes Kriterium die Menge der möglichen Werte. <br /><br /> Zur <strong>Testen</strong> gibt es unter {{pfad3|Aministratorhauptmenü|Bundesstatistik|Exportieren}} einen neuen Punkt ''Adressen außerhalb prüfen''. Sie können dort in einer Tabelle sehen, welche Adressen als außerhalb klassifiziert werden. <br />
|}</div>Ebkushttps://www.ebkus.org/wiki/KonfigurationKonfiguration2014-07-03T14:19:37Z<p>Ebkus: </p>
<hr />
<div>Die zentrale Konfigurationsdatei für eine EBKuS-Installation ist eine Textdatei namens <code>ebkus.conf</code> und befindet sich im Homeverzeichnis ({{file|ebkus}} im Installationsverzeichnis).<br />
<br />
Als Ausgangspunkt für die eigene Konfiguration dient die vom Installationsskript {{code|install.py}} aus einer [http://svn.berlios.de/wsvn/ebkus/ebkus-3/trunk/templates/ebkus.conf.template Vorlage] generierte Konfigurationsdatei. Die meisten Parameter (= Konfigurationvariable) sind darin bereits korrekt gesetzt.<br />
<br />
<br />
== Aufbau von <code>ebkus.conf</code> ==<br />
<br />
Zeilen, die leer sind oder mit dem Kommentarzeichen <code>#</code> beginnen, werden ignoriert, z.B.:<br />
<br />
<pre>#ebkus_home: %(install_dir)s\ebkus</pre><br />
<br />
In diesem Fall hat der Parameter den in der Tabelle genannten Standardwert.<br />
<br />
Zeilen, die nur aus einem Namen in eckigen Klammern bestehen, leiten eine Sektion ein, z.B.:<br />
<br />
<pre>[apache]</pre><br />
Die übrigen Zeilen weisen einem Parameter einen Wert zu. Sie beginnen mit dem Namen des Parameters, gefolgt von einem Doppelpunkt, gefolgt von dem Wert. Vor oder nach dem Doppelpunkt können Leerzeichen stehen. Beispiel:<br />
<br />
<pre>install_dir: C:\ebkus_installation</pre><br />
Werte können eine Syntax enthalten, die es erlaubt, vorher definierte Parameter in einen aktuellen Wert einzubeziehen (''Parametersubstitution''), z.B.:<br />
<br />
<pre>ebkus_home: %(install_dir)s\ebkus</pre><br />
Hier wird der Wert von <code>install_dir</code> in den Wert von <code>ebkus_home</code> einbezogen. Das ist genauso, als ob man gleich<br />
<br />
<pre>ebkus_home: C:\ebkus_installation\ebkus</pre><br />
definiert hätte. <code>%(</code>''parameter''<code>)s</code> wird durch den Wert von ''parameter'' ersetzt.<br />
<br />
Jede gültige Konfigurationsdatei muss die folgenden Sektionen aufweisen:<br />
<br />
*<code>[DEFAULT]</code><br />
*<code>[ebkus]</code><br />
*<code>[apache]</code><br />
*<code>[openssl]</code><br />
*eine Sektion für jede Instanz: <code>[</code>''Instanzname''<code>]</code><br />
<br />
Die möglichen Parameter für jede Sektion sind in den folgenden Tabellen aufgeführt.<br />
<br />
Alle Parameter außer denen, die in den Tabelle rot markiert sind, haben einen Standardwert (manchmal auch ''Defaultwert'' genannt), der in der Tabelle in der Spalte Standardwert angegeben ist. Ein Parameter hat diesen Wert, wenn er in der Konfiguration fehlt oder auskommentiert ist.<br />
<br />
Wie man sieht, können Parametersubstitutionen auch bei Standardwerten stattfinden. Der Wert des notwendige Parameter ''install_dir'' findet dadurch Eingang in weitere Parameter (''ebkus_home'', ''instance_home''), ohne dass diese explizit in der Konfiguration aufgeführt sind.<br />
<br />
''Anmerkung zu den Tabellen'': In einigen Fällen ist der angegebene Parameter bzw. Standardwert aus layout-technischen Gründen auf mehrere Zeilen verteilt, obwohl er eigentlich ohne Leerzeichen hintereinanderweg in einer Zeile stehen müsste.<br />
<br />
Wir unterscheiden ''Systemparameter'' von ''fachlichen Parametern''. Erstere betreffen den technischen Betrieb von EBKuS und werden von den Systemadministratoren (IT) bei der Installation eingerichtet. Fachparameter können ebenso wie Systemparameter in der {{file|ebkus.conf}} in der Instanzsektion gesetzt werden, außerdem kann aber auch der Anwendungsbetreuer über {{pfad2|Administratorhauptmenü|Allgemeine Konfiguration}} weitere Veränderungen vornehmen. Die vom Anwendungsbetreuer vorgenommenen Änderungen haben stets Vorrang über den Angaben in der {{file|ebkus.conf}}.<br />
<br />
<br />
== Systemparameter ==<br />
<br />
=== <nowiki>[DEFAULT]</nowiki> ===<br />
<br />
Die generierte Konfigurationsdatei enthält die korrekten Werte.<br />
<br />
Der Parameter {{konfig|install_dir}} bezeichnet das Installationsverzeichnis und muss immer in der Konfiguration definiert werden. Es bildet den Bezugspunkt für alle weiteren Pfade. Standardmäßig ist {{konfig|ebkus_home}} das Verzeichnis <code>ebkus</code> im Installationsverzeichnis; das sollte nicht verändert werden.<br />
<br />
Die in der Sektion <code>[DEFAULT]</code> definierten Parameter können in allen anderen Sektionen im Rahmen der Parametersubstitution als Teil eine Wertes verwendet werden (z.B. in der Definition von {{konfig|instance_home}}). Ansonsten stehen nur die Parameter derselben Sektion zur Verfügung.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|install_dir}}<br />
|style="background-color:orangered;"|{{code|}}<br />
|Installationsverzeichnis<br />
|-<br />
|{{konfig|ebkus_home}}<br />
|{{konfig|install_dir}}/ebkus<br />
|Homeverzeichnis<br />
|}<br />
<br />
<br />
=== <nowiki>[ebkus]</nowiki> ===<br />
<br />
Die generierte Konfigurationsdatei enthält in der Regel die korrekten Werte.<br />
<br />
Die {{konfig|database_admin_*}}-Parameter erlauben den Installationsskripten, neue Datenbanken für Instanzen einzurichten und diese bei der Deinstallation auch wieder zu entfernen.<br />
<br />
Falls aus Sicherheitsgründen erwünscht, kann hier ein Passwort für den Administratorzugriff auf MySQL eingetragen werden. Geschieht dies unter Windows vor der automatischen Installation von MySQL, wird bei der automatischen Installation der Administratorzugriff mit diesem Passwort eingerichtet.<br />
<br />
Falls das Passwort für den Administratorzugriff nicht im Klartext in der Konfigurationsdatei stehen soll, kann stattdessen <code>ASK</code>eingetragen werden. Dann fragen alle Skripte, die den Administratorzugriff benötigen, interaktiv nach dem Passwort, ohne es irgendwo zu speichern.<br />
<br />
Da MySQL standardmäßig nur von dem lokalen Rechner erreichbar ist, und dieser ohnehin nur für dem Administrator zugänglich ist, ist die zusätzliche Absicherung durch ein Passwort oft nicht nötig.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|download_dir}}<br />
|{{konfig|install_dir}}/download<br />
|Downloadverzeichnis. Dort steht die zu installierende Software, die im Bedarfsfall heruntergeladen wird.<br />
|-<br />
|{{konfig|database_admin_host}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer des Rechners, auf dem MySQL läuft. Muss angegeben werden, wenn das nicht der lokale Rechner ist.<br />
|-<br />
|{{konfig|database_admin_user}}<br />
|{{code|root}}<br />
|MySQL-Benutzer mit Administratorrechten<br />
|-<br />
|{{konfig|database_admin_password}}<br />
|{{code|}}<br />
|Dessen Passwort. Wenn hier ``ASK`` steht, wird das Passwort bei Bedarf interaktiv abgefragt.<br />
<br />
|-<br />
|{{konfig|mysql_dir}}<br />
|{{code|}}<br />
|Verzeichnis, in dem die MySQL-Programme mysql, mysqldump, etc. stehen. Muss angegeben werden, wenn MySQL-Programme nicht im Pfad stehen.<br />
<br />
|-<br />
|{{konfig|python_executable}}<br />
|<br />
|Vollständiger Pfad des Python-Executable, mit dem EBKuS ausgeführt wird<br />
|}<br />
<br />
<br />
=== <nowiki>[apache]</nowiki> ===<br />
<br />
Für den Parameter {{konfig|server_name}} muss unbedingt der Name oder die IP-Nummer des Rechners eingetragen werden, auf dem der Apache-Webserver läuft. Die generierte Konfigurationsdatei setzt den Standardwert <code>localhost</code>, womit EBKuS nur auf dem lokalen Rechner zugänglich ist.<br />
<br />
Für den Parameter {{konfig|server_admin}} sollte eine sinnvolle Email-Adresse eingetragen werden. Sie taucht in Apache-Fehlermeldungen auf (die allerdings normalerweise nicht vorkommen sollten).<br />
<br />
Alle übrigen Werte können in der Regel von der generierten Konfigurationsdatei übernommen werden.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|apache_log_dir}}<br />
|{{konfig|ebkus_home}}/log<br />
|Verzeichnis, in dem der Apache-Webserver Log-Dateien anlegt<br />
|-<br />
|{{konfig|server_admin}}<br />
|{{code|admin@localhost}}<br />
|Email-Adresse des Serveradministrators, die auf evt. Fehlerseiten des Servers erscheint.<br />
<br />
|-<br />
|{{konfig|server_name}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer des Rechners, auf dem der Apache-Webserver läuft.<br />
**Muss** explizit eingetragen werden, sonst kann EBKuS nur auf dem lokalen Rechner verwendet werden!<br />
<br />
|-<br />
|{{konfig|server_https_port}}<br />
|{{code|443}}<br />
|Port für verschlüsselte Verbindungen. Die EBKuS-Anwendung wird ausschließlich über diesen Port abgewickelt. Wenn der Standardport {{code|443}} nicht zur Verfügung steht, kann hier ein alternativer Port angegeben werden. Dieser muss dann als Teil der URL aufgeführt werden, z.B. für den Alternativport {{code|500}}: {{code|<nowiki>https://192.168.1.73:500/ebkus/demo/</nowiki>}}.<br />
<br />
|-<br />
|{{konfig|server_https_port}}<br />
|{{code|80}}<br />
|Port für unverschlüsselte Verbindungen. Die EBKuS-Anwendung verwendet diesen Port nicht. Dient nur zur Kontrolle des Apache Webservers: {{code|<nowiki>http://localhost/</nowiki>}} liefert "It works!". Wird hier der Port {{code|8080}} angegeben, müsste man {{code|<nowiki>http://localhost:8080/</nowiki>}} schreiben.<br />
<br />
|-<br />
|{{konfig|ssl_certificate_file}}<br />
|{{konfig|ebkus_home}}/ebkus_ssl_certificates/ebkusserver.cert<br />
|Vollständiger Pfad der SSL-Zertifikat-Datei<br />
<br />
<br />
|-<br />
|{{konfig|ssl_certificate_key_file}}<br />
|{{konfig|ebkus_home}}/ebkus_ssl_certificates/ebkusserver.key<br />
|Vollständiger Pfad der SSL-Schlüssel-Datei<br />
|}<br />
<br />
<br />
=== <nowiki>[openssl]</nowiki> ===<br />
<br />
Die Anwendung ist voll funktionsfähig mit den Werten aus der generierten Konfigurationsdatei; es empfiehlt sich jedoch, die organisatorischen Angaben für das SSL-Zertifikat anzupassen.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|openssl_executable}}<br />
|{{code|openssl}}<br />
|Falls openssl nicht im Pfad steht, muss der hier der vollständige Pfad zum Executable stehen<br />
<br />
|-<br />
|{{konfig|output_password}}<br />
|{{code|polo}}<br />
|Wird zur automatischen Zertifikatgenerierung benötigt<br />
<br />
|-<br />
|{{konfig|staat}}<br />
|{{code|DE}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|-<br />
|{{konfig|land}}<br />
|{{code|Berlin}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|-<br />
|{{konfig|ort}}<br />
|{{code|Berlin}}<br />
|Erscheint im SSL-Zertifikat<br />
|-<br />
|{{konfig|organisation}}<br />
|{{code|EFB}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|-<br />
|{{konfig|organisationseinheit}}<br />
|{{code|EFB}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|}<br />
<br />
<br />
=== <nowiki>[</nowiki>''Instanz''<nowiki>]</nowiki> ===<br />
<br />
<br />
Im Rahmen einer EBKuS-Installation auf einem Server können mehrere Instanzen einer EBKuS-Anwendung eingerichtet werden. Jede Instanz<br />
<br />
*hat einen Namen ({{konfig|instance_name}})<br />
*ist über eine eigene URL ansprechbar (<code>https://</code>'''server_name'''<code>/ebkus/</code>'''instance_name'''<code>/index.html</code>)<br />
*hat eine eigene Datenbank im Rahmen einer MySQL-Installation ({{konfig|database_name}}, {{konfig|database_user}}, {{konfig|database_password}})<br />
*hat ein eigenes Verzeichnis ({{konfig|instance_home}})<br />
*hat einen eigenen EBKuS-Server, der vom Apache-Webserver über eine eigene Portnummer angesprochen wird ({{konfig|port}})<br />
*hat eine eigene Log-Datei ({{konfig|log_file}})<br />
<br />
<br />
Für jede gewünschte Instanz wird eine Sektion in der Konfigurationsdatei angelegt. Die Sektionsüberschrift wird aus dem Namen der Instanz in eckigen Klammern gebildet. Der Name sollte mit einem Buchstaben beginnen und ansonsten nur Buchstaben, Ziffern und Unterstriche (<code>_</code>) enthalten (keine Leerzeichen!). Ein zusätzlicher Name für die Instanz ohne diese Einschränkung lässt sich über den Parameter {{konfig|instance_title}} einrichten (siehe unten).<br />
<br />
Falls der Instanzname mit <code>demo</code> beginnt, werden bei der Installation der Datenbank automatisch Demodaten erzeugt. Neben dem Benutzer <code>Admin</code> (Passwort: <code>Admin</code>) gibt es dann auch den Benutzer <code>test</code> (Passwort: <code>test</code>) und <code>verw</code>(Passwort: <code>verw</code>).<br />
<br />
Jede Sektion kann die in der Tabelle aufgeführten Parameter definieren. Erforderlich ist Wiederholung des Instanznamen als Wert von {{konfig|instance_name}}, ferner die Angabe einer eigenen, eindeutigen Portnummer, {{konfig|port}}. Für alle anderen Parameter können die Standardwerte genommen werden.<br />
<br />
Natürlich muss man {{konfig|berliner_version}} auf <code>true</code> setzen, wenn man die Berliner Version mit Berliner Straßenkatalog haben möchte; EBKuS-spezifische Fehlermeldungen sollten außerdem eine sinnvolle Telefonnummer bzw. Email-Adresse des Anwendungsbetreuers haben ({{konfig|admin_tel}}, {{konfig|admin_email}}).<br />
<br />
Die Parameter {{konfig|host}} und {{konfig|database_host}} müssen nur dann angepasst werden, wenn der EBKuS-Server bzw. die MySQL-Datenbank nicht auf demselben Rechner laufen wie der Apache-Webserver.<br />
<br />
Die bei der Installation generierte Konfigurationsdatei definiert vier Instanzen (2 davon auskommentiert):<br />
<br />
*<code>demo</code>: Demodaten, kein Straßenkatalog<br />
*<code>muster_efb</code>: keine Demodaten, kein Straßenkatalog. Beispiel für eine Produktionsinstanz, die vom Anwendungsbetreuer eingerichtet werden muss (siehe Einrichtung der Anwendung im Handbuch).<br />
<br />
Auskommentiert:<br />
*<code>demo_berlin</code>: Demodaten, Berliner Straßenkatalog (kleiner Ausschnitt, nur Straßen, deren Namen mit 'K' beginnen)<br />
*<code>demo_braunschweig</code>: Demodaten, Straßenkatalog mit Straßen aus Braunschweig, Gifhorn, Wolfenbüttel und Wolfsburg.<br />
<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
<br />
<br />
|-<br />
|{{konfig|instance_name}}<br />
|style="background-color:orangered;"|{{code|}}<br />
|Name der Instanz. Muss angegeben werden und dem Namen des Abschnitts (in eckigen Klammern) identisch sein. Darf keine Sonderzeichen außer den Unterstrich ('_') enthalten.<br />
<br />
<br />
|-<br />
|{{konfig|instance_home}}<br />
|{{konfig|ebkus_home}}/{{konfig|instance_name}}<br />
|Instanzverzeichnis. Liegt im Homeverzeichnis. Sollte nicht verändert werden.<br />
<br />
|-<br />
|{{konfig|initial_content}}<br />
|{{code|}}<br />
|Hier kann eine Datei angegeben werden, mit der die Instanzdatenbank initialisiert werden kann. Diese Datei wird immer dann geladen, wenn bei der Installation der Instanz ({{code|install.py}} oder {{code|configure.py}}) keine funktionierende Datenbank für die Instanz vorgefunden wird. Wenn keine Datei angegeben ist, wird eine neue Datenbank mit dem Merkmalskatalog ({{file|sql/merkmale_standard.py}}) und evt. einem Straßenkatalog erstellt. Wenn kein vollständiger Pfad für die Datei angegeben wird, muss die Datei im Homeverzeichnis liegen. Zulässige Dateien sind die mit dem Skript {{code|datenbank_sichern.py}} erzeugte Dateien sowie sonstige passende SQL-Dumps.<br />
<br />
|-<br />
|{{konfig|berliner_version}}<br />
|{{code|false}}<br />
|Wenn hier {{code|true}} steht, wird die Berliner EBKuS-Version verwendet mit Berliner Straßenkatalog. <br />
<br />
|-<br />
|{{konfig|database_host}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer, auf dem der Datenbankserver läuft.<br />
<br />
|-<br />
|{{konfig|database_name}}<br />
|{{konfig|instance_name}}<br />
|Name der Instanzdatenbank<br />
<br />
<br />
|-<br />
|{{konfig|database_user}}<br />
|{{konfig|instance_name}}<br />
|Benutzername der Instanzdatenbank<br />
<br />
|-<br />
|{{konfig|database_password}}<br />
|{{konfig|instance_name}}<br />
|Passwort der Instanzdatenbank<br />
<br />
<br />
|-<br />
|{{konfig|gemeindeschluessel_von_plz}}<br />
|{{code|}}<br />
|Definiert die Teilmenge der amtlichen Gemeindeschlüssel für die Bundesstatistik. Im Normalfall muss hier nichts eingetragen werden.<br />
<br /><br />
In der Bundesstatistik soll der amtliche Gemeindeschlüssel für den Wohnort des Klienten eingetragen werden, wenn der Wohnort des Klienten außerhalb des Kreises der Beratungsstelle liegt. Um die Menge der Daten zu begrenzen, kann hier über die Anfangsziffern der Postleitzahl eine Teilmenge definiert werden. Wenn mehrere Ziffernfolgen angegeben werden, müssen diese mit <code>;</code> getrennt werden.<br /><br /> Beispiele: <ul> <li>Alle Gemeindeschlüssel verwenden, außer die Postleitzahl der Gemeinde beginnt mit '9': <pre> 0;1;2;3;4;5;6;7;8 </pre> </li> <li>Große Teile Niedersachsens: <pre> 29;30;31;37;38 </pre> </li> <li>Nördliches Niedersachsen und Schleswig Holstein: <pre> 2 </pre> </li> <li>Berlin und Umgebung: <pre> 10;12;13;14;15;16 </pre> </li> <li>Bleibt die Variable leer, werden alle Gemeindeschlüssel verwendet. </li> </ul> Wenn es bei der Erkennung von Gemeindeschluesseln zu vielen Fehlern kommt, beispielsweise wegen unterschiedlicher Schreibweisen von Orten, kann man selber eine Datei <code>EBKUS_HOME/sql/gemeindeschluessel.csv</code> erstellen, bestehend aus einer Tabelle mit den Spalten <code>plz, ort ags</code>. Als Vorlage kann die Datei <code>EBKUS_HOME/sql/gemeindeschluessel_cache.csv</code> dienen, die automatisch erzeugt wird, wenn die Konfigurationsvariable <code>gemeindeschluessel_von_plz</code> einen Wert hat. <br />
|-<br />
|{{konfig|host}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer des Rechners, auf der EBKuS-Server der Instanz läuft.<br />
<br />
<br />
|-<br />
|{{konfig|keine_bundesstatistik}}<br />
|{{code|false}}<br />
|Falls hier {{code|true}} steht, wird die Bundesstatistik aus der Anwendung ausgeblendet. Es kann keine Bundesstatistik ausgefüllt werden und steht auch nicht für Statistik und Export zur Verfügung.<br />
<br />
|-<br />
|{{konfig|log_file}}<br />
|{{konfig|instance_home}}{{code|/}}{{konfig|instance_name}}{{code|.log}}<br />
|Name der Datei, in die der EBKuS-Server Meldungen schreibt<br />
<br />
|-<br />
|{{konfig|log_level}}<br />
|{{code|INFO}}<br />
|Legt fest, wie "geschwätzig" der EBKuS-Server ist. Muss einer der folgenden Werte sein, in aufsteigender Wortfülle: {{code|CRITICAL, ERROR, WARNING, INFO, DEBUG}} ({{code|DEBUG}} ist nur für die Fehlersuche geeignet, da sehr viel ausgegeben wird.)<br />
<br />
|-<br />
|{{konfig|port}}<br />
|style="background-color:orangered;"|{{code|}}<br />
|Portnummer über die der EBKuS-Server angesprochen wird. Muss angegeben werden. Jede Instanz muss eine unterschiedliche Portnummer erhalten.<br />
|}<br />
<br />
<br />
==== Konfiguration für externe Anwendungen ====<br />
<br />
Die folgenden Konfigurationsvariablen bewirken, dass auf der Klientenkarte ein Kasten mit maximal vier Buttons erscheint, die in einem neuen Tab/Fenster eine URL aufrufen, die Felder des aktuellen (letzten) Falles bzw. des angemeldeten Mitarbeiters als Bestandteile haben kann:<br />
# Kein Kasten, wenn diese Variable keinen Wert hat.<br />
extern_fieldset_label: Externe Anwendung<br />
# Position auf der Klientenkarte<br />
extern_fieldset_position: 6<br />
# Maximal vier Buttons, für jeden eine Bezeichnung und eine Url.<br />
# Ein Button kommt nur zustande, wenn sowohl Label als auch Url<br />
# einen Wert haben. <br />
extern_button1_label: GoogleWeb<br />
extern_button1_url: <nowiki>http://www.google.com/search?q=$$fall_id$$_$$fall_akte__ort$$</nowiki><br />
extern_button2_label: GoogleMaps<br />
extern_button2_url: <nowiki>http://www.google.com/maps?q=$$mitarbeiter_na$$</nowiki><br />
extern_button3_label: GoogleImages<br />
extern_button3_url: <nowiki>http://www.google.com/images?q=$$fall_akte__ort$$</nowiki><br />
extern_button4_label: GoogleNews<br />
extern_button4_url: http://www.google.com/news?q=$$fall_fn$$</nowiki><br />
<br />
Urls können Abschnitte der folgenden Form enthalten:<br />
{{code|$$<fall oder mitarbeiter>_<feld>$$}}<br />
Der ganze Abschnitt wird durch den Wert von {{code|<feld>}} ersetzt, <br />
wobei entweder im Fall-Objekt oder im Mitarbeiter-Objekt <br />
nachgeschlagen wird. <br />
Beispiele:<br />
{{code|$$fall_id$$}}, {{code|$$mitarbeiter_na$$}}, {{code|$$fall_akte__ort$$}}<br />
<br />
Im Beispiel oben werden als externe Anwendungen verschiedene Google-Dienst aufgerufen, wobei als Parameter Daten aus dem aktuellen Fall übergeben werden.<br />
(Das Beispiel ist nicht sinnvoll und dient nur der Illustration des Mechanismus.)<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|extern_fieldset_label}}<br />
|{{code|}}<br />
|Bezeichnung für den Kasten mit den Buttons für die externen Anwendungen<br />
<br />
|-<br />
|{{konfig|extern_fieldset_position}}<br />
|{{code|2}}<br />
|Position auf der Klientenkarte (Gezählt werden die umrandeten Kästen mit einer Bezeichnung: Klientendaten, Bezugspersonen, Leistungen, etc.)<br />
|-<br />
|{{konfig|extern_buttonX_label}}<br />
|{{code|}}<br />
|Name der externen Anwendung<br />
<br />
<br />
|-<br />
|{{konfig|extern_buttonX_url}}<br />
|{{code|}}<br />
|URL der externen Anwendung mit Platzhaltern für die zu übernehmenden Parameter<br />
<br />
|}<br />
<br />
{{konfig|X}} kann 1,2,3 oder 4 sein.<br />
<br />
<br />
== Fachliche Parameter ==<br />
<br />
Die hier beschriebenen Einstellungen können auch vom Anwendungsbetreuer über {{pfad2|Administratorhauptmenü|Allgemeine Konfiguration}} vorgenommen werden.<br />
<br />
<br />
=== <nowiki>[</nowiki>''Instanz''<nowiki>]</nowiki> ===<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|admin_email}}<br />
|{{code|Keine Angabe}}<br />
|Email-Adresse des Anwendungsbetreuers.<br />
<br />
Wird in Fehlermeldungen genannt.<br />
|-<br />
|{{konfig|admin_name}}<br />
|{{code|Keine Angabe}}<br />
|Name des Anwendungsbetreuers.<br />
<br />
Wird in Fehlermeldungen genannt.<br />
|-<br />
|{{konfig|admin_tel}}<br />
|{{code|Keine Angabe}}<br />
|Telefonnummer des Anwendungsbetreuers.<br />
<br />
Wird in Fehlermeldungen genannt.<br />
|-<br />
|{{konfig|anmeldungsdaten_}} {{konfig|obligatorisch}}<br />
|{{code|false}}<br />
|Falls <code>true</code> werden die Anmeldungsdaten obligatorisch im Aufnahmeformular erhoben anstatt optional in einer getrennten Maske.<br />
<br />
Die entsprechenden Pflichfelder sind dabei auszufüllen. Eine spätere Bearbeitung der Anmeldungsdaten erfolgt wie bisher in einer eigenständigen Maske (analog der späteren Bearbeitung einer Leistung).<br />
|-<br />
|{{konfig|anmeldeprobleme_und_}} {{konfig|beschaeftigung_bei_}}{{konfig|anmeldung_erfassen}}<br />
|{{code|false}}<br />
|Falls <code>true</code> werden Probleme bei der Anmeldung und Beschäftigung schon bei der Anmeldung erfasst und später für die Fachstatistik übernommen.<br />
<br />
Die Auswahlfelder 'Beschäftigung Jugendliche(r)', 'Beschäftigungsverhältnis Mutter', 'Beschäftigungsverhältnis Vater' und das Mehrfachauswahlfeld 'Problem(e) bei der Anmeldung' aus der Fachstatistik werden in den Kasten Anmeldekontakt als Pflichtfelder aufgenommen. Es ist jedoch in jedem Fall möglich 'Keine Angabe' auszuwählen (genau wie in der Fachstatistik selbst). Die Daten werden mit dem Fall (nicht mit der Akte bzw. den Stammdaten) gespeichert. Wenn eine Fachstatistik angelegt wird, werden die Daten übernommen.<br />
|-<br />
|{{konfig|beratungskontakte}}<br />
|{{code|false}}<br />
|Falls <code>true</code> können in der Klientenakte einzelne Beratungskontakte eingetragen werden. Die Summen werden in die Bundesstatistik und in die Fachstatistik als Vorgabe übernommen.<br />
|-<br />
|{{konfig|beratungskontakte_bs}}<br />
|{{code|false}}<br />
|Falls <code>true</code> treten Anpassungen speziell für Braunschweig in Kraft.<br />
<br />
Die Variable <code>beratungskontakte</code> muss ebenfalls auf <code>true</code> stehen.<br />
|-<br />
|{{konfig|cache_on}}<br />
|{{code|true}}<br />
|Falls <code>true</code> wird der Objektcache eingeschaltet, sonst bleibt er abgeschaltet.<br />
<br />
Normalerweise ist der Cache an, aber es kann in seltenen Fällen zu Fehlern kommen, die verschwinden, wenn er abgeschaltet wird. Auf die inhaltlichen Abläufe hat das keine Auswirkungen, <br />
allenfalls auf die Performance.<br />
|-????<br />
|{{konfig|erinnern_nach_wochen_ohne_kontakt}}<br />
|{{code|0}}<br />
|Anzahl der Wochen ohne Kontakt nach der ein offener Fall in die Erinnerungsfunktion aufgenommen wird.<br />
<br />
Wenn hier eine Zahl zwischen 1 und 99 steht, wird die Erinnerungsfunktion aktiviert. Auf einem zusätzlichen Button im Hauptmenü steht dann die Anzahl der offenen Fälle, mit denen es länger als die angegebene Anzahl von Wochen keinen Kontakt gegeben hat. Nach dem Betätigen des Buttons erscheint eine Liste dieser Fälle. Jeder Fall kann als erledigt markiert werden, worauf er künftig normalerweiser nicht mehr in der Liste erscheint. Für die gesamte Liste gibt es aber eine Option, alle Fälle einschließlich der erledigten anzuzeigen. Die 'Erledigt'-Markierung kann dann auch wieder rückgängig gemacht werden.<br />
<br />
Es muss hier die Ziffer 0 stehen, wenn die Erinnerungsfunktion deaktiviert bleiben soll.<br />
|-<br />
|{{konfig|fachstatistik_akte_}} {{konfig|diskrepanz_nicht_zulassen}}<br />
|{{code|false}}<br />
|Falls <code>true</code> werden Diskrepanzen zwischen Fachstatistik und Akte nicht zugelassen.<br />
<br />
Die entsprechenden Items in der Fachstatistik zeigen die Werte aus der Akte und sind nicht modifizierbar. Eine Diskrepanz kann so gar nicht entstehen. Allerdings muss bei Änderungen in der Akte die Fachstatistik neu abgespeichert werden, damit die Änderungen übernommen und für die Statistik wirksam werden.<br /> Betroffen sind nur die Items 'Familienstatus', 'Empfohlen von' und 'Erbrachte Leistungen in der Fachstatistik', deren Werte im Normalfall aus der Akte vorbelegt werden.<br />
|-<br />
|{{konfig|fallunabhaengige}} {{konfig|_aktivitaeten_bs}}<br />
|{{code|false}}<br />
|Falls <code>true</code> können fallunabhängige Aktivitäten eingetragen und ausgewertet werden. Speziell für Braunschweig. <br />
|-<br />
|{{konfig|fallbeginn_bei_}}{{konfig|erster_leistung}}<br />
|{{code|false}}<br />
|Bei Neumelde- und Abschlusszahlen sowie Klienten pro Mitarbeiter wird der Fallbeginn ab dem Datum der erste Leistung definiert anstatt ab dem Anmeldedatum.<br />
|-<br />
|{{konfig|fallbeginn_waehlbar}}<br />
|{{code|false}}<br />
|Bei Neumelde- und Abschlusszahlen sowie Klienten pro Mitarbeiter wird der Fallbeginn ab dem Datum der erste Leistung definiert anstatt ab dem Anmeldedatum.<br />
|-<br />
|{{konfig|instance_title}}<br />
|{{konfig|instance_name}}<br />
|Langname für die Instanz.<br />
<br />
Erscheint bei der Anmeldung und in der Statuszeile.<br />
|-<br />
|{{konfig|jgh_gemeindeschluessel}}<br />
|{{code|}}<br />
|Die letzten drei Ziffern des [http://de.wikipedia.org/wiki/Amtlicher_Gemeindeschl%C3%BCssel" Amtlichen Gemeindeschlüssels] oder das Wort "blank".<br />
<br />
Standardmäßig setzt EBKuS für diese drei Ziffern (Spalte 7-9 des Exportdatensatzes) drei mal die Ziffer 0 ein. Unseres Wissens werden diese Daten für die<br />
Bundesstatistik allerdings nicht ausgewertet. Bei Bedarf kann hier das Wort "blank" angegeben werden, dann erscheinen im Datensatz drei Leerzeichen, oder es können drei Ziffern<br />
eingegeben werden, die dann in den Datensatz eingefügt werden.<br />
|-<br />
|{{konfig|leistungsende_in_}}<br />
{{konfig|zukunft_erlaubt}}<br />
|{{code|false}}<br />
|Beim Eintrag einer Leistung darf für das Ende ein Datum, das in der Zukunft liegt, eingetragen werden.<br />
<br />
Der Abschluss des Falls ist erst möglich, wenn alle Leistungen beendet sind.<br />
|-<br />
|{{konfig|loeschfrist}}<br />
|{{code|36}}<br />
|Löschfrist in Monaten.<br />
<br />
Akten, die älter sind, können vom Administrator gelöscht werden.<br />
|-<br />
|{{konfig|log_query_laenger_als}}<br />
|{{code|0}}<br />
|Falls größer 0, Datenbankqueries in die Logdatei schreiben, die länger dauern als die angegeben Zahl in Millisekunden.<br />
<br />
Wenn 0 eingetragen wird, werden keine Datenbankqueries protokolliert. Alle Datenbankqueries können mit <code>log_level=DEBUG<code> erfasst werden. Nützlich zur Diagnose von Performanceproblemen.<br />
|-<br />
|{{konfig|meldung_vom_admin}}<br />
|{{code|}}<br />
|Inhalt wird als Meldung vom Administrator unübersehbar auf jeder EBKuS-Seite über der Statuszeile ausgegeben.<br />
<br />
Damit kann der Administrator Meldungen an alle aktiven EBKuS-Nutzer ausgeben, z.B. um einen Ausfall von EBKuS wegen Wartungsarbeiten anzukündigen. <br />
|-<br />
|{{konfig|neumeldungen_nach_region}}<br />
|{{code|}}<br />
|Definiert eine Tabelle ''Neumeldungen nach Region'' unter ''Neumelde- und Abschlusszahlen''.<br />
<br />
Die Regionen, für die in der Tabelle die Neumeldungen ausgezählt werden sollen, müssen unter {{pfad4|Hauptmenü|Statistikabfrage|Teilmenge|Neu}} als Teilmengendefinitionen eingeführt werden. Der Namen der gewünschten Definitionen werden durch <code>;</code> getrennt aufgeführt. <br /><br /> Beispiel: <ul> <li> <pre> Gifhorn und Samtgemeinde Meinersen; Braunschweig 38120 und 38112 </pre> </li> </ul> "Gifhorn und Samtgemeinde Meinersen" ist eine Teilmengendefinition mit der Definition: <code>( ort = 'Gifhorn' ODER samtgemeinde = 'Meinersen' )</code>. "Braunschweig 38120 und 38112" ist eine Teilmengendefinition mit der Definition: <code>( ort = 'Braunschweig' UND plz = '38112' oder '38120' )</code>. <br /><br /> <br />
|-<br />
|{{konfig|session_time}}<br />
|{{code|120}}<br />
|Länge einer Session in Minuten. <br />
<br />
Nach dieser Zeit wird ein Benutzer automatisch abgemeldet, wenn er keine Eingaben mehr macht.<br />
|-<br />
|{{konfig|sql_abfrage}}<br />
|{{code|false}}<br />
|Falls <code>true</code> steht die Maske zum Absetzen von SQL-Abfragen vom Administrationsmenü aus zur Verfügung. <br />
<br />
|-<br />
|{{konfig|strassenkatalog}}<br />
|{{code|}}<br />
|Falls diese Variable nicht leer ist, wird bei der Adresseingabe der Straßenkatalog verwendet.<br />
<br />
Der eigentliche Wert der Variable spielt nur bei der Erstinstallation der Instanz eine Rolle.<br />Eine Instanz ohne Straßenkatalog kann auch später noch für die Verwendung mit Straßenkatalog eingerichtet werden, indem der Straßenkatalog über {{pfad2|Administratorhauptmenü|Straßenkatalog importieren}} importiert wird und der Variable {{konfig|strassenkatalog}} ein beliebiger Wert zugewiesen wird, beispielsweise der Ortsname.<br />
|-<br />
|{{konfig|strassenkatalog_}} {{konfig|vollstaendig}}<br />
|{{code|false}}<br />
|Falls <code>true</code> wird angenommen, dass der Straßenkatalog Einträge für jede einzelne Hausnummer enthält.<br />
<br />
Ansonsten wird angenommen, dass lediglich Einträge für ganze Straßen bzw. für bestimmte Intervalle von Hausnummern vorhanden sind.<br />
|-<br />
|{{konfig|strassensuche}}<br />
|{{code|}}<br />
|Bestimmt die Anzeige von Zusatzinformationen aus dem Straßenkatalog bei der Darstellung und Eingabe von Adressen.<br />
<br />
Zulässige Werte sind: <code>ort bezirk ortsteil samtgemeinde</code>.<br /><br /> Beispiele: <ul> <li>In Berlin gibt es nur einen Ort im Straßenkatalog, nämlich 'Berlin'. Das Feld <code>ort</code> ist daher nicht nötig. Ortsteil und Samtgemeinde haben im Straßenkatalog keine Werte, Bezirk allerdings schon. Der sinnvolle Wert für Berlin ist also <pre> bezirk </pre> </li> <li>In Gifhorn gibt es mehrere Orte im Straßenkatalog. Sowohl Ortsteile und Samtgemeinden spielen eine Rolle und sind im Straßenkatalog erfasst, Bezirke jedoch nicht. Der sinnvolle Wert hier ist also <pre> ort ortsteil samtgemeinde </pre> </li> <li>Wenn es nur einen Ort gibt und weder Bezirke, Ortsteile oder Samtgemeinden im Straßenkatalog erfasst sind, sollte die Variable leer bleiben. </ul> <br /><br />Irrelevant, wenn kein Straßenkatalog verwendet wird.<br />
|-<br />
|{{konfig|warnung_bei_fachstatistik_}} {{konfig|akte_diskrepanz}}<br />
|{{code|false}}<br />
|Falls <code>true</code> wird beim Speichern der Fachstatistik auf eine Diskrepanz zwischen Akte und Fachstatistik hingewiesen, falls vorhanden.<br />
<br />
Wenn man bei dem dann zur Verfügung stehendem Item "Diskrepanz zur Akte zulassen" ein Häkchen setzt, kann man trotzdem speichern.<br /> Betroffen sind nur die Items 'Familienstatus', 'Empfohlen von' und 'Erbrachte Leistungen in der Fachstatistik', deren Werte im Normalfall aus der Akte vorbelegt werden.<br />
|-<br />
|{{konfig|wiederaufnahmefrist}}<br />
|{{code|1}}<br />
|Anzahl der Monate, innerhalb derer ein abgeschlossener Fall wiederaufgenommen werden kann ("z.d.A. rückgängig").<br />
<br />
Danach muss ein neuer Fall angelegt werden.<br />
|-<br />
|{{konfig|wohnt_nicht_ausserhalb}}<br />
|{{code|}}<br />
|Definiert die Teilmenge der Adressen, die im Sinne der Bundesstatistik in die Zuständigkeit der Beratungsstelle fallen.<br />
<br />
Aufgrund der hier angegebenen Kriterien wird entschieden, ob der Klient in der Bundesstatistik als ausserhalb des Zuständigkeitsbereichs der Beratungsstelle wohnend angegeben wird. Als mögliche Kriterien kommen in Frage: <code>plz,ort,ortsteil,samtgemeinde,bezirk,plraum</code>. Die Kriterien <code>ortsteil,samtgemeinde,bezirk</code> sind nur sinnvoll, wenn ein Straßenkatalog verwendet wird und dieser auch entsprechende Angaben enthält. <br /><br /> Die Kriterien werden wie folgt in der angegebenen Reihenfolge abgearbeitet: <ul> <li>Wenn die Klientenadresse keinen Wert für das Kriterium aufweist, wird zum nächsten Kriterium übergegangen. </li> <li>Falls die Klientenadresse einen Wert hat und im Kriterium genannt wird, wohnt er nicht außerhalb. Ist der Wert im Kriterium nicht genannt, wohnt er außerhalb. In beiden Fällen werden die weiteren Kriterien nicht mehr betrachtet. </li> <li>Falls aufgrund fehlender Werte (oder fehlender Kriterien) kein Kriterium angewendet werden konnte, wird standardmäßig angenommen, dass der Klient nicht außerhalb wohnt. </li> </ul> Beispiele: <ul> <li> <pre> bezirk: Friedrichshain-Kreuzberg; ort: Berlin </pre> In Berlin enthalten alle mit dem Straßenkatalog abgeglichene Adressen einen Wert für den Bezirk. Da jede Beratungsstelle genau für einen Bezirk zuständig ist, kann auf dieser Basis entschieden werden. Falls eine Adresse nicht mit dem Straßenkatalog abgeglichen wurde, kann der Ort als Kriterium herangezogen werden, da in diesem Fall für Bezirk keine Angaben vorliegen. </li> <li> Falls kein Straßenkatalog verwendet wird, kann nur der Ort, die Postleitzahl oder evt. der Planungsraum (falls solche definiert sind und routinemäßig mit den Klientenadressen zusammen erfasst werden) als Kriterium verwendet werden, z.B. (fiktiv!): <pre> plz: 12345;23456;34567 </pre> Adressen mit diesen Postleitzahlen werden als nicht außerhalb wohnend betrachtet, alle anderen als außerhalb. Falls die Klientenadresse keine 5-stellige PLZ enthält, gilt der Wert als fehlend. Ungenauigkeiten werden in Kauf genommen, da die Region der Zuständigkeit nicht immer exakt mit den Regionen der Postleitzahlen übereinstimmt. </li> <li> <pre> samtgemeinde: Name1;Name2;Name3; plz: 12345;23456 </pre> Analog zum Berliner Beispiel würde hier auch zunächst das Kriterium Samtgemeinde versucht, das aber nur nach einem Abgleich mit dem Straßenkatalog bekannt ist. Für die nicht abgeglichenen Adressen wird dann die Postleitzahl herangezogen. In seltenen Fällen kann das zu Fehlern führen, da die Bereiche der Postleitzahlen manchmal nicht mit den Bereichen der Zuständigkeit exakt übereinstimmen. </li> </ul> Falls das Ergebnis "wohnt außerhalb" ist, wird automatisch ein entsprechender Eintrag in die Bundesstatistik vorgenommen, der beim Ausfüllen oben im Kasten "Falldaten" angezeigt wird. Wenn möglich wird der <strong>amtliche Gemeindeschlüssel</strong> eingetragen. Wenn dieser nicht gefunden wird, wird Postleitzahl und Wohnort angegeben. <br /><br /> <strong>Syntax</strong> wie in den Beispielen. Rund um die Trenner <code>;</code> und <code>:</code> dürfen Leerzeichen stehen. Es können auch mehrere Zeilen verwendet werden. <br /><br /> Unter (Berater-) {{pfad5|Hauptmenü|Statistik|Teilmenge|Neu|Neue Bedingung}}" finden Sie für jedes Kriterium die Menge der möglichen Werte. <br /><br /> Zur <strong>Testen</strong> gibt es unter {{pfad3|Aministratorhauptmenü|Bundesstatistik|Exportieren}} einen neuen Punkt ''Adressen außerhalb prüfen''. Sie können dort in einer Tabelle sehen, welche Adressen als außerhalb klassifiziert werden. <br />
|}</div>Ebkushttps://www.ebkus.org/wiki/KonfigurationKonfiguration2014-07-03T14:18:05Z<p>Ebkus: </p>
<hr />
<div>Die zentrale Konfigurationsdatei für eine EBKuS-Installation ist eine Textdatei namens <code>ebkus.conf</code> und befindet sich im Homeverzeichnis ({{file|ebkus}} im Installationsverzeichnis).<br />
<br />
Als Ausgangspunkt für die eigene Konfiguration dient die vom Installationsskript {{code|install.py}} aus einer [http://svn.berlios.de/wsvn/ebkus/ebkus-3/trunk/templates/ebkus.conf.template Vorlage] generierte Konfigurationsdatei. Die meisten Parameter (= Konfigurationvariable) sind darin bereits korrekt gesetzt.<br />
<br />
<br />
== Aufbau von <code>ebkus.conf</code> ==<br />
<br />
Zeilen, die leer sind oder mit dem Kommentarzeichen <code>#</code> beginnen, werden ignoriert, z.B.:<br />
<br />
<pre>#ebkus_home: %(install_dir)s\ebkus</pre><br />
<br />
In diesem Fall hat der Parameter den in der Tabelle genannten Standardwert.<br />
<br />
Zeilen, die nur aus einem Namen in eckigen Klammern bestehen, leiten eine Sektion ein, z.B.:<br />
<br />
<pre>[apache]</pre><br />
Die übrigen Zeilen weisen einem Parameter einen Wert zu. Sie beginnen mit dem Namen des Parameters, gefolgt von einem Doppelpunkt, gefolgt von dem Wert. Vor oder nach dem Doppelpunkt können Leerzeichen stehen. Beispiel:<br />
<br />
<pre>install_dir: C:\ebkus_installation</pre><br />
Werte können eine Syntax enthalten, die es erlaubt, vorher definierte Parameter in einen aktuellen Wert einzubeziehen (''Parametersubstitution''), z.B.:<br />
<br />
<pre>ebkus_home: %(install_dir)s\ebkus</pre><br />
Hier wird der Wert von <code>install_dir</code> in den Wert von <code>ebkus_home</code> einbezogen. Das ist genauso, als ob man gleich<br />
<br />
<pre>ebkus_home: C:\ebkus_installation\ebkus</pre><br />
definiert hätte. <code>%(</code>''parameter''<code>)s</code> wird durch den Wert von ''parameter'' ersetzt.<br />
<br />
Jede gültige Konfigurationsdatei muss die folgenden Sektionen aufweisen:<br />
<br />
*<code>[DEFAULT]</code><br />
*<code>[ebkus]</code><br />
*<code>[apache]</code><br />
*<code>[openssl]</code><br />
*eine Sektion für jede Instanz: <code>[</code>''Instanzname''<code>]</code><br />
<br />
Die möglichen Parameter für jede Sektion sind in den folgenden Tabellen aufgeführt.<br />
<br />
Alle Parameter außer denen, die in den Tabelle rot markiert sind, haben einen Standardwert (manchmal auch ''Defaultwert'' genannt), der in der Tabelle in der Spalte Standardwert angegeben ist. Ein Parameter hat diesen Wert, wenn er in der Konfiguration fehlt oder auskommentiert ist.<br />
<br />
Wie man sieht, können Parametersubstitutionen auch bei Standardwerten stattfinden. Der Wert des notwendige Parameter ''install_dir'' findet dadurch Eingang in weitere Parameter (''ebkus_home'', ''instance_home''), ohne dass diese explizit in der Konfiguration aufgeführt sind.<br />
<br />
''Anmerkung zu den Tabellen'': In einigen Fällen ist der angegebene Parameter bzw. Standardwert aus layout-technischen Gründen auf mehrere Zeilen verteilt, obwohl er eigentlich ohne Leerzeichen hintereinanderweg in einer Zeile stehen müsste.<br />
<br />
Wir unterscheiden ''Systemparameter'' von ''fachlichen Parametern''. Erstere betreffen den technischen Betrieb von EBKuS und werden von den Systemadministratoren (IT) bei der Installation eingerichtet. Fachparameter können ebenso wie Systemparameter in der {{file|ebkus.conf}} in der Instanzsektion gesetzt werden, außerdem kann aber auch der Anwendungsbetreuer über {{pfad2|Administratorhauptmenü|Allgemeine Konfiguration}} weitere Veränderungen vornehmen. Die vom Anwendungsbetreuer vorgenommenen Änderungen haben stets Vorrang über den Angaben in der {{file|ebkus.conf}}.<br />
<br />
<br />
== Systemparameter ==<br />
<br />
=== <nowiki>[DEFAULT]</nowiki> ===<br />
<br />
Die generierte Konfigurationsdatei enthält die korrekten Werte.<br />
<br />
Der Parameter {{konfig|install_dir}} bezeichnet das Installationsverzeichnis und muss immer in der Konfiguration definiert werden. Es bildet den Bezugspunkt für alle weiteren Pfade. Standardmäßig ist {{konfig|ebkus_home}} das Verzeichnis <code>ebkus</code> im Installationsverzeichnis; das sollte nicht verändert werden.<br />
<br />
Die in der Sektion <code>[DEFAULT]</code> definierten Parameter können in allen anderen Sektionen im Rahmen der Parametersubstitution als Teil eine Wertes verwendet werden (z.B. in der Definition von {{konfig|instance_home}}). Ansonsten stehen nur die Parameter derselben Sektion zur Verfügung.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|install_dir}}<br />
|style="background-color:orangered;"|{{code|}}<br />
|Installationsverzeichnis<br />
|-<br />
|{{konfig|ebkus_home}}<br />
|{{konfig|install_dir}}/ebkus<br />
|Homeverzeichnis<br />
|}<br />
<br />
<br />
=== <nowiki>[ebkus]</nowiki> ===<br />
<br />
Die generierte Konfigurationsdatei enthält in der Regel die korrekten Werte.<br />
<br />
Die {{konfig|database_admin_*}}-Parameter erlauben den Installationsskripten, neue Datenbanken für Instanzen einzurichten und diese bei der Deinstallation auch wieder zu entfernen.<br />
<br />
Falls aus Sicherheitsgründen erwünscht, kann hier ein Passwort für den Administratorzugriff auf MySQL eingetragen werden. Geschieht dies unter Windows vor der automatischen Installation von MySQL, wird bei der automatischen Installation der Administratorzugriff mit diesem Passwort eingerichtet.<br />
<br />
Falls das Passwort für den Administratorzugriff nicht im Klartext in der Konfigurationsdatei stehen soll, kann stattdessen <code>ASK</code>eingetragen werden. Dann fragen alle Skripte, die den Administratorzugriff benötigen, interaktiv nach dem Passwort, ohne es irgendwo zu speichern.<br />
<br />
Da MySQL standardmäßig nur von dem lokalen Rechner erreichbar ist, und dieser ohnehin nur für dem Administrator zugänglich ist, ist die zusätzliche Absicherung durch ein Passwort oft nicht nötig.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|download_dir}}<br />
|{{konfig|install_dir}}/download<br />
|Downloadverzeichnis. Dort steht die zu installierende Software, die im Bedarfsfall heruntergeladen wird.<br />
|-<br />
|{{konfig|database_admin_host}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer des Rechners, auf dem MySQL läuft. Muss angegeben werden, wenn das nicht der lokale Rechner ist.<br />
|-<br />
|{{konfig|database_admin_user}}<br />
|{{code|root}}<br />
|MySQL-Benutzer mit Administratorrechten<br />
|-<br />
|{{konfig|database_admin_password}}<br />
|{{code|}}<br />
|Dessen Passwort. Wenn hier ``ASK`` steht, wird das Passwort bei Bedarf interaktiv abgefragt.<br />
<br />
|-<br />
|{{konfig|mysql_dir}}<br />
|{{code|}}<br />
|Verzeichnis, in dem die MySQL-Programme mysql, mysqldump, etc. stehen. Muss angegeben werden, wenn MySQL-Programme nicht im Pfad stehen.<br />
<br />
|-<br />
|{{konfig|python_executable}}<br />
|<br />
|Vollständiger Pfad des Python-Executable, mit dem EBKuS ausgeführt wird<br />
|}<br />
<br />
<br />
=== <nowiki>[apache]</nowiki> ===<br />
<br />
Für den Parameter {{konfig|server_name}} muss unbedingt der Name oder die IP-Nummer des Rechners eingetragen werden, auf dem der Apache-Webserver läuft. Die generierte Konfigurationsdatei setzt den Standardwert <code>localhost</code>, womit EBKuS nur auf dem lokalen Rechner zugänglich ist.<br />
<br />
Für den Parameter {{konfig|server_admin}} sollte eine sinnvolle Email-Adresse eingetragen werden. Sie taucht in Apache-Fehlermeldungen auf (die allerdings normalerweise nicht vorkommen sollten).<br />
<br />
Alle übrigen Werte können in der Regel von der generierten Konfigurationsdatei übernommen werden.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|apache_log_dir}}<br />
|{{konfig|ebkus_home}}/log<br />
|Verzeichnis, in dem der Apache-Webserver Log-Dateien anlegt<br />
|-<br />
|{{konfig|server_admin}}<br />
|{{code|admin@localhost}}<br />
|Email-Adresse des Serveradministrators, die auf evt. Fehlerseiten des Servers erscheint.<br />
<br />
|-<br />
|{{konfig|server_name}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer des Rechners, auf dem der Apache-Webserver läuft.<br />
**Muss** explizit eingetragen werden, sonst kann EBKuS nur auf dem lokalen Rechner verwendet werden!<br />
<br />
|-<br />
|{{konfig|server_https_port}}<br />
|{{code|443}}<br />
|Port für verschlüsselte Verbindungen. Die EBKuS-Anwendung wird ausschließlich über diesen Port abgewickelt. Wenn der Standardport {{code|443}} nicht zur Verfügung steht, kann hier ein alternativer Port angegeben werden. Dieser muss dann als Teil der URL aufgeführt werden, z.B. für den Alternativport {{code|500}}: {{code|<nowiki>https://192.168.1.73:500/ebkus/demo/</nowiki>}}.<br />
<br />
|-<br />
|{{konfig|server_https_port}}<br />
|{{code|80}}<br />
|Port für unverschlüsselte Verbindungen. Die EBKuS-Anwendung verwendet diesen Port nicht. Dient nur zur Kontrolle des Apache Webservers: {{code|<nowiki>http://localhost/</nowiki>}} liefert "It works!". Wird hier der Port {{code|8080}} angegeben, müsste man {{code|<nowiki>http://localhost:8080/</nowiki>}} schreiben.<br />
<br />
|-<br />
|{{konfig|ssl_certificate_file}}<br />
|{{konfig|ebkus_home}}/ebkus_ssl_certificates/ebkusserver.cert<br />
|Vollständiger Pfad der SSL-Zertifikat-Datei<br />
<br />
<br />
|-<br />
|{{konfig|ssl_certificate_key_file}}<br />
|{{konfig|ebkus_home}}/ebkus_ssl_certificates/ebkusserver.key<br />
|Vollständiger Pfad der SSL-Schlüssel-Datei<br />
|}<br />
<br />
<br />
=== <nowiki>[openssl]</nowiki> ===<br />
<br />
Die Anwendung ist voll funktionsfähig mit den Werten aus der generierten Konfigurationsdatei; es empfiehlt sich jedoch, die organisatorischen Angaben für das SSL-Zertifikat anzupassen.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|openssl_executable}}<br />
|{{code|openssl}}<br />
|Falls openssl nicht im Pfad steht, muss der hier der vollständige Pfad zum Executable stehen<br />
<br />
|-<br />
|{{konfig|output_password}}<br />
|{{code|polo}}<br />
|Wird zur automatischen Zertifikatgenerierung benötigt<br />
<br />
|-<br />
|{{konfig|staat}}<br />
|{{code|DE}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|-<br />
|{{konfig|land}}<br />
|{{code|Berlin}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|-<br />
|{{konfig|ort}}<br />
|{{code|Berlin}}<br />
|Erscheint im SSL-Zertifikat<br />
|-<br />
|{{konfig|organisation}}<br />
|{{code|EFB}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|-<br />
|{{konfig|organisationseinheit}}<br />
|{{code|EFB}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|}<br />
<br />
<br />
=== <nowiki>[</nowiki>''Instanz''<nowiki>]</nowiki> ===<br />
<br />
<br />
Im Rahmen einer EBKuS-Installation auf einem Server können mehrere Instanzen einer EBKuS-Anwendung eingerichtet werden. Jede Instanz<br />
<br />
*hat einen Namen ({{konfig|instance_name}})<br />
*ist über eine eigene URL ansprechbar (<code>https://</code>'''server_name'''<code>/ebkus/</code>'''instance_name'''<code>/index.html</code>)<br />
*hat eine eigene Datenbank im Rahmen einer MySQL-Installation ({{konfig|database_name}}, {{konfig|database_user}}, {{konfig|database_password}})<br />
*hat ein eigenes Verzeichnis ({{konfig|instance_home}})<br />
*hat einen eigenen EBKuS-Server, der vom Apache-Webserver über eine eigene Portnummer angesprochen wird ({{konfig|port}})<br />
*hat eine eigene Log-Datei ({{konfig|log_file}})<br />
<br />
<br />
Für jede gewünschte Instanz wird eine Sektion in der Konfigurationsdatei angelegt. Die Sektionsüberschrift wird aus dem Namen der Instanz in eckigen Klammern gebildet. Der Name sollte mit einem Buchstaben beginnen und ansonsten nur Buchstaben, Ziffern und Unterstriche (<code>_</code>) enthalten (keine Leerzeichen!). Ein zusätzlicher Name für die Instanz ohne diese Einschränkung lässt sich über den Parameter {{konfig|instance_title}} einrichten (siehe unten).<br />
<br />
Falls der Instanzname mit <code>demo</code> beginnt, werden bei der Installation der Datenbank automatisch Demodaten erzeugt. Neben dem Benutzer <code>Admin</code> (Passwort: <code>Admin</code>) gibt es dann auch den Benutzer <code>test</code> (Passwort: <code>test</code>) und <code>verw</code>(Passwort: <code>verw</code>).<br />
<br />
Jede Sektion kann die in der Tabelle aufgeführten Parameter definieren. Erforderlich ist Wiederholung des Instanznamen als Wert von {{konfig|instance_name}}, ferner die Angabe einer eigenen, eindeutigen Portnummer, {{konfig|port}}. Für alle anderen Parameter können die Standardwerte genommen werden.<br />
<br />
Natürlich muss man {{konfig|berliner_version}} auf <code>true</code> setzen, wenn man die Berliner Version mit Berliner Straßenkatalog haben möchte; EBKuS-spezifische Fehlermeldungen sollten außerdem eine sinnvolle Telefonnummer bzw. Email-Adresse des Anwendungsbetreuers haben ({{konfig|admin_tel}}, {{konfig|admin_email}}).<br />
<br />
Die Parameter {{konfig|host}} und {{konfig|database_host}} müssen nur dann angepasst werden, wenn der EBKuS-Server bzw. die MySQL-Datenbank nicht auf demselben Rechner laufen wie der Apache-Webserver.<br />
<br />
Die bei der Installation generierte Konfigurationsdatei definiert vier Instanzen (2 davon auskommentiert):<br />
<br />
*<code>demo</code>: Demodaten, kein Straßenkatalog<br />
*<code>muster_efb</code>: keine Demodaten, kein Straßenkatalog. Beispiel für eine Produktionsinstanz, die vom Anwendungsbetreuer eingerichtet werden muss (siehe Einrichtung der Anwendung im Handbuch).<br />
<br />
Auskommentiert:<br />
*<code>demo_berlin</code>: Demodaten, Berliner Straßenkatalog (kleiner Ausschnitt, nur Straßen, deren Namen mit 'K' beginnen)<br />
*<code>demo_braunschweig</code>: Demodaten, Straßenkatalog mit Straßen aus Braunschweig, Gifhorn, Wolfenbüttel und Wolfsburg.<br />
<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
<br />
<br />
|-<br />
|{{konfig|instance_name}}<br />
|style="background-color:orangered;"|{{code|}}<br />
|Name der Instanz. Muss angegeben werden und dem Namen des Abschnitts (in eckigen Klammern) identisch sein. Darf keine Sonderzeichen außer den Unterstrich ('_') enthalten.<br />
<br />
<br />
|-<br />
|{{konfig|instance_home}}<br />
|{{konfig|ebkus_home}}/{{konfig|instance_name}}<br />
|Instanzverzeichnis. Liegt im Homeverzeichnis. Sollte nicht verändert werden.<br />
<br />
|-<br />
|{{konfig|initial_content}}<br />
|{{code|}}<br />
|Hier kann eine Datei angegeben werden, mit der die Instanzdatenbank initialisiert werden kann. Diese Datei wird immer dann geladen, wenn bei der Installation der Instanz ({{code|install.py}} oder {{code|configure.py}}) keine funktionierende Datenbank für die Instanz vorgefunden wird. Wenn keine Datei angegeben ist, wird eine neue Datenbank mit dem Merkmalskatalog ({{file|sql/merkmale_standard.py}}) und evt. einem Straßenkatalog erstellt. Wenn kein vollständiger Pfad für die Datei angegeben wird, muss die Datei im Homeverzeichnis liegen. Zulässige Dateien sind die mit dem Skript {{code|datenbank_sichern.py}} erzeugte Dateien sowie sonstige passende SQL-Dumps.<br />
<br />
|-<br />
|{{konfig|berliner_version}}<br />
|{{code|false}}<br />
|Wenn hier {{code|true}} steht, wird die Berliner EBKuS-Version verwendet mit Berliner Straßenkatalog. <br />
<br />
|-<br />
|{{konfig|database_host}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer, auf dem der Datenbankserver läuft.<br />
<br />
|-<br />
|{{konfig|database_name}}<br />
|{{konfig|instance_name}}<br />
|Name der Instanzdatenbank<br />
<br />
<br />
|-<br />
|{{konfig|database_user}}<br />
|{{konfig|instance_name}}<br />
|Benutzername der Instanzdatenbank<br />
<br />
|-<br />
|{{konfig|database_password}}<br />
|{{konfig|instance_name}}<br />
|Passwort der Instanzdatenbank<br />
<br />
<br />
|-<br />
|{{konfig|gemeindeschluessel_von_plz}}<br />
|{{code|}}<br />
|Definiert die Teilmenge der amtlichen Gemeindeschlüssel für die Bundesstatistik. Im Normalfall muss hier nichts eingetragen werden.<br />
<br /><br />
In der Bundesstatistik soll der amtliche Gemeindeschlüssel für den Wohnort des Klienten eingetragen werden, wenn der Wohnort des Klienten außerhalb des Kreises der Beratungsstelle liegt. Um die Menge der Daten zu begrenzen, kann hier über die Anfangsziffern der Postleitzahl eine Teilmenge definiert werden. Wenn mehrere Ziffernfolgen angegeben werden, müssen diese mit <code>;</code> getrennt werden.<br /><br /> Beispiele: <ul> <li>Alle Gemeindeschlüssel verwenden, außer die Postleitzahl der Gemeinde beginnt mit '9': <pre> 0;1;2;3;4;5;6;7;8 </pre> </li> <li>Große Teile Niedersachsens: <pre> 29;30;31;37;38 </pre> </li> <li>Nördliches Niedersachsen und Schleswig Holstein: <pre> 2 </pre> </li> <li>Berlin und Umgebung: <pre> 10;12;13;14;15;16 </pre> </li> <li>Bleibt die Variable leer, werden alle Gemeindeschlüssel verwendet. </li> </ul> Wenn es bei der Erkennung von Gemeindeschluesseln zu vielen Fehlern kommt, beispielsweise wegen unterschiedlicher Schreibweisen von Orten, kann man selber eine Datei <code>EBKUS_HOME/sql/gemeindeschluessel.csv</code> erstellen, bestehend aus einer Tabelle mit den Spalten <code>plz, ort ags</code>. Als Vorlage kann die Datei <code>EBKUS_HOME/sql/gemeindeschluessel_cache.csv</code> dienen, die automatisch erzeugt wird, wenn die Konfigurationsvariable <code>gemeindeschluessel_von_plz</code> einen Wert hat. <br />
|-<br />
|{{konfig|host}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer des Rechners, auf der EBKuS-Server der Instanz läuft.<br />
<br />
<br />
|-<br />
|{{konfig|keine_bundesstatistik}}<br />
|{{code|false}}<br />
|Falls hier {{code|true}} steht, wird die Bundesstatistik aus der Anwendung ausgeblendet. Es kann keine Bundesstatistik ausgefüllt werden und steht auch nicht für Statistik und Export zur Verfügung.<br />
<br />
|-<br />
|{{konfig|log_file}}<br />
|{{konfig|instance_home}}{{code|/}}{{konfig|instance_name}}{{code|.log}}<br />
|Name der Datei, in die der EBKuS-Server Meldungen schreibt<br />
<br />
|-<br />
|{{konfig|log_level}}<br />
|{{code|INFO}}<br />
|Legt fest, wie "geschwätzig" der EBKuS-Server ist. Muss einer der folgenden Werte sein, in aufsteigender Wortfülle: {{code|CRITICAL, ERROR, WARNING, INFO, DEBUG}} ({{code|DEBUG}} ist nur für die Fehlersuche geeignet, da sehr viel ausgegeben wird.)<br />
<br />
|-<br />
|{{konfig|port}}<br />
|style="background-color:orangered;"|{{code|}}<br />
|Portnummer über die der EBKuS-Server angesprochen wird. Muss angegeben werden. Jede Instanz muss eine unterschiedliche Portnummer erhalten.<br />
|}<br />
<br />
<br />
==== Konfiguration für externe Anwendungen ====<br />
<br />
Die folgenden Konfigurationsvariablen bewirken, dass auf der Klientenkarte ein Kasten mit maximal vier Buttons erscheint, die in einem neuen Tab/Fenster eine URL aufrufen, die Felder des aktuellen (letzten) Falles bzw. des angemeldeten Mitarbeiters als Bestandteile haben kann:<br />
# Kein Kasten, wenn diese Variable keinen Wert hat.<br />
extern_fieldset_label: Externe Anwendung<br />
# Position auf der Klientenkarte<br />
extern_fieldset_position: 6<br />
# Maximal vier Buttons, für jeden eine Bezeichnung und eine Url.<br />
# Ein Button kommt nur zustande, wenn sowohl Label als auch Url<br />
# einen Wert haben. <br />
extern_button1_label: GoogleWeb<br />
extern_button1_url: <nowiki>http://www.google.com/search?q=$$fall_id$$_$$fall_akte__ort$$</nowiki><br />
extern_button2_label: GoogleMaps<br />
extern_button2_url: <nowiki>http://www.google.com/maps?q=$$mitarbeiter_na$$</nowiki><br />
extern_button3_label: GoogleImages<br />
extern_button3_url: <nowiki>http://www.google.com/images?q=$$fall_akte__ort$$</nowiki><br />
extern_button4_label: GoogleNews<br />
extern_button4_url: http://www.google.com/news?q=$$fall_fn$$</nowiki><br />
<br />
Urls können Abschnitte der folgenden Form enthalten:<br />
{{code|$$<fall oder mitarbeiter>_<feld>$$}}<br />
Der ganze Abschnitt wird durch den Wert von {{code|<feld>}} ersetzt, <br />
wobei entweder im Fall-Objekt oder im Mitarbeiter-Objekt <br />
nachgeschlagen wird. <br />
Beispiele:<br />
{{code|$$fall_id$$}}, {{code|$$mitarbeiter_na$$}}, {{code|$$fall_akte__ort$$}}<br />
<br />
Im Beispiel oben werden als externe Anwendungen verschiedene Google-Dienst aufgerufen, wobei als Parameter Daten aus dem aktuellen Fall übergeben werden.<br />
(Das Beispiel ist nicht sinnvoll und dient nur der Illustration des Mechanismus.)<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|extern_fieldset_label}}<br />
|{{code|}}<br />
|Bezeichnung für den Kasten mit den Buttons für die externen Anwendungen<br />
<br />
|-<br />
|{{konfig|extern_fieldset_position}}<br />
|{{code|2}}<br />
|Position auf der Klientenkarte (Gezählt werden die umrandeten Kästen mit einer Bezeichnung: Klientendaten, Bezugspersonen, Leistungen, etc.)<br />
|-<br />
|{{konfig|extern_buttonX_label}}<br />
|{{code|}}<br />
|Name der externen Anwendung<br />
<br />
<br />
|-<br />
|{{konfig|extern_buttonX_url}}<br />
|{{code|}}<br />
|URL der externen Anwendung mit Platzhaltern für die zu übernehmenden Parameter<br />
<br />
|}<br />
<br />
{{konfig|X}} kann 1,2,3 oder 4 sein.<br />
<br />
<br />
== Fachliche Parameter ==<br />
<br />
Die hier beschriebenen Einstellungen können auch vom Anwendungsbetreuer über {{pfad2|Administratorhauptmenü|Allgemeine Konfiguration}} vorgenommen werden.<br />
<br />
<br />
=== <nowiki>[</nowiki>''Instanz''<nowiki>]</nowiki> ===<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|admin_email}}<br />
|{{code|Keine Angabe}}<br />
|Email-Adresse des Anwendungsbetreuers.<br />
<br />
Wird in Fehlermeldungen genannt.<br />
|-<br />
|{{konfig|admin_name}}<br />
|{{code|Keine Angabe}}<br />
|Name des Anwendungsbetreuers.<br />
<br />
Wird in Fehlermeldungen genannt.<br />
|-<br />
|{{konfig|admin_tel}}<br />
|{{code|Keine Angabe}}<br />
|Telefonnummer des Anwendungsbetreuers.<br />
<br />
Wird in Fehlermeldungen genannt.<br />
|-<br />
|{{konfig|anmeldungsdaten_}} {{konfig|obligatorisch}}<br />
|{{code|false}}<br />
|Falls <code>true</code> werden die Anmeldungsdaten obligatorisch im Aufnahmeformular erhoben anstatt optional in einer getrennten Maske.<br />
<br />
Die entsprechenden Pflichfelder sind dabei auszufüllen. Eine spätere Bearbeitung der Anmeldungsdaten erfolgt wie bisher in einer eigenständigen Maske (analog der späteren Bearbeitung einer Leistung).<br />
|-<br />
|{{konfig|anmeldeprobleme_und_}} {{konfig|beschaeftigung_bei_}}{{konfig|anmeldung_erfassen}}<br />
|{{code|false}}<br />
|Falls <code>true</code> werden Probleme bei der Anmeldung und Beschäftigung schon bei der Anmeldung erfasst und später für die Fachstatistik übernommen.<br />
<br />
Die Auswahlfelder 'Beschäftigung Jugendliche(r)', 'Beschäftigungsverhältnis Mutter', 'Beschäftigungsverhältnis Vater' und das Mehrfachauswahlfeld 'Problem(e) bei der Anmeldung' aus der Fachstatistik werden in den Kasten Anmeldekontakt als Pflichtfelder aufgenommen. Es ist jedoch in jedem Fall möglich 'Keine Angabe' auszuwählen (genau wie in der Fachstatistik selbst). Die Daten werden mit dem Fall (nicht mit der Akte bzw. den Stammdaten) gespeichert. Wenn eine Fachstatistik angelegt wird, werden die Daten übernommen.<br />
|-<br />
|{{konfig|beratungskontakte}}<br />
|{{code|false}}<br />
|Falls <code>true</code> können in der Klientenakte einzelne Beratungskontakte eingetragen werden. Die Summen werden in die Bundesstatistik und in die Fachstatistik als Vorgabe übernommen.<br />
|-<br />
|{{konfig|beratungskontakte_bs}}<br />
|{{code|false}}<br />
|Falls <code>true</code> treten Anpassungen speziell für Braunschweig in Kraft.<br />
<br />
Die Variable <code>beratungskontakte</code> muss ebenfalls auf <code>true</code> stehen.<br />
|-<br />
|{{konfig|cache_on}}<br />
|{{code|true}}<br />
|Falls <code>true</code> wird der Objektcache eingeschaltet, sonst bleibt er abgeschaltet.<br />
<br />
Normalerweise ist der Cache an, aber es kann in seltenen Fällen zu Fehlern kommen, die verschwinden, wenn er abgeschaltet wird. Auf die inhaltlichen Abläufe hat das keine Auswirkungen, <br />
allenfalls auf die Performance.<br />
|-????<br />
|{{konfig|erinnern_nach_wochen_ohne_kontakt}}<br />
|{{code|0}}<br />
|Anzahl der Wochen ohne Kontakt nach der ein offener Fall in die Erinnerungsfunktion aufgenommen wird.<br />
<br />
Wenn hier eine Zahl zwischen 1 und 99 steht, wird die Erinnerungsfunktion aktiviert. Auf einem zusätzlichen Button im Hauptmenü steht dann die Anzahl der offenen Fälle, mit denen es länger als die angegebene Anzahl von Wochen keinen Kontakt gegeben hat. Nach dem Betätigen des Buttons erscheint eine Liste dieser Fälle. Jeder Fall kann als erledigt markiert werden, worauf er künftig normalerweiser nicht mehr in der Liste erscheint. Für die gesamte Liste gibt es aber eine Option, alle Fälle einschließlich der erledigten anzuzeigen. Die 'Erledigt'-Markierung kann dann auch wieder rückgängig gemacht werden.<br />
<br />
Es muss hier die Ziffer 0 stehen, wenn die Erinnerungsfunktion deaktiviert bleiben soll.<br />
|-<br />
|{{konfig|fachstatistik_akte_}} {{konfig|diskrepanz_nicht_zulassen}}<br />
|{{code|false}}<br />
|Falls <code>true</code> werden Diskrepanzen zwischen Fachstatistik und Akte nicht zugelassen.<br />
<br />
Die entsprechenden Items in der Fachstatistik zeigen die Werte aus der Akte und sind nicht modifizierbar. Eine Diskrepanz kann so gar nicht entstehen. Allerdings muss bei Änderungen in der Akte die Fachstatistik neu abgespeichert werden, damit die Änderungen übernommen und für die Statistik wirksam werden.<br /> Betroffen sind nur die Items 'Familienstatus', 'Empfohlen von' und 'Erbrachte Leistungen in der Fachstatistik', deren Werte im Normalfall aus der Akte vorbelegt werden.<br />
|-<br />
|{{konfig|fallunabhaengige}} {{konfig|_aktivitaeten_bs}}<br />
|{{code|false}}<br />
|Falls <code>true</code> können fallunabhängige Aktivitäten eingetragen und ausgewertet werden. Speziell für Braunschweig. <br />
|-<br />
|{{konfig|fallbeginn_bei_}}{{konfig|erster_leistung}}<br />
|{{code|false}}<br />
|Bei Neumelde- und Abschlusszahlen sowie Klienten pro Mitarbeiter wird der Fallbeginn ab dem Datum der erste Leistung definiert anstatt ab dem Anmeldedatum.<br />
|-<br />
|{{konfig|fallbeginn_waehlbar}}<br />
|{{code|false}}<br />
|Bei Neumelde- und Abschlusszahlen sowie Klienten pro Mitarbeiter wird der Fallbeginn ab dem Datum der erste Leistung definiert anstatt ab dem Anmeldedatum.<br />
|-<br />
|{{konfig|instance_title}}<br />
|{{konfig|instance_name}}<br />
|Langname für die Instanz.<br />
<br />
Erscheint bei der Anmeldung und in der Statuszeile.<br />
|-<br />
|{{konfig|jgh_gemeindeschluessel}}<br />
|{{code|}}<br />
|Die letzten drei Ziffern des <a href="http://de.wikipedia.org/wiki/Amtlicher_Gemeindeschl%C3%BCssel" target="_blank">Amtlichen Gemeindeschlüssels</a> oder das Wort "blank".<br />
<br />
Standardmäßig setzt EBKuS für diese drei Ziffern (Spalte 7-9 des Exportdatensatzes) drei mal die Ziffer 0 ein. Unseres Wissens werden diese Daten für die<br />
Bundesstatistik allerdings nicht ausgewertet. Bei Bedarf kann hier das Wort "blank" angegeben werden, dann erscheinen im Datensatz drei Leerzeichen, oder es können drei Ziffern<br />
eingegeben werden, die dann in den Datensatz eingefügt werden.<br />
|-<br />
|{{konfig|leistungsende_in_}}<br />
{{konfig|zukunft_erlaubt}}<br />
|{{code|false}}<br />
|Beim Eintrag einer Leistung darf für das Ende ein Datum, das in der Zukunft liegt, eingetragen werden.<br />
<br />
Der Abschluss des Falls ist erst möglich, wenn alle Leistungen beendet sind.<br />
|-<br />
|{{konfig|loeschfrist}}<br />
|{{code|36}}<br />
|Löschfrist in Monaten.<br />
<br />
Akten, die älter sind, können vom Administrator gelöscht werden.<br />
|-<br />
|{{konfig|log_query_laenger_als}}<br />
|{{code|0}}<br />
|Falls größer 0, Datenbankqueries in die Logdatei schreiben, die länger dauern als die angegeben Zahl in Millisekunden.<br />
<br />
Wenn 0 eingetragen wird, werden keine Datenbankqueries protokolliert. Alle Datenbankqueries können mit <code>log_level=DEBUG<code> erfasst werden. Nützlich zur Diagnose von Performanceproblemen.<br />
|-<br />
|{{konfig|meldung_vom_admin}}<br />
|{{code|}}<br />
|Inhalt wird als Meldung vom Administrator unübersehbar auf jeder EBKuS-Seite über der Statuszeile ausgegeben.<br />
<br />
Damit kann der Administrator Meldungen an alle aktiven EBKuS-Nutzer ausgeben, z.B. um einen Ausfall von EBKuS wegen Wartungsarbeiten anzukündigen. <br />
|-<br />
|{{konfig|neumeldungen_nach_region}}<br />
|{{code|}}<br />
|Definiert eine Tabelle ''Neumeldungen nach Region'' unter ''Neumelde- und Abschlusszahlen''.<br />
<br />
Die Regionen, für die in der Tabelle die Neumeldungen ausgezählt werden sollen, müssen unter {{pfad4|Hauptmenü|Statistikabfrage|Teilmenge|Neu}} als Teilmengendefinitionen eingeführt werden. Der Namen der gewünschten Definitionen werden durch <code>;</code> getrennt aufgeführt. <br /><br /> Beispiel: <ul> <li> <pre> Gifhorn und Samtgemeinde Meinersen; Braunschweig 38120 und 38112 </pre> </li> </ul> "Gifhorn und Samtgemeinde Meinersen" ist eine Teilmengendefinition mit der Definition: <code>( ort = 'Gifhorn' ODER samtgemeinde = 'Meinersen' )</code>. "Braunschweig 38120 und 38112" ist eine Teilmengendefinition mit der Definition: <code>( ort = 'Braunschweig' UND plz = '38112' oder '38120' )</code>. <br /><br /> <br />
|-<br />
|{{konfig|session_time}}<br />
|{{code|120}}<br />
|Länge einer Session in Minuten. <br />
<br />
Nach dieser Zeit wird ein Benutzer automatisch abgemeldet, wenn er keine Eingaben mehr macht.<br />
|-<br />
|{{konfig|sql_abfrage}}<br />
|{{code|false}}<br />
|Falls <code>true</code> steht die Maske zum Absetzen von SQL-Abfragen vom Administrationsmenü aus zur Verfügung. <br />
<br />
|-<br />
|{{konfig|strassenkatalog}}<br />
|{{code|}}<br />
|Falls diese Variable nicht leer ist, wird bei der Adresseingabe der Straßenkatalog verwendet.<br />
<br />
Der eigentliche Wert der Variable spielt nur bei der Erstinstallation der Instanz eine Rolle.<br />Eine Instanz ohne Straßenkatalog kann auch später noch für die Verwendung mit Straßenkatalog eingerichtet werden, indem der Straßenkatalog über {{pfad2|Administratorhauptmenü|Straßenkatalog importieren}} importiert wird und der Variable {{konfig|strassenkatalog}} ein beliebiger Wert zugewiesen wird, beispielsweise der Ortsname.<br />
|-<br />
|{{konfig|strassenkatalog_}} {{konfig|vollstaendig}}<br />
|{{code|false}}<br />
|Falls <code>true</code> wird angenommen, dass der Straßenkatalog Einträge für jede einzelne Hausnummer enthält.<br />
<br />
Ansonsten wird angenommen, dass lediglich Einträge für ganze Straßen bzw. für bestimmte Intervalle von Hausnummern vorhanden sind.<br />
|-<br />
|{{konfig|strassensuche}}<br />
|{{code|}}<br />
|Bestimmt die Anzeige von Zusatzinformationen aus dem Straßenkatalog bei der Darstellung und Eingabe von Adressen.<br />
<br />
Zulässige Werte sind: <code>ort bezirk ortsteil samtgemeinde</code>.<br /><br /> Beispiele: <ul> <li>In Berlin gibt es nur einen Ort im Straßenkatalog, nämlich 'Berlin'. Das Feld <code>ort</code> ist daher nicht nötig. Ortsteil und Samtgemeinde haben im Straßenkatalog keine Werte, Bezirk allerdings schon. Der sinnvolle Wert für Berlin ist also <pre> bezirk </pre> </li> <li>In Gifhorn gibt es mehrere Orte im Straßenkatalog. Sowohl Ortsteile und Samtgemeinden spielen eine Rolle und sind im Straßenkatalog erfasst, Bezirke jedoch nicht. Der sinnvolle Wert hier ist also <pre> ort ortsteil samtgemeinde </pre> </li> <li>Wenn es nur einen Ort gibt und weder Bezirke, Ortsteile oder Samtgemeinden im Straßenkatalog erfasst sind, sollte die Variable leer bleiben. </ul> <br /><br />Irrelevant, wenn kein Straßenkatalog verwendet wird.<br />
|-<br />
|{{konfig|warnung_bei_fachstatistik_}} {{konfig|akte_diskrepanz}}<br />
|{{code|false}}<br />
|Falls <code>true</code> wird beim Speichern der Fachstatistik auf eine Diskrepanz zwischen Akte und Fachstatistik hingewiesen, falls vorhanden.<br />
<br />
Wenn man bei dem dann zur Verfügung stehendem Item "Diskrepanz zur Akte zulassen" ein Häkchen setzt, kann man trotzdem speichern.<br /> Betroffen sind nur die Items 'Familienstatus', 'Empfohlen von' und 'Erbrachte Leistungen in der Fachstatistik', deren Werte im Normalfall aus der Akte vorbelegt werden.<br />
|-<br />
|{{konfig|wiederaufnahmefrist}}<br />
|{{code|1}}<br />
|Anzahl der Monate, innerhalb derer ein abgeschlossener Fall wiederaufgenommen werden kann ("z.d.A. rückgängig").<br />
<br />
Danach muss ein neuer Fall angelegt werden.<br />
|-<br />
|{{konfig|wohnt_nicht_ausserhalb}}<br />
|{{code|}}<br />
|Definiert die Teilmenge der Adressen, die im Sinne der Bundesstatistik in die Zuständigkeit der Beratungsstelle fallen.<br />
<br />
Aufgrund der hier angegebenen Kriterien wird entschieden, ob der Klient in der Bundesstatistik als ausserhalb des Zuständigkeitsbereichs der Beratungsstelle wohnend angegeben wird. Als mögliche Kriterien kommen in Frage: <code>plz,ort,ortsteil,samtgemeinde,bezirk,plraum</code>. Die Kriterien <code>ortsteil,samtgemeinde,bezirk</code> sind nur sinnvoll, wenn ein Straßenkatalog verwendet wird und dieser auch entsprechende Angaben enthält. <br /><br /> Die Kriterien werden wie folgt in der angegebenen Reihenfolge abgearbeitet: <ul> <li>Wenn die Klientenadresse keinen Wert für das Kriterium aufweist, wird zum nächsten Kriterium übergegangen. </li> <li>Falls die Klientenadresse einen Wert hat und im Kriterium genannt wird, wohnt er nicht außerhalb. Ist der Wert im Kriterium nicht genannt, wohnt er außerhalb. In beiden Fällen werden die weiteren Kriterien nicht mehr betrachtet. </li> <li>Falls aufgrund fehlender Werte (oder fehlender Kriterien) kein Kriterium angewendet werden konnte, wird standardmäßig angenommen, dass der Klient nicht außerhalb wohnt. </li> </ul> Beispiele: <ul> <li> <pre> bezirk: Friedrichshain-Kreuzberg; ort: Berlin </pre> In Berlin enthalten alle mit dem Straßenkatalog abgeglichene Adressen einen Wert für den Bezirk. Da jede Beratungsstelle genau für einen Bezirk zuständig ist, kann auf dieser Basis entschieden werden. Falls eine Adresse nicht mit dem Straßenkatalog abgeglichen wurde, kann der Ort als Kriterium herangezogen werden, da in diesem Fall für Bezirk keine Angaben vorliegen. </li> <li> Falls kein Straßenkatalog verwendet wird, kann nur der Ort, die Postleitzahl oder evt. der Planungsraum (falls solche definiert sind und routinemäßig mit den Klientenadressen zusammen erfasst werden) als Kriterium verwendet werden, z.B. (fiktiv!): <pre> plz: 12345;23456;34567 </pre> Adressen mit diesen Postleitzahlen werden als nicht außerhalb wohnend betrachtet, alle anderen als außerhalb. Falls die Klientenadresse keine 5-stellige PLZ enthält, gilt der Wert als fehlend. Ungenauigkeiten werden in Kauf genommen, da die Region der Zuständigkeit nicht immer exakt mit den Regionen der Postleitzahlen übereinstimmt. </li> <li> <pre> samtgemeinde: Name1;Name2;Name3; plz: 12345;23456 </pre> Analog zum Berliner Beispiel würde hier auch zunächst das Kriterium Samtgemeinde versucht, das aber nur nach einem Abgleich mit dem Straßenkatalog bekannt ist. Für die nicht abgeglichenen Adressen wird dann die Postleitzahl herangezogen. In seltenen Fällen kann das zu Fehlern führen, da die Bereiche der Postleitzahlen manchmal nicht mit den Bereichen der Zuständigkeit exakt übereinstimmen. </li> </ul> Falls das Ergebnis "wohnt außerhalb" ist, wird automatisch ein entsprechender Eintrag in die Bundesstatistik vorgenommen, der beim Ausfüllen oben im Kasten "Falldaten" angezeigt wird. Wenn möglich wird der <strong>amtliche Gemeindeschlüssel</strong> eingetragen. Wenn dieser nicht gefunden wird, wird Postleitzahl und Wohnort angegeben. <br /><br /> <strong>Syntax</strong> wie in den Beispielen. Rund um die Trenner <code>;</code> und <code>:</code> dürfen Leerzeichen stehen. Es können auch mehrere Zeilen verwendet werden. <br /><br /> Unter (Berater-) {{pfad5|Hauptmenü|Statistik|Teilmenge|Neu|Neue Bedingung}}" finden Sie für jedes Kriterium die Menge der möglichen Werte. <br /><br /> Zur <strong>Testen</strong> gibt es unter {{pfad3|Aministratorhauptmenü|Bundesstatistik|Exportieren}} einen neuen Punkt ''Adressen außerhalb prüfen''. Sie können dort in einer Tabelle sehen, welche Adressen als außerhalb klassifiziert werden. <br />
|}</div>Ebkushttps://www.ebkus.org/wiki/KonfigurationKonfiguration2014-07-03T14:09:43Z<p>Ebkus: </p>
<hr />
<div>Die zentrale Konfigurationsdatei für eine EBKuS-Installation ist eine Textdatei namens <code>ebkus.conf</code> und befindet sich im Homeverzeichnis ({{file|ebkus}} im Installationsverzeichnis).<br />
<br />
Als Ausgangspunkt für die eigene Konfiguration dient die vom Installationsskript {{code|install.py}} aus einer [http://svn.berlios.de/wsvn/ebkus/ebkus-3/trunk/templates/ebkus.conf.template Vorlage] generierte Konfigurationsdatei. Die meisten Parameter (= Konfigurationvariable) sind darin bereits korrekt gesetzt.<br />
<br />
<br />
== Aufbau von <code>ebkus.conf</code> ==<br />
<br />
Zeilen, die leer sind oder mit dem Kommentarzeichen <code>#</code> beginnen, werden ignoriert, z.B.:<br />
<br />
<pre>#ebkus_home: %(install_dir)s\ebkus</pre><br />
<br />
In diesem Fall hat der Parameter den in der Tabelle genannten Standardwert.<br />
<br />
Zeilen, die nur aus einem Namen in eckigen Klammern bestehen, leiten eine Sektion ein, z.B.:<br />
<br />
<pre>[apache]</pre><br />
Die übrigen Zeilen weisen einem Parameter einen Wert zu. Sie beginnen mit dem Namen des Parameters, gefolgt von einem Doppelpunkt, gefolgt von dem Wert. Vor oder nach dem Doppelpunkt können Leerzeichen stehen. Beispiel:<br />
<br />
<pre>install_dir: C:\ebkus_installation</pre><br />
Werte können eine Syntax enthalten, die es erlaubt, vorher definierte Parameter in einen aktuellen Wert einzubeziehen (''Parametersubstitution''), z.B.:<br />
<br />
<pre>ebkus_home: %(install_dir)s\ebkus</pre><br />
Hier wird der Wert von <code>install_dir</code> in den Wert von <code>ebkus_home</code> einbezogen. Das ist genauso, als ob man gleich<br />
<br />
<pre>ebkus_home: C:\ebkus_installation\ebkus</pre><br />
definiert hätte. <code>%(</code>''parameter''<code>)s</code> wird durch den Wert von ''parameter'' ersetzt.<br />
<br />
Jede gültige Konfigurationsdatei muss die folgenden Sektionen aufweisen:<br />
<br />
*<code>[DEFAULT]</code><br />
*<code>[ebkus]</code><br />
*<code>[apache]</code><br />
*<code>[openssl]</code><br />
*eine Sektion für jede Instanz: <code>[</code>''Instanzname''<code>]</code><br />
<br />
Die möglichen Parameter für jede Sektion sind in den folgenden Tabellen aufgeführt.<br />
<br />
Alle Parameter außer denen, die in den Tabelle rot markiert sind, haben einen Standardwert (manchmal auch ''Defaultwert'' genannt), der in der Tabelle in der Spalte Standardwert angegeben ist. Ein Parameter hat diesen Wert, wenn er in der Konfiguration fehlt oder auskommentiert ist.<br />
<br />
Wie man sieht, können Parametersubstitutionen auch bei Standardwerten stattfinden. Der Wert des notwendige Parameter ''install_dir'' findet dadurch Eingang in weitere Parameter (''ebkus_home'', ''instance_home''), ohne dass diese explizit in der Konfiguration aufgeführt sind.<br />
<br />
''Anmerkung zu den Tabellen'': In einigen Fällen ist der angegebene Parameter bzw. Standardwert aus layout-technischen Gründen auf mehrere Zeilen verteilt, obwohl er eigentlich ohne Leerzeichen hintereinanderweg in einer Zeile stehen müsste.<br />
<br />
Wir unterscheiden ''Systemparameter'' von ''fachlichen Parametern''. Erstere betreffen den technischen Betrieb von EBKuS und werden von den Systemadministratoren (IT) bei der Installation eingerichtet. Fachparameter können ebenso wie Systemparameter in der {{file|ebkus.conf}} in der Instanzsektion gesetzt werden, außerdem kann aber auch der Anwendungsbetreuer über {{pfad2|Administratorhauptmenü|Allgemeine Konfiguration}} weitere Veränderungen vornehmen. Die vom Anwendungsbetreuer vorgenommenen Änderungen haben stets Vorrang über den Angaben in der {{file|ebkus.conf}}.<br />
<br />
<br />
== Systemparameter ==<br />
<br />
=== <nowiki>[DEFAULT]</nowiki> ===<br />
<br />
Die generierte Konfigurationsdatei enthält die korrekten Werte.<br />
<br />
Der Parameter {{konfig|install_dir}} bezeichnet das Installationsverzeichnis und muss immer in der Konfiguration definiert werden. Es bildet den Bezugspunkt für alle weiteren Pfade. Standardmäßig ist {{konfig|ebkus_home}} das Verzeichnis <code>ebkus</code> im Installationsverzeichnis; das sollte nicht verändert werden.<br />
<br />
Die in der Sektion <code>[DEFAULT]</code> definierten Parameter können in allen anderen Sektionen im Rahmen der Parametersubstitution als Teil eine Wertes verwendet werden (z.B. in der Definition von {{konfig|instance_home}}). Ansonsten stehen nur die Parameter derselben Sektion zur Verfügung.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|install_dir}}<br />
|style="background-color:orangered;"|{{code|}}<br />
|Installationsverzeichnis<br />
|-<br />
|{{konfig|ebkus_home}}<br />
|{{konfig|install_dir}}/ebkus<br />
|Homeverzeichnis<br />
|}<br />
<br />
<br />
=== <nowiki>[ebkus]</nowiki> ===<br />
<br />
Die generierte Konfigurationsdatei enthält in der Regel die korrekten Werte.<br />
<br />
Die {{konfig|database_admin_*}}-Parameter erlauben den Installationsskripten, neue Datenbanken für Instanzen einzurichten und diese bei der Deinstallation auch wieder zu entfernen.<br />
<br />
Falls aus Sicherheitsgründen erwünscht, kann hier ein Passwort für den Administratorzugriff auf MySQL eingetragen werden. Geschieht dies unter Windows vor der automatischen Installation von MySQL, wird bei der automatischen Installation der Administratorzugriff mit diesem Passwort eingerichtet.<br />
<br />
Falls das Passwort für den Administratorzugriff nicht im Klartext in der Konfigurationsdatei stehen soll, kann stattdessen <code>ASK</code>eingetragen werden. Dann fragen alle Skripte, die den Administratorzugriff benötigen, interaktiv nach dem Passwort, ohne es irgendwo zu speichern.<br />
<br />
Da MySQL standardmäßig nur von dem lokalen Rechner erreichbar ist, und dieser ohnehin nur für dem Administrator zugänglich ist, ist die zusätzliche Absicherung durch ein Passwort oft nicht nötig.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|download_dir}}<br />
|{{konfig|install_dir}}/download<br />
|Downloadverzeichnis. Dort steht die zu installierende Software, die im Bedarfsfall heruntergeladen wird.<br />
|-<br />
|{{konfig|database_admin_host}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer des Rechners, auf dem MySQL läuft. Muss angegeben werden, wenn das nicht der lokale Rechner ist.<br />
|-<br />
|{{konfig|database_admin_user}}<br />
|{{code|root}}<br />
|MySQL-Benutzer mit Administratorrechten<br />
|-<br />
|{{konfig|database_admin_password}}<br />
|{{code|}}<br />
|Dessen Passwort. Wenn hier ``ASK`` steht, wird das Passwort bei Bedarf interaktiv abgefragt.<br />
<br />
|-<br />
|{{konfig|mysql_dir}}<br />
|{{code|}}<br />
|Verzeichnis, in dem die MySQL-Programme mysql, mysqldump, etc. stehen. Muss angegeben werden, wenn MySQL-Programme nicht im Pfad stehen.<br />
<br />
|-<br />
|{{konfig|python_executable}}<br />
|<br />
|Vollständiger Pfad des Python-Executable, mit dem EBKuS ausgeführt wird<br />
|}<br />
<br />
<br />
=== <nowiki>[apache]</nowiki> ===<br />
<br />
Für den Parameter {{konfig|server_name}} muss unbedingt der Name oder die IP-Nummer des Rechners eingetragen werden, auf dem der Apache-Webserver läuft. Die generierte Konfigurationsdatei setzt den Standardwert <code>localhost</code>, womit EBKuS nur auf dem lokalen Rechner zugänglich ist.<br />
<br />
Für den Parameter {{konfig|server_admin}} sollte eine sinnvolle Email-Adresse eingetragen werden. Sie taucht in Apache-Fehlermeldungen auf (die allerdings normalerweise nicht vorkommen sollten).<br />
<br />
Alle übrigen Werte können in der Regel von der generierten Konfigurationsdatei übernommen werden.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|apache_log_dir}}<br />
|{{konfig|ebkus_home}}/log<br />
|Verzeichnis, in dem der Apache-Webserver Log-Dateien anlegt<br />
|-<br />
|{{konfig|server_admin}}<br />
|{{code|admin@localhost}}<br />
|Email-Adresse des Serveradministrators, die auf evt. Fehlerseiten des Servers erscheint.<br />
<br />
|-<br />
|{{konfig|server_name}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer des Rechners, auf dem der Apache-Webserver läuft.<br />
**Muss** explizit eingetragen werden, sonst kann EBKuS nur auf dem lokalen Rechner verwendet werden!<br />
<br />
|-<br />
|{{konfig|server_https_port}}<br />
|{{code|443}}<br />
|Port für verschlüsselte Verbindungen. Die EBKuS-Anwendung wird ausschließlich über diesen Port abgewickelt. Wenn der Standardport {{code|443}} nicht zur Verfügung steht, kann hier ein alternativer Port angegeben werden. Dieser muss dann als Teil der URL aufgeführt werden, z.B. für den Alternativport {{code|500}}: {{code|<nowiki>https://192.168.1.73:500/ebkus/demo/</nowiki>}}.<br />
<br />
|-<br />
|{{konfig|server_https_port}}<br />
|{{code|80}}<br />
|Port für unverschlüsselte Verbindungen. Die EBKuS-Anwendung verwendet diesen Port nicht. Dient nur zur Kontrolle des Apache Webservers: {{code|<nowiki>http://localhost/</nowiki>}} liefert "It works!". Wird hier der Port {{code|8080}} angegeben, müsste man {{code|<nowiki>http://localhost:8080/</nowiki>}} schreiben.<br />
<br />
|-<br />
|{{konfig|ssl_certificate_file}}<br />
|{{konfig|ebkus_home}}/ebkus_ssl_certificates/ebkusserver.cert<br />
|Vollständiger Pfad der SSL-Zertifikat-Datei<br />
<br />
<br />
|-<br />
|{{konfig|ssl_certificate_key_file}}<br />
|{{konfig|ebkus_home}}/ebkus_ssl_certificates/ebkusserver.key<br />
|Vollständiger Pfad der SSL-Schlüssel-Datei<br />
|}<br />
<br />
<br />
=== <nowiki>[openssl]</nowiki> ===<br />
<br />
Die Anwendung ist voll funktionsfähig mit den Werten aus der generierten Konfigurationsdatei; es empfiehlt sich jedoch, die organisatorischen Angaben für das SSL-Zertifikat anzupassen.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|openssl_executable}}<br />
|{{code|openssl}}<br />
|Falls openssl nicht im Pfad steht, muss der hier der vollständige Pfad zum Executable stehen<br />
<br />
|-<br />
|{{konfig|output_password}}<br />
|{{code|polo}}<br />
|Wird zur automatischen Zertifikatgenerierung benötigt<br />
<br />
|-<br />
|{{konfig|staat}}<br />
|{{code|DE}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|-<br />
|{{konfig|land}}<br />
|{{code|Berlin}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|-<br />
|{{konfig|ort}}<br />
|{{code|Berlin}}<br />
|Erscheint im SSL-Zertifikat<br />
|-<br />
|{{konfig|organisation}}<br />
|{{code|EFB}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|-<br />
|{{konfig|organisationseinheit}}<br />
|{{code|EFB}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|}<br />
<br />
<br />
=== <nowiki>[</nowiki>''Instanz''<nowiki>]</nowiki> ===<br />
<br />
<br />
Im Rahmen einer EBKuS-Installation auf einem Server können mehrere Instanzen einer EBKuS-Anwendung eingerichtet werden. Jede Instanz<br />
<br />
*hat einen Namen ({{konfig|instance_name}})<br />
*ist über eine eigene URL ansprechbar (<code>https://</code>'''server_name'''<code>/ebkus/</code>'''instance_name'''<code>/index.html</code>)<br />
*hat eine eigene Datenbank im Rahmen einer MySQL-Installation ({{konfig|database_name}}, {{konfig|database_user}}, {{konfig|database_password}})<br />
*hat ein eigenes Verzeichnis ({{konfig|instance_home}})<br />
*hat einen eigenen EBKuS-Server, der vom Apache-Webserver über eine eigene Portnummer angesprochen wird ({{konfig|port}})<br />
*hat eine eigene Log-Datei ({{konfig|log_file}})<br />
<br />
<br />
Für jede gewünschte Instanz wird eine Sektion in der Konfigurationsdatei angelegt. Die Sektionsüberschrift wird aus dem Namen der Instanz in eckigen Klammern gebildet. Der Name sollte mit einem Buchstaben beginnen und ansonsten nur Buchstaben, Ziffern und Unterstriche (<code>_</code>) enthalten (keine Leerzeichen!). Ein zusätzlicher Name für die Instanz ohne diese Einschränkung lässt sich über den Parameter {{konfig|instance_title}} einrichten (siehe unten).<br />
<br />
Falls der Instanzname mit <code>demo</code> beginnt, werden bei der Installation der Datenbank automatisch Demodaten erzeugt. Neben dem Benutzer <code>Admin</code> (Passwort: <code>Admin</code>) gibt es dann auch den Benutzer <code>test</code> (Passwort: <code>test</code>) und <code>verw</code>(Passwort: <code>verw</code>).<br />
<br />
Jede Sektion kann die in der Tabelle aufgeführten Parameter definieren. Erforderlich ist Wiederholung des Instanznamen als Wert von {{konfig|instance_name}}, ferner die Angabe einer eigenen, eindeutigen Portnummer, {{konfig|port}}. Für alle anderen Parameter können die Standardwerte genommen werden.<br />
<br />
Natürlich muss man {{konfig|berliner_version}} auf <code>true</code> setzen, wenn man die Berliner Version mit Berliner Straßenkatalog haben möchte; EBKuS-spezifische Fehlermeldungen sollten außerdem eine sinnvolle Telefonnummer bzw. Email-Adresse des Anwendungsbetreuers haben ({{konfig|admin_tel}}, {{konfig|admin_email}}).<br />
<br />
Die Parameter {{konfig|host}} und {{konfig|database_host}} müssen nur dann angepasst werden, wenn der EBKuS-Server bzw. die MySQL-Datenbank nicht auf demselben Rechner laufen wie der Apache-Webserver.<br />
<br />
Die bei der Installation generierte Konfigurationsdatei definiert vier Instanzen (2 davon auskommentiert):<br />
<br />
*<code>demo</code>: Demodaten, kein Straßenkatalog<br />
*<code>muster_efb</code>: keine Demodaten, kein Straßenkatalog. Beispiel für eine Produktionsinstanz, die vom Anwendungsbetreuer eingerichtet werden muss (siehe Einrichtung der Anwendung im Handbuch).<br />
<br />
Auskommentiert:<br />
*<code>demo_berlin</code>: Demodaten, Berliner Straßenkatalog (kleiner Ausschnitt, nur Straßen, deren Namen mit 'K' beginnen)<br />
*<code>demo_braunschweig</code>: Demodaten, Straßenkatalog mit Straßen aus Braunschweig, Gifhorn, Wolfenbüttel und Wolfsburg.<br />
<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
<br />
<br />
|-<br />
|{{konfig|instance_name}}<br />
|style="background-color:orangered;"|{{code|}}<br />
|Name der Instanz. Muss angegeben werden und dem Namen des Abschnitts (in eckigen Klammern) identisch sein. Darf keine Sonderzeichen außer den Unterstrich ('_') enthalten.<br />
<br />
<br />
|-<br />
|{{konfig|instance_home}}<br />
|{{konfig|ebkus_home}}/{{konfig|instance_name}}<br />
|Instanzverzeichnis. Liegt im Homeverzeichnis. Sollte nicht verändert werden.<br />
<br />
|-<br />
|{{konfig|initial_content}}<br />
|{{code|}}<br />
|Hier kann eine Datei angegeben werden, mit der die Instanzdatenbank initialisiert werden kann. Diese Datei wird immer dann geladen, wenn bei der Installation der Instanz ({{code|install.py}} oder {{code|configure.py}}) keine funktionierende Datenbank für die Instanz vorgefunden wird. Wenn keine Datei angegeben ist, wird eine neue Datenbank mit dem Merkmalskatalog ({{file|sql/merkmale_standard.py}}) und evt. einem Straßenkatalog erstellt. Wenn kein vollständiger Pfad für die Datei angegeben wird, muss die Datei im Homeverzeichnis liegen. Zulässige Dateien sind die mit dem Skript {{code|datenbank_sichern.py}} erzeugte Dateien sowie sonstige passende SQL-Dumps.<br />
<br />
|-<br />
|{{konfig|berliner_version}}<br />
|{{code|false}}<br />
|Wenn hier {{code|true}} steht, wird die Berliner EBKuS-Version verwendet mit Berliner Straßenkatalog. <br />
<br />
|-<br />
|{{konfig|database_host}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer, auf dem der Datenbankserver läuft.<br />
<br />
|-<br />
|{{konfig|database_name}}<br />
|{{konfig|instance_name}}<br />
|Name der Instanzdatenbank<br />
<br />
<br />
|-<br />
|{{konfig|database_user}}<br />
|{{konfig|instance_name}}<br />
|Benutzername der Instanzdatenbank<br />
<br />
|-<br />
|{{konfig|database_password}}<br />
|{{konfig|instance_name}}<br />
|Passwort der Instanzdatenbank<br />
<br />
<br />
|-<br />
|{{konfig|gemeindeschluessel_von_plz}}<br />
|{{code|}}<br />
|Definiert die Teilmenge der amtlichen Gemeindeschlüssel für die Bundesstatistik. Im Normalfall muss hier nichts eingetragen werden.<br />
<br /><br />
In der Bundesstatistik soll der amtliche Gemeindeschlüssel für den Wohnort des Klienten eingetragen werden, wenn der Wohnort des Klienten außerhalb des Kreises der Beratungsstelle liegt. Um die Menge der Daten zu begrenzen, kann hier über die Anfangsziffern der Postleitzahl eine Teilmenge definiert werden. Wenn mehrere Ziffernfolgen angegeben werden, müssen diese mit <code>;</code> getrennt werden.<br /><br /> Beispiele: <ul> <li>Alle Gemeindeschlüssel verwenden, außer die Postleitzahl der Gemeinde beginnt mit '9': <pre> 0;1;2;3;4;5;6;7;8 </pre> </li> <li>Große Teile Niedersachsens: <pre> 29;30;31;37;38 </pre> </li> <li>Nördliches Niedersachsen und Schleswig Holstein: <pre> 2 </pre> </li> <li>Berlin und Umgebung: <pre> 10;12;13;14;15;16 </pre> </li> <li>Bleibt die Variable leer, werden alle Gemeindeschlüssel verwendet. </li> </ul> Wenn es bei der Erkennung von Gemeindeschluesseln zu vielen Fehlern kommt, beispielsweise wegen unterschiedlicher Schreibweisen von Orten, kann man selber eine Datei <code>EBKUS_HOME/sql/gemeindeschluessel.csv</code> erstellen, bestehend aus einer Tabelle mit den Spalten <code>plz, ort ags</code>. Als Vorlage kann die Datei <code>EBKUS_HOME/sql/gemeindeschluessel_cache.csv</code> dienen, die automatisch erzeugt wird, wenn die Konfigurationsvariable <code>gemeindeschluessel_von_plz</code> einen Wert hat. <br />
|-<br />
|{{konfig|host}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer des Rechners, auf der EBKuS-Server der Instanz läuft.<br />
<br />
<br />
|-<br />
|{{konfig|keine_bundesstatistik}}<br />
|{{code|false}}<br />
|Falls hier {{code|true}} steht, wird die Bundesstatistik aus der Anwendung ausgeblendet. Es kann keine Bundesstatistik ausgefüllt werden und steht auch nicht für Statistik und Export zur Verfügung.<br />
<br />
|-<br />
|{{konfig|log_file}}<br />
|{{konfig|instance_home}}{{code|/}}{{konfig|instance_name}}{{code|.log}}<br />
|Name der Datei, in die der EBKuS-Server Meldungen schreibt<br />
<br />
|-<br />
|{{konfig|log_level}}<br />
|{{code|INFO}}<br />
|Legt fest, wie "geschwätzig" der EBKuS-Server ist. Muss einer der folgenden Werte sein, in aufsteigender Wortfülle: {{code|CRITICAL, ERROR, WARNING, INFO, DEBUG}} ({{code|DEBUG}} ist nur für die Fehlersuche geeignet, da sehr viel ausgegeben wird.)<br />
<br />
|-<br />
|{{konfig|port}}<br />
|style="background-color:orangered;"|{{code|}}<br />
|Portnummer über die der EBKuS-Server angesprochen wird. Muss angegeben werden. Jede Instanz muss eine unterschiedliche Portnummer erhalten.<br />
|}<br />
<br />
<br />
==== Konfiguration für externe Anwendungen ====<br />
<br />
Die folgenden Konfigurationsvariablen bewirken, dass auf der Klientenkarte ein Kasten mit maximal vier Buttons erscheint, die in einem neuen Tab/Fenster eine URL aufrufen, die Felder des aktuellen (letzten) Falles bzw. des angemeldeten Mitarbeiters als Bestandteile haben kann:<br />
# Kein Kasten, wenn diese Variable keinen Wert hat.<br />
extern_fieldset_label: Externe Anwendung<br />
# Position auf der Klientenkarte<br />
extern_fieldset_position: 6<br />
# Maximal vier Buttons, für jeden eine Bezeichnung und eine Url.<br />
# Ein Button kommt nur zustande, wenn sowohl Label als auch Url<br />
# einen Wert haben. <br />
extern_button1_label: GoogleWeb<br />
extern_button1_url: <nowiki>http://www.google.com/search?q=$$fall_id$$_$$fall_akte__ort$$</nowiki><br />
extern_button2_label: GoogleMaps<br />
extern_button2_url: <nowiki>http://www.google.com/maps?q=$$mitarbeiter_na$$</nowiki><br />
extern_button3_label: GoogleImages<br />
extern_button3_url: <nowiki>http://www.google.com/images?q=$$fall_akte__ort$$</nowiki><br />
extern_button4_label: GoogleNews<br />
extern_button4_url: http://www.google.com/news?q=$$fall_fn$$</nowiki><br />
<br />
Urls können Abschnitte der folgenden Form enthalten:<br />
{{code|$$<fall oder mitarbeiter>_<feld>$$}}<br />
Der ganze Abschnitt wird durch den Wert von {{code|<feld>}} ersetzt, <br />
wobei entweder im Fall-Objekt oder im Mitarbeiter-Objekt <br />
nachgeschlagen wird. <br />
Beispiele:<br />
{{code|$$fall_id$$}}, {{code|$$mitarbeiter_na$$}}, {{code|$$fall_akte__ort$$}}<br />
<br />
Im Beispiel oben werden als externe Anwendungen verschiedene Google-Dienst aufgerufen, wobei als Parameter Daten aus dem aktuellen Fall übergeben werden.<br />
(Das Beispiel ist nicht sinnvoll und dient nur der Illustration des Mechanismus.)<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|extern_fieldset_label}}<br />
|{{code|}}<br />
|Bezeichnung für den Kasten mit den Buttons für die externen Anwendungen<br />
<br />
|-<br />
|{{konfig|extern_fieldset_position}}<br />
|{{code|2}}<br />
|Position auf der Klientenkarte (Gezählt werden die umrandeten Kästen mit einer Bezeichnung: Klientendaten, Bezugspersonen, Leistungen, etc.)<br />
|-<br />
|{{konfig|extern_buttonX_label}}<br />
|{{code|}}<br />
|Name der externen Anwendung<br />
<br />
<br />
|-<br />
|{{konfig|extern_buttonX_url}}<br />
|{{code|}}<br />
|URL der externen Anwendung mit Platzhaltern für die zu übernehmenden Parameter<br />
<br />
|}<br />
<br />
{{konfig|X}} kann 1,2,3 oder 4 sein.<br />
<br />
<br />
== Fachliche Parameter ==<br />
<br />
Die hier beschriebenen Einstellungen können auch vom Anwendungsbetreuer über {{pfad2|Administratorhauptmenü|Allgemeine Konfiguration}} vorgenommen werden.<br />
<br />
<br />
=== <nowiki>[</nowiki>''Instanz''<nowiki>]</nowiki> ===<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|admin_email}}<br />
|{{code|Keine Angabe}}<br />
|Email-Adresse des Anwendungsbetreuers.<br />
<br />
Wird in Fehlermeldungen genannt.<br />
|-<br />
|{{konfig|admin_name}}<br />
|{{code|Keine Angabe}}<br />
|Name des Anwendungsbetreuers.<br />
<br />
Wird in Fehlermeldungen genannt.<br />
|-<br />
|{{konfig|admin_tel}}<br />
|{{code|Keine Angabe}}<br />
|Telefonnummer des Anwendungsbetreuers.<br />
<br />
Wird in Fehlermeldungen genannt.<br />
|-<br />
|{{konfig|anmeldungsdaten_}} {{konfig|obligatorisch}}<br />
|{{code|false}}<br />
|Falls <code>true</code> werden die Anmeldungsdaten obligatorisch im Aufnahmeformular erhoben anstatt optional in einer getrennten Maske.<br />
<br />
Die entsprechenden Pflichfelder sind dabei auszufüllen. Eine spätere Bearbeitung der Anmeldungsdaten erfolgt wie bisher in einer eigenständigen Maske (analog der späteren Bearbeitung einer Leistung).<br />
|-<br />
|{{konfig|anmeldeprobleme_und_}} {{konfig|beschaeftigung_bei_}}{{konfig|anmeldung_erfassen}}<br />
|{{code|false}}<br />
|Falls <code>true</code> werden Probleme bei der Anmeldung und Beschäftigung schon bei der Anmeldung erfasst und später für die Fachstatistik übernommen.<br />
<br />
Die Auswahlfelder 'Beschäftigung Jugendliche(r)', 'Beschäftigungsverhältnis Mutter', 'Beschäftigungsverhältnis Vater' und das Mehrfachauswahlfeld 'Problem(e) bei der Anmeldung' aus der Fachstatistik werden in den Kasten Anmeldekontakt als Pflichtfelder aufgenommen. Es ist jedoch in jedem Fall möglich 'Keine Angabe' auszuwählen (genau wie in der Fachstatistik selbst). Die Daten werden mit dem Fall (nicht mit der Akte bzw. den Stammdaten) gespeichert. Wenn eine Fachstatistik angelegt wird, werden die Daten übernommen.<br />
|-<br />
|{{konfig|beratungskontakte}}<br />
|{{code|false}}<br />
|Falls <code>true</code> können in der Klientenakte einzelne Beratungskontakte eingetragen werden. Die Summen werden in die Bundesstatistik und in die Fachstatistik als Vorgabe übernommen.<br />
|-<br />
|{{konfig|beratungskontakte_bs}}<br />
|{{code|false}}<br />
|Falls <code>true</code> treten Anpassungen speziell für Braunschweig in Kraft.<br />
<br />
Die Variable <code>beratungskontakte</code> muss ebenfalls auf <code>true</code> stehen.<br />
|-<br />
|{{konfig|cache_on}}<br />
|{{code|true}}<br />
|Falls <code>true</code> wird der Objektcache eingeschaltet, sonst bleibt er abgeschaltet.<br />
<br />
Normalerweise ist der Cache an, aber es kann in seltenen Fällen zu Fehlern kommen, die verschwinden, wenn er abgeschaltet wird. Auf die inhaltlichen Abläufe hat das keine Auswirkungen, <br />
allenfalls auf die Performance.<br />
|-????<br />
|{{konfig|erinnern_nach_wochen_ohne_kontakt}}<br />
|{{code|0}}<br />
|Anzahl der Wochen ohne Kontakt nach der ein offener Fall in die Erinnerungsfunktion aufgenommen wird.<br />
<br />
Wenn hier eine Zahl zwischen 1 und 99 steht, wird die Erinnerungsfunktion aktiviert. Auf einem zusätzlichen Button im Hauptmenü steht dann die Anzahl der offenen Fälle, mit denen es länger als die angegebene Anzahl von Wochen keinen Kontakt gegeben hat. Nach dem Betätigen des Buttons erscheint eine Liste dieser Fälle. Jeder Fall kann als erledigt markiert werden, worauf er künftig normalerweiser nicht mehr in der Liste erscheint. Für die gesamte Liste gibt es aber eine Option, alle Fälle einschließlich der erledigten anzuzeigen. Die 'Erledigt'-Markierung kann dann auch wieder rückgängig gemacht werden.<br />
<br />
Es muss hier die Ziffer 0 stehen, wenn die Erinnerungsfunktion deaktiviert bleiben soll.<br />
|-<br />
|{{konfig|fachstatistik_akte_}} {{konfig|diskrepanz_nicht_zulassen}}<br />
|{{code|false}}<br />
|Falls <code>true</code> werden Diskrepanzen zwischen Fachstatistik und Akte nicht zugelassen.<br />
<br />
Die entsprechenden Items in der Fachstatistik zeigen die Werte aus der Akte und sind nicht modifizierbar. Eine Diskrepanz kann so gar nicht entstehen. Allerdings muss bei Änderungen in der Akte die Fachstatistik neu abgespeichert werden, damit die Änderungen übernommen und für die Statistik wirksam werden.<br /> Betroffen sind nur die Items 'Familienstatus', 'Empfohlen von' und 'Erbrachte Leistungen in der Fachstatistik', deren Werte im Normalfall aus der Akte vorbelegt werden.<br />
|-<br />
|{{konfig|fallunabhaengige}} {{konfig|_aktivitaeten_bs}}<br />
|{{code|false}}<br />
|Falls <code>true</code> können fallunabhängige Aktivitäten eingetragen und ausgewertet werden. Speziell für Braunschweig. <br />
|-????<br />
|{{konfig|fallbeginn_bei_}}{{konfig|erster_leistung}}<br />
|{{code|false}}<br />
|Falls <code>true</code> können fallunabhängige Aktivitäten eingetragen und ausgewertet werden. Speziell für Braunschweig. <br />
|-????<br />
|{{konfig|fallbeginn_waehlbar}}<br />
|{{code|false}}<br />
|Falls <code>true</code> können fallunabhängige Aktivitäten eingetragen und ausgewertet werden. Speziell für Braunschweig. <br />
|-<br />
|{{konfig|instance_title}}<br />
|{{konfig|instance_name}}<br />
|Langname für die Instanz.<br />
<br />
Erscheint bei der Anmeldung und in der Statuszeile.<br />
|-????<br />
|{{konfig|jgh_gemeindeschluessel}}<br />
|{{code|}}<br />
|Langname für die Instanz.<br />
<br />
Erscheint bei der Anmeldung und in der Statuszeile.<br />
|-<br />
|{{konfig|leistungsende_in_}}<br />
{{konfig|zukunft_erlaubt}}<br />
|{{code|false}}<br />
|Beim Eintrag einer Leistung darf für das Ende ein Datum, das in der Zukunft liegt, eingetragen werden.<br />
<br />
Der Abschluss des Falls ist erst möglich, wenn alle Leistungen beendet sind.<br />
|-<br />
|{{konfig|loeschfrist}}<br />
|{{code|36}}<br />
|Löschfrist in Monaten.<br />
<br />
Akten, die älter sind, können vom Administrator gelöscht werden.<br />
|-????<br />
|{{konfig|log_query_laenger_als}}<br />
|{{code|0}}<br />
|Löschfrist in Monaten.<br />
<br />
Akten, die älter sind, können vom Administrator gelöscht werden.<br />
|-<br />
|{{konfig|meldung_vom_admin}}<br />
|{{code|}}<br />
|Inhalt wird als Meldung vom Administrator unübersehbar auf jeder EBKuS-Seite über der Statuszeile ausgegeben.<br />
<br />
Damit kann der Administrator Meldungen an alle aktiven EBKuS-Nutzer ausgeben, z.B. um einen Ausfall von EBKuS wegen Wartungsarbeiten anzukündigen. <br />
|-<br />
|{{konfig|neumeldungen_nach_region}}<br />
|{{code|}}<br />
|Definiert eine Tabelle ''Neumeldungen nach Region'' unter ''Neumelde- und Abschlusszahlen''.<br />
<br />
Die Regionen, für die in der Tabelle die Neumeldungen ausgezählt werden sollen, müssen unter {{pfad4|Hauptmenü|Statistikabfrage|Teilmenge|Neu}} als Teilmengendefinitionen eingeführt werden. Der Namen der gewünschten Definitionen werden durch <code>;</code> getrennt aufgeführt. <br /><br /> Beispiel: <ul> <li> <pre> Gifhorn und Samtgemeinde Meinersen; Braunschweig 38120 und 38112 </pre> </li> </ul> "Gifhorn und Samtgemeinde Meinersen" ist eine Teilmengendefinition mit der Definition: <code>( ort = 'Gifhorn' ODER samtgemeinde = 'Meinersen' )</code>. "Braunschweig 38120 und 38112" ist eine Teilmengendefinition mit der Definition: <code>( ort = 'Braunschweig' UND plz = '38112' oder '38120' )</code>. <br /><br /> <br />
|-<br />
|{{konfig|session_time}}<br />
|{{code|120}}<br />
|Länge einer Session in Minuten. <br />
<br />
Nach dieser Zeit wird ein Benutzer automatisch abgemeldet, wenn er keine Eingaben mehr macht.<br />
|-<br />
|{{konfig|sql_abfrage}}<br />
|{{code|false}}<br />
|Falls <code>true</code> steht die Maske zum Absetzen von SQL-Abfragen vom Administrationsmenü aus zur Verfügung. <br />
<br />
|-<br />
|{{konfig|strassenkatalog}}<br />
|{{code|}}<br />
|Falls diese Variable nicht leer ist, wird bei der Adresseingabe der Straßenkatalog verwendet.<br />
<br />
Der eigentliche Wert der Variable spielt nur bei der Erstinstallation der Instanz eine Rolle.<br />Eine Instanz ohne Straßenkatalog kann auch später noch für die Verwendung mit Straßenkatalog eingerichtet werden, indem der Straßenkatalog über {{pfad2|Administratorhauptmenü|Straßenkatalog importieren}} importiert wird und der Variable {{konfig|strassenkatalog}} ein beliebiger Wert zugewiesen wird, beispielsweise der Ortsname.<br />
|-<br />
|{{konfig|strassenkatalog_}} {{konfig|vollstaendig}}<br />
|{{code|false}}<br />
|Falls <code>true</code> wird angenommen, dass der Straßenkatalog Einträge für jede einzelne Hausnummer enthält.<br />
<br />
Ansonsten wird angenommen, dass lediglich Einträge für ganze Straßen bzw. für bestimmte Intervalle von Hausnummern vorhanden sind.<br />
|-<br />
|{{konfig|strassensuche}}<br />
|{{code|}}<br />
|Bestimmt die Anzeige von Zusatzinformationen aus dem Straßenkatalog bei der Darstellung und Eingabe von Adressen.<br />
<br />
Zulässige Werte sind: <code>ort bezirk ortsteil samtgemeinde</code>.<br /><br /> Beispiele: <ul> <li>In Berlin gibt es nur einen Ort im Straßenkatalog, nämlich 'Berlin'. Das Feld <code>ort</code> ist daher nicht nötig. Ortsteil und Samtgemeinde haben im Straßenkatalog keine Werte, Bezirk allerdings schon. Der sinnvolle Wert für Berlin ist also <pre> bezirk </pre> </li> <li>In Gifhorn gibt es mehrere Orte im Straßenkatalog. Sowohl Ortsteile und Samtgemeinden spielen eine Rolle und sind im Straßenkatalog erfasst, Bezirke jedoch nicht. Der sinnvolle Wert hier ist also <pre> ort ortsteil samtgemeinde </pre> </li> <li>Wenn es nur einen Ort gibt und weder Bezirke, Ortsteile oder Samtgemeinden im Straßenkatalog erfasst sind, sollte die Variable leer bleiben. </ul> <br /><br />Irrelevant, wenn kein Straßenkatalog verwendet wird.<br />
|-<br />
|{{konfig|warnung_bei_fachstatistik_}} {{konfig|akte_diskrepanz}}<br />
|{{code|false}}<br />
|Falls <code>true</code> wird beim Speichern der Fachstatistik auf eine Diskrepanz zwischen Akte und Fachstatistik hingewiesen, falls vorhanden.<br />
<br />
Wenn man bei dem dann zur Verfügung stehendem Item "Diskrepanz zur Akte zulassen" ein Häkchen setzt, kann man trotzdem speichern.<br /> Betroffen sind nur die Items 'Familienstatus', 'Empfohlen von' und 'Erbrachte Leistungen in der Fachstatistik', deren Werte im Normalfall aus der Akte vorbelegt werden.<br />
|-<br />
|{{konfig|wiederaufnahmefrist}}<br />
|{{code|1}}<br />
|Anzahl der Monate, innerhalb derer ein abgeschlossener Fall wiederaufgenommen werden kann ("z.d.A. rückgängig").<br />
<br />
Danach muss ein neuer Fall angelegt werden.<br />
|-<br />
|{{konfig|wohnt_nicht_ausserhalb}}<br />
|{{code|}}<br />
|Definiert die Teilmenge der Adressen, die im Sinne der Bundesstatistik in die Zuständigkeit der Beratungsstelle fallen.<br />
<br />
Aufgrund der hier angegebenen Kriterien wird entschieden, ob der Klient in der Bundesstatistik als ausserhalb des Zuständigkeitsbereichs der Beratungsstelle wohnend angegeben wird. Als mögliche Kriterien kommen in Frage: <code>plz,ort,ortsteil,samtgemeinde,bezirk,plraum</code>. Die Kriterien <code>ortsteil,samtgemeinde,bezirk</code> sind nur sinnvoll, wenn ein Straßenkatalog verwendet wird und dieser auch entsprechende Angaben enthält. <br /><br /> Die Kriterien werden wie folgt in der angegebenen Reihenfolge abgearbeitet: <ul> <li>Wenn die Klientenadresse keinen Wert für das Kriterium aufweist, wird zum nächsten Kriterium übergegangen. </li> <li>Falls die Klientenadresse einen Wert hat und im Kriterium genannt wird, wohnt er nicht außerhalb. Ist der Wert im Kriterium nicht genannt, wohnt er außerhalb. In beiden Fällen werden die weiteren Kriterien nicht mehr betrachtet. </li> <li>Falls aufgrund fehlender Werte (oder fehlender Kriterien) kein Kriterium angewendet werden konnte, wird standardmäßig angenommen, dass der Klient nicht außerhalb wohnt. </li> </ul> Beispiele: <ul> <li> <pre> bezirk: Friedrichshain-Kreuzberg; ort: Berlin </pre> In Berlin enthalten alle mit dem Straßenkatalog abgeglichene Adressen einen Wert für den Bezirk. Da jede Beratungsstelle genau für einen Bezirk zuständig ist, kann auf dieser Basis entschieden werden. Falls eine Adresse nicht mit dem Straßenkatalog abgeglichen wurde, kann der Ort als Kriterium herangezogen werden, da in diesem Fall für Bezirk keine Angaben vorliegen. </li> <li> Falls kein Straßenkatalog verwendet wird, kann nur der Ort, die Postleitzahl oder evt. der Planungsraum (falls solche definiert sind und routinemäßig mit den Klientenadressen zusammen erfasst werden) als Kriterium verwendet werden, z.B. (fiktiv!): <pre> plz: 12345;23456;34567 </pre> Adressen mit diesen Postleitzahlen werden als nicht außerhalb wohnend betrachtet, alle anderen als außerhalb. Falls die Klientenadresse keine 5-stellige PLZ enthält, gilt der Wert als fehlend. Ungenauigkeiten werden in Kauf genommen, da die Region der Zuständigkeit nicht immer exakt mit den Regionen der Postleitzahlen übereinstimmt. </li> <li> <pre> samtgemeinde: Name1;Name2;Name3; plz: 12345;23456 </pre> Analog zum Berliner Beispiel würde hier auch zunächst das Kriterium Samtgemeinde versucht, das aber nur nach einem Abgleich mit dem Straßenkatalog bekannt ist. Für die nicht abgeglichenen Adressen wird dann die Postleitzahl herangezogen. In seltenen Fällen kann das zu Fehlern führen, da die Bereiche der Postleitzahlen manchmal nicht mit den Bereichen der Zuständigkeit exakt übereinstimmen. </li> </ul> Falls das Ergebnis "wohnt außerhalb" ist, wird automatisch ein entsprechender Eintrag in die Bundesstatistik vorgenommen, der beim Ausfüllen oben im Kasten "Falldaten" angezeigt wird. Wenn möglich wird der <strong>amtliche Gemeindeschlüssel</strong> eingetragen. Wenn dieser nicht gefunden wird, wird Postleitzahl und Wohnort angegeben. <br /><br /> <strong>Syntax</strong> wie in den Beispielen. Rund um die Trenner <code>;</code> und <code>:</code> dürfen Leerzeichen stehen. Es können auch mehrere Zeilen verwendet werden. <br /><br /> Unter (Berater-) {{pfad5|Hauptmenü|Statistik|Teilmenge|Neu|Neue Bedingung}}" finden Sie für jedes Kriterium die Menge der möglichen Werte. <br /><br /> Zur <strong>Testen</strong> gibt es unter {{pfad3|Aministratorhauptmenü|Bundesstatistik|Exportieren}} einen neuen Punkt ''Adressen außerhalb prüfen''. Sie können dort in einer Tabelle sehen, welche Adressen als außerhalb klassifiziert werden. <br />
|}</div>Ebkushttps://www.ebkus.org/wiki/KonfigurationKonfiguration2014-07-03T14:09:10Z<p>Ebkus: </p>
<hr />
<div>Die zentrale Konfigurationsdatei für eine EBKuS-Installation ist eine Textdatei namens <code>ebkus.conf</code> und befindet sich im Homeverzeichnis ({{file|ebkus}} im Installationsverzeichnis).<br />
<br />
Als Ausgangspunkt für die eigene Konfiguration dient die vom Installationsskript {{code|install.py}} aus einer [http://svn.berlios.de/wsvn/ebkus/ebkus-3/trunk/templates/ebkus.conf.template Vorlage] generierte Konfigurationsdatei. Die meisten Parameter (= Konfigurationvariable) sind darin bereits korrekt gesetzt.<br />
<br />
<br />
== Aufbau von <code>ebkus.conf</code> ==<br />
<br />
Zeilen, die leer sind oder mit dem Kommentarzeichen <code>#</code> beginnen, werden ignoriert, z.B.:<br />
<br />
<pre>#ebkus_home: %(install_dir)s\ebkus</pre><br />
<br />
In diesem Fall hat der Parameter den in der Tabelle genannten Standardwert.<br />
<br />
Zeilen, die nur aus einem Namen in eckigen Klammern bestehen, leiten eine Sektion ein, z.B.:<br />
<br />
<pre>[apache]</pre><br />
Die übrigen Zeilen weisen einem Parameter einen Wert zu. Sie beginnen mit dem Namen des Parameters, gefolgt von einem Doppelpunkt, gefolgt von dem Wert. Vor oder nach dem Doppelpunkt können Leerzeichen stehen. Beispiel:<br />
<br />
<pre>install_dir: C:\ebkus_installation</pre><br />
Werte können eine Syntax enthalten, die es erlaubt, vorher definierte Parameter in einen aktuellen Wert einzubeziehen (''Parametersubstitution''), z.B.:<br />
<br />
<pre>ebkus_home: %(install_dir)s\ebkus</pre><br />
Hier wird der Wert von <code>install_dir</code> in den Wert von <code>ebkus_home</code> einbezogen. Das ist genauso, als ob man gleich<br />
<br />
<pre>ebkus_home: C:\ebkus_installation\ebkus</pre><br />
definiert hätte. <code>%(</code>''parameter''<code>)s</code> wird durch den Wert von ''parameter'' ersetzt.<br />
<br />
Jede gültige Konfigurationsdatei muss die folgenden Sektionen aufweisen:<br />
<br />
*<code>[DEFAULT]</code><br />
*<code>[ebkus]</code><br />
*<code>[apache]</code><br />
*<code>[openssl]</code><br />
*eine Sektion für jede Instanz: <code>[</code>''Instanzname''<code>]</code><br />
<br />
Die möglichen Parameter für jede Sektion sind in den folgenden Tabellen aufgeführt.<br />
<br />
Alle Parameter außer denen, die in den Tabelle rot markiert sind, haben einen Standardwert (manchmal auch ''Defaultwert'' genannt), der in der Tabelle in der Spalte Standardwert angegeben ist. Ein Parameter hat diesen Wert, wenn er in der Konfiguration fehlt oder auskommentiert ist.<br />
<br />
Wie man sieht, können Parametersubstitutionen auch bei Standardwerten stattfinden. Der Wert des notwendige Parameter ''install_dir'' findet dadurch Eingang in weitere Parameter (''ebkus_home'', ''instance_home''), ohne dass diese explizit in der Konfiguration aufgeführt sind.<br />
<br />
''Anmerkung zu den Tabellen'': In einigen Fällen ist der angegebene Parameter bzw. Standardwert aus layout-technischen Gründen auf mehrere Zeilen verteilt, obwohl er eigentlich ohne Leerzeichen hintereinanderweg in einer Zeile stehen müsste.<br />
<br />
Wir unterscheiden ''Systemparameter'' von ''fachlichen Parametern''. Erstere betreffen den technischen Betrieb von EBKuS und werden von den Systemadministratoren (IT) bei der Installation eingerichtet. Fachparameter können ebenso wie Systemparameter in der {{file|ebkus.conf}} in der Instanzsektion gesetzt werden, außerdem kann aber auch der Anwendungsbetreuer über {{pfad2|Administratorhauptmenü|Allgemeine Konfiguration}} weitere Veränderungen vornehmen. Die vom Anwendungsbetreuer vorgenommenen Änderungen haben stets Vorrang über den Angaben in der {{file|ebkus.conf}}.<br />
<br />
<br />
== Systemparameter ==<br />
<br />
=== <nowiki>[DEFAULT]</nowiki> ===<br />
<br />
Die generierte Konfigurationsdatei enthält die korrekten Werte.<br />
<br />
Der Parameter {{konfig|install_dir}} bezeichnet das Installationsverzeichnis und muss immer in der Konfiguration definiert werden. Es bildet den Bezugspunkt für alle weiteren Pfade. Standardmäßig ist {{konfig|ebkus_home}} das Verzeichnis <code>ebkus</code> im Installationsverzeichnis; das sollte nicht verändert werden.<br />
<br />
Die in der Sektion <code>[DEFAULT]</code> definierten Parameter können in allen anderen Sektionen im Rahmen der Parametersubstitution als Teil eine Wertes verwendet werden (z.B. in der Definition von {{konfig|instance_home}}). Ansonsten stehen nur die Parameter derselben Sektion zur Verfügung.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|install_dir}}<br />
|style="background-color:orangered;"|{{code|}}<br />
|Installationsverzeichnis<br />
|-<br />
|{{konfig|ebkus_home}}<br />
|{{konfig|install_dir}}/ebkus<br />
|Homeverzeichnis<br />
|}<br />
<br />
<br />
=== <nowiki>[ebkus]</nowiki> ===<br />
<br />
Die generierte Konfigurationsdatei enthält in der Regel die korrekten Werte.<br />
<br />
Die {{konfig|database_admin_*}}-Parameter erlauben den Installationsskripten, neue Datenbanken für Instanzen einzurichten und diese bei der Deinstallation auch wieder zu entfernen.<br />
<br />
Falls aus Sicherheitsgründen erwünscht, kann hier ein Passwort für den Administratorzugriff auf MySQL eingetragen werden. Geschieht dies unter Windows vor der automatischen Installation von MySQL, wird bei der automatischen Installation der Administratorzugriff mit diesem Passwort eingerichtet.<br />
<br />
Falls das Passwort für den Administratorzugriff nicht im Klartext in der Konfigurationsdatei stehen soll, kann stattdessen <code>ASK</code>eingetragen werden. Dann fragen alle Skripte, die den Administratorzugriff benötigen, interaktiv nach dem Passwort, ohne es irgendwo zu speichern.<br />
<br />
Da MySQL standardmäßig nur von dem lokalen Rechner erreichbar ist, und dieser ohnehin nur für dem Administrator zugänglich ist, ist die zusätzliche Absicherung durch ein Passwort oft nicht nötig.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|download_dir}}<br />
|{{konfig|install_dir}}/download<br />
|Downloadverzeichnis. Dort steht die zu installierende Software, die im Bedarfsfall heruntergeladen wird.<br />
|-<br />
|{{konfig|database_admin_host}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer des Rechners, auf dem MySQL läuft. Muss angegeben werden, wenn das nicht der lokale Rechner ist.<br />
|-<br />
|{{konfig|database_admin_user}}<br />
|{{code|root}}<br />
|MySQL-Benutzer mit Administratorrechten<br />
|-<br />
|{{konfig|database_admin_password}}<br />
|{{code|}}<br />
|Dessen Passwort. Wenn hier ``ASK`` steht, wird das Passwort bei Bedarf interaktiv abgefragt.<br />
<br />
|-<br />
|{{konfig|mysql_dir}}<br />
|{{code|}}<br />
|Verzeichnis, in dem die MySQL-Programme mysql, mysqldump, etc. stehen. Muss angegeben werden, wenn MySQL-Programme nicht im Pfad stehen.<br />
<br />
|-<br />
|{{konfig|python_executable}}<br />
|<br />
|Vollständiger Pfad des Python-Executable, mit dem EBKuS ausgeführt wird<br />
|}<br />
<br />
<br />
=== <nowiki>[apache]</nowiki> ===<br />
<br />
Für den Parameter {{konfig|server_name}} muss unbedingt der Name oder die IP-Nummer des Rechners eingetragen werden, auf dem der Apache-Webserver läuft. Die generierte Konfigurationsdatei setzt den Standardwert <code>localhost</code>, womit EBKuS nur auf dem lokalen Rechner zugänglich ist.<br />
<br />
Für den Parameter {{konfig|server_admin}} sollte eine sinnvolle Email-Adresse eingetragen werden. Sie taucht in Apache-Fehlermeldungen auf (die allerdings normalerweise nicht vorkommen sollten).<br />
<br />
Alle übrigen Werte können in der Regel von der generierten Konfigurationsdatei übernommen werden.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|apache_log_dir}}<br />
|{{konfig|ebkus_home}}/log<br />
|Verzeichnis, in dem der Apache-Webserver Log-Dateien anlegt<br />
|-<br />
|{{konfig|server_admin}}<br />
|{{code|admin@localhost}}<br />
|Email-Adresse des Serveradministrators, die auf evt. Fehlerseiten des Servers erscheint.<br />
<br />
|-<br />
|{{konfig|server_name}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer des Rechners, auf dem der Apache-Webserver läuft.<br />
**Muss** explizit eingetragen werden, sonst kann EBKuS nur auf dem lokalen Rechner verwendet werden!<br />
<br />
|-<br />
|{{konfig|server_https_port}}<br />
|{{code|443}}<br />
|Port für verschlüsselte Verbindungen. Die EBKuS-Anwendung wird ausschließlich über diesen Port abgewickelt. Wenn der Standardport {{code|443}} nicht zur Verfügung steht, kann hier ein alternativer Port angegeben werden. Dieser muss dann als Teil der URL aufgeführt werden, z.B. für den Alternativport {{code|500}}: {{code|<nowiki>https://192.168.1.73:500/ebkus/demo/</nowiki>}}.<br />
<br />
|-<br />
|{{konfig|server_https_port}}<br />
|{{code|80}}<br />
|Port für unverschlüsselte Verbindungen. Die EBKuS-Anwendung verwendet diesen Port nicht. Dient nur zur Kontrolle des Apache Webservers: {{code|<nowiki>http://localhost/</nowiki>}} liefert "It works!". Wird hier der Port {{code|8080}} angegeben, müsste man {{code|<nowiki>http://localhost:8080/</nowiki>}} schreiben.<br />
<br />
|-<br />
|{{konfig|ssl_certificate_file}}<br />
|{{konfig|ebkus_home}}/ebkus_ssl_certificates/ebkusserver.cert<br />
|Vollständiger Pfad der SSL-Zertifikat-Datei<br />
<br />
<br />
|-<br />
|{{konfig|ssl_certificate_key_file}}<br />
|{{konfig|ebkus_home}}/ebkus_ssl_certificates/ebkusserver.key<br />
|Vollständiger Pfad der SSL-Schlüssel-Datei<br />
|}<br />
<br />
<br />
=== <nowiki>[openssl]</nowiki> ===<br />
<br />
Die Anwendung ist voll funktionsfähig mit den Werten aus der generierten Konfigurationsdatei; es empfiehlt sich jedoch, die organisatorischen Angaben für das SSL-Zertifikat anzupassen.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|openssl_executable}}<br />
|{{code|openssl}}<br />
|Falls openssl nicht im Pfad steht, muss der hier der vollständige Pfad zum Executable stehen<br />
<br />
|-<br />
|{{konfig|output_password}}<br />
|{{code|polo}}<br />
|Wird zur automatischen Zertifikatgenerierung benötigt<br />
<br />
|-<br />
|{{konfig|staat}}<br />
|{{code|DE}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|-<br />
|{{konfig|land}}<br />
|{{code|Berlin}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|-<br />
|{{konfig|ort}}<br />
|{{code|Berlin}}<br />
|Erscheint im SSL-Zertifikat<br />
|-<br />
|{{konfig|organisation}}<br />
|{{code|EFB}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|-<br />
|{{konfig|organisationseinheit}}<br />
|{{code|EFB}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|}<br />
<br />
<br />
=== <nowiki>[</nowiki>''Instanz''<nowiki>]</nowiki> ===<br />
<br />
<br />
Im Rahmen einer EBKuS-Installation auf einem Server können mehrere Instanzen einer EBKuS-Anwendung eingerichtet werden. Jede Instanz<br />
<br />
*hat einen Namen ({{konfig|instance_name}})<br />
*ist über eine eigene URL ansprechbar (<code>https://</code>'''server_name'''<code>/ebkus/</code>'''instance_name'''<code>/index.html</code>)<br />
*hat eine eigene Datenbank im Rahmen einer MySQL-Installation ({{konfig|database_name}}, {{konfig|database_user}}, {{konfig|database_password}})<br />
*hat ein eigenes Verzeichnis ({{konfig|instance_home}})<br />
*hat einen eigenen EBKuS-Server, der vom Apache-Webserver über eine eigene Portnummer angesprochen wird ({{konfig|port}})<br />
*hat eine eigene Log-Datei ({{konfig|log_file}})<br />
<br />
<br />
Für jede gewünschte Instanz wird eine Sektion in der Konfigurationsdatei angelegt. Die Sektionsüberschrift wird aus dem Namen der Instanz in eckigen Klammern gebildet. Der Name sollte mit einem Buchstaben beginnen und ansonsten nur Buchstaben, Ziffern und Unterstriche (<code>_</code>) enthalten (keine Leerzeichen!). Ein zusätzlicher Name für die Instanz ohne diese Einschränkung lässt sich über den Parameter {{konfig|instance_title}} einrichten (siehe unten).<br />
<br />
Falls der Instanzname mit <code>demo</code> beginnt, werden bei der Installation der Datenbank automatisch Demodaten erzeugt. Neben dem Benutzer <code>Admin</code> (Passwort: <code>Admin</code>) gibt es dann auch den Benutzer <code>test</code> (Passwort: <code>test</code>) und <code>verw</code>(Passwort: <code>verw</code>).<br />
<br />
Jede Sektion kann die in der Tabelle aufgeführten Parameter definieren. Erforderlich ist Wiederholung des Instanznamen als Wert von {{konfig|instance_name}}, ferner die Angabe einer eigenen, eindeutigen Portnummer, {{konfig|port}}. Für alle anderen Parameter können die Standardwerte genommen werden.<br />
<br />
Natürlich muss man {{konfig|berliner_version}} auf <code>true</code> setzen, wenn man die Berliner Version mit Berliner Straßenkatalog haben möchte; EBKuS-spezifische Fehlermeldungen sollten außerdem eine sinnvolle Telefonnummer bzw. Email-Adresse des Anwendungsbetreuers haben ({{konfig|admin_tel}}, {{konfig|admin_email}}).<br />
<br />
Die Parameter {{konfig|host}} und {{konfig|database_host}} müssen nur dann angepasst werden, wenn der EBKuS-Server bzw. die MySQL-Datenbank nicht auf demselben Rechner laufen wie der Apache-Webserver.<br />
<br />
Die bei der Installation generierte Konfigurationsdatei definiert vier Instanzen (2 davon auskommentiert):<br />
<br />
*<code>demo</code>: Demodaten, kein Straßenkatalog<br />
*<code>muster_efb</code>: keine Demodaten, kein Straßenkatalog. Beispiel für eine Produktionsinstanz, die vom Anwendungsbetreuer eingerichtet werden muss (siehe Einrichtung der Anwendung im Handbuch).<br />
<br />
Auskommentiert:<br />
*<code>demo_berlin</code>: Demodaten, Berliner Straßenkatalog (kleiner Ausschnitt, nur Straßen, deren Namen mit 'K' beginnen)<br />
*<code>demo_braunschweig</code>: Demodaten, Straßenkatalog mit Straßen aus Braunschweig, Gifhorn, Wolfenbüttel und Wolfsburg.<br />
<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
<br />
<br />
|-<br />
|{{konfig|instance_name}}<br />
|style="background-color:orangered;"|{{code|}}<br />
|Name der Instanz. Muss angegeben werden und dem Namen des Abschnitts (in eckigen Klammern) identisch sein. Darf keine Sonderzeichen außer den Unterstrich ('_') enthalten.<br />
<br />
<br />
|-<br />
|{{konfig|instance_home}}<br />
|{{konfig|ebkus_home}}/{{konfig|instance_name}}<br />
|Instanzverzeichnis. Liegt im Homeverzeichnis. Sollte nicht verändert werden.<br />
<br />
|-<br />
|{{konfig|initial_content}}<br />
|{{code|}}<br />
|Hier kann eine Datei angegeben werden, mit der die Instanzdatenbank initialisiert werden kann. Diese Datei wird immer dann geladen, wenn bei der Installation der Instanz ({{code|install.py}} oder {{code|configure.py}}) keine funktionierende Datenbank für die Instanz vorgefunden wird. Wenn keine Datei angegeben ist, wird eine neue Datenbank mit dem Merkmalskatalog ({{file|sql/merkmale_standard.py}}) und evt. einem Straßenkatalog erstellt. Wenn kein vollständiger Pfad für die Datei angegeben wird, muss die Datei im Homeverzeichnis liegen. Zulässige Dateien sind die mit dem Skript {{code|datenbank_sichern.py}} erzeugte Dateien sowie sonstige passende SQL-Dumps.<br />
<br />
|-<br />
|{{konfig|berliner_version}}<br />
|{{code|false}}<br />
|Wenn hier {{code|true}} steht, wird die Berliner EBKuS-Version verwendet mit Berliner Straßenkatalog. <br />
<br />
|-<br />
|{{konfig|database_host}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer, auf dem der Datenbankserver läuft.<br />
<br />
|-<br />
|{{konfig|database_name}}<br />
|{{konfig|instance_name}}<br />
|Name der Instanzdatenbank<br />
<br />
<br />
|-<br />
|{{konfig|database_user}}<br />
|{{konfig|instance_name}}<br />
|Benutzername der Instanzdatenbank<br />
<br />
|-<br />
|{{konfig|database_password}}<br />
|{{konfig|instance_name}}<br />
|Passwort der Instanzdatenbank<br />
<br />
<br />
|-<br />
|{{konfig|gemeindeschluessel_von_plz}}<br />
|{{code|}}<br />
|Definiert die Teilmenge der amtlichen Gemeindeschlüssel für die Bundesstatistik. Im Normalfall muss hier nichts eingetragen werden.<br />
<br /><br />
In der Bundesstatistik soll der amtliche Gemeindeschlüssel für den Wohnort des Klienten eingetragen werden, wenn der Wohnort des Klienten außerhalb des Kreises der Beratungsstelle liegt. Um die Menge der Daten zu begrenzen, kann hier über die Anfangsziffern der Postleitzahl eine Teilmenge definiert werden. Wenn mehrere Ziffernfolgen angegeben werden, müssen diese mit <code>;</code> getrennt werden.<br /><br /> Beispiele: <ul> <li>Alle Gemeindeschlüssel verwenden, außer die Postleitzahl der Gemeinde beginnt mit '9': <pre> 0;1;2;3;4;5;6;7;8 </pre> </li> <li>Große Teile Niedersachsens: <pre> 29;30;31;37;38 </pre> </li> <li>Nördliches Niedersachsen und Schleswig Holstein: <pre> 2 </pre> </li> <li>Berlin und Umgebung: <pre> 10;12;13;14;15;16 </pre> </li> <li>Bleibt die Variable leer, werden alle Gemeindeschlüssel verwendet. </li> </ul> Wenn es bei der Erkennung von Gemeindeschluesseln zu vielen Fehlern kommt, beispielsweise wegen unterschiedlicher Schreibweisen von Orten, kann man selber eine Datei <code>EBKUS_HOME/sql/gemeindeschluessel.csv</code> erstellen, bestehend aus einer Tabelle mit den Spalten <code>plz, ort ags</code>. Als Vorlage kann die Datei <code>EBKUS_HOME/sql/gemeindeschluessel_cache.csv</code> dienen, die automatisch erzeugt wird, wenn die Konfigurationsvariable <code>gemeindeschluessel_von_plz</code> einen Wert hat. <br />
|-<br />
|{{konfig|host}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer des Rechners, auf der EBKuS-Server der Instanz läuft.<br />
<br />
<br />
|-<br />
|{{konfig|keine_bundesstatistik}}<br />
|{{code|false}}<br />
|Falls hier {{code|true}} steht, wird die Bundesstatistik aus der Anwendung ausgeblendet. Es kann keine Bundesstatistik ausgefüllt werden und steht auch nicht für Statistik und Export zur Verfügung.<br />
<br />
|-<br />
|{{konfig|log_file}}<br />
|{{konfig|instance_home}}{{code|/}}{{konfig|instance_name}}{{code|.log}}<br />
|Name der Datei, in die der EBKuS-Server Meldungen schreibt<br />
<br />
|-<br />
|{{konfig|log_level}}<br />
|{{code|INFO}}<br />
|Legt fest, wie "geschwätzig" der EBKuS-Server ist. Muss einer der folgenden Werte sein, in aufsteigender Wortfülle: {{code|CRITICAL, ERROR, WARNING, INFO, DEBUG}} ({{code|DEBUG}} ist nur für die Fehlersuche geeignet, da sehr viel ausgegeben wird.)<br />
<br />
|-<br />
|{{konfig|port}}<br />
|style="background-color:orangered;"|{{code|}}<br />
|Portnummer über die der EBKuS-Server angesprochen wird. Muss angegeben werden. Jede Instanz muss eine unterschiedliche Portnummer erhalten.<br />
|}<br />
<br />
<br />
==== Konfiguration für externe Anwendungen ====<br />
<br />
Die folgenden Konfigurationsvariablen bewirken, dass auf der Klientenkarte ein Kasten mit maximal vier Buttons erscheint, die in einem neuen Tab/Fenster eine URL aufrufen, die Felder des aktuellen (letzten) Falles bzw. des angemeldeten Mitarbeiters als Bestandteile haben kann:<br />
# Kein Kasten, wenn diese Variable keinen Wert hat.<br />
extern_fieldset_label: Externe Anwendung<br />
# Position auf der Klientenkarte<br />
extern_fieldset_position: 6<br />
# Maximal vier Buttons, für jeden eine Bezeichnung und eine Url.<br />
# Ein Button kommt nur zustande, wenn sowohl Label als auch Url<br />
# einen Wert haben. <br />
extern_button1_label: GoogleWeb<br />
extern_button1_url: <nowiki>http://www.google.com/search?q=$$fall_id$$_$$fall_akte__ort$$</nowiki><br />
extern_button2_label: GoogleMaps<br />
extern_button2_url: <nowiki>http://www.google.com/maps?q=$$mitarbeiter_na$$</nowiki><br />
extern_button3_label: GoogleImages<br />
extern_button3_url: <nowiki>http://www.google.com/images?q=$$fall_akte__ort$$</nowiki><br />
extern_button4_label: GoogleNews<br />
extern_button4_url: http://www.google.com/news?q=$$fall_fn$$</nowiki><br />
<br />
Urls können Abschnitte der folgenden Form enthalten:<br />
{{code|$$<fall oder mitarbeiter>_<feld>$$}}<br />
Der ganze Abschnitt wird durch den Wert von {{code|<feld>}} ersetzt, <br />
wobei entweder im Fall-Objekt oder im Mitarbeiter-Objekt <br />
nachgeschlagen wird. <br />
Beispiele:<br />
{{code|$$fall_id$$}}, {{code|$$mitarbeiter_na$$}}, {{code|$$fall_akte__ort$$}}<br />
<br />
Im Beispiel oben werden als externe Anwendungen verschiedene Google-Dienst aufgerufen, wobei als Parameter Daten aus dem aktuellen Fall übergeben werden.<br />
(Das Beispiel ist nicht sinnvoll und dient nur der Illustration des Mechanismus.)<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|extern_fieldset_label}}<br />
|{{code|}}<br />
|Bezeichnung für den Kasten mit den Buttons für die externen Anwendungen<br />
<br />
|-<br />
|{{konfig|extern_fieldset_position}}<br />
|{{code|2}}<br />
|Position auf der Klientenkarte (Gezählt werden die umrandeten Kästen mit einer Bezeichnung: Klientendaten, Bezugspersonen, Leistungen, etc.)<br />
|-<br />
|{{konfig|extern_buttonX_label}}<br />
|{{code|}}<br />
|Name der externen Anwendung<br />
<br />
<br />
|-<br />
|{{konfig|extern_buttonX_url}}<br />
|{{code|}}<br />
|URL der externen Anwendung mit Platzhaltern für die zu übernehmenden Parameter<br />
<br />
|}<br />
<br />
{{konfig|X}} kann 1,2,3 oder 4 sein.<br />
<br />
<br />
== Fachliche Parameter ==<br />
<br />
Die hier beschriebenen Einstellungen können auch vom Anwendungsbetreuer über {{pfad2|Administratorhauptmenü|Allgemeine Konfiguration}} vorgenommen werden.<br />
<br />
<br />
=== <nowiki>[</nowiki>''Instanz''<nowiki>]</nowiki> ===<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|admin_email}}<br />
|{{code|Keine Angabe}}<br />
|Email-Adresse des Anwendungsbetreuers.<br />
<br />
Wird in Fehlermeldungen genannt.<br />
|-<br />
|{{konfig|admin_name}}<br />
|{{code|Keine Angabe}}<br />
|Name des Anwendungsbetreuers.<br />
<br />
Wird in Fehlermeldungen genannt.<br />
|-<br />
|{{konfig|admin_tel}}<br />
|{{code|Keine Angabe}}<br />
|Telefonnummer des Anwendungsbetreuers.<br />
<br />
Wird in Fehlermeldungen genannt.<br />
|-<br />
|{{konfig|anmeldungsdaten_}} {{konfig|obligatorisch}}<br />
|{{code|false}}<br />
|Falls <code>true</code> werden die Anmeldungsdaten obligatorisch im Aufnahmeformular erhoben anstatt optional in einer getrennten Maske.<br />
<br />
Die entsprechenden Pflichfelder sind dabei auszufüllen. Eine spätere Bearbeitung der Anmeldungsdaten erfolgt wie bisher in einer eigenständigen Maske (analog der späteren Bearbeitung einer Leistung).<br />
|-<br />
|{{konfig|anmeldeprobleme_und_}} {{konfig|beschaeftigung_bei_}}{{konfig|anmeldung_erfassen}}<br />
|{{code|false}}<br />
|Falls <code>true</code> werden Probleme bei der Anmeldung und Beschäftigung schon bei der Anmeldung erfasst und später für die Fachstatistik übernommen.<br />
<br />
Die Auswahlfelder 'Beschäftigung Jugendliche(r)', 'Beschäftigungsverhältnis Mutter', 'Beschäftigungsverhältnis Vater' und das Mehrfachauswahlfeld 'Problem(e) bei der Anmeldung' aus der Fachstatistik werden in den Kasten Anmeldekontakt als Pflichtfelder aufgenommen. Es ist jedoch in jedem Fall möglich 'Keine Angabe' auszuwählen (genau wie in der Fachstatistik selbst). Die Daten werden mit dem Fall (nicht mit der Akte bzw. den Stammdaten) gespeichert. Wenn eine Fachstatistik angelegt wird, werden die Daten übernommen.<br />
|-<br />
|{{konfig|beratungskontakte}}<br />
|{{code|false}}<br />
|Falls <code>true</code> können in der Klientenakte einzelne Beratungskontakte eingetragen werden. Die Summen werden in die Bundesstatistik und in die Fachstatistik als Vorgabe übernommen.<br />
|-<br />
|{{konfig|beratungskontakte_bs}}<br />
|{{code|false}}<br />
|Falls <code>true</code> treten Anpassungen speziell für Braunschweig in Kraft.<br />
<br />
Die Variable <code>beratungskontakte</code> muss ebenfalls auf <code>true</code> stehen.<br />
|-<br />
|{{konfig|cache_on}}<br />
|{{code|true}}<br />
|Falls <code>true</code> wird der Objektcache eingeschaltet, sonst bleibt er abgeschaltet.<br />
<br />
Normalerweise ist der Cache an, aber es kann in seltenen Fällen zu Fehlern kommen, die verschwinden, wenn er abgeschaltet wird. Auf die inhaltlichen Abläufe hat das keine Auswirkungen, <br />
allenfalls auf die Performance.<br />
|-????<br />
|{{konfig|erinnern_nach_wochen_ohne_kontakt}}<br />
|{{code|0}}<br />
|Anzahl der Wochen ohne Kontakt nach der ein offener Fall in die Erinnerungsfunktion aufgenommen wird.<br />
<br />
Wenn hier eine Zahl zwischen 1 und 99 steht, wird die Erinnerungsfunktion aktiviert. Auf einem zusätzlichen Button im Hauptmenü steht dann die Anzahl der offenen Fälle, mit denen es länger als die angegebene Anzahl von Wochen keinen Kontakt gegeben hat. Nach dem Betätigen des Buttons erscheint eine Liste dieser Fälle. Jeder Fall kann als erledigt markiert werden, worauf er künftig normalerweiser nicht mehr in der Liste erscheint. Für die gesamte Liste gibt es aber eine Option, alle Fälle einschließlich der erledigten anzuzeigen. Die 'Erledigt'-Markierung kann dann auch wieder rückgängig gemacht werden.<br />
<br /><br /><br />
Es muss hier die Ziffer 0 stehen, wenn die Erinnerungsfunktion deaktiviert bleiben soll.<br />
|-<br />
|{{konfig|fachstatistik_akte_}} {{konfig|diskrepanz_nicht_zulassen}}<br />
|{{code|false}}<br />
|Falls <code>true</code> werden Diskrepanzen zwischen Fachstatistik und Akte nicht zugelassen.<br />
<br />
Die entsprechenden Items in der Fachstatistik zeigen die Werte aus der Akte und sind nicht modifizierbar. Eine Diskrepanz kann so gar nicht entstehen. Allerdings muss bei Änderungen in der Akte die Fachstatistik neu abgespeichert werden, damit die Änderungen übernommen und für die Statistik wirksam werden.<br /> Betroffen sind nur die Items 'Familienstatus', 'Empfohlen von' und 'Erbrachte Leistungen in der Fachstatistik', deren Werte im Normalfall aus der Akte vorbelegt werden.<br />
|-<br />
|{{konfig|fallunabhaengige}} {{konfig|_aktivitaeten_bs}}<br />
|{{code|false}}<br />
|Falls <code>true</code> können fallunabhängige Aktivitäten eingetragen und ausgewertet werden. Speziell für Braunschweig. <br />
|-????<br />
|{{konfig|fallbeginn_bei_}}{{konfig|erster_leistung}}<br />
|{{code|false}}<br />
|Falls <code>true</code> können fallunabhängige Aktivitäten eingetragen und ausgewertet werden. Speziell für Braunschweig. <br />
|-????<br />
|{{konfig|fallbeginn_waehlbar}}<br />
|{{code|false}}<br />
|Falls <code>true</code> können fallunabhängige Aktivitäten eingetragen und ausgewertet werden. Speziell für Braunschweig. <br />
|-<br />
|{{konfig|instance_title}}<br />
|{{konfig|instance_name}}<br />
|Langname für die Instanz.<br />
<br />
Erscheint bei der Anmeldung und in der Statuszeile.<br />
|-????<br />
|{{konfig|jgh_gemeindeschluessel}}<br />
|{{code|}}<br />
|Langname für die Instanz.<br />
<br />
Erscheint bei der Anmeldung und in der Statuszeile.<br />
|-<br />
|{{konfig|leistungsende_in_}}<br />
{{konfig|zukunft_erlaubt}}<br />
|{{code|false}}<br />
|Beim Eintrag einer Leistung darf für das Ende ein Datum, das in der Zukunft liegt, eingetragen werden.<br />
<br />
Der Abschluss des Falls ist erst möglich, wenn alle Leistungen beendet sind.<br />
|-<br />
|{{konfig|loeschfrist}}<br />
|{{code|36}}<br />
|Löschfrist in Monaten.<br />
<br />
Akten, die älter sind, können vom Administrator gelöscht werden.<br />
|-????<br />
|{{konfig|log_query_laenger_als}}<br />
|{{code|0}}<br />
|Löschfrist in Monaten.<br />
<br />
Akten, die älter sind, können vom Administrator gelöscht werden.<br />
|-<br />
|{{konfig|meldung_vom_admin}}<br />
|{{code|}}<br />
|Inhalt wird als Meldung vom Administrator unübersehbar auf jeder EBKuS-Seite über der Statuszeile ausgegeben.<br />
<br />
Damit kann der Administrator Meldungen an alle aktiven EBKuS-Nutzer ausgeben, z.B. um einen Ausfall von EBKuS wegen Wartungsarbeiten anzukündigen. <br />
|-<br />
|{{konfig|neumeldungen_nach_region}}<br />
|{{code|}}<br />
|Definiert eine Tabelle ''Neumeldungen nach Region'' unter ''Neumelde- und Abschlusszahlen''.<br />
<br />
Die Regionen, für die in der Tabelle die Neumeldungen ausgezählt werden sollen, müssen unter {{pfad4|Hauptmenü|Statistikabfrage|Teilmenge|Neu}} als Teilmengendefinitionen eingeführt werden. Der Namen der gewünschten Definitionen werden durch <code>;</code> getrennt aufgeführt. <br /><br /> Beispiel: <ul> <li> <pre> Gifhorn und Samtgemeinde Meinersen; Braunschweig 38120 und 38112 </pre> </li> </ul> "Gifhorn und Samtgemeinde Meinersen" ist eine Teilmengendefinition mit der Definition: <code>( ort = 'Gifhorn' ODER samtgemeinde = 'Meinersen' )</code>. "Braunschweig 38120 und 38112" ist eine Teilmengendefinition mit der Definition: <code>( ort = 'Braunschweig' UND plz = '38112' oder '38120' )</code>. <br /><br /> <br />
|-<br />
|{{konfig|session_time}}<br />
|{{code|120}}<br />
|Länge einer Session in Minuten. <br />
<br />
Nach dieser Zeit wird ein Benutzer automatisch abgemeldet, wenn er keine Eingaben mehr macht.<br />
|-<br />
|{{konfig|sql_abfrage}}<br />
|{{code|false}}<br />
|Falls <code>true</code> steht die Maske zum Absetzen von SQL-Abfragen vom Administrationsmenü aus zur Verfügung. <br />
<br />
|-<br />
|{{konfig|strassenkatalog}}<br />
|{{code|}}<br />
|Falls diese Variable nicht leer ist, wird bei der Adresseingabe der Straßenkatalog verwendet.<br />
<br />
Der eigentliche Wert der Variable spielt nur bei der Erstinstallation der Instanz eine Rolle.<br />Eine Instanz ohne Straßenkatalog kann auch später noch für die Verwendung mit Straßenkatalog eingerichtet werden, indem der Straßenkatalog über {{pfad2|Administratorhauptmenü|Straßenkatalog importieren}} importiert wird und der Variable {{konfig|strassenkatalog}} ein beliebiger Wert zugewiesen wird, beispielsweise der Ortsname.<br />
|-<br />
|{{konfig|strassenkatalog_}} {{konfig|vollstaendig}}<br />
|{{code|false}}<br />
|Falls <code>true</code> wird angenommen, dass der Straßenkatalog Einträge für jede einzelne Hausnummer enthält.<br />
<br />
Ansonsten wird angenommen, dass lediglich Einträge für ganze Straßen bzw. für bestimmte Intervalle von Hausnummern vorhanden sind.<br />
|-<br />
|{{konfig|strassensuche}}<br />
|{{code|}}<br />
|Bestimmt die Anzeige von Zusatzinformationen aus dem Straßenkatalog bei der Darstellung und Eingabe von Adressen.<br />
<br />
Zulässige Werte sind: <code>ort bezirk ortsteil samtgemeinde</code>.<br /><br /> Beispiele: <ul> <li>In Berlin gibt es nur einen Ort im Straßenkatalog, nämlich 'Berlin'. Das Feld <code>ort</code> ist daher nicht nötig. Ortsteil und Samtgemeinde haben im Straßenkatalog keine Werte, Bezirk allerdings schon. Der sinnvolle Wert für Berlin ist also <pre> bezirk </pre> </li> <li>In Gifhorn gibt es mehrere Orte im Straßenkatalog. Sowohl Ortsteile und Samtgemeinden spielen eine Rolle und sind im Straßenkatalog erfasst, Bezirke jedoch nicht. Der sinnvolle Wert hier ist also <pre> ort ortsteil samtgemeinde </pre> </li> <li>Wenn es nur einen Ort gibt und weder Bezirke, Ortsteile oder Samtgemeinden im Straßenkatalog erfasst sind, sollte die Variable leer bleiben. </ul> <br /><br />Irrelevant, wenn kein Straßenkatalog verwendet wird.<br />
|-<br />
|{{konfig|warnung_bei_fachstatistik_}} {{konfig|akte_diskrepanz}}<br />
|{{code|false}}<br />
|Falls <code>true</code> wird beim Speichern der Fachstatistik auf eine Diskrepanz zwischen Akte und Fachstatistik hingewiesen, falls vorhanden.<br />
<br />
Wenn man bei dem dann zur Verfügung stehendem Item "Diskrepanz zur Akte zulassen" ein Häkchen setzt, kann man trotzdem speichern.<br /> Betroffen sind nur die Items 'Familienstatus', 'Empfohlen von' und 'Erbrachte Leistungen in der Fachstatistik', deren Werte im Normalfall aus der Akte vorbelegt werden.<br />
|-<br />
|{{konfig|wiederaufnahmefrist}}<br />
|{{code|1}}<br />
|Anzahl der Monate, innerhalb derer ein abgeschlossener Fall wiederaufgenommen werden kann ("z.d.A. rückgängig").<br />
<br />
Danach muss ein neuer Fall angelegt werden.<br />
|-<br />
|{{konfig|wohnt_nicht_ausserhalb}}<br />
|{{code|}}<br />
|Definiert die Teilmenge der Adressen, die im Sinne der Bundesstatistik in die Zuständigkeit der Beratungsstelle fallen.<br />
<br />
Aufgrund der hier angegebenen Kriterien wird entschieden, ob der Klient in der Bundesstatistik als ausserhalb des Zuständigkeitsbereichs der Beratungsstelle wohnend angegeben wird. Als mögliche Kriterien kommen in Frage: <code>plz,ort,ortsteil,samtgemeinde,bezirk,plraum</code>. Die Kriterien <code>ortsteil,samtgemeinde,bezirk</code> sind nur sinnvoll, wenn ein Straßenkatalog verwendet wird und dieser auch entsprechende Angaben enthält. <br /><br /> Die Kriterien werden wie folgt in der angegebenen Reihenfolge abgearbeitet: <ul> <li>Wenn die Klientenadresse keinen Wert für das Kriterium aufweist, wird zum nächsten Kriterium übergegangen. </li> <li>Falls die Klientenadresse einen Wert hat und im Kriterium genannt wird, wohnt er nicht außerhalb. Ist der Wert im Kriterium nicht genannt, wohnt er außerhalb. In beiden Fällen werden die weiteren Kriterien nicht mehr betrachtet. </li> <li>Falls aufgrund fehlender Werte (oder fehlender Kriterien) kein Kriterium angewendet werden konnte, wird standardmäßig angenommen, dass der Klient nicht außerhalb wohnt. </li> </ul> Beispiele: <ul> <li> <pre> bezirk: Friedrichshain-Kreuzberg; ort: Berlin </pre> In Berlin enthalten alle mit dem Straßenkatalog abgeglichene Adressen einen Wert für den Bezirk. Da jede Beratungsstelle genau für einen Bezirk zuständig ist, kann auf dieser Basis entschieden werden. Falls eine Adresse nicht mit dem Straßenkatalog abgeglichen wurde, kann der Ort als Kriterium herangezogen werden, da in diesem Fall für Bezirk keine Angaben vorliegen. </li> <li> Falls kein Straßenkatalog verwendet wird, kann nur der Ort, die Postleitzahl oder evt. der Planungsraum (falls solche definiert sind und routinemäßig mit den Klientenadressen zusammen erfasst werden) als Kriterium verwendet werden, z.B. (fiktiv!): <pre> plz: 12345;23456;34567 </pre> Adressen mit diesen Postleitzahlen werden als nicht außerhalb wohnend betrachtet, alle anderen als außerhalb. Falls die Klientenadresse keine 5-stellige PLZ enthält, gilt der Wert als fehlend. Ungenauigkeiten werden in Kauf genommen, da die Region der Zuständigkeit nicht immer exakt mit den Regionen der Postleitzahlen übereinstimmt. </li> <li> <pre> samtgemeinde: Name1;Name2;Name3; plz: 12345;23456 </pre> Analog zum Berliner Beispiel würde hier auch zunächst das Kriterium Samtgemeinde versucht, das aber nur nach einem Abgleich mit dem Straßenkatalog bekannt ist. Für die nicht abgeglichenen Adressen wird dann die Postleitzahl herangezogen. In seltenen Fällen kann das zu Fehlern führen, da die Bereiche der Postleitzahlen manchmal nicht mit den Bereichen der Zuständigkeit exakt übereinstimmen. </li> </ul> Falls das Ergebnis "wohnt außerhalb" ist, wird automatisch ein entsprechender Eintrag in die Bundesstatistik vorgenommen, der beim Ausfüllen oben im Kasten "Falldaten" angezeigt wird. Wenn möglich wird der <strong>amtliche Gemeindeschlüssel</strong> eingetragen. Wenn dieser nicht gefunden wird, wird Postleitzahl und Wohnort angegeben. <br /><br /> <strong>Syntax</strong> wie in den Beispielen. Rund um die Trenner <code>;</code> und <code>:</code> dürfen Leerzeichen stehen. Es können auch mehrere Zeilen verwendet werden. <br /><br /> Unter (Berater-) {{pfad5|Hauptmenü|Statistik|Teilmenge|Neu|Neue Bedingung}}" finden Sie für jedes Kriterium die Menge der möglichen Werte. <br /><br /> Zur <strong>Testen</strong> gibt es unter {{pfad3|Aministratorhauptmenü|Bundesstatistik|Exportieren}} einen neuen Punkt ''Adressen außerhalb prüfen''. Sie können dort in einer Tabelle sehen, welche Adressen als außerhalb klassifiziert werden. <br />
|}</div>Ebkushttps://www.ebkus.org/wiki/KonfigurationKonfiguration2014-07-03T13:52:40Z<p>Ebkus: </p>
<hr />
<div>Die zentrale Konfigurationsdatei für eine EBKuS-Installation ist eine Textdatei namens <code>ebkus.conf</code> und befindet sich im Homeverzeichnis ({{file|ebkus}} im Installationsverzeichnis).<br />
<br />
Als Ausgangspunkt für die eigene Konfiguration dient die vom Installationsskript {{code|install.py}} aus einer [http://svn.berlios.de/wsvn/ebkus/ebkus-3/trunk/templates/ebkus.conf.template Vorlage] generierte Konfigurationsdatei. Die meisten Parameter (= Konfigurationvariable) sind darin bereits korrekt gesetzt.<br />
<br />
<br />
== Aufbau von <code>ebkus.conf</code> ==<br />
<br />
Zeilen, die leer sind oder mit dem Kommentarzeichen <code>#</code> beginnen, werden ignoriert, z.B.:<br />
<br />
<pre>#ebkus_home: %(install_dir)s\ebkus</pre><br />
<br />
In diesem Fall hat der Parameter den in der Tabelle genannten Standardwert.<br />
<br />
Zeilen, die nur aus einem Namen in eckigen Klammern bestehen, leiten eine Sektion ein, z.B.:<br />
<br />
<pre>[apache]</pre><br />
Die übrigen Zeilen weisen einem Parameter einen Wert zu. Sie beginnen mit dem Namen des Parameters, gefolgt von einem Doppelpunkt, gefolgt von dem Wert. Vor oder nach dem Doppelpunkt können Leerzeichen stehen. Beispiel:<br />
<br />
<pre>install_dir: C:\ebkus_installation</pre><br />
Werte können eine Syntax enthalten, die es erlaubt, vorher definierte Parameter in einen aktuellen Wert einzubeziehen (''Parametersubstitution''), z.B.:<br />
<br />
<pre>ebkus_home: %(install_dir)s\ebkus</pre><br />
Hier wird der Wert von <code>install_dir</code> in den Wert von <code>ebkus_home</code> einbezogen. Das ist genauso, als ob man gleich<br />
<br />
<pre>ebkus_home: C:\ebkus_installation\ebkus</pre><br />
definiert hätte. <code>%(</code>''parameter''<code>)s</code> wird durch den Wert von ''parameter'' ersetzt.<br />
<br />
Jede gültige Konfigurationsdatei muss die folgenden Sektionen aufweisen:<br />
<br />
*<code>[DEFAULT]</code><br />
*<code>[ebkus]</code><br />
*<code>[apache]</code><br />
*<code>[openssl]</code><br />
*eine Sektion für jede Instanz: <code>[</code>''Instanzname''<code>]</code><br />
<br />
Die möglichen Parameter für jede Sektion sind in den folgenden Tabellen aufgeführt.<br />
<br />
Alle Parameter außer denen, die in den Tabelle rot markiert sind, haben einen Standardwert (manchmal auch ''Defaultwert'' genannt), der in der Tabelle in der Spalte Standardwert angegeben ist. Ein Parameter hat diesen Wert, wenn er in der Konfiguration fehlt oder auskommentiert ist.<br />
<br />
Wie man sieht, können Parametersubstitutionen auch bei Standardwerten stattfinden. Der Wert des notwendige Parameter ''install_dir'' findet dadurch Eingang in weitere Parameter (''ebkus_home'', ''instance_home''), ohne dass diese explizit in der Konfiguration aufgeführt sind.<br />
<br />
''Anmerkung zu den Tabellen'': In einigen Fällen ist der angegebene Parameter bzw. Standardwert aus layout-technischen Gründen auf mehrere Zeilen verteilt, obwohl er eigentlich ohne Leerzeichen hintereinanderweg in einer Zeile stehen müsste.<br />
<br />
Wir unterscheiden ''Systemparameter'' von ''fachlichen Parametern''. Erstere betreffen den technischen Betrieb von EBKuS und werden von den Systemadministratoren (IT) bei der Installation eingerichtet. Fachparameter können ebenso wie Systemparameter in der {{file|ebkus.conf}} in der Instanzsektion gesetzt werden, außerdem kann aber auch der Anwendungsbetreuer über {{pfad2|Administratorhauptmenü|Allgemeine Konfiguration}} weitere Veränderungen vornehmen. Die vom Anwendungsbetreuer vorgenommenen Änderungen haben stets Vorrang über den Angaben in der {{file|ebkus.conf}}.<br />
<br />
<br />
== Systemparameter ==<br />
<br />
=== <nowiki>[DEFAULT]</nowiki> ===<br />
<br />
Die generierte Konfigurationsdatei enthält die korrekten Werte.<br />
<br />
Der Parameter {{konfig|install_dir}} bezeichnet das Installationsverzeichnis und muss immer in der Konfiguration definiert werden. Es bildet den Bezugspunkt für alle weiteren Pfade. Standardmäßig ist {{konfig|ebkus_home}} das Verzeichnis <code>ebkus</code> im Installationsverzeichnis; das sollte nicht verändert werden.<br />
<br />
Die in der Sektion <code>[DEFAULT]</code> definierten Parameter können in allen anderen Sektionen im Rahmen der Parametersubstitution als Teil eine Wertes verwendet werden (z.B. in der Definition von {{konfig|instance_home}}). Ansonsten stehen nur die Parameter derselben Sektion zur Verfügung.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|install_dir}}<br />
|style="background-color:orangered;"|{{code|}}<br />
|Installationsverzeichnis<br />
|-<br />
|{{konfig|ebkus_home}}<br />
|{{konfig|install_dir}}/ebkus<br />
|Homeverzeichnis<br />
|}<br />
<br />
<br />
=== <nowiki>[ebkus]</nowiki> ===<br />
<br />
Die generierte Konfigurationsdatei enthält in der Regel die korrekten Werte.<br />
<br />
Die {{konfig|database_admin_*}}-Parameter erlauben den Installationsskripten, neue Datenbanken für Instanzen einzurichten und diese bei der Deinstallation auch wieder zu entfernen.<br />
<br />
Falls aus Sicherheitsgründen erwünscht, kann hier ein Passwort für den Administratorzugriff auf MySQL eingetragen werden. Geschieht dies unter Windows vor der automatischen Installation von MySQL, wird bei der automatischen Installation der Administratorzugriff mit diesem Passwort eingerichtet.<br />
<br />
Falls das Passwort für den Administratorzugriff nicht im Klartext in der Konfigurationsdatei stehen soll, kann stattdessen <code>ASK</code>eingetragen werden. Dann fragen alle Skripte, die den Administratorzugriff benötigen, interaktiv nach dem Passwort, ohne es irgendwo zu speichern.<br />
<br />
Da MySQL standardmäßig nur von dem lokalen Rechner erreichbar ist, und dieser ohnehin nur für dem Administrator zugänglich ist, ist die zusätzliche Absicherung durch ein Passwort oft nicht nötig.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|download_dir}}<br />
|{{konfig|install_dir}}/download<br />
|Downloadverzeichnis. Dort steht die zu installierende Software, die im Bedarfsfall heruntergeladen wird.<br />
|-<br />
|{{konfig|database_admin_host}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer des Rechners, auf dem MySQL läuft. Muss angegeben werden, wenn das nicht der lokale Rechner ist.<br />
|-<br />
|{{konfig|database_admin_user}}<br />
|{{code|root}}<br />
|MySQL-Benutzer mit Administratorrechten<br />
|-<br />
|{{konfig|database_admin_password}}<br />
|{{code|}}<br />
|Dessen Passwort. Wenn hier ``ASK`` steht, wird das Passwort bei Bedarf interaktiv abgefragt.<br />
<br />
|-<br />
|{{konfig|mysql_dir}}<br />
|{{code|}}<br />
|Verzeichnis, in dem die MySQL-Programme mysql, mysqldump, etc. stehen. Muss angegeben werden, wenn MySQL-Programme nicht im Pfad stehen.<br />
<br />
|-<br />
|{{konfig|python_executable}}<br />
|<br />
|Vollständiger Pfad des Python-Executable, mit dem EBKuS ausgeführt wird<br />
|}<br />
<br />
<br />
=== <nowiki>[apache]</nowiki> ===<br />
<br />
Für den Parameter {{konfig|server_name}} muss unbedingt der Name oder die IP-Nummer des Rechners eingetragen werden, auf dem der Apache-Webserver läuft. Die generierte Konfigurationsdatei setzt den Standardwert <code>localhost</code>, womit EBKuS nur auf dem lokalen Rechner zugänglich ist.<br />
<br />
Für den Parameter {{konfig|server_admin}} sollte eine sinnvolle Email-Adresse eingetragen werden. Sie taucht in Apache-Fehlermeldungen auf (die allerdings normalerweise nicht vorkommen sollten).<br />
<br />
Alle übrigen Werte können in der Regel von der generierten Konfigurationsdatei übernommen werden.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|apache_log_dir}}<br />
|{{konfig|ebkus_home}}/log<br />
|Verzeichnis, in dem der Apache-Webserver Log-Dateien anlegt<br />
|-<br />
|{{konfig|server_admin}}<br />
|{{code|admin@localhost}}<br />
|Email-Adresse des Serveradministrators, die auf evt. Fehlerseiten des Servers erscheint.<br />
<br />
|-<br />
|{{konfig|server_name}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer des Rechners, auf dem der Apache-Webserver läuft.<br />
**Muss** explizit eingetragen werden, sonst kann EBKuS nur auf dem lokalen Rechner verwendet werden!<br />
<br />
|-<br />
|{{konfig|server_https_port}}<br />
|{{code|443}}<br />
|Port für verschlüsselte Verbindungen. Die EBKuS-Anwendung wird ausschließlich über diesen Port abgewickelt. Wenn der Standardport {{code|443}} nicht zur Verfügung steht, kann hier ein alternativer Port angegeben werden. Dieser muss dann als Teil der URL aufgeführt werden, z.B. für den Alternativport {{code|500}}: {{code|<nowiki>https://192.168.1.73:500/ebkus/demo/</nowiki>}}.<br />
<br />
|-<br />
|{{konfig|server_https_port}}<br />
|{{code|80}}<br />
|Port für unverschlüsselte Verbindungen. Die EBKuS-Anwendung verwendet diesen Port nicht. Dient nur zur Kontrolle des Apache Webservers: {{code|<nowiki>http://localhost/</nowiki>}} liefert "It works!". Wird hier der Port {{code|8080}} angegeben, müsste man {{code|<nowiki>http://localhost:8080/</nowiki>}} schreiben.<br />
<br />
|-<br />
|{{konfig|ssl_certificate_file}}<br />
|{{konfig|ebkus_home}}/ebkus_ssl_certificates/ebkusserver.cert<br />
|Vollständiger Pfad der SSL-Zertifikat-Datei<br />
<br />
<br />
|-<br />
|{{konfig|ssl_certificate_key_file}}<br />
|{{konfig|ebkus_home}}/ebkus_ssl_certificates/ebkusserver.key<br />
|Vollständiger Pfad der SSL-Schlüssel-Datei<br />
|}<br />
<br />
<br />
=== <nowiki>[openssl]</nowiki> ===<br />
<br />
Die Anwendung ist voll funktionsfähig mit den Werten aus der generierten Konfigurationsdatei; es empfiehlt sich jedoch, die organisatorischen Angaben für das SSL-Zertifikat anzupassen.<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|openssl_executable}}<br />
|{{code|openssl}}<br />
|Falls openssl nicht im Pfad steht, muss der hier der vollständige Pfad zum Executable stehen<br />
<br />
|-<br />
|{{konfig|output_password}}<br />
|{{code|polo}}<br />
|Wird zur automatischen Zertifikatgenerierung benötigt<br />
<br />
|-<br />
|{{konfig|staat}}<br />
|{{code|DE}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|-<br />
|{{konfig|land}}<br />
|{{code|Berlin}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|-<br />
|{{konfig|ort}}<br />
|{{code|Berlin}}<br />
|Erscheint im SSL-Zertifikat<br />
|-<br />
|{{konfig|organisation}}<br />
|{{code|EFB}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|-<br />
|{{konfig|organisationseinheit}}<br />
|{{code|EFB}}<br />
|Erscheint im SSL-Zertifikat<br />
<br />
|}<br />
<br />
<br />
=== <nowiki>[</nowiki>''Instanz''<nowiki>]</nowiki> ===<br />
<br />
<br />
Im Rahmen einer EBKuS-Installation auf einem Server können mehrere Instanzen einer EBKuS-Anwendung eingerichtet werden. Jede Instanz<br />
<br />
*hat einen Namen ({{konfig|instance_name}})<br />
*ist über eine eigene URL ansprechbar (<code>https://</code>'''server_name'''<code>/ebkus/</code>'''instance_name'''<code>/index.html</code>)<br />
*hat eine eigene Datenbank im Rahmen einer MySQL-Installation ({{konfig|database_name}}, {{konfig|database_user}}, {{konfig|database_password}})<br />
*hat ein eigenes Verzeichnis ({{konfig|instance_home}})<br />
*hat einen eigenen EBKuS-Server, der vom Apache-Webserver über eine eigene Portnummer angesprochen wird ({{konfig|port}})<br />
*hat eine eigene Log-Datei ({{konfig|log_file}})<br />
<br />
<br />
Für jede gewünschte Instanz wird eine Sektion in der Konfigurationsdatei angelegt. Die Sektionsüberschrift wird aus dem Namen der Instanz in eckigen Klammern gebildet. Der Name sollte mit einem Buchstaben beginnen und ansonsten nur Buchstaben, Ziffern und Unterstriche (<code>_</code>) enthalten (keine Leerzeichen!). Ein zusätzlicher Name für die Instanz ohne diese Einschränkung lässt sich über den Parameter {{konfig|instance_title}} einrichten (siehe unten).<br />
<br />
Falls der Instanzname mit <code>demo</code> beginnt, werden bei der Installation der Datenbank automatisch Demodaten erzeugt. Neben dem Benutzer <code>Admin</code> (Passwort: <code>Admin</code>) gibt es dann auch den Benutzer <code>test</code> (Passwort: <code>test</code>) und <code>verw</code>(Passwort: <code>verw</code>).<br />
<br />
Jede Sektion kann die in der Tabelle aufgeführten Parameter definieren. Erforderlich ist Wiederholung des Instanznamen als Wert von {{konfig|instance_name}}, ferner die Angabe einer eigenen, eindeutigen Portnummer, {{konfig|port}}. Für alle anderen Parameter können die Standardwerte genommen werden.<br />
<br />
Natürlich muss man {{konfig|berliner_version}} auf <code>true</code> setzen, wenn man die Berliner Version mit Berliner Straßenkatalog haben möchte; EBKuS-spezifische Fehlermeldungen sollten außerdem eine sinnvolle Telefonnummer bzw. Email-Adresse des Anwendungsbetreuers haben ({{konfig|admin_tel}}, {{konfig|admin_email}}).<br />
<br />
Die Parameter {{konfig|host}} und {{konfig|database_host}} müssen nur dann angepasst werden, wenn der EBKuS-Server bzw. die MySQL-Datenbank nicht auf demselben Rechner laufen wie der Apache-Webserver.<br />
<br />
Die bei der Installation generierte Konfigurationsdatei definiert vier Instanzen (2 davon auskommentiert):<br />
<br />
*<code>demo</code>: Demodaten, kein Straßenkatalog<br />
*<code>muster_efb</code>: keine Demodaten, kein Straßenkatalog. Beispiel für eine Produktionsinstanz, die vom Anwendungsbetreuer eingerichtet werden muss (siehe Einrichtung der Anwendung im Handbuch).<br />
<br />
Auskommentiert:<br />
*<code>demo_berlin</code>: Demodaten, Berliner Straßenkatalog (kleiner Ausschnitt, nur Straßen, deren Namen mit 'K' beginnen)<br />
*<code>demo_braunschweig</code>: Demodaten, Straßenkatalog mit Straßen aus Braunschweig, Gifhorn, Wolfenbüttel und Wolfsburg.<br />
<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
<br />
<br />
|-<br />
|{{konfig|instance_name}}<br />
|style="background-color:orangered;"|{{code|}}<br />
|Name der Instanz. Muss angegeben werden und dem Namen des Abschnitts (in eckigen Klammern) identisch sein. Darf keine Sonderzeichen außer den Unterstrich ('_') enthalten.<br />
<br />
<br />
|-<br />
|{{konfig|instance_home}}<br />
|{{konfig|ebkus_home}}/{{konfig|instance_name}}<br />
|Instanzverzeichnis. Liegt im Homeverzeichnis. Sollte nicht verändert werden.<br />
<br />
|-<br />
|{{konfig|initial_content}}<br />
|{{code|}}<br />
|Hier kann eine Datei angegeben werden, mit der die Instanzdatenbank initialisiert werden kann. Diese Datei wird immer dann geladen, wenn bei der Installation der Instanz ({{code|install.py}} oder {{code|configure.py}}) keine funktionierende Datenbank für die Instanz vorgefunden wird. Wenn keine Datei angegeben ist, wird eine neue Datenbank mit dem Merkmalskatalog ({{file|sql/merkmale_standard.py}}) und evt. einem Straßenkatalog erstellt. Wenn kein vollständiger Pfad für die Datei angegeben wird, muss die Datei im Homeverzeichnis liegen. Zulässige Dateien sind die mit dem Skript {{code|datenbank_sichern.py}} erzeugte Dateien sowie sonstige passende SQL-Dumps.<br />
<br />
|-<br />
|{{konfig|berliner_version}}<br />
|{{code|false}}<br />
|Wenn hier {{code|true}} steht, wird die Berliner EBKuS-Version verwendet mit Berliner Straßenkatalog. <br />
<br />
|-<br />
|{{konfig|database_host}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer, auf dem der Datenbankserver läuft.<br />
<br />
|-<br />
|{{konfig|database_name}}<br />
|{{konfig|instance_name}}<br />
|Name der Instanzdatenbank<br />
<br />
<br />
|-<br />
|{{konfig|database_user}}<br />
|{{konfig|instance_name}}<br />
|Benutzername der Instanzdatenbank<br />
<br />
|-<br />
|{{konfig|database_password}}<br />
|{{konfig|instance_name}}<br />
|Passwort der Instanzdatenbank<br />
<br />
<br />
|-<br />
|{{konfig|gemeindeschluessel_von_plz}}<br />
|{{code|}}<br />
|Definiert die Teilmenge der amtlichen Gemeindeschlüssel für die Bundesstatistik. Im Normalfall muss hier nichts eingetragen werden.<br />
<br /><br />
In der Bundesstatistik soll der amtliche Gemeindeschlüssel für den Wohnort des Klienten eingetragen werden, wenn der Wohnort des Klienten außerhalb des Kreises der Beratungsstelle liegt. Um die Menge der Daten zu begrenzen, kann hier über die Anfangsziffern der Postleitzahl eine Teilmenge definiert werden. Wenn mehrere Ziffernfolgen angegeben werden, müssen diese mit <code>;</code> getrennt werden.<br /><br /> Beispiele: <ul> <li>Alle Gemeindeschlüssel verwenden, außer die Postleitzahl der Gemeinde beginnt mit '9': <pre> 0;1;2;3;4;5;6;7;8 </pre> </li> <li>Große Teile Niedersachsens: <pre> 29;30;31;37;38 </pre> </li> <li>Nördliches Niedersachsen und Schleswig Holstein: <pre> 2 </pre> </li> <li>Berlin und Umgebung: <pre> 10;12;13;14;15;16 </pre> </li> <li>Bleibt die Variable leer, werden alle Gemeindeschlüssel verwendet. </li> </ul> Wenn es bei der Erkennung von Gemeindeschluesseln zu vielen Fehlern kommt, beispielsweise wegen unterschiedlicher Schreibweisen von Orten, kann man selber eine Datei <code>EBKUS_HOME/sql/gemeindeschluessel.csv</code> erstellen, bestehend aus einer Tabelle mit den Spalten <code>plz, ort ags</code>. Als Vorlage kann die Datei <code>EBKUS_HOME/sql/gemeindeschluessel_cache.csv</code> dienen, die automatisch erzeugt wird, wenn die Konfigurationsvariable <code>gemeindeschluessel_von_plz</code> einen Wert hat. <br />
|-<br />
|{{konfig|host}}<br />
|{{code|localhost}}<br />
|Name oder IP-Nummer des Rechners, auf der EBKuS-Server der Instanz läuft.<br />
<br />
<br />
|-<br />
|{{konfig|keine_bundesstatistik}}<br />
|{{code|false}}<br />
|Falls hier {{code|true}} steht, wird die Bundesstatistik aus der Anwendung ausgeblendet. Es kann keine Bundesstatistik ausgefüllt werden und steht auch nicht für Statistik und Export zur Verfügung.<br />
<br />
|-<br />
|{{konfig|log_file}}<br />
|{{konfig|instance_home}}{{code|/}}{{konfig|instance_name}}{{code|.log}}<br />
|Name der Datei, in die der EBKuS-Server Meldungen schreibt<br />
<br />
|-<br />
|{{konfig|log_level}}<br />
|{{code|INFO}}<br />
|Legt fest, wie "geschwätzig" der EBKuS-Server ist. Muss einer der folgenden Werte sein, in aufsteigender Wortfülle: {{code|CRITICAL, ERROR, WARNING, INFO, DEBUG}} ({{code|DEBUG}} ist nur für die Fehlersuche geeignet, da sehr viel ausgegeben wird.)<br />
<br />
|-<br />
|{{konfig|port}}<br />
|style="background-color:orangered;"|{{code|}}<br />
|Portnummer über die der EBKuS-Server angesprochen wird. Muss angegeben werden. Jede Instanz muss eine unterschiedliche Portnummer erhalten.<br />
|}<br />
<br />
<br />
==== Konfiguration für externe Anwendungen ====<br />
<br />
Die folgenden Konfigurationsvariablen bewirken, dass auf der Klientenkarte ein Kasten mit maximal vier Buttons erscheint, die in einem neuen Tab/Fenster eine URL aufrufen, die Felder des aktuellen (letzten) Falles bzw. des angemeldeten Mitarbeiters als Bestandteile haben kann:<br />
# Kein Kasten, wenn diese Variable keinen Wert hat.<br />
extern_fieldset_label: Externe Anwendung<br />
# Position auf der Klientenkarte<br />
extern_fieldset_position: 6<br />
# Maximal vier Buttons, für jeden eine Bezeichnung und eine Url.<br />
# Ein Button kommt nur zustande, wenn sowohl Label als auch Url<br />
# einen Wert haben. <br />
extern_button1_label: GoogleWeb<br />
extern_button1_url: <nowiki>http://www.google.com/search?q=$$fall_id$$_$$fall_akte__ort$$</nowiki><br />
extern_button2_label: GoogleMaps<br />
extern_button2_url: <nowiki>http://www.google.com/maps?q=$$mitarbeiter_na$$</nowiki><br />
extern_button3_label: GoogleImages<br />
extern_button3_url: <nowiki>http://www.google.com/images?q=$$fall_akte__ort$$</nowiki><br />
extern_button4_label: GoogleNews<br />
extern_button4_url: http://www.google.com/news?q=$$fall_fn$$</nowiki><br />
<br />
Urls können Abschnitte der folgenden Form enthalten:<br />
{{code|$$<fall oder mitarbeiter>_<feld>$$}}<br />
Der ganze Abschnitt wird durch den Wert von {{code|<feld>}} ersetzt, <br />
wobei entweder im Fall-Objekt oder im Mitarbeiter-Objekt <br />
nachgeschlagen wird. <br />
Beispiele:<br />
{{code|$$fall_id$$}}, {{code|$$mitarbeiter_na$$}}, {{code|$$fall_akte__ort$$}}<br />
<br />
Im Beispiel oben werden als externe Anwendungen verschiedene Google-Dienst aufgerufen, wobei als Parameter Daten aus dem aktuellen Fall übergeben werden.<br />
(Das Beispiel ist nicht sinnvoll und dient nur der Illustration des Mechanismus.)<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|extern_fieldset_label}}<br />
|{{code|}}<br />
|Bezeichnung für den Kasten mit den Buttons für die externen Anwendungen<br />
<br />
|-<br />
|{{konfig|extern_fieldset_position}}<br />
|{{code|2}}<br />
|Position auf der Klientenkarte (Gezählt werden die umrandeten Kästen mit einer Bezeichnung: Klientendaten, Bezugspersonen, Leistungen, etc.)<br />
|-<br />
|{{konfig|extern_buttonX_label}}<br />
|{{code|}}<br />
|Name der externen Anwendung<br />
<br />
<br />
|-<br />
|{{konfig|extern_buttonX_url}}<br />
|{{code|}}<br />
|URL der externen Anwendung mit Platzhaltern für die zu übernehmenden Parameter<br />
<br />
|}<br />
<br />
{{konfig|X}} kann 1,2,3 oder 4 sein.<br />
<br />
<br />
== Fachliche Parameter ==<br />
<br />
Die hier beschriebenen Einstellungen können auch vom Anwendungsbetreuer über {{pfad2|Administratorhauptmenü|Allgemeine Konfiguration}} vorgenommen werden.<br />
<br />
<br />
=== <nowiki>[</nowiki>''Instanz''<nowiki>]</nowiki> ===<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Parameter<br />
! Standardwert<br />
! Bedeutung<br />
|-<br />
|{{konfig|admin_email}}<br />
|{{code|Keine Angabe}}<br />
|Email-Adresse des Anwendungsbetreuers.<br />
<br />
Wird in Fehlermeldungen genannt.<br />
|-<br />
|{{konfig|admin_name}}<br />
|{{code|Keine Angabe}}<br />
|Name des Anwendungsbetreuers.<br />
<br />
Wird in Fehlermeldungen genannt.<br />
|-<br />
|{{konfig|admin_tel}}<br />
|{{code|Keine Angabe}}<br />
|Telefonnummer des Anwendungsbetreuers.<br />
<br />
Wird in Fehlermeldungen genannt.<br />
|-<br />
|{{konfig|anmeldungsdaten_}} {{konfig|obligatorisch}}<br />
|{{code|false}}<br />
|Falls <code>true</code> werden die Anmeldungsdaten obligatorisch im Aufnahmeformular erhoben anstatt optional in einer getrennten Maske.<br />
<br />
Die entsprechenden Pflichfelder sind dabei auszufüllen. Eine spätere Bearbeitung der Anmeldungsdaten erfolgt wie bisher in einer eigenständigen Maske (analog der späteren Bearbeitung einer Leistung).<br />
|-<br />
|{{konfig|anmeldeprobleme_und_}} {{konfig|beschaeftigung_bei_}}{{konfig|anmeldung_erfassen}}<br />
|{{code|false}}<br />
|Falls <code>true</code> werden Probleme bei der Anmeldung und Beschäftigung schon bei der Anmeldung erfasst und später für die Fachstatistik übernommen.<br />
<br />
Die Auswahlfelder 'Beschäftigung Jugendliche(r)', 'Beschäftigungsverhältnis Mutter', 'Beschäftigungsverhältnis Vater' und das Mehrfachauswahlfeld 'Problem(e) bei der Anmeldung' aus der Fachstatistik werden in den Kasten Anmeldekontakt als Pflichtfelder aufgenommen. Es ist jedoch in jedem Fall möglich 'Keine Angabe' auszuwählen (genau wie in der Fachstatistik selbst). Die Daten werden mit dem Fall (nicht mit der Akte bzw. den Stammdaten) gespeichert. Wenn eine Fachstatistik angelegt wird, werden die Daten übernommen.<br />
|-<br />
|{{konfig|beratungskontakte}}<br />
|{{code|false}}<br />
|Falls <code>true</code> können in der Klientenakte einzelne Beratungskontakte eingetragen werden. Die Summen werden in die Bundesstatistik und in die Fachstatistik als Vorgabe übernommen.<br />
|-<br />
|{{konfig|beratungskontakte_bs}}<br />
|{{code|false}}<br />
|Falls <code>true</code> treten Anpassungen speziell für Braunschweig in Kraft.<br />
<br />
Die Variable <code>beratungskontakte</code> muss ebenfalls auf <code>true</code> stehen.<br />
|-<br />
|{{konfig|fachstatistik_akte_}} {{konfig|diskrepanz_nicht_zulassen}}<br />
|{{code|false}}<br />
|Falls <code>true</code> werden Diskrepanzen zwischen Fachstatistik und Akte nicht zugelassen.<br />
<br />
Die entsprechenden Items in der Fachstatistik zeigen die Werte aus der Akte und sind nicht modifizierbar. Eine Diskrepanz kann so gar nicht entstehen. Allerdings muss bei Änderungen in der Akte die Fachstatistik neu abgespeichert werden, damit die Änderungen übernommen und für die Statistik wirksam werden.<br /> Betroffen sind nur die Items 'Familienstatus', 'Empfohlen von' und 'Erbrachte Leistungen in der Fachstatistik', deren Werte im Normalfall aus der Akte vorbelegt werden.<br />
|-<br />
|{{konfig|fallunabhaengige}} {{konfig|_aktivitaeten_bs}}<br />
|{{code|false}}<br />
|Falls <code>true</code> können fallunabhängige Aktivitäten eingetragen und ausgewertet werden. Speziell für Braunschweig. <br />
|-<br />
|{{konfig|instance_title}}<br />
|{{konfig|instance_name}}<br />
|Langname für die Instanz.<br />
<br />
Erscheint bei der Anmeldung und in der Statuszeile.<br />
|-<br />
|{{konfig|leistungsende_in_}}<br />
{{konfig|zukunft_erlaubt}}<br />
|{{code|false}}<br />
|Beim Eintrag einer Leistung darf für das Ende ein Datum, das in der Zukunft liegt, eingetragen werden.<br />
<br />
Der Abschluss des Falls ist erst möglich, wenn alle Leistungen beendet sind.<br />
|-<br />
|{{konfig|loeschfrist}}<br />
|{{code|36}}<br />
|Löschfrist in Monaten.<br />
<br />
Akten, die älter sind, können vom Administrator gelöscht werden.<br />
|-<br />
|{{konfig|meldung_vom_admin}}<br />
|{{code|}}<br />
|Inhalt wird als Meldung vom Administrator unübersehbar auf jeder EBKuS-Seite über der Statuszeile ausgegeben.<br />
<br />
Damit kann der Administrator Meldungen an alle aktiven EBKuS-Nutzer ausgeben, z.B. um einen Ausfall von EBKuS wegen Wartungsarbeiten anzukündigen. <br />
|-<br />
|{{konfig|neumeldungen_nach_region}}<br />
|{{code|}}<br />
|Definiert eine Tabelle ''Neumeldungen nach Region'' unter ''Neumelde- und Abschlusszahlen''.<br />
<br />
Die Regionen, für die in der Tabelle die Neumeldungen ausgezählt werden sollen, müssen unter {{pfad4|Hauptmenü|Statistikabfrage|Teilmenge|Neu}} als Teilmengendefinitionen eingeführt werden. Der Namen der gewünschten Definitionen werden durch <code>;</code> getrennt aufgeführt. <br /><br /> Beispiel: <ul> <li> <pre> Gifhorn und Samtgemeinde Meinersen; Braunschweig 38120 und 38112 </pre> </li> </ul> "Gifhorn und Samtgemeinde Meinersen" ist eine Teilmengendefinition mit der Definition: <code>( ort = 'Gifhorn' ODER samtgemeinde = 'Meinersen' )</code>. "Braunschweig 38120 und 38112" ist eine Teilmengendefinition mit der Definition: <code>( ort = 'Braunschweig' UND plz = '38112' oder '38120' )</code>. <br /><br /> <br />
|-<br />
|{{konfig|session_time}}<br />
|{{code|120}}<br />
|Länge einer Session in Minuten. <br />
<br />
Nach dieser Zeit wird ein Benutzer automatisch abgemeldet, wenn er keine Eingaben mehr macht.<br />
|-<br />
|{{konfig|sql_abfrage}}<br />
|{{code|false}}<br />
|Falls <code>true</code> steht die Maske zum Absetzen von SQL-Abfragen vom Administrationsmenü aus zur Verfügung. <br />
<br />
|-<br />
|{{konfig|strassenkatalog}}<br />
|{{code|}}<br />
|Falls diese Variable nicht leer ist, wird bei der Adresseingabe der Straßenkatalog verwendet.<br />
<br />
Der eigentliche Wert der Variable spielt nur bei der Erstinstallation der Instanz eine Rolle.<br />Eine Instanz ohne Straßenkatalog kann auch später noch für die Verwendung mit Straßenkatalog eingerichtet werden, indem der Straßenkatalog über {{pfad2|Administratorhauptmenü|Straßenkatalog importieren}} importiert wird und der Variable {{konfig|strassenkatalog}} ein beliebiger Wert zugewiesen wird, beispielsweise der Ortsname.<br />
|-<br />
|{{konfig|strassenkatalog_}} {{konfig|vollstaendig}}<br />
|{{code|false}}<br />
|Falls <code>true</code> wird angenommen, dass der Straßenkatalog Einträge für jede einzelne Hausnummer enthält.<br />
<br />
Ansonsten wird angenommen, dass lediglich Einträge für ganze Straßen bzw. für bestimmte Intervalle von Hausnummern vorhanden sind.<br />
|-<br />
|{{konfig|strassensuche}}<br />
|{{code|}}<br />
|Bestimmt die Anzeige von Zusatzinformationen aus dem Straßenkatalog bei der Darstellung und Eingabe von Adressen.<br />
<br />
Zulässige Werte sind: <code>ort bezirk ortsteil samtgemeinde</code>.<br /><br /> Beispiele: <ul> <li>In Berlin gibt es nur einen Ort im Straßenkatalog, nämlich 'Berlin'. Das Feld <code>ort</code> ist daher nicht nötig. Ortsteil und Samtgemeinde haben im Straßenkatalog keine Werte, Bezirk allerdings schon. Der sinnvolle Wert für Berlin ist also <pre> bezirk </pre> </li> <li>In Gifhorn gibt es mehrere Orte im Straßenkatalog. Sowohl Ortsteile und Samtgemeinden spielen eine Rolle und sind im Straßenkatalog erfasst, Bezirke jedoch nicht. Der sinnvolle Wert hier ist also <pre> ort ortsteil samtgemeinde </pre> </li> <li>Wenn es nur einen Ort gibt und weder Bezirke, Ortsteile oder Samtgemeinden im Straßenkatalog erfasst sind, sollte die Variable leer bleiben. </ul> <br /><br />Irrelevant, wenn kein Straßenkatalog verwendet wird.<br />
|-<br />
|{{konfig|warnung_bei_fachstatistik_}} {{konfig|akte_diskrepanz}}<br />
|{{code|false}}<br />
|Falls <code>true</code> wird beim Speichern der Fachstatistik auf eine Diskrepanz zwischen Akte und Fachstatistik hingewiesen, falls vorhanden.<br />
<br />
Wenn man bei dem dann zur Verfügung stehendem Item "Diskrepanz zur Akte zulassen" ein Häkchen setzt, kann man trotzdem speichern.<br /> Betroffen sind nur die Items 'Familienstatus', 'Empfohlen von' und 'Erbrachte Leistungen in der Fachstatistik', deren Werte im Normalfall aus der Akte vorbelegt werden.<br />
|-<br />
|{{konfig|wiederaufnahmefrist}}<br />
|{{code|1}}<br />
|Anzahl der Monate, innerhalb derer ein abgeschlossener Fall wiederaufgenommen werden kann ("z.d.A. rückgängig").<br />
<br />
Danach muss ein neuer Fall angelegt werden.<br />
|-<br />
|{{konfig|wohnt_nicht_ausserhalb}}<br />
|{{code|}}<br />
|Definiert die Teilmenge der Adressen, die im Sinne der Bundesstatistik in die Zuständigkeit der Beratungsstelle fallen.<br />
<br />
Aufgrund der hier angegebenen Kriterien wird entschieden, ob der Klient in der Bundesstatistik als ausserhalb des Zuständigkeitsbereichs der Beratungsstelle wohnend angegeben wird. Als mögliche Kriterien kommen in Frage: <code>plz,ort,ortsteil,samtgemeinde,bezirk,plraum</code>. Die Kriterien <code>ortsteil,samtgemeinde,bezirk</code> sind nur sinnvoll, wenn ein Straßenkatalog verwendet wird und dieser auch entsprechende Angaben enthält. <br /><br /> Die Kriterien werden wie folgt in der angegebenen Reihenfolge abgearbeitet: <ul> <li>Wenn die Klientenadresse keinen Wert für das Kriterium aufweist, wird zum nächsten Kriterium übergegangen. </li> <li>Falls die Klientenadresse einen Wert hat und im Kriterium genannt wird, wohnt er nicht außerhalb. Ist der Wert im Kriterium nicht genannt, wohnt er außerhalb. In beiden Fällen werden die weiteren Kriterien nicht mehr betrachtet. </li> <li>Falls aufgrund fehlender Werte (oder fehlender Kriterien) kein Kriterium angewendet werden konnte, wird standardmäßig angenommen, dass der Klient nicht außerhalb wohnt. </li> </ul> Beispiele: <ul> <li> <pre> bezirk: Friedrichshain-Kreuzberg; ort: Berlin </pre> In Berlin enthalten alle mit dem Straßenkatalog abgeglichene Adressen einen Wert für den Bezirk. Da jede Beratungsstelle genau für einen Bezirk zuständig ist, kann auf dieser Basis entschieden werden. Falls eine Adresse nicht mit dem Straßenkatalog abgeglichen wurde, kann der Ort als Kriterium herangezogen werden, da in diesem Fall für Bezirk keine Angaben vorliegen. </li> <li> Falls kein Straßenkatalog verwendet wird, kann nur der Ort, die Postleitzahl oder evt. der Planungsraum (falls solche definiert sind und routinemäßig mit den Klientenadressen zusammen erfasst werden) als Kriterium verwendet werden, z.B. (fiktiv!): <pre> plz: 12345;23456;34567 </pre> Adressen mit diesen Postleitzahlen werden als nicht außerhalb wohnend betrachtet, alle anderen als außerhalb. Falls die Klientenadresse keine 5-stellige PLZ enthält, gilt der Wert als fehlend. Ungenauigkeiten werden in Kauf genommen, da die Region der Zuständigkeit nicht immer exakt mit den Regionen der Postleitzahlen übereinstimmt. </li> <li> <pre> samtgemeinde: Name1;Name2;Name3; plz: 12345;23456 </pre> Analog zum Berliner Beispiel würde hier auch zunächst das Kriterium Samtgemeinde versucht, das aber nur nach einem Abgleich mit dem Straßenkatalog bekannt ist. Für die nicht abgeglichenen Adressen wird dann die Postleitzahl herangezogen. In seltenen Fällen kann das zu Fehlern führen, da die Bereiche der Postleitzahlen manchmal nicht mit den Bereichen der Zuständigkeit exakt übereinstimmen. </li> </ul> Falls das Ergebnis "wohnt außerhalb" ist, wird automatisch ein entsprechender Eintrag in die Bundesstatistik vorgenommen, der beim Ausfüllen oben im Kasten "Falldaten" angezeigt wird. Wenn möglich wird der <strong>amtliche Gemeindeschlüssel</strong> eingetragen. Wenn dieser nicht gefunden wird, wird Postleitzahl und Wohnort angegeben. <br /><br /> <strong>Syntax</strong> wie in den Beispielen. Rund um die Trenner <code>;</code> und <code>:</code> dürfen Leerzeichen stehen. Es können auch mehrere Zeilen verwendet werden. <br /><br /> Unter (Berater-) {{pfad5|Hauptmenü|Statistik|Teilmenge|Neu|Neue Bedingung}}" finden Sie für jedes Kriterium die Menge der möglichen Werte. <br /><br /> Zur <strong>Testen</strong> gibt es unter {{pfad3|Aministratorhauptmenü|Bundesstatistik|Exportieren}} einen neuen Punkt ''Adressen außerhalb prüfen''. Sie können dort in einer Tabelle sehen, welche Adressen als außerhalb klassifiziert werden. <br />
|}</div>Ebkushttps://www.ebkus.org/wiki/Zeitangaben_(Fallbeginn,_usw.)Zeitangaben (Fallbeginn, usw.)2014-01-15T15:32:59Z<p>Ebkus: </p>
<hr />
<div><br />
__FORCETOC__ <br />
<br />
=== Datenbankfelder für Zeitangaben ===<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Name<br />
! Tabelle.Feld<br />
! Woher initialer Wert<br />
! Wo Änderbar<br />
! Zusicherungen<br />
! Bemerkungen<br />
|-<br />
|Fallbeginn (synonym: Anmeldedatum)<br />
|{{konfig|fall.bg}}<br />
|{{pfad2|Neuaufnahme|Anmeldedatum}}, {{pfad2|Wiederaufnahme|Anmeldedatum}}<br />
|{{pfad3|Klientenkarte|Stand|Fallbeginn}}<br />
|< erster Leistung, < erstem Beratungskontakt, = erste Zuständigkeit Beginn<br />
|Anmeldedatum kann am Ende des Jahres liegen, erste Leistung am Beginn des folgenden<br />
|-<br />
|Fallnummer<br />
|{{konfig|fall.fn}}<br />
|Wird mit Anmeldedatum automatisch erzeugt<br />
|Nicht änderbar<br />
|Jahr in Fallnummer = Jahr in Anmeldedatum (erste Eingabe)<br />
|Das Jahr im Anmeldedatum kann nachträglich geändert werden, Fallnummer wird <strong>nicht</strong> nachgezogen.<br />
|-<br />
|Zu den Akten<br />
|{{konfig|fall.zda}}<br />
|{{pfad3|Klientenkarte|Stand|Zu den Akten}}<br />
|Nicht änderbar<br />
|= Fachstatistikjahr, = Bundesstatistikjahr, = letzte Zuständigkeit Ende<br />
|<br />
|-<br />
|Zuständigkeit Beginn<br />
|{{konfig|zustaendigkeit.bg}}<br />
|Fallbeginn, Wiederaufnahme, {{pfad3|Klientenkarte|Bearbeiter|Beginn}}<br />
|{{pfad3|Klientenkarte|Bearbeiter|Beginn}}<br />
|Erste Zuständigkeit Beginn = Fallbeginn<br />
|<br />
|-<br />
|Zuständigkeit Ende<br />
|{{konfig|zustaendigkeit.e}}<br />
|ZdA, {{pfad3|Klientenkarte|Bearbeiter|Ende}}<br />
|{{pfad3|Klientenkarte|Bearbeiter|Ende}}<br />
|Letzte Zuständigkeit Ende = ZdA<br />
|<br />
|-<br />
|Leistung Beginn<br />
|{{konfig|leistung.bg}}<br />
|Neuaufnahme, Wiederaufnahme, {{pfad2|Klientenkarte|Leistungen}}<br />
|{{pfad2|Klientenkarte|Leistungen}}<br />
|> Fallbeginn, < Leistung Ende<br />
|<br />
|-<br />
|Leistung Ende<br />
|{{konfig|leistung.e}}<br />
|{{pfad2|Klientenkarte|Leistungen}}<br />
|{{pfad2|Klientenkarte|Leistungen}}<br />
|> Leistung Beginn, < ZdA<br />
|<br />
|-<br />
|Beratungskontakt<br />
|{{konfig|beratungskontakt.k}}<br />
|{{pfad2|Klientenkarte|Beratungskontakte}}<br />
|{{pfad2|Klientenkarte|Beratungskontakte}}<br />
|> Fallbeginn<br />
|<br />
|-<br />
|Fachstatistik Jahr<br />
|{{konfig|fachstat.jahr}}<br />
|{{pfad2|Fachstatistik|Jahr}}<br />
|{{pfad2|Fachstatistik|Jahr}}<br />
|<br />
|<br />
|-<br />
|Bundesstatistik Jahr<br />
|{{konfig|jghstat07.jahr}}<br />
|{{pfad2|Bundesstatistik|Jahr}}<br />
|{{pfad2|Bundesstatistik|Jahr}}<br />
|= Bundesstatistik Ende der Beratung (falls beendet),<br />
>= Bundesstatistik Beginn der Beratung, <= aktuelles Jahr<br />
|<br />
|-<br />
|Bundesstatistik Beginn der Beratung<br />
|{{konfig|jghstat07.bg}}<br />
|{{pfad2|Bundesstatistik|Beginn}}<br />
|{{pfad2|Bundesstatistik|Beginn}}<br />
|< Bundesstatistik Ende der Beratung (falls beendet),<br />
>= Fallbeginn<br />
|Als Vorgabe wird der Monat der ersten Leistung übernommen<br />
|-<br />
|Bundesstatistik Ende der Beratung<br />
|{{konfig|jghstat07.e}}<br />
|{{pfad2|Bundesstatistik|Ende}}<br />
|{{pfad2|Bundesstatistik|Ende}}<br />
|> Bundesstatistik Beginn der Beratung,<br />
= Bundesstatistik Jahr<br />
|<br />
|}<br />
<br />
=== Verwendung der Zeitangaben in den Auswertungen ===<br />
<br />
==== Tabelle Neumeldungen und Abschlüsse ====<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Spalte<br />
! Definition<br />
! Bemerkungen<br />
|-<br />
|Laufende am Monatsende<br />
|Fallbeginn (Anmeldedatum) < 1. des Folgemonats,<br />
kein ZdA-Datum oder ZdA-Datum >= 1. des Folgemonats<br />
|<br />
|-<br />
|Neu<br />
|Fallbeginn (Anmeldedatum) Monat = Monat<br />
|<br />
|-<br />
|davon ASD<br />
|Neu mit Zugangsmodus ASD<br />
|<br />
|-<br />
|Hauptfall<br />
|Bundesstatistik Ende Monat = Monat, Bundesstatistik kein Geschwisterfall<br />
|<br />
|-<br />
|Geschwisterfall<br />
|Bundesstatistik Ende Monat = Monat, Bundesstatistik Geschwisterfall<br />
|<br />
|-<br />
|abgeschl. Bundesstatistik<br />
|Bundesstatistik Ende Monat = Monat<br />
|<br />
|-<br />
|davon noch ohne Z.d.A.<br />
|Bundesstatistik Ende Monat = Monat, kein ZdA-Datum oder ZdA-Datum >= 1. des Folgemonats<br />
|<br />
|}<br />
<br />
==== Tabelle Neumeldungen und Abschlüsse pro Mitarbeiter ====<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Spalte<br />
! Definition<br />
! Bemerkungen<br />
|-<br />
|Übernommen<br />
|Summe aller Zuständigkeiten: Beginn Jahr < Jahr, Ende Jahr >= Jahr<br />
|<br />
|-<br />
|Neu<br />
|Summe aller Zuständigkeiten: Beginn Jahr = Jahr<br />
|<br />
|-<br />
|davon Fallbeginn<br />
|Neu, Fallbeginn (Anmeldedatum) = Zuständigkeit Beginn<br />
|<br />
|-<br />
|Laufend<br />
|Summe aller Zuständigkeiten: Beginn Jahr <= Jahr, kein Ende Jahr oder Ende Jahr > Jahr<br />
|<br />
|-<br />
|Beendet<br />
|Summe aller Zuständigkeiten: Ende Jahr = Jahr<br />
|<br />
|-<br />
|davon ZdA<br />
|Beendet, Ende Datum = ZdA-Datum <br />
|<br />
|}<br />
<br />
==== Tabelle Wartezeit ====<br />
<br />
Gezählt werden nur Fälle, für die die erste Leistung in dem betreffenden Jahr erfolgte. Die Wartezeit ist die Anzahl der Tage zwischen Fallbeginn (Anmeldedatum) und dem Tag der ersten Leistung. Es können hier also Fälle enthalten sein, für die die Anmeldung im Vorjahr liegt.<br />
<br />
==== Statistik ====<br />
<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Gruppe<br />
! Definition<br />
! Bemerkungen<br />
|-<br />
|Abgeschlossen<br />
|ZdA-Datum vorhanden, Fachstatistik und/oder Bundesstatistik für das Jahr vorhanden<br />
|Auswertung über mehrere Jahr hinweg möglich<br />
|-<br />
|Laufend<br />
|kein ZdA-Datum, Fachstatistik und/oder Bundesstatistik für das Jahr vorhanden<br />
|Auswertung nur für ein Jahr möglich. Wirklich sinnvoll ist nur das aktuelle Jahr, da es nur eine Fachstatistik bzw. Bundesstatistik pro Fall geben kann, die bei fortlaufenden Fällen im Folgejahr überschrieben wird.<br />
|-<br />
|Neu<br />
|Erster Beratungskontakt in dem Jahr oder erste Leistung in dem Jahr, Fachstatistik und/oder Bundesstatistik für das Jahr vorhanden<br />
|Auswertung nur für ein Jahr möglich. Es werden sowohl abgeschlossene als auch laufende Fälle einbezogen.<br />
|<br />
|}<br />
<br />
Falls im Statistikaufrufformular "Keine Fälle ohne Kontakt im Abschlussjahr" markiert ist, werden alle Fälle herausgenommen, für die es keine Beratungskontakte in dem Jahr gab. Dies geschieht aber nur dann, wenn es überhaupt Beratungskontakte für den Fall gibt, da sonst davon ausgegangen wird, dass Beratungskontakte gar nicht erfasst werden.</div>Ebkushttps://www.ebkus.org/wiki/Zeitangaben_(Fallbeginn,_usw.)Zeitangaben (Fallbeginn, usw.)2014-01-15T14:34:26Z<p>Ebkus: </p>
<hr />
<div><br />
__FORCETOC__ <br />
<br />
=== Datenbankfelder für Zeitangaben ===<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Name<br />
! Tabelle.Feld<br />
! Woher initialer Wert<br />
! Wo Änderbar<br />
! Zusicherungen<br />
! Bemerkungen<br />
|-<br />
|Fallbeginn (synonym: Anmeldedatum)<br />
|{{konfig|fall.bg}}<br />
|{{pfad2|Neuaufnahme|Anmeldedatum}}, {{pfad2|Wiederaufnahme|Anmeldedatum}}<br />
|{{pfad3|Klientenkarte|Stand|Fallbeginn}}<br />
|< erster Leistung, < erstem Beratungskontakt, = erste Zuständigkeit Beginn<br />
|Anmeldedatum kann am Ende des Jahres liegen, erste Leistung am Beginn des folgenden<br />
|-<br />
|Fallnummer<br />
|{{konfig|fall.fn}}<br />
|Wird mit Anmeldedatum automatisch erzeugt<br />
|Nicht änderbar<br />
|Jahr in Fallnummer = Jahr in Anmeldedatum (erste Eingabe)<br />
|Das Jahr im Anmeldedatum kann nachträglich geändert werden, Fallnummer wird <strong>nicht</strong> nachgezogen.<br />
|-<br />
|Zu den Akten<br />
|{{konfig|fall.zda}}<br />
|{{pfad3|Klientenkarte|Stand|Zu den Akten}}<br />
|Nicht änderbar<br />
|= Fachstatistikjahr, = Bundesstatistikjahr, = letzte Zuständigkeit Ende<br />
|<br />
|-<br />
|Zuständigkeit Beginn<br />
|{{konfig|zustaendigkeit.bg}}<br />
|Fallbegin, Wiederaufnahme, {{pfad3|Klientenkarte|Bearbeiter|Beginn}}<br />
|{{pfad3|Klientenkarte|Bearbeiter|Beginn}}<br />
|Erste Zuständigkeit Beginn = Fallbeginn<br />
|<br />
|-<br />
|Zuständigkeit Ende<br />
|{{konfig|zustaendigkeit.e}}<br />
|ZdA, {{pfad3|Klientenkarte|Bearbeiter|Ende}}<br />
|{{pfad3|Klientenkarte|Bearbeiter|Ende}}<br />
|Letzte Zuständigkeit Ende = ZdA<br />
|<br />
|-<br />
|Leistung Beginn<br />
|{{konfig|leistung.bg}}<br />
|Neuaufnahme, Wiederaufnahme, {{pfad2|Klientenkarte|Leistungen}}<br />
|{{pfad2|Klientenkarte|Leistungen}}<br />
|> Fallbeginn, < Leistung Ende<br />
|<br />
|-<br />
|Leistung Ende<br />
|{{konfig|leistung.e}}<br />
|{{pfad2|Klientenkarte|Leistungen}}<br />
|{{pfad2|Klientenkarte|Leistungen}}<br />
|> Leistung Beginn, < ZdA<br />
|<br />
|-<br />
|Beratungskontakt<br />
|{{konfig|beratungskontakt.k}}<br />
|{{pfad2|Klientenkarte|Beratungskontakte}}<br />
|{{pfad2|Klientenkarte|Beratungskontakte}}<br />
|> Fallbeginn<br />
|<br />
|-<br />
|Fachstatistik Jahr<br />
|{{konfig|fachstat.jahr}}<br />
|{{pfad2|Fachstatistik|Jahr}}<br />
|{{pfad2|Fachstatistik|Jahr}}<br />
|<br />
|<br />
|-<br />
|Bundesstatistik Jahr<br />
|{{konfig|jghstat07.jahr}}<br />
|{{pfad2|Bundesstatistik|Jahr}}<br />
|{{pfad2|Bundesstatistik|Jahr}}<br />
|= Bundesstatistik Ende der Beratung (falls beendet),<br />
>= Bundesstatistik Beginn der Beratung, <= aktuelles Jahr<br />
|<br />
|-<br />
|Bundesstatistik Beginn der Beratung<br />
|{{konfig|jghstat07.bg}}<br />
|{{pfad2|Bundesstatistik|Beginn}}<br />
|{{pfad2|Bundesstatistik|Beginn}}<br />
|< Bundesstatistik Ende der Beratung (falls beendet),<br />
>= Fallbeginn<br />
|Als Vorgabe wird der Monat der ersten Leistung übernommen<br />
|-<br />
|Bundesstatistik Ende der Beratung<br />
|{{konfig|jghstat07.e}}<br />
|{{pfad2|Bundesstatistik|Ende}}<br />
|{{pfad2|Bundesstatistik|Ende}}<br />
|> Bundesstatistik Beginn der Beratung,<br />
= Bundesstatistik Jahr<br />
|<br />
|}<br />
<br />
=== Verwendung der Zeitangaben in den Auswertungen ===<br />
<br />
==== Tabelle Neumeldungen und Abschlüsse ====<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Spalte<br />
! Definition<br />
! Bemerkungen<br />
|-<br />
|Laufende am Monatsende<br />
|Fallbeginn (Anmeldedatum) < 1. des Folgemonats,<br />
kein ZdA-Datum oder ZdA-Datum >= 1. des Folgemonats<br />
|<br />
|-<br />
|Neu<br />
|Fallbeginn (Anmeldedatum) Monat = Monat<br />
|<br />
|-<br />
|davon ASD<br />
|Neu mit Zugangsmodus ASD<br />
|<br />
|-<br />
|Hauptfall<br />
|Bundesstatistik Ende Monat = Monat, Bundesstatistik kein Geschwisterfall<br />
|<br />
|-<br />
|Geschwisterfall<br />
|Bundesstatistik Ende Monat = Monat, Bundesstatistik Geschwisterfall<br />
|<br />
|-<br />
|abgeschl. Bundesstatistik<br />
|Bundesstatistik Ende Monat = Monat<br />
|<br />
|-<br />
|davon noch ohne Z.d.A.<br />
|Bundesstatistik Ende Monat = Monat, kein ZdA-Datum oder ZdA-Datum >= 1. des Folgemonats<br />
|<br />
|}<br />
<br />
==== Tabelle Neumeldungen und Abschlüsse pro Mitarbeiter ====<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Spalte<br />
! Definition<br />
! Bemerkungen<br />
|-<br />
|Übernommen<br />
|Summe aller Zuständigkeiten: Beginn Jahr < Jahr, Ende Jahr >= Jahr<br />
|<br />
|-<br />
|Neu<br />
|Summe aller Zuständigkeiten: Beginn Jahr = Jahr<br />
|<br />
|-<br />
|davon Fallbeginn<br />
|Neu, Fallbeginn (Anmeldedatum) = Zuständigkeit Beginn<br />
|<br />
|-<br />
|Laufend<br />
|Summe aller Zuständigkeiten: Beginn Jahr <= Jahr, kein Ende Jahr oder Ende Jahr > Jahr<br />
|<br />
|-<br />
|Beendet<br />
|Summe aller Zuständigkeiten: Ende Jahr = Jahr<br />
|<br />
|-<br />
|davon ZdA<br />
|Beendet, Ende Datum = ZdA-Datum <br />
|<br />
|}<br />
<br />
==== Tabelle Wartezeit ====<br />
<br />
Gezählt werden nur Fälle, für die die erste Leistung in dem betreffenden Jahr erfolgte. Die Wartezeit ist die Anzahl der Tage zwischen Fallbeginn (Anmeldedatum) und dem Tag der ersten Leistung. Es können hier also Fälle enthalten sein, für die die Anmeldung im Vorjahr liegt.<br />
<br />
==== Statistik ====<br />
<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Gruppe<br />
! Definition<br />
! Bemerkungen<br />
|-<br />
|Abgeschlossen<br />
|ZdA-Datum vorhanden, Fachstatistik und/oder Bundesstatistik für das Jahr vorhanden<br />
|Auswertung über mehrere Jahr hinweg möglich<br />
|-<br />
|Laufend<br />
|kein ZdA-Datum, Fachstatistik und/oder Bundesstatistik für das Jahr vorhanden<br />
|Auswertung nur für ein Jahr möglich. Wirklich sinnvoll ist nur das aktuelle Jahr, da es nur eine Fachstatistik bzw. Bundesstatistik pro Fall geben kann, die bei fortlaufenden Fällen im Folgejahr überschrieben wird.<br />
|-<br />
|Neu<br />
|Erster Beratungskontakt in dem Jahr oder erste Leistung in dem Jahr, Fachstatistik und/oder Bundesstatistik für das Jahr vorhanden<br />
|Auswertung nur für ein Jahr möglich. Es werden sowohl abgeschlossene als auch laufende Fälle einbezogen.<br />
|<br />
|}<br />
<br />
Falls im Statistikaufrufformular "Keine Fälle ohne Kontakt im Abschlussjahr" markiert ist, werden alle Fälle herausgenommen, für die es keine Beratungskontakte in dem Jahr gab. Dies geschieht aber nur dann, wenn es überhaupt Beratungskontakte für den Fall gibt, da sonst davon ausgegangen wird, dass Beratungskontakte gar nicht erfasst werden.</div>Ebkushttps://www.ebkus.org/wiki/Zeitangaben_(Fallbeginn,_usw.)Zeitangaben (Fallbeginn, usw.)2014-01-15T14:33:47Z<p>Ebkus: </p>
<hr />
<div><br />
__FORCETOC__ <br />
<br />
=== Datenbankfelder für Zeitangaben ===<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Name<br />
! Tabelle.Feld<br />
! Woher initialer Wert<br />
! Wo Änderbar<br />
! Zusicherungen<br />
! Bemerkungen<br />
|-<br />
|Fallbeginn (synonym: Anmeldedatum)<br />
|{{konfig|fall.bg}}<br />
|{{pfad2|Neuaufnahme|Anmeldedatum}}, {{pfad2|Wiederaufnahme|Anmeldedatum}}<br />
|{{pfad3|Klientenkarte|Stand|Fallbeginn}}<br />
|< erster Leistung, < erstem Beratungskontakt, = erste Zuständigkeit Beginn<br />
|Anmeldedatum kann am Ende des Jahres liegen, erste Leistung am Beginn des folgenden<br />
|-<br />
|Fallnummer<br />
|{{konfig|fall.fn}}<br />
|Wird mit Anmeldedatum automatisch erzeugt<br />
|Nicht änderbar<br />
|Jahr in Fallnummer = Jahr in Anmeldedatum (erste Eingabe)<br />
|Das Jahr im Anmeldedatum kann nachträglich geändert werden, Fallnummer wird <strong>nicht</strong> nachgezogen.<br />
|-<br />
|Zu den Akten<br />
|{{konfig|fall.zda}}<br />
|{{pfad3|Klientenkarte|Stand|Zu den Akten}}<br />
|Nicht änderbar<br />
|= Fachstatistikjahr, = Bundesstatistikjahr, = letzte Zuständigkeit Ende<br />
|<br />
|-<br />
|Zuständigkeit Beginn<br />
|{{konfig|zustaendigkeit.bg}}<br />
|Fallbegin, Wiederaufnahme, {{pfad3|Klientenkarte|Bearbeiter|Beginn}}<br />
|{{pfad3|Klientenkarte|Bearbeiter|Beginn}}<br />
|Erste Zuständigkeit Beginne = Fallbeginn<br />
|<br />
|-<br />
|Zuständigkeit Ende<br />
|{{konfig|zustaendigkeit.e}}<br />
|ZdA, {{pfad3|Klientenkarte|Bearbeiter|Ende}}<br />
|{{pfad3|Klientenkarte|Bearbeiter|Ende}}<br />
|Letzte Zuständigkeit Ende = ZdA<br />
|<br />
|-<br />
|Leistung Beginn<br />
|{{konfig|leistung.bg}}<br />
|Neuaufnahme, Wiederaufnahme, {{pfad2|Klientenkarte|Leistungen}}<br />
|{{pfad2|Klientenkarte|Leistungen}}<br />
|> Fallbeginn, < Leistung Ende<br />
|<br />
|-<br />
|Leistung Ende<br />
|{{konfig|leistung.e}}<br />
|{{pfad2|Klientenkarte|Leistungen}}<br />
|{{pfad2|Klientenkarte|Leistungen}}<br />
|> Leistung Beginn, < ZdA<br />
|<br />
|-<br />
|Beratungskontakt<br />
|{{konfig|beratungskontakt.k}}<br />
|{{pfad2|Klientenkarte|Beratungskontakte}}<br />
|{{pfad2|Klientenkarte|Beratungskontakte}}<br />
|> Fallbeginn<br />
|<br />
|-<br />
|Fachstatistik Jahr<br />
|{{konfig|fachstat.jahr}}<br />
|{{pfad2|Fachstatistik|Jahr}}<br />
|{{pfad2|Fachstatistik|Jahr}}<br />
|<br />
|<br />
|-<br />
|Bundesstatistik Jahr<br />
|{{konfig|jghstat07.jahr}}<br />
|{{pfad2|Bundesstatistik|Jahr}}<br />
|{{pfad2|Bundesstatistik|Jahr}}<br />
|= Bundesstatistik Ende der Beratung (falls beendet),<br />
>= Bundesstatistik Beginn der Beratung, <= aktuelles Jahr<br />
|<br />
|-<br />
|Bundesstatistik Beginn der Beratung<br />
|{{konfig|jghstat07.bg}}<br />
|{{pfad2|Bundesstatistik|Beginn}}<br />
|{{pfad2|Bundesstatistik|Beginn}}<br />
|< Bundesstatistik Ende der Beratung (falls beendet),<br />
>= Fallbeginn<br />
|Als Vorgabe wird der Monat der ersten Leistung übernommen<br />
|-<br />
|Bundesstatistik Ende der Beratung<br />
|{{konfig|jghstat07.e}}<br />
|{{pfad2|Bundesstatistik|Ende}}<br />
|{{pfad2|Bundesstatistik|Ende}}<br />
|> Bundesstatistik Beginn der Beratung,<br />
= Bundesstatistik Jahr<br />
|<br />
|}<br />
<br />
=== Verwendung der Zeitangaben in den Auswertungen ===<br />
<br />
==== Tabelle Neumeldungen und Abschlüsse ====<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Spalte<br />
! Definition<br />
! Bemerkungen<br />
|-<br />
|Laufende am Monatsende<br />
|Fallbeginn (Anmeldedatum) < 1. des Folgemonats,<br />
kein ZdA-Datum oder ZdA-Datum >= 1. des Folgemonats<br />
|<br />
|-<br />
|Neu<br />
|Fallbeginn (Anmeldedatum) Monat = Monat<br />
|<br />
|-<br />
|davon ASD<br />
|Neu mit Zugangsmodus ASD<br />
|<br />
|-<br />
|Hauptfall<br />
|Bundesstatistik Ende Monat = Monat, Bundesstatistik kein Geschwisterfall<br />
|<br />
|-<br />
|Geschwisterfall<br />
|Bundesstatistik Ende Monat = Monat, Bundesstatistik Geschwisterfall<br />
|<br />
|-<br />
|abgeschl. Bundesstatistik<br />
|Bundesstatistik Ende Monat = Monat<br />
|<br />
|-<br />
|davon noch ohne Z.d.A.<br />
|Bundesstatistik Ende Monat = Monat, kein ZdA-Datum oder ZdA-Datum >= 1. des Folgemonats<br />
|<br />
|}<br />
<br />
==== Tabelle Neumeldungen und Abschlüsse pro Mitarbeiter ====<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Spalte<br />
! Definition<br />
! Bemerkungen<br />
|-<br />
|Übernommen<br />
|Summe aller Zuständigkeiten: Beginn Jahr < Jahr, Ende Jahr >= Jahr<br />
|<br />
|-<br />
|Neu<br />
|Summe aller Zuständigkeiten: Beginn Jahr = Jahr<br />
|<br />
|-<br />
|davon Fallbeginn<br />
|Neu, Fallbeginn (Anmeldedatum) = Zuständigkeit Beginn<br />
|<br />
|-<br />
|Laufend<br />
|Summe aller Zuständigkeiten: Beginn Jahr <= Jahr, kein Ende Jahr oder Ende Jahr > Jahr<br />
|<br />
|-<br />
|Beendet<br />
|Summe aller Zuständigkeiten: Ende Jahr = Jahr<br />
|<br />
|-<br />
|davon ZdA<br />
|Beendet, Ende Datum = ZdA-Datum <br />
|<br />
|}<br />
<br />
==== Tabelle Wartezeit ====<br />
<br />
Gezählt werden nur Fälle, für die die erste Leistung in dem betreffenden Jahr erfolgte. Die Wartezeit ist die Anzahl der Tage zwischen Fallbeginn (Anmeldedatum) und dem Tag der ersten Leistung. Es können hier also Fälle enthalten sein, für die die Anmeldung im Vorjahr liegt.<br />
<br />
==== Statistik ====<br />
<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Gruppe<br />
! Definition<br />
! Bemerkungen<br />
|-<br />
|Abgeschlossen<br />
|ZdA-Datum vorhanden, Fachstatistik und/oder Bundesstatistik für das Jahr vorhanden<br />
|Auswertung über mehrere Jahr hinweg möglich<br />
|-<br />
|Laufend<br />
|kein ZdA-Datum, Fachstatistik und/oder Bundesstatistik für das Jahr vorhanden<br />
|Auswertung nur für ein Jahr möglich. Wirklich sinnvoll ist nur das aktuelle Jahr, da es nur eine Fachstatistik bzw. Bundesstatistik pro Fall geben kann, die bei fortlaufenden Fällen im Folgejahr überschrieben wird.<br />
|-<br />
|Neu<br />
|Erster Beratungskontakt in dem Jahr oder erste Leistung in dem Jahr, Fachstatistik und/oder Bundesstatistik für das Jahr vorhanden<br />
|Auswertung nur für ein Jahr möglich. Es werden sowohl abgeschlossene als auch laufende Fälle einbezogen.<br />
|<br />
|}<br />
<br />
Falls im Statistikaufrufformular "Keine Fälle ohne Kontakt im Abschlussjahr" markiert ist, werden alle Fälle herausgenommen, für die es keine Beratungskontakte in dem Jahr gab. Dies geschieht aber nur dann, wenn es überhaupt Beratungskontakte für den Fall gibt, da sonst davon ausgegangen wird, dass Beratungskontakte gar nicht erfasst werden.</div>Ebkushttps://www.ebkus.org/wiki/Zeitangaben_(Fallbeginn,_usw.)Zeitangaben (Fallbeginn, usw.)2014-01-15T14:29:35Z<p>Ebkus: </p>
<hr />
<div><br />
__FORCETOC__ <br />
<br />
=== Datenbankfelder für Zeitangaben ===<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Name<br />
! Tabelle.Feld<br />
! Woher initialer Wert<br />
! Wo Änderbar<br />
! Zusicherungen<br />
! Bemerkungen<br />
|-<br />
|Fallbeginn (synonym: Anmeldedatum)<br />
|{{konfig|fall.bg}}<br />
|{{pfad2|Neuaufnahme|Anmeldedatum}}, {{pfad2|Wiederaufnahme|Anmeldedatum}}<br />
|{{pfad3|Klientenkarte|Stand|Fallbeginn}}<br />
|< erster Leistung, < erstem Beratungskontakt, = erste Zuständigkeit Beginn<br />
|Anmeldedatum kann am Ende des Jahres liegen, erste Leistung am Beginn des folgenden<br />
|-<br />
|Fallnummer<br />
|{{konfig|fall.fn}}<br />
|Wird mit Anmeldedatum automatisch erzeugt<br />
|Nicht änderbar<br />
|Jahr in Fallnummer = Jahr in Anmeldedatum (erste Eingabe)<br />
|Das Jahr im Anmeldedatum kann nachträglich geändert werden, Fallnummer wird <strong>nicht</strong> nachgezogen.<br />
|-<br />
|Zu den Akten<br />
|{{konfig|fall.zda}}<br />
|{{pfad3|Klientenkarte|Stand|Zu den Akten}}<br />
|Nicht änderbar<br />
|= Fachstatistikjahr, = Bundesstatistikjahr, = letzte Zuständigkeit Ende<br />
|<br />
|-<br />
|Zuständigkeit Beginn<br />
|{{konfig|zustaendigkeit.bg}}<br />
|Fallbegin, Wiederaufnahme, {{pfad3|Klientenkarte|Bearbeiter|Beginn}}<br />
|{{pfad3|Klientenkarte|Bearbeiter|Beginn}}<br />
|Erste Zuständigkeit Beginne = Fallbeginn<br />
|<br />
|-<br />
|Zuständigkeit Ende<br />
|{{konfig|zustaendigkeit.e}}<br />
|ZdA, {{pfad3|Klientenkarte|Bearbeiter|Ende}}<br />
|{{pfad3|Klientenkarte|Bearbeiter|Ende}}<br />
|Letzte Zuständigkeit Ende = ZdA<br />
|<br />
|-<br />
|Leistung Beginn<br />
|{{konfig|leistung.bg}}<br />
|Neuaufnahme, Wiederaufnahme, {{pfad2|Klientenkarte|Leistungen}}<br />
|{{pfad2|Klientenkarte|Leistungen}}<br />
|> Fallbeginn, < Leistung Ende<br />
|<br />
|-<br />
|Leistung Ende<br />
|{{konfig|leistung.e}}<br />
|{{pfad2|Klientenkarte|Leistungen}}<br />
|{{pfad2|Klientenkarte|Leistungen}}<br />
|> Leistung Beginn, < ZdA<br />
|<br />
|-<br />
|Beratungskontakt<br />
|{{konfig|beratungskontakt.k}}<br />
|{{pfad2|Klientenkarte|Beratungskontakte}}<br />
|{{pfad2|Klientenkarte|Beratungskontakte}}<br />
|> Fallbeginn<br />
|<br />
|-<br />
|Fachstatistik Jahr<br />
|{{konfig|fachstat.jahr}}<br />
|{{pfad2|Fachstatistik|Jahr}}<br />
|{{pfad2|Fachstatistik|Jahr}}<br />
|<br />
|<br />
|-<br />
|Bundesstatistik Jahr<br />
|{{konfig|jghstat07.jahr}}<br />
|{{pfad2|Bundesstatistik|Jahr}}<br />
|{{pfad2|Bundesstatistik|Jahr}}<br />
|= Bundesstatistik Ende der Beratung (falls beendet),<br />
>= Bundesstatistik Beginn der Beratung, <= aktuelles Jahr<br />
|<br />
|-<br />
|Bundesstatistik Beginn der Beratung<br />
|{{konfig|jghstat07.bg}}<br />
|{{pfad2|Bundesstatistik|Beginn}}<br />
|{{pfad2|Bundesstatistik|Beginn}}<br />
|< Bundesstatistik Ende der Beratung (falls beendet),<br />
>= Fallbeginn<br />
|Als Vorgabe wird der Monat der ersten Leistung übernommen<br />
|-<br />
|Bundesstatistik Ende der Beratung<br />
|{{konfig|jghstat07.e}}<br />
|{{pfad2|Bundesstatistik|Ende}}<br />
|{{pfad2|Bundesstatistik|Ende}}<br />
|> Bundesstatistik Beginn der Beratung,<br />
= Bundesstatistik Jahr<br />
|<br />
|}<br />
<br />
Anmerkungen:<br />
<br />
Änderungen sind immer nur bei einem laufendem Fall möglich<br />
<br />
=== Verwendung der Zeitangaben in den Auswertungen ===<br />
<br />
==== Tabelle Neumeldungen und Abschlüsse ====<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Spalte<br />
! Definition<br />
! Bemerkungen<br />
|-<br />
|Laufende am Monatsende<br />
|Fallbeginn (Anmeldedatum) < 1. des Folgemonats,<br />
kein ZdA-Datum oder ZdA-Datum >= 1. des Folgemonats<br />
|<br />
|-<br />
|Neu<br />
|Fallbeginn (Anmeldedatum) Monat = Monat<br />
|<br />
|-<br />
|davon ASD<br />
|Neu mit Zugangsmodus ASD<br />
|<br />
|-<br />
|Hauptfall<br />
|Bundesstatistik Ende Monat = Monat, Bundesstatistik kein Geschwisterfall<br />
|<br />
|-<br />
|Geschwisterfall<br />
|Bundesstatistik Ende Monat = Monat, Bundesstatistik Geschwisterfall<br />
|<br />
|-<br />
|abgeschl. Bundesstatistik<br />
|Bundesstatistik Ende Monat = Monat<br />
|<br />
|-<br />
|davon noch ohne Z.d.A.<br />
|Bundesstatistik Ende Monat = Monat, kein ZdA-Datum oder ZdA-Datum >= 1. des Folgemonats<br />
|<br />
|}<br />
<br />
==== Tabelle Neumeldungen und Abschlüsse pro Mitarbeiter ====<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Spalte<br />
! Definition<br />
! Bemerkungen<br />
|-<br />
|Übernommen<br />
|Summe aller Zuständigkeiten: Beginn Jahr < Jahr, Ende Jahr >= Jahr<br />
|<br />
|-<br />
|Neu<br />
|Summe aller Zuständigkeiten: Beginn Jahr = Jahr<br />
|<br />
|-<br />
|davon Fallbeginn<br />
|Neu, Fallbeginn (Anmeldedatum) = Zuständigkeit Beginn<br />
|<br />
|-<br />
|Laufend<br />
|Summe aller Zuständigkeiten: Beginn Jahr <= Jahr, kein Ende Jahr oder Ende Jahr > Jahr<br />
|<br />
|-<br />
|Beendet<br />
|Summe aller Zuständigkeiten: Ende Jahr = Jahr<br />
|<br />
|-<br />
|davon ZdA<br />
|Beendet, Ende Datum = ZdA-Datum <br />
|<br />
|}<br />
<br />
==== Tabelle Wartezeit ====<br />
<br />
Gezählt werden nur Fälle, für die die erste Leistung in dem betreffenden Jahr erfolgte. Die Wartezeit ist die Anzahl der Tage zwischen Fallbeginn (Anmeldedatum) und dem Tag der ersten Leistung. Es können hier also Fälle enthalten sein, für die die Anmeldung im Vorjahr liegt.<br />
<br />
==== Statistik ====<br />
<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Gruppe<br />
! Definition<br />
! Bemerkungen<br />
|-<br />
|Abgeschlossen<br />
|ZdA-Datum vorhanden, Fachstatistik und/oder Bundesstatistik für das Jahr vorhanden<br />
|Auswertung über mehrere Jahr hinweg möglich<br />
|-<br />
|Laufend<br />
|kein ZdA-Datum, Fachstatistik und/oder Bundesstatistik für das Jahr vorhanden<br />
|Auswertung nur für ein Jahr möglich. Wirklich sinnvoll ist nur das aktuelle Jahr, da es nur eine Fachstatistik bzw. Bundesstatistik pro Fall geben kann, die bei fortlaufenden Fällen im Folgejahr überschrieben wird.<br />
|-<br />
|Neu<br />
|Erster Beratungskontakt in dem Jahr oder erste Leistung in dem Jahr, Fachstatistik und/oder Bundesstatistik für das Jahr vorhanden<br />
|Auswertung nur für ein Jahr möglich. Es werden sowohl abgeschlossene als auch laufende Fälle einbezogen.<br />
|<br />
|}<br />
<br />
Falls im Statistikaufrufformular "Keine Fälle ohne Kontakt im Abschlussjahr" markiert ist, werden alle Fälle herausgenommen, für die es keine Beratungskontakte in dem Jahr gab. Dies geschieht aber nur dann, wenn es überhaupt Beratungskontakte für den Fall gibt, da sonst davon ausgegangen wird, dass Beratungskontakte gar nicht erfasst werden.</div>Ebkushttps://www.ebkus.org/wiki/Zeitangaben_(Fallbeginn,_usw.)Zeitangaben (Fallbeginn, usw.)2014-01-15T14:21:16Z<p>Ebkus: </p>
<hr />
<div><br />
__FORCETOC__ <br />
<br />
=== Datenbankfelder für Zeitangaben ===<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Name<br />
! Tabelle.Feld<br />
! Woher initialer Wert<br />
! Wo Änderbar<br />
! Zusicherungen<br />
! Bemerkungen<br />
|-<br />
|Fallbeginn (synonym: Anmeldedatum)<br />
|{{konfig|fall.bg}}<br />
|{{pfad2|Neuaufnahme|Anmeldedatum}}, {{pfad2|Wiederaufnahme|Anmeldedatum}}<br />
|{{pfad3|Klientenkarte|Stand|Fallbeginn}}<br />
|< erster Leistung, < erstem Beratungskontakt, = erste Zuständigkeit Beginn<br />
|Anmeldedatum kann am Ende des Jahres liegen, erste Leistung am Beginn des folgenden<br />
|-<br />
|Fallnummer<br />
|{{konfig|fall.fn}}<br />
|Wird mit Anmeldedatum automatisch erzeugt<br />
|Nicht änderbar<br />
|Jahr in Fallnummer = Jahr in Anmeldedatum (erste Eingabe)<br />
|Das Jahr im Anmeldedatum kann nachträglich geändert werden, Fallnummer wird <strong>nicht</strong> nachgezogen.<br />
|-<br />
|Zu den Akten<br />
|{{konfig|fall.zda}}<br />
|{{pfad3|Klientenkarte|Stand|Zu den Akten}}<br />
|Nicht änderbar<br />
|= Fachstatistikjahr, = Bundesstatistikjahr, = letzte Zuständigkeit Ende<br />
|<br />
|-<br />
|Zuständigkeit Beginn<br />
|{{konfig|zustaendigkeit.bg}}<br />
|Fallbegin, Wiederaufnahme, {{pfad3|Klientenkarte|Bearbeiter|Beginn}}<br />
|{{pfad3|Klientenkarte|Bearbeiter|Beginn}}<br />
|Erste Zuständigkeit = Fallbeginn<br />
|<br />
|-<br />
|Zuständigkeit Ende<br />
|{{konfig|zustaendigkeit.e}}<br />
|ZdA, {{pfad3|Klientenkarte|Bearbeiter|Ende}}<br />
|{{pfad3|Klientenkarte|Bearbeiter|Ende}}<br />
|Letzte Zuständigkeit = ZdA<br />
|<br />
|-<br />
|Leistung Beginn<br />
|{{konfig|leistung.bg}}<br />
|Neuaufnahme, Wiederaufnahme, {{pfad2|Klientenkarte|Leistungen}}<br />
|{{pfad2|Klientenkarte|Leistungen}}<br />
|> Fallbeginn, < Leistung Ende<br />
|<br />
|-<br />
|Leistung Ende<br />
|{{konfig|leistung.e}}<br />
|{{pfad2|Klientenkarte|Leistungen}}<br />
|{{pfad2|Klientenkarte|Leistungen}}<br />
|> Leistung Beginn<br />
|<br />
|-<br />
|Beratungskontakt<br />
|{{konfig|beratungskontakt.k}}<br />
|{{pfad2|Klientenkarte|Beratungskontakte}}<br />
|{{pfad2|Klientenkarte|Beratungskontakte}}<br />
|> Fallbeginn<br />
|<br />
|-<br />
|Fachstatistik Jahr<br />
|{{konfig|fachstat.jahr}}<br />
|{{pfad2|Fachstatistik|Jahr}}<br />
|{{pfad2|Fachstatistik|Jahr}}<br />
|<br />
|<br />
|-<br />
|Bundesstatistik Jahr<br />
|{{konfig|jghstat07.jahr}}<br />
|{{pfad2|Bundesstatistik|Jahr}}<br />
|{{pfad2|Bundesstatistik|Jahr}}<br />
|= Bundesstatistik Ende der Beratung (falls beendet),<br />
>= Bundesstatistik Beginn der Beratung, <= aktuelles Jahr<br />
|<br />
|-<br />
|Bundesstatistik Beginn der Beratung<br />
|{{konfig|jghstat07.bg}}<br />
|{{pfad2|Bundesstatistik|Beginn}}<br />
|{{pfad2|Bundesstatistik|Beginn}}<br />
|< Bundesstatistik Ende der Beratung (falls beendet),<br />
>= Fallbeginn<br />
|Als Vorgabe wird der Monat der ersten Leistung übernommen<br />
|-<br />
|Bundesstatistik Ende der Beratung<br />
|{{konfig|jghstat07.e}}<br />
|{{pfad2|Bundesstatistik|Ende}}<br />
|{{pfad2|Bundesstatistik|Ende}}<br />
|> Bundesstatistik Beginn der Beratung,<br />
= Bundesstatistik Jahr<br />
|<br />
|}<br />
<br />
Anmerkungen:<br />
<br />
Änderungen sind immer nur bei einem laufendem Fall möglich<br />
<br />
=== Verwendung der Zeitangaben in den Auswertungen ===<br />
<br />
==== Tabelle Neumeldungen und Abschlüsse ====<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Spalte<br />
! Definition<br />
! Bemerkungen<br />
|-<br />
|Laufende am Monatsende<br />
|Fallbeginn (Anmeldedatum) < 1. des Folgemonats,<br />
kein ZdA-Datum oder ZdA-Datum >= 1. des Folgemonats<br />
|<br />
|-<br />
|Neu<br />
|Fallbeginn (Anmeldedatum) Monat = Monat<br />
|<br />
|-<br />
|davon ASD<br />
|Neu mit Zugangsmodus ASD<br />
|<br />
|-<br />
|Hauptfall<br />
|Bundesstatistik Ende Monat = Monat, Bundesstatistik kein Geschwisterfall<br />
|<br />
|-<br />
|Geschwisterfall<br />
|Bundesstatistik Ende Monat = Monat, Bundesstatistik Geschwisterfall<br />
|<br />
|-<br />
|abgeschl. Bundesstatistik<br />
|Bundesstatistik Ende Monat = Monat<br />
|<br />
|-<br />
|davon noch ohne Z.d.A.<br />
|Bundesstatistik Ende Monat = Monat, kein ZdA-Datum oder ZdA-Datum >= 1. des Folgemonats<br />
|<br />
|}<br />
<br />
==== Tabelle Neumeldungen und Abschlüsse pro Mitarbeiter ====<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Spalte<br />
! Definition<br />
! Bemerkungen<br />
|-<br />
|Übernommen<br />
|Summe aller Zuständigkeiten: Beginn Jahr < Jahr, Ende Jahr >= Jahr<br />
|<br />
|-<br />
|Neu<br />
|Summe aller Zuständigkeiten: Beginn Jahr = Jahr<br />
|<br />
|-<br />
|davon Fallbeginn<br />
|Neu, Fallbeginn (Anmeldedatum) = Zuständigkeit Beginn<br />
|<br />
|-<br />
|Laufend<br />
|Summe aller Zuständigkeiten: Beginn Jahr <= Jahr, kein Ende Jahr oder Ende Jahr > Jahr<br />
|<br />
|-<br />
|Beendet<br />
|Summe aller Zuständigkeiten: Ende Jahr = Jahr<br />
|<br />
|-<br />
|davon ZdA<br />
|Beendet, Ende Datum = ZdA-Datum <br />
|<br />
|}<br />
<br />
==== Tabelle Wartezeit ====<br />
<br />
Gezeigt werden nur Fälle, für die die erste Leistung in dem betreffenden Jahr erfolgte. Die Wartezeit ist die Anzahl der Tage zwischen Fallbeginn (Anmeldedatum) und dem Tag der ersten Leistung. Es können hier also Fälle enthalten sein, für die Anmeldung im Vorjahr liegt.<br />
<br />
==== Statistik ====<br />
<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Gruppe<br />
! Definition<br />
! Bemerkungen<br />
|-<br />
|Abgeschlossen<br />
|ZdA-Datum vorhanden, Fachstatistik und/oder Bundesstatistik für das Jahr vorhanden<br />
|Auswertung über mehrere Jahr hinweg möglich<br />
|-<br />
|Laufend<br />
|kein ZdA-Datum, Fachstatistik und/oder Bundesstatistik für das Jahr vorhanden<br />
|Auswertung nur für ein Jahr möglich. Wirklich sinnvoll ist nur das aktuelle Jahr, da es nur eine Fachstatistik bzw. Bundesstatistik pro Fall geben kann, die bei fortlaufenden Fällen im Folgejahr überschrieben wird.<br />
|-<br />
|Neu<br />
|Erster Beratungskontakt in dem Jahr oder erste Leistung in dem Jahr, Fachstatistik und/oder Bundesstatistik für das Jahr vorhanden<br />
|Auswertung nur für ein Jahr möglich. Es werden sowohl abgeschlossene als auch laufende Fälle einbezogen.<br />
|<br />
|}<br />
<br />
Falls im Statistikaufrufformular "Keine Fälle ohne Kontakt im Abschlussjahr" markiert ist, werden alle Fälle herausgenommen, für die es keine Beratungskontakte in dem Jahr gab. Dies geschieht aber nur dann, wenn es überhaupt Beratungskontakte für den Fall gibt, da sonst davon ausgegangen wird, dass Beratungskontakte gar nicht erfasst werde.</div>Ebkushttps://www.ebkus.org/wiki/Zeitangaben_(Fallbeginn,_usw.)Zeitangaben (Fallbeginn, usw.)2014-01-15T13:30:31Z<p>Ebkus: </p>
<hr />
<div><br />
__FORCETOC__ <br />
<br />
=== Datenbankfelder für Zeitangaben ===<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Name<br />
! Tabelle.Feld<br />
! Woher initialer Wert<br />
! Wo Änderbar<br />
! Zusicherungen<br />
! Bemerkungen<br />
|-<br />
|Fallbeginn (synonym: Anmeldedatum)<br />
|{{konfig|fall.bg}}<br />
|{{pfad2|Neuaufnahme|Anmeldedatum}}, {{pfad2|Wiederaufnahme|Anmeldedatum}}<br />
|{{pfad3|Klientenkarte|Stand|Fallbeginn}}<br />
|< erster Leistung, < erstem Beratungskontakt, = erste Zuständigkeit Beginn<br />
|Anmeldedatum kann am Ende des Jahres liegen, erste Leistung am Beginn des folgenden<br />
|-<br />
|Fallnummer<br />
|{{konfig|fall.fn}}<br />
|Wird mit Anmeldedatum automatisch erzeugt<br />
|Nicht änderbar<br />
|Jahr in Fallnummer = Jahr in Anmeldedatum (erste Eingabe)<br />
|Das Jahr im Anmeldedatum kann nachträglich geändert werden, Fallnummer wird <strong>nicht</strong> nachgezogen.<br />
|-<br />
|Zu den Akten<br />
|{{konfig|fall.zda}}<br />
|{{pfad3|Klientenkarte|Stand|Zu den Akten}}<br />
|Nicht änderbar<br />
|= Fachstatistikjahr, = Bundesstatistikjahr, = letzte Zuständigkeit Ende<br />
|<br />
|-<br />
|Zuständigkeit Beginn<br />
|{{konfig|zustaendigkeit.bg}}<br />
|Fallbegin, Wiederaufnahme, {{pfad3|Klientenkarte|Bearbeiter|Beginn}}<br />
|{{pfad3|Klientenkarte|Bearbeiter|Beginn}}<br />
|Erste Zuständigkeit = Fallbeginn<br />
|<br />
|-<br />
|Zuständigkeit Ende<br />
|{{konfig|zustaendigkeit.e}}<br />
|ZdA, {{pfad3|Klientenkarte|Bearbeiter|Ende}}<br />
|{{pfad3|Klientenkarte|Bearbeiter|Ende}}<br />
|Letzte Zuständigkeit = ZdA<br />
|<br />
|-<br />
|Leistung Beginn<br />
|{{konfig|leistung.bg}}<br />
|Neuaufnahme, Wiederaufnahme, {{pfad2|Klientenkarte|Leistungen}}<br />
|{{pfad2|Klientenkarte|Leistungen}}<br />
|> Fallbeginn, < Leistung Ende<br />
|<br />
|-<br />
|Leistung Ende<br />
|{{konfig|leistung.e}}<br />
|{{pfad2|Klientenkarte|Leistungen}}<br />
|{{pfad2|Klientenkarte|Leistungen}}<br />
|> Leistung Beginn<br />
|<br />
|-<br />
|Beratungskontakt<br />
|{{konfig|beratungskontakt.k}}<br />
|{{pfad2|Klientenkarte|Beratungskontakte}}<br />
|{{pfad2|Klientenkarte|Beratungskontakte}}<br />
|> Fallbeginn<br />
|<br />
|-<br />
|Fachstatistik Jahr<br />
|{{konfig|fachstat.jahr}}<br />
|{{pfad2|Fachstatistik|Jahr}}<br />
|{{pfad2|Fachstatistik|Jahr}}<br />
|<br />
|<br />
|-<br />
|Bundesstatistik Jahr<br />
|{{konfig|jghstat07.jahr}}<br />
|{{pfad2|Bundesstatistik|Jahr}}<br />
|{{pfad2|Bundesstatistik|Jahr}}<br />
|= Bundesstatistik Ende der Beratung (falls beendet),<br />
>= Bundesstatistik Beginn der Beratung, <= aktuelles Jahr<br />
|<br />
|-<br />
|Bundesstatistik Beginn der Beratung<br />
|{{konfig|jghstat07.bg}}<br />
|{{pfad2|Bundesstatistik|Beginn}}<br />
|{{pfad2|Bundesstatistik|Beginn}}<br />
|< Bundesstatistik Ende der Beratung (falls beendet),<br />
>= Fallbeginn<br />
|<br />
|-<br />
|Bundesstatistik Ende der Beratung<br />
|{{konfig|jghstat07.e}}<br />
|{{pfad2|Bundesstatistik|Ende}}<br />
|{{pfad2|Bundesstatistik|Ende}}<br />
|> Bundesstatistik Beginn der Beratung,<br />
= Bundesstatistik Jahr<br />
|<br />
|}<br />
<br />
Anmerkungen:<br />
<br />
Änderungen sind immer nur bei einem laufendem Fall möglich<br />
<br />
=== Verwendung der Zeitangaben in den Auswertungen ===<br />
<br />
==== Tabelle Neumeldungen und Abschlüsse ====<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Spalte<br />
! Definition<br />
! Bemerkungen<br />
|-<br />
|Laufende am Monatsende<br />
|Fallbeginn (Anmeldedatum) < 1. des Folgemonats,<br />
kein ZdA-Datum oder ZdA-Datum >= 1. des Folgemonats<br />
|<br />
|-<br />
|Neu<br />
|Fallbeginn (Anmeldedatum) Monat = Monat<br />
|<br />
|-<br />
|davon ASD<br />
|Neu mit Zugangsmodus ASD<br />
|<br />
|-<br />
|Hauptfall<br />
|Bundesstatistik Ende Monat = Monat, Bundesstatistik kein Geschwisterfall<br />
|<br />
|-<br />
|Geschwisterfall<br />
|Bundesstatistik Ende Monat = Monat, Bundesstatistik Geschwisterfall<br />
|<br />
|-<br />
|abgeschl. Bundesstatistik<br />
|Bundesstatistik Ende Monat = Monat<br />
|<br />
|-<br />
|davon noch ohne Z.d.A.<br />
|Bundesstatistik Ende Monat = Monat, kein ZdA-Datum oder ZdA-Datum >= 1. des Folgemonats<br />
|<br />
|}<br />
<br />
==== Tabelle Neumeldungen und Abschlüsse pro Mitarbeiter ====<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Spalte<br />
! Definition<br />
! Bemerkungen<br />
|-<br />
|Übernommen<br />
|Summe aller Zuständigkeiten: Beginn Jahr < Jahr, Ende Jahr >= Jahr<br />
|<br />
|-<br />
|Neu<br />
|Summe aller Zuständigkeiten: Beginn Jahr = Jahr<br />
|<br />
|-<br />
|davon Fallbeginn<br />
|Neu, Fallbeginn (Anmeldedatum) = Zuständigkeit Beginn<br />
|<br />
|-<br />
|Laufend<br />
|Summe aller Zuständigkeiten: Beginn Jahr <= Jahr, kein Ende Jahr oder Ende Jahr > Jahr<br />
|<br />
|-<br />
|Beendet<br />
|Summe aller Zuständigkeiten: Ende Jahr = Jahr<br />
|<br />
|-<br />
|davon ZdA<br />
|Beendet, Ende Datum = ZdA-Datum <br />
|<br />
|}</div>Ebkushttps://www.ebkus.org/wiki/Zeitangaben_(Fallbeginn,_usw.)Zeitangaben (Fallbeginn, usw.)2014-01-15T13:11:12Z<p>Ebkus: </p>
<hr />
<div><br />
__FORCETOC__ <br />
<br />
=== Datenbankfelder für Zeitangaben ===<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Name<br />
! Tabelle.Feld<br />
! Woher initialer Wert<br />
! Wo Änderbar<br />
! Zusicherungen<br />
! Bemerkungen<br />
|-<br />
|Fallbeginn (synonym: Anmeldedatum)<br />
|{{konfig|fall.bg}}<br />
|{{pfad2|Neuaufnahme|Anmeldedatum}}, {{pfad2|Wiederaufnahme|Anmeldedatum}}<br />
|{{pfad3|Klientenkarte|Stand|Fallbeginn}}<br />
|< erster Leistung, < erstem Beratungskontakt, = erste Zuständigkeit Beginn<br />
|Anmeldedatum kann am Ende des Jahres liegen, erste Leistung am Beginn des folgenden<br />
|-<br />
|Fallnummer<br />
|{{konfig|fall.fn}}<br />
|Wird mit Anmeldedatum automatisch erzeugt<br />
|Nicht änderbar<br />
|Jahr in Fallnummer = Jahr in Anmeldedatum (erste Eingabe)<br />
|Das Jahr im Anmeldedatum kann nachträglich geändert werden, Fallnummer wird <strong>nicht</strong> nachgezogen.<br />
|-<br />
|Zu den Akten<br />
|{{konfig|fall.zda}}<br />
|{{pfad3|Klientenkarte|Stand|Zu den Akten}}<br />
|Nicht änderbar<br />
|= Fachstatistikjahr, = Bundesstatistikjahr, = letzte Zuständigkeit Ende<br />
|<br />
|-<br />
|Zuständigkeit Beginn<br />
|{{konfig|zustaendigkeit.bg}}<br />
|Fallbegin, Wiederaufnahme, {{pfad3|Klientenkarte|Bearbeiter|Beginn}}<br />
|{{pfad3|Klientenkarte|Bearbeiter|Beginn}}<br />
|Erste Zuständigkeit = Fallbeginn<br />
|<br />
|-<br />
|Zuständigkeit Ende<br />
|{{konfig|zustaendigkeit.e}}<br />
|ZdA, {{pfad3|Klientenkarte|Bearbeiter|Ende}}<br />
|{{pfad3|Klientenkarte|Bearbeiter|Ende}}<br />
|Letzte Zuständigkeit = ZdA<br />
|<br />
|-<br />
|Leistung Beginn<br />
|{{konfig|leistung.bg}}<br />
|Neuaufnahme, Wiederaufnahme, {{pfad2|Klientenkarte|Leistungen}}<br />
|{{pfad2|Klientenkarte|Leistungen}}<br />
|> Fallbeginn, < Leistung Ende<br />
|<br />
|-<br />
|Leistung Ende<br />
|{{konfig|leistung.e}}<br />
|{{pfad2|Klientenkarte|Leistungen}}<br />
|{{pfad2|Klientenkarte|Leistungen}}<br />
|> Leistung Beginn<br />
|<br />
|-<br />
|Beratungskontakt<br />
|{{konfig|beratungskontakt.k}}<br />
|{{pfad2|Klientenkarte|Beratungskontakte}}<br />
|{{pfad2|Klientenkarte|Beratungskontakte}}<br />
|> Fallbeginn<br />
|<br />
|-<br />
|Fachstatistik Jahr<br />
|{{konfig|fachstat.jahr}}<br />
|{{pfad2|Fachstatistik|Jahr}}<br />
|{{pfad2|Fachstatistik|Jahr}}<br />
|<br />
|<br />
|-<br />
|Bundesstatistik Jahr<br />
|{{konfig|jghstat07.jahr}}<br />
|{{pfad2|Bundesstatistik|Jahr}}<br />
|{{pfad2|Bundesstatistik|Jahr}}<br />
|= Bundesstatistik Ende der Beratung (falls beendet),<br />
>= Bundesstatistik Beginn der Beratung, <= aktuelles Jahr<br />
|<br />
|-<br />
|Bundesstatistik Beginn der Beratung<br />
|{{konfig|jghstat07.bg}}<br />
|{{pfad2|Bundesstatistik|Beginn}}<br />
|{{pfad2|Bundesstatistik|Beginn}}<br />
|< Bundesstatistik Ende der Beratung (falls beendet),<br />
>= Fallbeginn<br />
|<br />
|-<br />
|Bundesstatistik Ende der Beratung<br />
|{{konfig|jghstat07.e}}<br />
|{{pfad2|Bundesstatistik|Ende}}<br />
|{{pfad2|Bundesstatistik|Ende}}<br />
|> Bundesstatistik Beginn der Beratung,<br />
= Bundesstatistik Jahr<br />
|<br />
|}<br />
<br />
Anmerkungen:<br />
<br />
Änderungen sind immer nur bei einem laufendem Fall möglich<br />
<br />
=== Verwendung der Zeitangaben in den Auswertungen ===<br />
<br />
==== Tabelle Neumeldungen und Abschlüsse ====<br />
<br />
{|border="1" cellspacing="0" cellpadding="8" style="background-color:snow;" width="100%"<br />
|- align="left" style="background-color:aliceblue;"<br />
! Spalte<br />
! Definition<br />
! Bemerkungen<br />
|-<br />
|Laufende am Monatsende<br />
|Fallbeginn (Anmeldedatum) < 1. des Folgemonats,<br />
kein ZdA-Datum oder ZdA-Datum >= 1. des Folgemonats<br />
|<br />
|-<br />
|Neu<br />
|Fallbeginn (Anmeldedatum) Monat = Monat<br />
|<br />
|-<br />
|davon ASD<br />
|Neu mit Zugangsmodus ASD<br />
|<br />
|-<br />
|Hauptfall<br />
|Bundesstatistik Ende Monat = Monat, Bundesstatistik kein Geschwisterfall<br />
|<br />
|-<br />
|Geschwisterfall<br />
|Bundesstatistik Ende Monat = Monat, Bundesstatistik Geschwisterfall<br />
|<br />
|-<br />
|abgeschl. Bundesstatistik<br />
|Bundesstatistik Ende Monat = Monat<br />
|<br />
|-<br />
|davon noch ohne Z.d.A.<br />
|Bundesstatistik Ende Monat = Monat, kein ZdA-Datum oder ZdA-Datum >= 1. des Folgemonats<br />
|<br />
|}</div>Ebkus