Aktualisieren des Analytics-Backend/IA-Agenten

Als Administrator aktualisieren Sie Ihre Analytics-Installation. Dieses Thema beschreibt, wie Sie Analytics in einem lokalen Automic Automation-System manuell aktualisieren. Dieses Thema gilt nicht für Automic Automation Kubernetes Edition (AAKE)-Systeme. Weitere Informationen zur Migration von Automic Automation von einer früheren Version auf ein AAKE-System finden Sie unter Container-basierte Systemaktualisierung - Automic Automation Kubernetes Edition.

Wichtig!

  • Die relevanten Upgrade-Pakete können auf der Download-Seite von Automic heruntergeladen werden sowie über unseren Marketplace unter https://marketplace.automic.com/.

  • Stellen Sie sicher, dass Sie die Anforderungen für die TLS/SSL-Konfiguration von Automation Engine erfüllen, bevor Sie ein Upgrade durchführen. Da AWI eine Verbindung zum JCP herstellt, stellen Sie außerdem sicher, dass Sie über alle relevanten Zertifikate verfügen. Weitere Informationen finden Sie unter Verbindungen zur AE sichern (TLS/SSL) und Hinweise zu TLS-/SSL-Zertifikaten.

  • Automic Automation unterstützt ab Version 24 Unicode/UTF-8. Analytics unterstützt nur PostgreSQL-Datenbanken. Wenn Ihre Analytics-Datenbank bereits UTF-8 unterstützt, wie in vorherigen Versionen empfohlen, muss die Konfiguration nicht geändert werden. Weitere Informationen finden Sie unter Universelle Sprachunterstützung (Unicode).

Diese Seite beinhaltet Folgendes:

Versionen von Analytics-Backend und Automic Automation zuordnen

Unten finden Sie die Versionszuordnung zwischen der Analytics-Backend-Komponente und Automic Automation. Stellen Sie sicher, dass das Analytics-Backend mindestens dieselbe Haupt- und Nebenversion wie Automation Engine und Automic Web Interface verwendet:

  • Backend 2.3.x = 12.3.x Automic Automation

  • Backend 21.0.0 = 21.0.x Automic Automation

  • Backend 24.0.0 = 24.x Automic Automation

Aktualisieren des Analytics-Backends/IA-Agenten von v21.0.0 auf v24.0.0

Die relevanten Analytics-Upgrade-Pakete können von der Automic Download-Seite heruntergeladen werden, ebenso wie von unserem Marketplace unter https://marketplace.automic.com/.

Lesen Sie die Versionshinweise und prüfen Sie, ob die Eigenschaftendateien geändert werden müssen, bevor Sie den Analytics Backend-/IA-Agenten aktualisieren. Gehen Sie dazu wie folgt vor:

  1. Stoppen des Backends/IA-Agenten.

  2. Aktualisieren Sie AE von v21.0.x auf v24.x. Stellen Sie sicher, dass Sie alle TLS/SSL-Anforderungen erfüllen und über die erforderlichen Zertifikate verfügen.

  3. Ersetzen Sie die Backend-jar-Datei 21.0.0Analytics durch die jar-Datei 24.0.0.

  4. Passen Sie die INI-Datei des Backends/IA-Agenten an den Port des neuen Java-Kommunikationsprozesses (JCP) an.

    Hinweis: Überprüfen Sie außerdem die AE-Datenbankverbindung in der Datei application.properties, um sicherzustellen, dass die neue UTF-8-AE-Datenbank erreicht werden kann.

  5. Starten des Backends/IA-Agenten.

    Das Analytics Backend wird gestartet und als Teil des IA-Agenten ausgeführt. Der Analytics-Datenspeicher wird in das neue Schema migriert. Dies kann je nach Menge der migrierten Daten einige Zeit dauern. Der Agent stellt die Verbindung zur in der INI-Datei genannten AE her.

  6. Aktualisieren Sie AWI von v21.0.x auf v24.x. Da die neue Version von AWI eine Verbindung zum neuen Java-Kommunikationsprozess (JCP) herstellt, stellen Sie sicher, dass Sie alle TLS/SSL-Anforderungen erfüllen und die erforderlichen Zertifikate besitzen.

  7. Das Analytics WebUI-Plugin ist Teil der Standardinstallation von AWI und ist im Ordner autoinstallation verfügbar. Aktualisieren Sie die Datei plugin.properties, um die Kommunikation zwischen dem Plug-in und dem Backend über die REST-API zu aktivieren. Gehen Sie dabei folgendermaßen vor:

    • backend.api_key=

      Dieser Schlüssel sichert den Zugriff auf die Backend-REST-API. Er wurde vom Script setup.psql generiert, als Sie den Datenspeicher eingerichtet haben. Beim Einrichten des Datenspeichers haben Sie diesen Schlüssel in eine Textdatei kopiert.

    • backend.endpoint=

      Dies ist der Hostname des Analytics-Backend-Hosts.

Aktualisieren des Analytics-Backend/IA-Agenten von v2.3.x auf v24.0.0

Die relevanten Analytics-Upgrade-Pakete können von der Automic Download-Seite heruntergeladen werden, ebenso wie von unserem Marketplace unter https://marketplace.automic.com/.

Lesen Sie die Versionshinweise und prüfen Sie, ob die Eigenschaftendateien geändert werden müssen, bevor Sie den Analytics Backend-/IA-Agenten aktualisieren. Gehen Sie dazu wie folgt vor:

  1. Stoppen des Backends/IA-Agenten.

  2. Aktualisieren Sie AE von v12.3 auf v24.x. Stellen Sie sicher, dass Sie alle TLS/SSL-Anforderungen erfüllen und über die erforderlichen Zertifikate verfügen.

  3. Ersetzen Sie die Backend-jar-Datei 2.3.xAnalytics durch die jar-Datei 24.0.0.

  4. Passen Sie die INI-Datei des Backends/IA-Agenten an den Port des neuen Java-Kommunikationsprozesses (JCP) an.

    Hinweis: Überprüfen Sie außerdem die AE-Datenbankverbindung in der Datei application.properties, um sicherzustellen, dass die neue UTF-8-AE-Datenbank erreicht werden kann.

  5. Starten des Backends/IA-Agenten.

    (missing or bad snippet)

  6. Aktualisieren Sie AWI von v12.3 auf v24.x. Da die neue Version von AWI eine Verbindung zum neuen Java-Kommunikationsprozess (JCP) herstellt, stellen Sie sicher, dass Sie alle TLS/SSL-Anforderungen erfüllen und die erforderlichen Zertifikate besitzen.

  7. Das Analytics WebUI-Plugin ist Teil der Standardinstallation von AWI und ist im Ordner autoinstallation verfügbar. Aktualisieren Sie die Datei plugin.properties, um die Kommunikation zwischen dem Plug-in und dem Backend über die REST-API zu aktivieren. Gehen Sie dabei folgendermaßen vor:

    • backend.api_key=

      Dieser Schlüssel sichert den Zugriff auf die Backend-REST-API. Er wurde vom Script setup.psql generiert, als Sie den Datenspeicher eingerichtet haben. Beim Einrichten des Datenspeichers haben Sie diesen Schlüssel in eine Textdatei kopiert.

    • backend.endpoint=

      Dies ist der Hostname des Analytics-Backend-Hosts.