Zum Hauptinhalt springen
Version: 15.0

Installation von Hotfixes für ADONIS 15.0

Hotfixes beheben Softwarefehler und Sicherheitsprobleme. Bitte beachten Sie, dass der aktuellste Hotfix immer die Änderungen früherer Hotfixes enthält. Nur der neueste Hotfix muss installiert werden, um alle Fehlerbehebungen zu erhalten.

Planen Sie die Installation eines Hotfixes für ADONIS 15.0? Dieser Leitfaden führt Sie durch die notwendigen Schritte, um einen reibungslosen Übergang zu gewährleisten.

Bevor Sie beginnen

Beachten Sie bitte folgende Punkte, bevor Sie loslegen:

  • In den meisten Fällen werden Sie von Ihrem ADONIS-Kundenbetreuer über einen Hotfix informiert.

  • Das Versionsformat eines Hotfixes ist 15.0.x (zum Beispiel: 15.0.1 oder 15.0.2).

  • Laden Sie den Hotfix von der BOC-Website herunter (Ihr ADONIS-Kundenbetreuer wird Ihnen per E-Mail einen Link senden).

  • Bei der Installation wird ein vollständiges, eigenständiges Installationspaket verwendet.

Dienste stoppen

Zunächst müssen der ADONIS 15.0 Applikations-Server und der Apache Tomcat Dienst gestoppt werden.

So stoppen Sie die Dienste (in Windows):

  • Öffnen Sie Dienste. Drücken Sie <Windows> + < R>, um das Feld Ausführen zu öffnen, geben Sie services.msc ein, und klicken Sie dann OK.

  • Stoppen Sie den ADONIS Applikations-Server (Service-Name z.B. "ADONISNPServer15.0Service") und den Apache Tomcat Web-Server (Service-Name z. B. "Tomcat9").

Deployment-spezifische Daten sichern

Deployment-spezifische Daten umfassen unterschiedliche Einstellungen und Informationen, die nicht in der Datenbank gespeichert werden. Dazu gehören beispielsweise Einstellungen wie Server-Ports und mehr.

Abhängig von Ihrer ADONIS 15.0-Installation, müssen Sie folgende Ordner und Dateien sichern:

ADONIS Applikations-Server Konfiguration

  • <ADONIS 15.0 Applikations-Server>/conf/server.conf (enthält den Datenbanknamen, Ports für Applikations-Server oder aworker-Prozesse und die vertrauenswürdige IP-Adresse des Web-Servers).

  • <ADONIS 15.0 Applikations-Server>/conf/adoxx.conf (optional, wenn der Standardwert von Parametern geändert wurde)

  • <ADONIS 15.0 Applikations-Server>/conf/adoxx_web_conf.js (optional, wenn der Standardwert von Parametern geändert wurde)

Apache Tomcat Konfiguration

  • <Tomcat>/webapps/ADONIS15_0/adoxx_web.properties (enthält die IP-Adresse des Applikations-Servers und die Definition der aworker-Prozesse)

  • <Tomcat>/webapps/ADONIS15_0/WEB-INF/classes/logback.xml (optional, wenn Logging-Parameter geändert wurden)

  • <Tomcat>/webapps/ADONIS15_0/WEB-INF/web.xml (optional, wenn zusätzliche Dateitypen für das Hochladen freigegeben wurden)

  • <Tomcat>/webapps/ADONIS15_0/WEB-INF/registry/rest/RESTAuthorization.xml (Teil der REST-API-Konfiguration)

ADONIS 15.0 deinstallieren

Sie haben alle relevanten deployment-spezifischen Daten gesichert; jetzt ist es an der Zeit, die aktuell installierte Version von ADONIS 15.0 zu deinstallieren:

  • Deinstallieren Sie den ADONIS 15.0 Applikations-Server, sowie alle weiteren ADONIS 15.0 Rich-Client-Installationen zur Nutzung des Administrations-Toolkits. Dies können Sie über die Systemsteuerung erledigen.

  • Entfernen Sie die ADONIS 15.0 Webapplikation aus Apache Tomcat.

Hinweis

Für ausführliche Anweisungen zur Deinstallation siehe ADONIS deinstallieren.

ADONIS 15.0.x Rich-Client installieren und konfigurieren

Jetzt ist es an der Zeit, den ADONIS 15.0.x Rich-Client zu installieren und zu konfigurieren. Dieser dient als Applikations-Server und wird für die Verwendung des Administrations-Toolkits benötigt. Detaillierte Anweisungen finden Sie in den folgenden Abschnitten.

Installation durchführen

Installieren Sie den ADONIS 15.0.x Rich-Client. Abhängig vom Deployment-Szenario müssen Sie folgende Schritte durchführen:

  • Installieren Sie ADONIS als Applikationsserver auf dem vorgesehenen Server-Rechner.

  • Installieren Sie ADONIS zur Nutzung des Administrations-Toolkits, beispielsweise auf Client-Rechnern oder einem Terminalserver.

So führen Sie die Installation durch:

  • Doppelklicken Sie auf setup.exe im Ordner 02 Rich Client im ADONIS 15.0.x Installationspaket und befolgen Sie die Anweisungen des Installationsassistenten.
Hinweis

Für detaillierte Anweisungen zum Installationsprozess siehe Rich-Client installieren.

Applikations-Server konfigurieren

Nachdem die Installation abgeschlossen ist, wird der ADONIS 15.0.x Applikations-Server konfiguriert. Anders als bei einer Neuinstallation, bei der Werte initial festlegt werden, verwenden Sie hier Ihre zuvor gesicherten Applikations-Server Konfigurationsdateien und übernehmen die Werte von dort.

So konfigurieren Sie den Applikations-Server:

  • Navigieren Sie zum Verzeichnis <ADONIS 15.0.x Applikations-Server>/conf.

  • Bearbeiten Sie die Konfigurationsdatei server.conf und übertragen Sie die Werte aus Ihrer Sicherungsdatei, einschließlich des Datenbanknamens, der Ports für Applikations-Server oder aworker-Prozesse sowie der vertrauenswürdigen IP-Adresse des Web-Servers.

  • Optional: Bearbeiten Sie die Konfigurationsdateien adoxx.conf und adoxx_web_conf.js und übertragen Sie die Werte aus Ihren Sicherungsdateien, wenn Parameter in diesen Dateien zuvor geändert wurden.

Beispiel

Wenn Sie beispielsweise zuvor die Datei adoxx_web_conf.js angepasst haben, um die Standard-Sprache für den Web-Client anzupassen, kopieren Sie den Wert des Parameters ADOXX_WEB_CLIENT_LANGUAGE in die neue adoxx_web_conf.js-Datei.

Achtung

Fügen Sie Ihre Änderungen immer in die neuen Konfigurationsdateien ein - überschreiben Sie diese niemals!

Installation des Applikations-Servers als Dienst

Nach der Installation und Konfiguration des Rich-Clients ist es nun an der Zeit, den ADONIS 15.0.x Applikations-Server als Dienst zu installieren.

  • Öffnen Sie die Windows-Eingabeaufforderung als Administrator. Drücken Sie <Windows> + < R>, um das Feld Ausführen zu öffnen, geben Sie cmd ein, und drücken Sie dann <Strg> + <Shift> + <Enter>.

  • Navigieren Sie zum Verzeichnis <ADONIS 15.0.x Applikations-Server>.

  • Geben Sie den Befehl aserver.exe -i ein, um das Windows Service (z.B. ADONISServer15.0.xService) zu installieren.

Der Applikations-Server ist nun als Dienst installiert. Starten Sie den Dienst noch nicht.

ADONIS 15.0.x Web-Client installieren und konfigurieren

Jetzt müssen Sie den ADONIS 15.0.x Web-Client bereitstellen und mithilfe Ihrer zuvor gesicherten Tomcat Konfigurationsdateien konfigurieren. Durch die Verwendung derselben Tomcat-Instanz, die bereits den vorigen ADONIS 15.0 Web-Client gehostet hat, sparen Sie sich aufwendige Konfigurationsarbeiten. Detaillierte Anweisungen finden Sie in den folgenden Abschnitten.

Web-Client bereitstellen

Stellen Sie jetzt die ADONIS 15.0.x Webapplikation auf Apache Tomcat bereit, indem Sie die notwendigen Dateien kopieren:

  • Kopieren Sie die Datei ADONIS15_0.war in das Verzeichnis <Tomcat>/webapps. Diese Datei befindet sich im Ordner 03 Web Client im ADONIS 15.0.x Installationspaket.

Der ADONIS 15.0.x Web-Client ist jetzt bereitgestellt. Starten Sie den Apache Tomcat-Service noch nicht.

Web Client konfigurieren

Jetzt ist es an der Zeit, den ADONIS 15.0.x Web-Client zu konfigurieren. Anders als bei einer Neuinstallation, bei der Werte initial festlegt werden, verwenden Sie hier Ihre gesicherten Tomcat-Konfigurationsdateien und übernehmen die Werte von dort.

So konfigurieren Sie den Web-Client:

  1. Navigieren Sie zum Verzeichnis <Tomcat>/webapps.

  2. Öffnen Sie die Datei ADONIS15_0.war mit einer Komprimierungs-Software und bearbeiten Sie den Inhalt folgendermaßen:

    • Bearbeiten Sie die Konfigurationsdatei adoxx_web.properties. Übertragen Sie die Werte aus Ihrer Sicherungsdatei, einschließlich der IP-Adresse des Applikations-Servers und der Definition der aworker-Prozesse.

    • Optional: Bearbeiten Sie die Konfigurationsdateien WEB-INF/classes/logback.xml, WEB-INF/web.xml und WEB-INF/registry/rest/RESTAuthorization.xml und übertragen Sie die Werte aus Ihren Sicherungsdateien, wenn Parameter in diesen Dateien zuvor geändert wurden.

  3. Speichern Sie die Änderungen.

Achtung

Fügen Sie Ihre Änderungen immer in die neuen Konfigurationsdateien ein - überschreiben Sie diese niemals!

Dienste starten

Zum Schluss müssen der ADONIS 15.0.x Applikations-Server und der Apache Tomcat Web-Server gestartet werden.

So starten Sie die Dienste (in Windows):

  • Öffnen Sie Dienste. Drücken Sie <Windows> + < R>, um das Feld Ausführen zu öffnen, geben Sie services.msc ein, und klicken Sie dann OK.

  • Starten Sie den ADONIS Applikations-Server (Service-Name z.B. "ADONISServer15.0.xService") und den Apache Tomcat Web-Server (Service-Name z. B. "Tomcat9").

Sie können auf den Web-Client über folgende Adresse zugreifen: http://<SERVER_NAME>:<TOMCAT_PORT>/ADONIS15_0/. Dabei steht <SERVER_NAME> für den Namen des Server-Rechners, und <TOMCAT_PORT> entspricht dem beim Setup definierten HTTP/1.1 Connector-Port (der Standardwert ist "8000").