2 Installation

Dieses Kapitel beschreibt die Installation (2) und Konfiguration von BAO.web und AuE.web.
BAO.web ist der eigentliche Dienst zum Führen von Besonderen Aufbauorganisationen.
AuE.web ist ein eigenständiger Dienst, der Alarm- und Einsatzunterlagen (1.2.7) zur Verfügung stellt, die direkt von BAO.web aus genutzt werden können.
Der BAO-Dienst wird vom AuE-Dienst über ablaufende Aktionen informiert, die dann automatisch im BAO-System protokolliert werden.
Unterstützt werden die Betriebssysteme (1.1.1) Windows 2000, Windows XP sowie Linux.
Die zur Installation benötigten Schritte sind für Linux und Windows unterschiedlich:

Führen Sie bitte die gesamte Installation (2) und Konfiguration als Administrator (Windows) bzw. root (Linux) durch (für den Erstbetrieb (2.7) ist das nicht mehr erforderlich).

2.1 Systemvoraussetzungen

Voraussetzung für den Betrieb von BAO.web-Server ist ein Server-Rechner unter Microsoft Windows-Betriebssystem (ab Windows 2000) mit einem installierten Microsoft Internet-Information-Server (IIS) oder unter Linux mit einem installierten Apache-Webserver (ab Version 2.0.49).

2.2 Installieren der Dateien

BAO.web kann von http://www.eldeo.de/poe.htm herunter geladen werden: Melden Sie sich in BAO.web an und folgen Sie den Instruktionen auf der Begrüßungsseite. Sie erhalten dann ein Zip-Archiv, das die gesamte Software enthält. 
  1. Erzeugen Sie auf dem Server-Rechner ein Installationsverzeichnis, z.B. das Verzeichnis c:\bao für Windows oder /opt/bao für Linux.
  2. Kopieren Sie alle Dateien des Archivs in das Installationsverzeichnis.
    Bei einer Windows-Insatllation werden die für Linux benötigten Komponenten automatisch gelöscht.
    Bei einer Linux-Insatllation werden die für Windows benötigten Komponenten automatisch gelöscht.

2.3 Installation unter Windows

2.3.1 Installieren und Starten des Serverdienstes

BAO.web wird durch einen Serverdienst betrieben, der an einen Webserver gekoppelt wird. Nach der Installation (2) muß der Dienst in der Dienstesteuerung noch auf automatisches Starten gesetzt werden.
  1. Öffnen Sie das BAO.web-Installationsverzeichnis.
  2. Führen Sie die Datei "win32install.cmd" aus - ein Doppelklick auf die Datei genügt.
    Die Serverdienste werden hiermit installiert und gestartet.
  3. Wechseln Sie in die Windows-Dienstesteuerung (Systemsteuerung->Verwaltung->Dienste).
    In der Liste der Dienste sind jetzt die Einträge "DEMO_BAO.web" und "DEMO_AuE.web" aufgeführt.
     
    Führen Sie folgende Schritte nacheinander für beide Dienste aus
     
  4. Öffnen Sie die Eigenschaften des Dienstes (Rechtsklick auf den Eintrag->Eigenschaften).
  5. Setzten Sie in der Registerkarte 'Allgemein' den Starttyp auf "automatisch". Dadurch steht BAO.web sofort mit dem Neustart des Rechners zur Verfügung.
  6. Wechseln Sie auf die Registerkarte 'Wiederherstellen'.
    Wählen Sie in den Feldern 'Erster Fehlschlag', 'Zweiter Fehlschlag' und 'Weitere Fehlschläge' den Wert 'Dienst neu starten'.
    Geben Sie in 'Dienst nach ... Minuten neu starten' den Wert 0 ein.
    Dadurch werden nach einem Systemfehler BAO.web und AuE.web sofort wieder zur Verfügung gestellt.
  7. Schließen Sie das Fenster mit "OK".
Die Konfiguration der Serverdienste ist damit beendet. Sie können die Dienstesteuerung verlassen.

2.3.2 Konfiguration des Webservers

Verwandte Themen
2.4.1Installieren und Starten des Serverdienstes
Um den BAO.web-Serverdienst an den Internet-Information-Server (IIS) zu koppeln, muß in der Steuerungskonsole des IIS ein virtuelles Verzeichnis mit Namen BAO angelegt werden, welches auf das BAO.web-Installationsverzeichnis verweist. Das Startdokument des Verzeichnisses wird die Datei baoportal.htm. Der AuE-Server benutzt dieselben Einstellungen mit und muß daher nicht weiter konfiguriert werden.
  1. Öffnen Sie die Management-Konsole des IIS (Systemsteuerung->Verwaltung->Internet-Informationsdienste).
  2. Öffnen Sie den Ordner Websites. Hier finden Sie die Standardwebsite.
  3. Klicken Sie mit der rechten Maustaste auf die Standardwebsite und wählen Sie die Option Neu->Virtuelles Verzeichnis.
    Es öffnet sich ein Assistent, der Sie durch die Einstellungen führt.
  4. Geben Sie unter "Alias" den Namen BAO ein. Bestätigen Sie mit "Weiter".
  5. Unter "Verzeichnis" geben Sie Ihr BAO.web-Installationsverzeichnis - also z.B. c:\bao\ - an. Bestätigen Sie mit "Weiter".
  6. Aktivieren Sie unter "Zugriffsberechtigungen" die Optionen "Lesen" und "Ausführen". Die übrigen Optionen können deaktiviert werden.
  7. Klicken Sie auf "Fertigstellen", um den Assistenten zu beenden.
    Unter der Standardwebsite ist jetzt der Eintrag "BAO" zu finden.
  8. Zeigen Sie die Eigenschaftenseite des Eintrags "BAO" an (Rechtsklick auf den Eintrag->Eigenschaften).
  9. Stellen Sie in der Registerkarte "Virtuelles Verzeichnis" sicher, daß die Ausführungsberechtigungen für "Skripts und ausführbare Dateien" gesetzt sind.
  10. Wechseln Sie zur Registerkarte "Dokumente", und entfernen Sie alle Einträge aus der Liste "Standarddokumente".
  11. Fügen Sie der Liste den Eintrag "baoportal.htm" hinzu. Bestätigen Sie mit "OK". Sie verlassen das Eigenschaftenfenster.
  12. Stellen Sie sicher, daß der Webserver gestartet ist: Klicken Sie mit der rechten Taste auf "Standardwebsite". Wenn die Option "Start" zur Verfügung steht, führen Sie sie aus. Ist die Option deaktiviert, läuft der Server bereits.
Die Konfiguration des Webservers (2.3.2) ist damit beendet. Sie können die IIS-Konsole verlassen.

2.4 Installation unter Linux

2.4.1 Installieren und Starten des Serverdienstes

BAO.web und AuE.web werden durch Serverdienste betrieben, die an einen Webserver gekoppelt werden. Nach der Installation (2) werden die Dienste automatisch in den Runlevels 3 und 5 gestartet. Benutzen Sie bei Bedarf den jeweiligen Runlevel-Editor Ihrer Distribution, um diese Einstellungen zu ändern.
  1. Öffnen Sie das BAO.web-Installationsverzeichnis in einer Konsole.
  2. Führen Sie auf der Konsole folgenden Befehl aus:
     
    sh linuxinstall.sh
     
    Die Serverdienste werden hiermit installiert und gestartet.
Die Konfiguration der Serverdienste ist damit beendet. Sie finden die Startskripten DEMO_BAO.web und DEMO_AuE.web in /etc/init.d/.
Unter diesem Namen werden die Dienste auch im Runlevel-Editor bzw. Dienstemanager aufgeführt.

2.4.2 Konfiguration des Webservers

Um den BAO.web-Serverdienst an den Apache-Webserver zu koppeln, muß in der Apache-Konfigurationsdatei httpd.conf ein Alias angelegt werden, der auf das Installationsverzeichnis verweist. Außerdem muss ggf. das mit BAO.web ausgelieferte ISAPI-Modul für den Apache installiert und geladen werden.
Der AuE-Server benutzt dieselben Einstellungen mit und muß daher nicht weiter konfiguriert werden.

2.4.2.1 Installation des ISAPI-Moduls

Das ISAPI-Modul muss vom mitgelieferten Archiv "isapi_module.tar" in das Module-Verzeichnis des Apache-Webservers extrahiert werden.
Dieses Verzeichnis istFühren Sie zum extrahieren des Moduls im BAO-Installationsverzeichnis folgenden Konsolenbefehl aus:
 
tar -xvf isapi_module.tar MODULVERZEICHNIS
 
MODULVERZEICHNIS entspricht dabei dem vollständigen Pfad zum o. g. Verzeichnis der Apache-Module. Er muß mit einem "/" enden.

2.4.2.2 Anpassen der Konfigurationsdatei

Ähnlich wie das Module-Verzeichnis, kann sich auch die Konfigurationsdatei für den Apache-Webserver an verschiedenen Orten befinden.
Der Name der Datei ist httpd.conf und kann gefunden werdenFügen Sie folgende Zeilen am Ende der Datei httpd.conf an:
 
# Laden des ISAPI-Moduls
LoadModule isapi_module MODULVERZEICHNIS/libmodisapi.so
 
# Alias für BAO.web
Alias /BAO "BAO-VERZEICHNIS"
Alias /bao "BAO-VERZEICHNIS"
<DIRECTORY "BAO-VERZEICHNIS">
  Options Indexes FollowSymLinks MultiViews ExecCGI
  AllowOverride None
  Order allow,deny
  Allow from all
  AddHandler isapi-isa .dll
  DirectoryIndex baoportal.htm
</DIRECTORY>
 
MODULVERZEICHNIS entspricht dabei dem vollständigen Pfad zum o. g. Verzeichnis der Apache-Module,
BAO-VERZEICHNIS entspricht Ihrem BAO.web-Installationsverzeichnis, also z.B. /opt/bao. Achten Sie auf die Anführungszeichen!
 
Damit ist die Konfiguration des Webservers (2.3.2) abgeschlossen. Damit die Änderungen wirksam werden, muss der Apache-Server neu gestartet werden.

2.5 Aufruf des Programms

Das Programm kann von jedem Rechnerarbeitsplatz, der über eine Netzwerkverbindung zum BAO-Rechner verfügt, aufgerufen werden.
Öffnen Sie hierzu einen Webbrowser (z.B. Internet-Explorer) und geben Sie die Adresse "http://RECHNERNAME/BAO" ein, wobei RECHNERNAME dem Netzwerknamen oder der IP-Adresse des BAO-Rechners entspricht. Sie gelangen zur BAO.web-Anmeldung.

2.6 Konfiguration des BAO-Servers

Verwandte Themen
4.1Ansicht 'Konfiguration des BAO-Servers'
BAO.web beinhaltet ein eigenständiges Modul zur Server-Konfiguration. Um die Konfigurationsseiten zu erhalten, rufen Sie die Adresse "http://RECHNERNAME/BAO/gate.dll?op=config" auf, wobei RECHNERNAME dem Netzwerknamen oder der IP-Adresse des BAO-Rechners entspricht.
Sie erhalten eine Anmeldeseite für die Konfiguration. Melden Sie sich mit folgenden Daten an:
Benutzername:Administrator
Kennwort:01234
Dieses Benutzerkonto (2.7.1.1) ist nicht in der Benutzerdatenbank enthalten, es dient ausschließlich der Konfiguration.
Nach der erfolgreichen Anmeldung erhalten Sie Ansicht 'Konfiguration des BAO-Servers' (4.1).
    System
  1. Geben Sie im Feld "Server-Kürzel" einen eindeutigen Kurznamen Ihres BAO-Servers ein.
    Der Name darf höchstens 5 Zeichen lang sein.
  2. Im Feld "Eigene URL" geben Sie den kompletten HTTP-Zugriffspfad auf die BAO-Anwendung ein. Der Pfad muß mit "http://" beginnen und auf "gate.dll" enden.
    Beispiele: "http://localhost/BAO/gate.dll", "http://192.168.1.5/BAO/gate.dll"
  3. Tragen Sie im Feld IPGate-Serveradresse eine Adresse der Form SERVER:PORTein.
    SERVER steht dabei für den Namen oder die IP-Adresse des Servers, auf dem die BAO-Anwendung installiert ist.
    Es kann "localhost" verwendet werden, wenn der Webserver und der BAO-Server auf dem gleichen Rechner installiert sind.
    PORT muß eine freie Portnummer auf dem BAO-Rechner sein. Auf diesem Port findet die Kommunikation zwischen BAO-Server und Webserver statt.
  4. Wenn Sie die Maßnahmenkataloge von AuE.web benutzen wollen, geben Sie im Feld "URL des AuE-Servers" den kompletten HTTP-Zugriffspfad auf die AuE-Anwendung ein. Der Pfad muß mit "http://" beginnen und auf "gate.dll" enden.
    Beispiele: "http://localhost/AuE/gate.dll", "http://192.168.1.5/AuE/gate.dll"
  5. Im Feld "IP-Erreichbarkeit de POE-Servers" geben Sie eine Adresse der Form SERVER:PORT ein.
    SERVER steht dabei für den Namen oder die IP-Adresse des POE-Servers.
    PORT steht für die Portnummer, über die der POE-Server Anfragen entgegen nehmen kann.
    Der Inhalt des Feldes entspricht damit der "IP-Erreichbarkeit" in den POE-Systemeinstellungen.
  6. Im Feld "Weitere BAO-Server" werden die vollständigen HTTP-Zugriffspfade weiterer BAO-Server angegeben.
    Die Pfade werden zeilenweise in das Feld eingetragen. Jeder Pfad muß mit "http://" beginnen und auf "gate.dll" enden.
    Diese Server werden zur Auswahl angeboten, wenn eine untergeordnete BAO verknüpft werden soll.
     
    7. Protokolltabelle
  7. Geben Sie im Feld "Aktualisierungsintervall" die Zeit in Sekunden ein, nach der die Protokolltanelle automatisch aktualisiert wird.
     
    8. Administratorkonto
  8. Im Feld "Benutzername für die Konfiguration" können Sie den Benutzernamen ändern, mit dem die Server-Konfiguration geöffnet wird.
    Achtung: Dieses Konto ist vollkommen eigenständig und gilt nur für die Server-Konfiguration. Es ist nicht in der Benutzerdatenbank vorhanden!
  9. Im Feld "Passwort für die Konfiguration" können Sie das Passwort für das o.g. Administratorkonto ändern.

2.7 Erstbetrieb

Nach der Installation (2) müssen noch einige Schritte ausgeführt werden, um ein sinnvolles Arbeiten mit dem Programm zu ermöglichen.
Lesen Sie hierzu bitte auch die zugehörigen Abschnitte der Benutzerdokumentation.

2.7.1 Voreinstellungen

2.7.1.1 Benutzerkonto

Verwandte Themen
2.6Konfiguration des BAO-Servers
BAO.web verfügt über eine eigene, von Windows unabhängige Benutzerverwaltung.
Die Benutzerdatenbank enthält anfangs nur einen Benutzer mit vollen Zugriffsrechten. Benutzen dieses Konto für die erste Anmeldung:
Benutzername:Administrator
Kennwort:01234
Sie können - und sollten - das Kennwort nach der Installation (2) verändern. Das Konto sollte nicht gelöscht werden!
Zum Verwalten von Benutzerkonten wählen Sie nach der Anmeldung im Hauptmenü den Menüpunkt "Systemverwaltung (1.2.6)" und rufen auf der folgenden Seite die Benutzerverwaltung auf.
Legen Sie Benutzerkonten für alle Personen an, die Zugriff auf BAO.web erhalten sollen. Die Benutzer können in Gruppen mit gleichen Berechtigungen zusammengefasst werden.

2.7.1.2 Kategorien

Verwandte Themen
2.6Konfiguration des BAO-Servers
3.21Ablauf 'Kategorien verwalten'
4.34Ansicht 'Kategorien verwalten'
Standardmäßig enthält die Datenbank der Demoversion eine Beispielkategorie, die willkürlich zusammengestellt wurde.
Zum Verwalten von Kategorien (2.7.1.2) wählen Sie nach der Anmeldung im Hauptmenü den Menüpunkt "Systemverwaltung (1.2.6)" und rufen auf der folgenden Seite die Kategorieverwaltung auf.
Hier können Kategorien erstellt oder entfernt werden.

2.7.1.3 BAO- und Protokolltabelle

Die Systemtabellen für BAO-Ereignisse sowie Protokoll enthalten keine Beispieldaten.
Zum Anlegen einer BAO wählen Sie im Hauptmenü den Menüpunkt "BAO anlegen" aus.