EBKuS Virtuelle Maschine für VMware

3.1 Arbeiten auf der Kommandozeile

Grundsätzlich kann auf der EBKuS-VM nur mit der Kommandozeile gearbeitet werden, da keine grafische Oberfläche installiert ist.

Entweder man meldet sich direkt auf der virtuellen Konsole an (die einzige Möglichkeit, solange das Netzwerk nicht funktioniert), oder man verwendet ssh, was in der Regel komfortabler ist.

GNU/Linux:

ssh -l ebkus <IP-Nummer>

Windows: Das Programm putty kann man sich kostenlos herunterladen und installieren. Es handelt sich um einen vollwertigen ssh-Client.

In beiden Fällen erhält man nach der Anmeldung eine Konsole, in die man Befehle eingeben kann. Eine minimale Vertrautheit mit Befehlen wie ls, cd, rm, etc. ist hier von Vorteil :-)

Den Benutzer root für Operationen, die Administratorrechte erfordern, benötigt man nicht, da man jedem Befehl sudo voranstellen kann. Editieren einer Datei mit Administratorrechten:

sudo nano /etc/sshd_config

3.2 Benutzer und Passwort

Für die Arbeit mit EBKuS ist ein Benutzer ebkus eingerichtet. Das Passwort ist ebenfalls ebkus, das man mit dem Befehl passwd ändern kann.

Tip: Wenn man wiederum ein "einfaches" Passwort haben möchte, sollte man als Administrator das Passwort wechseln:

sudo passwd ebkus

Der Benutzer ebkus hat Administratorrechte, d.h. er kann Befehle durch voranstellen von sudo als Administrator ausführen, wobei er beim ersten Mal (in einer gewissen Zeitspanne) nach seinem eigenen Passwort gefragt wird.

3.3 Netzwerkkonfiguration

Für die regelmäßige Benutzung von EBKuS ist es unerlässlich, dass die EBKuS-VM immer dieselbe IP-Nummer hat. Ansonsten müsste man beim Zugriff über den Browser immer eine andere Adresse eintragen.

ethernet0.generatedAddress = "00:0c:29:c4:d7:19"

# The primary network interface
auto eth0
iface eth0 inet dhcp
#iface eth0 inet static
#   address 192.168.1.226
#   netmask 255.255.255.0
#   gateway 192.168.1.1
#   broadcast 192.168.1.255

# The primary network interface
auto eth0
#iface eth0 inet dhcp
iface eth0 inet static
   address 192.168.1.226
   netmask 255.255.255.0
   gateway 192.168.1.1
   broadcast 192.168.1.255

sudo /etc/init.d/networking restart

3.4 Shares

Das EBKuS Verzeichnis /home/ebkus der VM lässt sich als Netzlaufwerk auf dem Hostsystem (oder einem anderen Rechner im lokalen Netzwerk) wie eine Windows-Freigabe einbinden:

• Windows: im Explorer: Netzlaufwerk verbinden: \\<IP-Nummer>\ebkus

• Ubuntu Linux: im Datei-Browser: Datei --> mit Server verbinden

• Linux Kommandozeile: (geht nur, wenn Samba-Client installiert ist), z.B.:

  mount -t smbfs -o 'username=ebkus,password=ebkus' //<IP-Nummer>/ebkus /mnt/ebkus

Benutzer und Passwort ist ebkus. Das Passwort ändert sich nicht, wenn man das Linux-Benutzer Passwort mit passwd ändert. Man kann es wie folgt ändern:

sudo smbpasswd ebkus
... [man wird aufgefordert, das neue Passwort einzugeben]
sudo /etc/init.d/samba restart

3.5 Dateien editieren

Falls /home/ebkus als Share auf dem Host eingebunden ist, kann natürlich jeder Editor (außer Notepad, der mit Unix-Zeilenumbruch nicht klar kommt) auf dem Hostsystem verwendet werden, z.B. notepad++ (kann kostenlos heruntergeladen werden).

Auf der EBKuS-VM selbst gibt es nur die text-basierte Editoren emacs, vi und nano. Nano ist vollständig selbstdokumentierend und daher am einfachsten, wenn man die anderen nicht kennt.

3.6 Log-Dateien

Da verschiedene Dateien (insbesondere Log-Dateien) mit der Zeit sehr viel Platz einnehmen können, ist es für einen lange Zeit laufenden Server wichtig, dass automatisch und regelmäßig solche Dateien komprimiert und nach einer gewissen Zeit auch gelöscht werden. logrotate ist hierfür das einschlägige Programm auf einem GNU/Linux-System. Die EBKuS-VM ist so konfiguriert, dass sie ohne manuelle Wartung auf diesem Gebiet dauerhaft laufen kann.

Voraussetzung ist jedoch, dass die Maschine zu den Zeiten läuft, wo diese Wartungsprozesse aufgerufen werden. Diese Zeiten sind in der Datei /etc/crontab definiert:

# m h dom mon dow user  command
17 *    * * *   root    cd / && run-parts --report /etc/cron.hourly
25 17   * * *   root    test -x /usr/sbin/anacron || ( cd / && run-parts --report /etc/cron.daily )
47 17   * * 7   root    test -x /usr/sbin/anacron || ( cd / && run-parts --report /etc/cron.weekly )
52 17   1 * *   root    test -x /usr/sbin/anacron || ( cd / && run-parts --report /etc/cron.monthly )
#

Die 17 in der zweiten Spalte unter h definiert die Stunde, in der die Wartungsskripte aufgerufen werden. Zu dieser Zeit müsste EBKuS-VM also laufen. Hier kann man eine genehme Stunde eintragen.

Im Notfall kann man auch gelegentlich per Hand das entsprechende Skript anstossen:

sudo logrotate  /etc/logrotate.conf

Die Log-Dateien der EBKuS-Instanzen (siehe unten) (/home/ebkus/ebkus_installation/ebkus/<Instanzname>/<Instanzname>.log) sind in das logrotate-Verfahren eingebunden (Konfigurationseinträge im Verzeichnis /etc/logrotate.d/). Log-Dateien für EBKuS-Instanzen werden 52 Wochen aufbewahrt, ehe sie gelöscht werden.

3.7 Updates

Ein gelegentliches:

sudo apt-get update

gefolgt von:

sudo apt-get upgrade

hält eine EBKuS-VM mit Internetzugang auf dem neuesten Stand, insbesondere was Sicherheitslücken betrifft. (Das kann auch automatisiert werden. Ich bin mir nicht ganz klar darüber, ob die EBKuS-VM das automatisch macht.)

4.1 Verzeichnisse

Die gesamte EBKuS-Installation findet sich beim Benutzer ebkus unter /home/ebkus.

Verzeichnisse (siehe Handbuch Kapitel 5.3):

• Installationsverzeichnis: /home/ebkus/ebkus_installation/

• Homeverzeichnis: /home/ebkus/ebkus_installation/ebkus/

• Backupverzeichnis: /home/ebkus/backups

4.2 Installierte EBKuS-Instanzen

Auf der VM sind vier EBKuS-Instanzen konfiguriert:

• demo (mit Demodaten)

• demo_berlin (mit Demodaten und dem Berliner Straßenkatalog)

• demo_braunschweig (mit Demodaten und Braunschweiger Straßenkatalog)

• test1 (ohne Demodaten)

Die Instanzen werden automatisch beim Hochfahren gestartet und sind auf dem Host-Rechner und im lokalen Netz unter folgender URL ansprechbar:

https://<IP-Nummer>/ebkus/<Instanzname>/

<IP-Nummer> ist die IP-Adresse der EBKuS-VM.

Anmelden bei den drei Demo-Instanzen:

• als Administrator: Benutzer: Admin, Passwort: Admin

• als Bearbeiter: Benutzer: test, Passwort: test

Anmelden bei der leeren Instanz test1 ist nur als Administrator möglich:

• Benutzer: Admin, Passwort: Admin

Als Administrator können dann weitere Benutzer eingerichtet werden.

4.3 Instanzen starten/anhalten/Status abfragen

Zusätzlich zu den im Handbuch beschriebenen Verfahren gibt es ein Skript ebkusctl, mit dem sich die einzelnen EBKuS-Instanzen steuern lassen:

ebkusctl <Instanzname oder all> <start|restart|stop|status>

z.B.:

ebkusctl help
ebkusctl all stop
ebkusctl demo_berlin status

Alle Instanzen sind standardmäßig als Dienste eingerichtet, die beim Hochfahren des Systems automatisch gestartet und beim Herunterfahren automatisch angehalten werden. Zur Fehlersuche empfiehlt sich das im Handbuch beschriebene Verfahren, z.B. für die Instanz demo_berlin:

cd /home/ebkus/ebkus_installation/ebkus/demo_berlin
./status.py
./stop.py
./start.py --console

Eine auf diese Weise gestartete Instanz schreibt ihre Ausgabe auf die Konsole anstatt in die Log-Datei.

4.4 Einrichten einer neuen EBKuS-Instanz

Siehe im Handbuch besonders die Kapitel Konfiguration und configure.py.

1. Mit einem Texteditor die neue Instanz in die Konfigurationsdatei eintragen:

   cd /home/ebkus/ebkus_installation/ebkus/
   nano ebkus.conf

   Zu beachten:

   • Wenn der Instanzname mit demo_ anfängt, werden automatisch Beispieldaten generiert. Eine solche Instanz ist für die Produktion ungeeignet.

   • Unbedingt eine noch nicht verwendete Port-Nummer für die neue Instanz vergeben!

   • Hinweise auf neue, im Handbuch noch nicht dokumentierte Konfigurationsvariablen finden sich in der Versionsgeschichte bzw. in der Datei:

     /home/ebkus/ebkus_installation/ebkus/doc/VERSIONS_GESCHICHTE.html

2. Das configure.py-Skript ausführen:

   cd /home/ebkus/ebkus_installation/ebkus/
   ./configure.py <Instanzname>

3. Apache neu starten:

   sudo apache2ctl restart

4. Instanz starten:

   ebkusctl <Instanzname> start

4.5 Löschen einer EBKuS-Instanz

Siehe im Handbuch das Kapitel uninstall.py.

1. Instanz anhalten:

   ebkusctl <Instanzname> stop

2. uninstall.py-Skript ausführen:

   cd /home/ebkus/ebkus_installation/ebkus/
   ./uninstall.py .. <Instanzname>

3. Mit einem Texteditor die gelöschte Instanz aus der Konfigurationsdatei entfernen:

   cd /home/ebkus/ebkus_installation/ebkus/
   nano ebkus.conf

4. Apache neu starten:

   sudo apache2ctl restart

4.6 Datenbank Passworte

Die Datenbank-Passworte für die EBKuS-Instanzen stehen in der Konfigurationsdatei ebkus.conf. Der Datenbank-Benutzer root hat kein Passwort. Ein Sicherheitsrisiko stellt das nicht dar, da die Datenbank so konfiguriert ist, dass sie nur lokal von der EBKuS-VM aus angesprochen werden kann.

Direkter shell-Zugriff auf die Datenbank:

mysql -uroot

4.7 Backups

Zusätzlich zu dem im Handbuchkapitel Datensicherung beschriebenen Verfahren gibt es das Skript ebkusdump, das z.B. so aufgerufen werden kann:

ebkusdump all /home/ebkus/backups

Damit wird für jede Instanz eine Datensicherung in das angegebene Backup-Verzeichnis geschrieben. Weitere Aufrufmöglichkeiten:

ebkusdump help
ebkusdump demo_berlin /home/ebkus

Wie im Handbuchkapitel Datensicherung beschrieben, kann man einen Cron-Job einrichten, der täglich automatisch ein Backup für alle Instanzen in das Backup-Verzeichnis durchführt. Im crontab für den Benutzer EBKuS stehen bereits die Zeilen:

# Jeden Tag 11:31h ausfuehren
#31 11 * * * $HOME/bin/ebkusdump all $HOME/backups &> /dev/null

Wenn man von der letzten Zeile das Kommentarzeichen entfernt, wird täglich 11:31 eine Sicherung aller Instanzen durchgeführt.

Crontab ansehen/verändern:

crontab -l
crontab -e

Wenn ein solches automatische Backup eingerichtet wird, ist natürlich dafür zu sorgen, dass die Backups auf ein physisch getrenntes Medium kopiert werden, was allerdings auch automatisiert werden könnte.

Weiterhin müssen im Backup-Verzeichnis alte Backups regelmäßig gelöscht werden, damit der Festplattenbedarf nicht ständig wächst. Das Verzeichnis /home/ebkus/backups ist nicht in logrotate-Verfahren eingebunden!