Download des ECAROS-Installer
Sie werden über neue Updates von uns immer per E-Mail informiert. Sollten Sie noch keine Mail erhalten haben, so melden Sie sich bitte bei unserem Support. In der E-Mail ist immer der Download-Link zur aktuellen Version enthalten. Diesen führen Sie entweder direkt auf dem Server aus, um die aktuelle Version herunter zu laden oder kopieren den geladenen Installer nach dem Download auf den Server.
Seit Version 8.0 beinhaltet der Installer im Namen auch immer die Versionsnummer. So können Sie sicherstellen, dass Sie immer die korrekte Version benutzen.
Voraussetzungen
Um eine Aktualisierung mit dem ECAROS-Installer erfolgreich durchführen zu können, müssen folgende Voraussetzungen erfüllt sein:
- Der Firebird 2.x Datenbankserver (SuperServer oder Classic) muss gestartet sein (bei einem laufenden ECAROS-System ist dies automatisch gegeben)
- Der Jboss-Applicationserver darf nicht gestartet sein (ecaros-Dienste oder Anwendungen müssen beendet sein)
- Die Verzeichnisse, die für die Backups gewählt wurden (ersichtlich unter Schritt 2+3 im Installer) 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 Konfigurationsdatei 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.
Vorbereitende Maßnahmen
Sollte bei Ihnen ECAROS als Serveranwendung laufen und nicht als Dienst, gehen Sie bitte wie folgt vor
Konsolen-Fenster (Windows)
Öffnen Sie das jeweilige Fenster und drücken Sie dann Strg + C, die Anwendung wird heruntergefahren. Sobald dies geschehen ist, erhalten Sie eine abschließende Abfrage Batchvorgang beenden (J/N): Dies bestätigen Sie mit J, damit schließt sich die Konsole von alleine. Führen Sie das für alle ECAROS-Module durch, die ggf. installiert und geöffnet sind (ECAROS, ETKA, ETOS, MICROCAT).
Konsolen-Fenster (LINUX)
Öffnen Sie eine Konsole und wechseln Sie in /etc/init.d/, hier sollten die entsprechenden Stop-Skripte angelegt sein, mit denen Sie den ECAROS Server und die Zusatzmodule beenden können.
Läuft ECAROS als Dienst (Windows) gehen Sie bitte wie folgt vor
Suchen Sie hier den folgenden Dienst
ECAROS2SERVER
Optional können noch weitere Dienste installiert sein
XDTIEtkaSocketServer oder XDTIEtkaSocketServer64
EtosSocketServer oder EtosSocketServer64
MicrocatSocketServer oder MicrocatSocketServer64
und beenden Sie diese/n Dienst/e.
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 angezeigt. Der letzte Schritt führt die eigentlichen Aktualisierungen durch. Bei den dazwischen liegenden Schritte wird die Konfiguration des ECAROS2-Systems vorgenommen.
Durch einen Doppelklick auf die ECAROS-Installer-Datei wird der Installer gestartet.
Achten Sie zunächst darauf, dass Sie auch die aktuellste Version gestartet haben. Die Version können Sie oben links auslesen. Unten links können Sie auslesen in welchem der Installationsschritte Sie sich befinden.
Unten rechts können Sie mit Weiter und Zurück zwischen den Installationsschritten wechseln und mit Beenden den Installer abbrechen.
Im Normalfall müssen unter den Schritten 1-9 keine Anpassungen vorgenommen werden, es sei denn Sie wurden über die E-Mail ausdrücklich aufgefordert eine Einstellung anzupassen. Sobald Sie den Schritt 10 anwählen, beginnt die Installation, diese darf auf keinen Fall abgebrochen werden.
Der Installer erstellt im Laufe des Updates Sicherungen der Datenbanken und der Programmmodule.
Grüner Haken Dieser Punkt wurde erfolgreich bearbeitet. Laufende Uhr Dieser Punkt ist im Moment in Bearbeitung Zahnrad Dieser Punkt muss noch bearbeitet werden.
Sobald alle Punkte durchgeführt wurden und mit einem grünen Haken versehen sind, ist das Update erfolgreich beendet. Sie können jetzt über Beenden den Installer schließen. Nun können Sie je nach Installationsvariante entweder über die Verknüpfungen auf dem Desktop (Windows, ECAROS läuft als Anwendung), die Start-Skripte unter /etc/init.d/ (Linux) oder über die Dienste (Windows, ECAROS läuft als Dienst) das ECAROS und die ggf. mit installierten Zusatzmodule wieder starten.
Konfiguration und Durchführung der Aktualisierung ohne graphische Oberfläche
Hat der Server als Betriebssystem LINUX ohne graphische Oberfläche, so muss in der Konsole der Befehl
java -jar <Pfad zum ECAROS-Installer-Datei> -nogui
angegeben werden.
Sollte es notwendig sein, dass Einstellungen innerhalb des ECAROS-Installers geändert werden müssen, so führen Sie den ECAROS-Installer zuvor unter Windows aus, um die entsprechenden Änderungen vorzunehmen.
WICHTIG! Es darf Schritt 9 mit WEITER nicht abgeschlossen werden!
Danach muss im User-Verzeichnis unter .ecaros die Konfigurationsdatei installer_configuration.xml auf den Server in das gleiche Verzeichnis (Bsp.: /home/ecaros2/.ecaros2) kopiert werden.
Update Anleitungen
Update 8.1.0
Allgemein
In der Version 8.1.0 wurde eine zusätzliche Funktion für alle Classic-Kunden eingebaut. Der ECAROS-Admin wird jetzt mit einem eigenen Start-Batch ausgeliefert, über die dieser mit mehr Speicher (Standard = 512 MB) gestartet werden kann. Der Speicherwert kann im Installer unter Schritt 9 von 10 > Max. Speicher auch eingestellt werden.
Schritt 9 von 10 (Konfiguration Administrations Tools)
Hier können Sie im Installer nicht mit Weiter (rot) fortfahren, da noch eine Angabe gemacht werden muss.
Hierzu muss für die Konfigurationen Admin Start Konfiguration (Windows) und Admin Start Konfiguration (Linux) (blau) noch das JDK Verzeichnis (grün) hinterlegt werden.
Den entsprechenden Pfad (braun) können Sie unter Schritt 4 von 10 > Jboss Start Konfiguration (Windows) oder Schritt 4 von 10 > Jboss Start Konfiguration (Linux) (orange) auslesen.
Den Pfad kopieren und bei Schritt 9 von 10 für beide Konfigurationen Admin Start Konfiguration (Windows) und Admin Start Konfiguration (Linux) hinterlegen.
Sobald in beiden Konfigurationen der Pfad hinterlegt ist, wird auch der Weiter-Button aktiv und der Installationsvorgang kann gestartet werden.
Update 10.2.0
Allgemein
Mit der Version 10.2 werden nicht nur funktionale Änderungen innerhalb des Programms vorgenommen sondern auch technische Änderungen an der Serveranwendung und den Clients. Mit dem Update 10.2 erfolgt der Umstieg auf einen neuen Applicationserver und auf Java 8.
Für die Installation und den Betrieb von ECAROS muss am Server das Java Development Kit 8 (JDK8) und an den Arbeitsstationen das Java Runtime Environment 8 (JRE8) installiert sein.
Sollten Sie ECAROS auf einem Linuxserver betreiben, beachten Sie bitte auch Punkt Hinweis für Linuxserver dieser Anleitung!
Erforderliche Anpassungen bei der Installation
In den folgenden Punkten werden die notwendigen Schritte beschrieben, die für den erfolgreichen Start erforderlich sind. Die angegebenen Einstellungen/Verzeichnisse sind Beispiele und können abweichen.
Combobox Konfiguration / Jboss Start Konfiguration
Hier muss das Installationsverzeichnis des JDK 8 hinterlegt werden.
Konfiguration ETKA-/ETOS-/Microcat-Socketserver
In den Schritten 6-8 muss, falls der Weiter-Button jeweils nicht aktiv ist, das JDK-Installationsverzeichnis eingepflegt werden. Es handelt sich um den gleichen Pfad wie in Punkt Combobox Konfiguration / Jboss Start Konfiguration
Konfiguration Administrations Tools
Auch hier muss das JDK-Installationsverzeichnis aus Punkt Combobox Konfiguration / Jboss Start Konfiguration eingepflegt werden.
Abschluss der Installation
Wenn Schritt 9 (Konfiguration der Administrationstools) erfolgt ist, wir über den Button „Weiter“ die Installation ausgeführt.
Hinweis für Linuxserver
Sie müssen nach dem Konfigurieren des neuen Installers unbedingt die neu erstellte „installer_configuration.xml“ auf den Linuxserver übernehmen, bevor Sie dort den Installer laufen lassen. Sollten Sie hierzu Fragen haben, stehen wir Ihnen gerne zur Verfügung.