Zum Hauptinhalt springen
Version: 13 LTS

Installation von Hotfixes für ADOGRC 13 LTS

Seit ADOGRC 13.2 ist das Installieren eines Hotfix besonders einfach. Dieser Artikel beschreibt beispielhaft die Installation eines Hotfix für eine bestehende ADOGRC 13.2 Installation.

Ein Hotfix ist eine Mikro-Version, die nur der Behebung von Softwarefehlern und Sicherheitslücken dient und keine neue Funktionalität enthält. 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.

Ein Hotfix gehört immer zu einer bestimmten Minor / Major Version und kann daher nicht für ein direktes Softwareupgrade auf so eine Version verwendet werden. Wenn Sie z.B. derzeit ADOGRC 13.2 verwenden, können Sie diese anhand dieser Anleitung auf die Version 13.2.1 aktualisieren. Wenn Sie hingegen ADOGRC 13.0 oder 13.1 verwenden, sind zusätzliche Schritte für ein Upgrade auf ADOGRC 13.2 notwendig, welche nicht Teil dieser Anleitung sind.

Hinweis

Das folgende Beispiel geht von einer aktuell installierten ADOGRC 13.2.0 Installation aus. Sollten Sie bereits eine höhere Version installiert haben, passen Sie die Versionsnummern und Pfade entsprechend an.

Bevor Sie beginnen

Beachten Sie bitte folgende Punkte, bevor Sie loslegen:

  • In den meisten Fällen werden Sie von Ihrem ADOGRC-Kundenbetreuer über einen Hotfix informiert.
  • Das Versionsformat eines Hotfixes ist 13.2.x (zum Beispiel: 13.2.1 oder 13.2.2).
  • Laden Sie den Hotfix von der BOC-Website herunter (Ihr ADOGRC-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 ADOGRC 13.2 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 ADOGRC Applikations-Server (Service-Name z.B. "ADOGRC13.2.0-ADONISServer16.4.0Service") und den Apache Tomcat Web-Server (Service-Name z. B. "Tomcat10").

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 ADOGRC 13.2-Installation, müssen Sie folgende Ordner und Dateien sichern:

ADOGRC Applikations-Server Konfiguration​

  • <ADOGRC 13.2 Installationsordner>/conf/server.conf (enthält den Datenbanknamen, Ports für Applikations-Server oder aworker-Prozesse und die vertrauenswürdige IP-Adresse des Web-Servers).
  • <ADOGRC 13.2 Installationsordner>/conf/adoxx.conf (optional, wenn der Standardwert von Parametern geändert wurde)
  • <ADOGRC 13.2 Installationsordner>/conf/adoxx_web_conf.js (optional, wenn der Standardwert von Parametern geändert wurde)
  • <ADOGRC 13.2 Installationsordner>/conf/module/afts_server.conf (optional, wenn die Java-Heap-Größe für die Engine der Volltextsuche erhöht wurde)

Apache Tomcat Konfiguration​

  • <Tomcat Installationsordner>/webapps/ADONIS16_4/adoxx_web.properties (enthält die IP-Adresse des Applikations-Servers und die Definition der aworker-Prozesse)
  • <Tomcat Installationsordner>/webapps/ADONIS16_4/WEB-INF/classes/logback.xml (optional, wenn Logging-Parameter geändert wurden)
  • <Tomcat Installationsordner>/webapps/ADONIS16_4/WEB-INF/web.xml (optional, wenn zusätzliche Dateitypen für das Hochladen freigegeben wurden)
  • <Tomcat Installationsordner>/webapps/ADONIS16_4/WEB-INF/registry/rest/RESTAuthorization.xml (Teil der REST-API-Konfiguration)
Hinweis

Bitte beachten Sie, dass der Name der Webanwendung - und damit auch die Namen der Verzeichnisse - ADONIS16_4 lautet, dies ist so beabsichtigt.

ADOGRC 13.2 deinstallieren

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

  • Deinstallieren Sie den ADOGRC 13.2 Applikations-Server. Dies können Sie über die Systemsteuerung erledigen.
  • Entfernen Sie die ADOGRC 13.2 Webapplikation aus Apache Tomcat. Löschen Sie dazu den Ordner ADONIS16_4 und die Datei ADONIS16_4.war aus dem Verzeichnis /webapps/ im Tomcat Installationsordner.
Hinweis

Bitte beachten Sie, dass der Name der Webanwendung - und damit auch die Namen der Verzeichnisse - ADONIS16_4 lautet, dies ist so beabsichtigt.

ADOGRC 13.2.x Applikations-Server installieren und konfigurieren

Jetzt ist es an der Zeit, den ADOGRC 13.2.x Applikations-Server zu installieren und zu konfigurieren. Detaillierte Anweisungen finden Sie in den folgenden Abschnitten.

Installation durchführen​

Installieren Sie den ADOGRC 13.2.x Applikations-Server auf dem vorgesehenen Server-Rechner. So führen Sie die Installation durch:

  • Doppelklicken Sie auf setup.exe im Ordner 02 Application Server des ADOGRC 13.2.x Installationspakets und befolgen Sie die Anweisungen des Installationsassistenten.

Applikations-Server konfigurieren​

Nachdem die Installation abgeschlossen ist, wird der ADOGRC 13.2.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 <ADOGRC 13.2.x Installationsordner>/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, adoxx_web_conf.js und module/afts_server.conf 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 ADOGRC 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 Applikations-Servers ist es nun an der Zeit, den ADOGRC 13.2.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 <ADOGRC 13.2.x Installationsordner>.
  • Geben Sie den Befehl aserver.exe -i ein, um das Windows Service (z.B. "ADOGRC13.2.0-ADONISServer16.4.0Service") zu installieren.

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

ADOGRC 13.2.x Webapplikation installieren und konfigurieren​

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

Webapplikation bereitstellen​

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

Kopieren Sie die Datei ADONIS16_4.war in das Verzeichnis <Tomcat Installationsordner>/webapps. Diese Datei befindet sich im Ordner 03 Web Application des ADOGRC 13.2.x Installationspaket. Die ADOGRC 13.2.x Webapplikation ist jetzt bereitgestellt. Starten Sie den Apache Tomcat-Service noch nicht.

Hinweis

Bitte beachten Sie, dass der Name der Webanwendung - und damit auch die Namen der Verzeichnisse - ADONIS16_4 lautet, dies ist so beabsichtigt.

Webapplikation konfigurieren​

Jetzt ist es an der Zeit, die ADOGRC 13.2.x Webapplikation 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 die Webapplikation:

  • Navigieren Sie zum Verzeichnis <Tomcat Installationsordner>/webapps.
  • Öffnen Sie die Datei ADONIS16_4.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.
  • Speichern Sie die Änderungen.
Achtung

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

Hinweis

Bitte beachten Sie, dass der Name der Webanwendung - und damit auch die Namen der Verzeichnisse - ADONIS16_4 lautet, dies ist so beabsichtigt.

Dienste starten

Zum Schluss müssen der ADOGRC 13.2.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 ADOGRC Applikations-Server (Service-Name "ADOGRC13.2.1-ADONISServer16.4.1Service") und den Apache Tomcat Web-Server (Service-Name z. B. "Tomcat10").

Sie können nun auf ADOGRC über die gewohnte Adresse zugreifen. Standardmäßig ist dies: http://<SERVER_NAME>:<TOMCAT_PORT>/ADONIS16_4/. Dabei steht <SERVER_NAME> für den Namen des Server-Rechners, und <TOMCAT_PORT> entspricht dem bei der Installation von Tomcat definierten HTTP/1.1 Connector-Port (der Standardwert ist "8000").