Linux Installation

GNU/Linux

Voraussetzungen:

• Python und MySQL-Python sind bereits installiert.
• Die MySQL-Datenbank ist installiert und Sie haben das Recht, in MySQL neue Datenbanken anzulegen (d.h. Sie können sich als Benutzer root bei der Datenbank anmelden).
• Der Apache-Webserver ist installiert und SSL-fähig über mod_ssl. Sie verfügen über die nötigen Rechte, um die Apache-Konfigurationsdatei httpd.conf zu modifizieren.
• Eine EBKuS-Distribution. Falls diese nicht vorhanden ist, kann man sie selber erstellen mit dem Skript `create_cd.py`_oder von |dist_url| herunterladen (ca. 70MB).

Schritte:

1. `Installationsverzeichnis`_ einrichten, z.B. /home/user/ebinst:

 mkdir /home/user/ebinst

1. In das `Distributionsverzeichnis`_ gehen (z.B. /home/user/ebkus-cd/ebkus-3.3; man könnte hier auch direkt von der CD arbeiten):

 cd /home/user/ebkus-cd/ebkus-3.3

1. EBKuS-Konfiguration erzeugen:

 python install.py --config /home/user/ebinst

1. Erzeugte Konfigurationsdatei /home/user/ebinst/ebkus/ebkus.confanpassen (siehe `Konfiguration`_).
2. EBKuS und alle in der Konfigurationsdatei definierten Instanzen installieren und konfigurieren:

 python install.py /home/user/ebinst

Für jede in der Konfiguration definierten Instanz gibt es dann ein `Instanzverzeichnis`_:

/home/user/ebinst/ebkus/Instanzname

Die Meldungen des Installationsskriptes stehen auch in der Datei /home/user/ebinst/install.log.

1. (als root) Die in Schritt 5. erzeugte Datei /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:

 Include /home/user/ebinst/ebkus/ebkus_httpd.conf

1. (als root) Den Apache-Webserver neustarten, damit die modifizierte Konfiguration berücksichtigt wird, z.B. bei SuSE:

 rcapache restart

1. Eine konfigurierte EBKuS-Instanz testen, z.B. die Instanz demo:

 cd /home/user/ebinst/ebkus/demo 
 ./start.py --console

Der gestartete Server gibt Meldungen auf die Konsole aus.

1. Über einen Browser mit der Instanz demo arbeiten (anstatt demo auch mit jeder anderen in der `Konfiguration`_definierten Instanz):

 https://localhost/ebkus/demo/cgi/do/login

Die Login-Maske kann auch über eine vorgeschaltete Eingangsseite erreicht werden, die für jede Instanz generiert wird:

 https://localhost/ebkus/demo/index.html

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 htdocs/index.html zu finden.

Als Administrator anmelden: Benutzer Admin, Passwort Admin. Als angemeldeter Administrator können Sie weitere Benutzer anlegen.

Die Instanzen demo bzw. 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 test, Passwort test bzw. Benutzer verw, Passwort verw.

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.:

 https://192.168.1.92/ebkus/demo/index.html https://192.168.1.92/ebkus/demo/cgi/do/login

1. (als 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:

 cd /home/user/ebinst/ebkus/demo cp ebkus_demo /etc/init.d

Die Links für die Run-Level manuell setzen oder, z.B. bei SuSE, den Run-Level-Editor verwenden.

1. In einer Produktionsinstanz die Anwendung einrichten, siehe Einrichtung der Anwendung im Handbuch.

- Apache richtig löschen, so dass frische Konfig kommt:

- sudo dpkg --purge --force-remove-reinstreq apache2.2-common

So geht richtiges uninstall mit Konfiguration: apt-get remove ––purge *paketname*

- download mit wget auf dem ubuntu server

Apache Konfiguration

cd /etc/apache2/mods-enabled sudo ln -s ../mods-available/ssl.conf ssl.conf sudo ln -s ../mods-available/ssl.load ssl.load

cd /etc/apache2/sites-enabled sudo ln -s /home/ebkus/ebkus_installation/ebkus/ebkus_httpd.conf ebkus-ssl