Aktualisieren des Analytics Backend/IA-Agenten

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 von der Automic Download-Seite heruntergeladen werden, ebenso wie von unserem Marketplace unter https://marketplace.automic.com/

  • Wenn Sie von Automic System v12.2 (Analytics v1.0.3) auf v12.3 (Analytics v2.3) aktualisieren und die Streaming-Plattform und die Event Engine installieren möchten, finden Sie im Handbuch der einzelnen Komponenten Informationen zur Installation:

  • Ab dieser Version verwendet die Kommunikation zwischen der Automation Engine, dem Automic Web Interface und dem Proxy-Client sowie zwischen der AE und den Windows-, UNIX- und Java-Agenten TLS/SSL über ein sicheres WebSocket (WSS). Diese Komponenten richten eine Verbindung mit dem Java-Kommunikationsprozess (JCP) und/oder dem REST-Prozess (REST) ein. Diese Server-Prozesse verwenden vertrauenswürdige Zertifikate, um ihre Identität gegenüber anderen Kommunikationspartnern wie z. B. Agenten nachzuweisen.

    Nicht-TLS/SSL-Agenten wie BS2000, NSK, OS/400, VMS und z/OS stellen weiterhin eine Verbindung zu einem Kommunikationsprozess (CP) her. Die Kommunikation zwischen einem TLS/SSL- und einem Nicht-TLS/SSL-Agenten kann unter Verwendung des TLS Gatewayhergestellt werden.

    Mehr Informationen:

Diese Seite beinhaltet Folgendes:

Versionen von Analytics Backend und Automic Automation zuordnen

Der folgende Abschnitt beschreibt die Zuordnung zwischen der Analytics Backend-Komponente und Automic Automation:

  • Backend 1.0x = 12.0 Automic Workload Automation

  • Backend 2.0.x = 12.1.0 Automic Workload Automation

  • Backend 2.1.x = 12.1.1+ Automic Workload Automation

  • Backend 2.2.x = 12.2 Automic Workload Automation

  • Backend 2.3.x = 12.3.x Automic Automation

  • Backend 21.0.0 = 21.0.x Automic Automation

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

Wichtig! Stellen Sie sicher, dass Sie die Anforderungen für die TLS/SSL-Konfiguration der Automation Engine erfüllen, bevor Sie sie auf v21.0 aktualisieren. Da die AWI ab v21 eine Verbindung zum neuen JCP herstellt, stellen Sie sicher, dass Sie alle relevanten Zertifikate besitzen. Weitere Informationen finden Sie unter Verbindungen zur AE sichern (TLS/SSL) und TLS/SSL-Zertifikate vorbereiten.

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 v21.0. Stellen Sie sicher, dass Sie alle TLS/SSL-Anforderungen erfüllen und die notwendigen Zertifikate besitzen.

  3. Ersetzen Sie die jar-Datei des 2.3.x Analytics Backends durch die jar-Datei 21.0.0.

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

  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 v12.3 auf v21.0. Da die neue Version des AWI eine Verbindung zum neuen Java-Kommunikationsprozess (JCP) herstellt, stellen Sie sicher, dass Sie alle TLS/SSL-Anforderungen erfüllen und die notwendigen Zertifikate besitzen.

  7. Installieren Sie das neue Analytics UI-Plug-in (und ggf. das Rules UI-Plug-in). Extrahieren Sie dazu die Datei webui-plugin-analytics.jar aus dem Paket und kopieren Sie sie in den Ordner AWI_ROOT_FOLDER/WEBINF/autoinstall.

Wichtig!

  • Entfernen Sie die vorhandene Datei webui-plugin-analytics.jar, bevor Sie die neue Datei kopieren.

  • Aktualisieren Sie bei Bedarf die Konfiguration in AWI_ROOT_FOLDER/config/awi-plugins-reporting/reporting.properties.

Aktualisieren des Analytics Backends/IA-Agenten von v2.2.x auf v21.0.0

Wichtig! Stellen Sie sicher, dass Sie die Anforderungen für die TLS/SSL-Konfiguration der Automation Engine erfüllen, bevor Sie sie auf v21.0 aktualisieren. Da die AWI ab v21 eine Verbindung zum neuen JCP herstellt, stellen Sie sicher, dass Sie alle relevanten Zertifikate besitzen. Weitere Informationen finden Sie unter Verbindungen zur AE sichern (TLS/SSL) und TLS/SSL-Zertifikate vorbereiten.

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.2 auf v21.0. Stellen Sie sicher, dass Sie alle TLS/SSL-Anforderungen erfüllen und die notwendigen Zertifikate besitzen.

  3. Ersetzen Sie die jar-Datei des 2.2.x Analytics Backends durch die jar-Datei 21.0.0.

  4. Passen Sie die INI-Datei des Backend-/IA-Agenten an den Port des neuen Java-Kommunikationsprozesses (JCP) an. Weitere Informationen finden Sie unter Serverprozesstypen.

  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. Upgrade AWI von v12.2 auf v21.0

  7. Installieren Sie das neue Analytics UI-Plug-in (und ggf. das Rules UI-Plug-in). Extrahieren Sie dazu die Datei webui-plugin-analytics.jar aus dem Paket und kopieren Sie sie in den Ordner AWI_ROOT_FOLDER/WEBINF/autoinstall.

Wichtig!

  • Entfernen Sie die vorhandene Datei webui-plugin-analytics.jar, bevor Sie die neue Datei kopieren.

  • Aktualisieren Sie bei Bedarf die Konfiguration in AWI_ROOT_FOLDER/config/awi-plugins-reporting/reporting.properties.

Aktualisieren des Analytics Backends/IA-Agenten von v2.1.x auf v21.0.0

Wichtig! Stellen Sie sicher, dass Sie die Anforderungen für die TLS/SSL-Konfiguration der Automation Engine erfüllen, bevor Sie sie auf v21.0 aktualisieren. Da die AWI ab v21 eine Verbindung zum neuen JCP herstellt, stellen Sie sicher, dass Sie alle relevanten Zertifikate besitzen. Weitere Informationen finden Sie unter Verbindungen zur AE sichern (TLS/SSL) und TLS/SSL-Zertifikate vorbereiten.

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.1 auf v21.0. Stellen Sie sicher, dass Sie alle TLS/SSL-Anforderungen erfüllen und die notwendigen Zertifikate besitzen.

  3. Ersetzen Sie die jar-Datei des 2.1.x Analytics Backends durch die jar-Datei 21.0.0.

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

  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 v12.1 auf v21.0. Da die neue Version der 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. Installieren Sie das neue Analytics UI-Plug-in (und ggf. das Rules UI-Plug-in). Extrahieren Sie dazu die Datei webui-plugin-analytics.jar aus dem Paket und kopieren Sie sie in den Ordner AWI_ROOT_FOLDER/WEBINF/autoinstall.

Wichtig!

  • Entfernen Sie die vorhandene Datei webui-plugin-analytics.jar, bevor Sie die neue Datei kopieren.

  • Aktualisieren Sie bei Bedarf die Konfiguration in AWI_ROOT_FOLDER/config/awi-plugins-reporting/reporting.properties.

Aktualisieren des Analytics Backends/IA-Agenten von v2.0.x auf v21.0.0

Wichtig! Stellen Sie sicher, dass Sie die Anforderungen für die TLS/SSL-Konfiguration der Automation Engine erfüllen, bevor Sie sie auf v21.0 aktualisieren. Da die AWI ab v21 eine Verbindung zum neuen JCP herstellt, stellen Sie sicher, dass Sie alle relevanten Zertifikate besitzen. Weitere Informationen finden Sie unter Verbindungen zur AE sichern (TLS/SSL) und TLS/SSL-Zertifikate vorbereiten.

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 die AE von v12.0 auf v21.0. Stellen Sie sicher, dass Sie alle TLS/SSL-Anforderungen erfüllen und die notwendigen Zertifikate besitzen.

  3. Ersetzen Sie die jar-Datei des 2.0.x Analytics Backends durch die jar-Datei 21.0.0.

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

  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 das AWI von v12.0 auf v21.0 durch. 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. Installieren Sie das neue Analytics UI-Plug-in (und ggf. das Rules UI-Plug-in). Extrahieren Sie dazu die Datei webui-plugin-analytics.jar aus dem Paket und kopieren Sie sie in den Ordner AWI_ROOT_FOLDER/WEBINF/autoinstall.

Wichtig!

  • Entfernen Sie die vorhandene Datei webui-plugin-analytics.jar, bevor Sie die neue Datei kopieren.

  • Aktualisieren Sie bei Bedarf die Konfiguration in AWI_ROOT_FOLDER/config/awi-plugins-reporting/reporting.properties.