Installer
Der ecaros-Installer wird ausschließlich von Classic-Kunden, zum Einspielen der Updates für das ecaros-System, benötigt. Nach erstmaliger Konfiguration durch einen Mitarbeiter des ECAROS - Supports kann der EDV-Betreuer selbstständig und zu einem von Ihm frei wählbaren Zeitpunkt (zum Beispiel Nachts oder am Wochenende) die Aktualisierungen des ecaros-Systems durchführen. Der ecaros-Installer steht erstmalig zum Update auf die Version 3.0.0 des ecaros-Systems zur Verfügung und ist kumulativ. Kumulativ bedeutet, dass jede Version des ecaros-Installer alle vorherigen Versionen enthält und somit nicht alle Zwischenversionen eingespielt werden müssen um auf die aktuellste Version zu wechseln.
| Beim Update auf 3.0.0 unbedingt beachten |
|---|
| Bei der Aktualisierung mit dem ecaros-Installer auf Version 3.0.0 wird für die Datenbanken die letzte Bugfix-Version (aktuell 2.2.9) aus der 2.2.x Reihe vorausgesetzt, da ansonsten wichtige Datenbankupdates verloren gehen. |
Inhaltsverzeichnis |
Voraussetzungen
Um eine Aktualisierung mit dem ecaros-Installer erfolgreich durchführen zu können müssen folgende Voraussetzungen erfüllt sein:
- Das Sun JDK 1.5 (oder höher) muss installiert und die Umgebungsvariable JAVA_HOME auf das Java-Installationsverzeichnis gesetzt sein
- Der Firebird 2.x Datenbankserver (SuperServer oder Classic) muss installiert und gestartet sein
- Der Jboss-Applicationserver darf nicht gestartet sein
- Die Verzeichnisse die für die Backups gewählt wurden müssen mindestens so viel freien Platz haben wie die Verzeichnisse für Jboss, Etka, Etos und die Datenbank aktuell benötigen
- Der Benutzer mit dem die Aktualisierung durchgeführt wird muss in die gewählten Verzeichnisse schreiben dürfen
Funktionsweise
Der ecaros-Installer kennt zwei Funktionsweisen:
- Die erste Funktionsweise setzt eine graphische Oberfläche zur Konfiguration und Durchführung der Aktualisierung voraus. Diese Funktionsweise bietet sich auch dann an, wenn der Firebird-Datenbankserver und der ecaros-Server auf unterschiedlichen Systemen laufen, die aber beide über eine graphische Oberfläche verfügen. In diesem Fall muss der ecaros-Installer einmal auf dem System mit dem ecaros-Server und ein weiteres Mal auf dem System mit dem Firebird-Datenbankserver ausgeführt werden.
- Die zweite Funktionsweise führt ausschließlich die Aktualisierung anhand einer vorher, auf einem anderen System mit graphischer Oberfläche, erstellten Konfigurationdatei durch. Diese Funktionsweise setzt keine graphische Oberfläche voraus. Um diese Funktionsweise zu wählen muss der Aufruf für den ecaros-Installer (in der Konsole) folgendermaßen lauten: "java -jar ecaros2-installer.jar -nogui". Die zu verwendende Konfigurationsdatei muss sich im Heimat-Verzeichnis des aktuellen Benutzers im Ordner ".ecaros2" befinden und der Name muss "installer_configuration.xml" lauten.
Konfiguration und Durchführung der Aktualisierung mit graphischer Oberfläche
Der komplette Vorgang teilt sich in mehrere Schritte auf. Dabei werden im ersten Schritt allgemeine Hinweise zur aktuellen Version des ecaros-Installer, sowie ein Changelog der Änderungen die in der aktuellen Version enthalten sind, angezeigt. Der letzte Schritt führt die eigentlichen Aktualisierungen durch. Bei den dazwischen liegenden Schritte wird die Konfiguration des ecaros-Systems vorgenommen. Im folgenden findet sich eine Erläuterung der einzelnen Konfigurationsschritte.
Allgemeine Einstellungen
Bei diesem Schritt wählen Sie die Komponenten zur Aktualisierung bzw. Installation auf dem aktuellen System. Zu jeder ecaros-Installation gehört mindestens der Jboss-Applicationserver, sowie die Firebird Datenbanken. Die Installation des Etka und Etos Socketserver ist optional. In das Backupverzeichnis werden die Backups des Jboss Applicationservers, des Etka Socketservers und des Etos Socketserver gespeichert. Für die Backups der Firebird Datenbanken können Sie in einem späteren Schritt eigene Backupverzeichnisse wählen.
Wird die oben beschriebene zweite Funktionsweise des ecaros-Installer verwendet, darf keine der Komponenten ausgewählt sein. Beim letzten Schritt, also der eigentlichen Aktualisierung/Installation, werden dann entsprechend auch keine Komponenten aktualisiert. Das Backupverzeichnis muss in diesem Fall ein auf dem Zielsystem vorhandenes Verzeichnis sein.
Firebird Datenbankserver
In diesem Schritt geben Sie die Pfade zu den benötigten Tools (gbak zum Erstellen der Datenbankbackups und isql zum Erstellen neuer Datenbanken) des Firebird-Datenbankservers, sowie die für ECAROS benötigten Datenbanken an. Wenn Datenbanken konfiguriert werden die noch nicht existieren, dann werden diese im letzten Schritt der Installation angelegt und die Tabellenstruktur erzeugt. Die erstellten Datenbanken haben dann noch keinen Inhalt und können so noch nicht verwendet werden. Katalogdatenbanken können mit Hilfe des ecaros-Admin gefüllt werden, Datenbanken vom Typ Hauptmandant, Integration, AccountManager und ConnectionProperties nur durch einen Mitarbeiter des ECAROS - Supports. Es muss mindestens eine Datenbank vom Typ Hauptmandant und eine weitere Datenbank vom Typ Integration konfiguriert werden. Alle anderen Datenbanktypen sind optional.
Durch einen Klick auf den Knopf Hinzufügen kann eine neue Datenbank konfiguriert werden. In dem erscheinenden Dialog kann die Konfiguration der Datenbank vorgenommen werden. Nach erfolgreicher Konfiguration erscheint der Eintrag für die Datenbank in der Liste der Datenbanken.
Durch einen Klick auf den Knopf Bearbeiten kann die in der Liste der Datenbanken ausgewählte Konfiguration angepasst werden. Die gewünschte Konfiguration kann auch angepasst werden in dem in der Liste der Datenbanken der entsprechende Eintrag doppelt angeklickt wird. Nach Abschluss der Änderung der gewählten Konfiguration wird der Eintrag in der Liste der Datenbanken aktualisiert.
Durch einen Klick auf den Knopf Löschen der Konfiguration einer Datenbank werden die in der Liste der Datenbanken gewählten Einträge gelöscht. Es können mehrere Einträge auf einmal ausgewählt und gelöscht werden. Das Löschen der gewählten Konfiguration(en) beeinflusst die eigentlichen Datenbankdateien nicht, diese bleiben unverändert erhalten.
Datenbank-Konfigurationsdialog
Wählen Sie im sich öffnenden Fenster zunächst den Typ der Datenbank aus und geben anschließend den Pfad zur Datenbankdatei (*.fdb) an. Dazu klicken Sie rechts neben dem Textfeld auf den Knopf und wählen in dem sich öffnenden Öffnen-Dialog die Datenbankdatei aus und bestätigen mit Ok. Der Pfad für die Backupdatei wird mit einem Standardwert gefüllt. Bitte überprüfen Sie ob es sich um den gewünschten Pfad handelt und passen den Pfad gegebenenfalls an. Falls die zu konfigurierende Datenbank noch nicht existiert wählen Sie im Öffnen-Dialog zunächst den Ordner in dem die Datenbank erstellt werden soll aus und fügen, nach dem Sie den Öffnen-Dialog mit Ok bestätigt haben, den gewünschten Namen (inkl. Endung .fdb) für die Datenbankdatei an den Pfad an. Der Pfad zur Backupdatei wird, nach Verlassen des Textfeldes, mit einem Standardwert gefüllt. Bitte überprüfen Sie auch in diesem Fall ob es sich um den gewünschten Pfad handelt und passen den Pfad gegebenenfalls an. Bitte tragen Sie dann als letztes das Passwort, dass Sie bei der Installation des Firebird Datenbankservers angegeben haben in das entsprechende Feld ein. Die Werte in den Feldern Host, Benutzer und Kodierung können Sie in der Regel unverändert lassen.
Da es für Katalog-Datenbanken nicht erforderlich ist vor der Aktualisierung ein Backup zu erstellen, können und sollten Sie für diese Datenbanken den Pfad zur Backupdatei leer lassen. Dies bewirkt, dass kein Backup der Datenbank vor der Aktualisierung erstellt wird und spart dadurch einiges an Zeit.
Jboss Applicationserver
Geben Sie zunächst den Pfad an in dem der JBoss Applicationserver installiert werden soll an. Klicken Sie dazu auf den Knopf mit dem Ordner-Symbol rechts neben dem Textfeld mit der Bezeichnung "Jboss Installationsverzeichnis" und wählen Sie das gewünschte Verzeichnis aus.
Im Bereich der mit Konfiguration überschrieben ist, nehmen Sie dann die Konfiguration des JBoss Applicationservers vor. Die folgenden Bereiche und Einstellungen müssen konfiguriert werden. In vielen Fällen können Sie jedoch die Voreinstellung unverändert beibehalten.
Jboss Service Konfiguration
Solange nicht bereits andere Applikationen (z.B. DMS Backbone, ECAROS 1) die hier genannten Ports belegen können Sie die Standardeinstellungen unverändert beibehalten. Falls die Ports belegt sind, dann setzen Sie den Wert auf einen freien Port.
Jboss Webserver Konfiguration
Solange nicht bereits andere Applikationen (z.B. MS Internet Information Server, Apache) die hier genannten Ports belegen können Sie die Standardeinstellungen unverändert beibehalten. Falls die Ports belegt sind, dann setzen Sie den Wert auf einen freien Port.
Jboss Properties Konfiguration
Die Werte der Felder "Ecaros2 Logfile" und "Dmsbb Logfile" müssen Sie in jedem Fall anpassen. TODO
Falls Sie bei der Jboss Service Konfiguration den Wert für den Jnp Port angepasst haben, müssen Sie die Werte der folgenden Felder ebenfalls anpassen:
- JndiUrl Beanproxy
- JndiUrl PluginModuleBean
- DmsBB ConnectionUrl
- Serviceterminal ConnectionUrl
- Timemanagement ConnectionUrl
- AccountManager ConnectionUrl
Dazu ersetzen Sie die als Voreinstellung eingetragene "1099" durch den Wert den Sie für den Jnp Port bei der Jboss Service Konfiguration angegeben haben.
Die Werte der anderen Felder können Sie unverändert lassen.
Jboss Start Konfiguration (Windows)
Tragen Sie in das Feld "Java Home (JDK)" den Pfad ein, in dem das Java Development Kit installiert ist. Das Pfad sieht ungefähr wie folgt aus: "C:\Programme\Java\jdk1.5.0_12".
In das Feld "Rmi-Server Hostname" tragen Sie die IP-Adresse des Servers ein.
