Aktualisierung des Platform-Monitoring-Servers

In diesem Beitrag finden Sie eine Anleitung zur Aktualisierung des Platform-Monitoring Servers.

Installationsdateien herunterladen

Laden Sie das aktuelle Zip-Archiv vom FTP-Server /pub/eww/cs.pi.tm.all_in_one/cs.pi.tm.all_in_one .zip
Entpacken Sie dieses in ein beliebiges Verzeichnis z. B. „C:elasticUpdate“ auf dem Monitoring-Server (Ziel-Server).

• Hinweise zu Downloads über FTP-Server

Caramel-Installation prüfen

Die gesamte Installation wird mittels des Hilfswerkzeugs Cara (Abk. für Caramel) durchgeführt. Falls Cara noch nicht installiert ist, muss die Installation von Cara als Erstes erfolgen. Sie können den Installationsstatus von Cara einfach durch Eingabe des Befehls cara in einer beliebigen Eingabeaufforderung prüfen. Falls Cara installiert ist, meldet es sich mit einer Auflistung der Programmoptionen, andernfalls erscheint eine Fehlermeldung. Das Programm befindet sich bei einer Standard-Installation unter „C:ProgramDataSchleupen.CSCaramel“.

Sollte Cara nicht installiert sein, führen Sie das MSI-Paket Schleupen.CS.PI.DP.Caramel.msi aus dem entpackten ZIP-Paket aus.

CS.PI.TM-Server-Installationspaket  einspielen

Starten Sie eine Eingabeaufforderung als Administrator.

Die Installation kann mit dem Befehl cara upgrade gestartet werden. Es müssen nur die Parameter die vom Standardwert abweichen, angegeben werden. Alle anderen Werte können weggelassen werden (siehe auch Beispiel unten)! Hierbei sind die Angaben in spitzen Klammern im nachfolgenden Befehl Platzhalter und müssen ersetzt werden:

cara upgrade schleupen.cs.pi.tm.server <Aktuelle Versionsnummer> "C:elasticUpdateChocoPackages"

			

Zusätzliche Anpassungen nach dem Update

Diese Anpassungen werden nur benötigt, wenn eigene Dashboards in Kibana erstellt wurden.
Wenn in Kibana manuell neue Dashboards/Visualisierungen hinzugefügt wurden, kann es mit der nächsten Elastic-Version zu Inkompatibilitäten bei den Metriken kommen. Um dies zu vermeiden, sollten die Metriken, die in den Dashboards verwendet werden, einmal mit folgender Tabelle abgeglichen und ggf. angepasst werden:

• Elastisearch Platform
  (Table 5. Metricbeat renamed fields in 7.0)

Relevant sind hierbei nur die Metricbeat-Felder.

Parameterwerte überprüfen

Möglicherweise wurden bei der Erstinstallationen die Standard-Parameter überschrieben, z .B. um das Standard-Installationsverzeichnis zu ändern. Diese vom Standard abweichenden Parameter müssen erneut angegeben werden.

Die bei Ihnen eingestellten Parameterwerte können Sie wie folgt überprüfen:

KibanaInstallLocation (Standardwert: c:elastickibana)
Auslesen in der bereits geöffneten Eingabeaufforderung.

ElasticHost (Standardwert: localhost)
Zu finden in Datei ‚kibana.yml‘. Befindet sich im Verzeichnis KibanaInstallLocationConfig.

ElasticSearchInstallLocation (Standardwert: C:elasticelasticsearch)
Auslesen über den entsprechenden Windowsdienst (über Kontextmenü > Eigenschaften):

ElasticIpBinding (Standardwert= network.host: _site_)
Zu finden in Datei ‚elasticsearch.yml‘ (ElasticSearchInstallLocation/config)

KibanaHostIpBinding (Standardwert= server.host: „0.0.0.0“)
Zu finden in Datei ‚kibana.yml‘ (KibanaInstallLocation/config)

KibanaPort (Standardwert= server.port: 5601)
Zu finden in Datei ‚kibana.yml‘ (KibanaInstallLocation/config)

ElasticCuratorInstallLocation (Standardwert: C:elasticcurator)
Steht in der MSWindows-Aufgabenplanung (Name=Elasticsearch aufräumen)

ElasticHeapSize (Standardwert: 1g)

Zu finden in Datei ‚jvm.options‘ (ElasticSearchInstallLocation/config)

Der initiale (Xms) und der maximale (Xmx) Wert müssen gleich sein und werden deshalb bei Cara nur einmal angegeben.

Aktualisierung des Schleupen.CS.PI.TM.MonitoringSender

Falls Sie die automatische Aktualisierung des Schleupen.CS.PI.TM.MonitoringSender deaktiviert haben ("autoUpdate": false), installieren Sie bitte die neueste Version.

Die Einstellungen des MonitoringSender finden Sie unter

•  %programfiles(x86)%SchleupenSchleupen.CS.PI.TM.MonitoringSenderSchleupen.CS.PI.TM.MonitoringSender.config.json

{
  "autoUpdate": true,
  "ftp": {
  "maintenance": {},
  "telemetry": {}
  },
  "elastic": {
    "hostUri": "http://localhost:8080"
  }

			

Automatische Aktualisierung aktivieren (empfohlen)

Für eine automatische Aktualisierung ändern Sie die Eigenschaft auf true.

Aktualisierung auf die neueste Version

Die Installationsanleitung finden Sie unter

• Hilfe Portal > System > Diagnose & Benchmarking > Übertragung konfigurieren

Bekannte Probleme & Workarounds

Neu 19/09/22

Nach einem Upgrade auf Windows Server 2022 läuft der ElasticSearch-Server nicht mehr

Nach einem Upgrade von Windows Server 2019 auf Windows Server 2022 startet der ElasticSearch-Serverdienst nicht mehr bzw. immer neu.
Laut Log (z.B. C:elasticelasticsearchlogselasticsearch-service-x64-stderr.2022-08-29.log) protokoliert ElasticSearch folgenden Fehler:

Lösung: Hier muss das Verzeichnis elasticsearch in dem temporären Verzeichnis (Temp) manuell angelegt werden, damit ElasticSearch wieder starten kann.
Der gewählte Speicherort ist beabsichtigt.

Zugriff auf Pfad nssm.exe wurde verweigert

1. Beenden Sie die Dienste ElasticSearch und Kibana.
2. Schließen Sie den Dialog für die Windows-Dienste.
3. Starten Sie die Installation neu.

Fehlermeldung „Timeout (10 seconds) exceeded waiting for ElasticSearch and/or Kibana“

Die Ursache ist in den meisten Fällen, dass der Elastic-Server nicht erreicht werden kann. Informationen hierzu befinden sich in den Elastic / Kibana.log Files. Typische Fehlersituation ist ein fehlerhaftes IP-Binding. Der Elastic-Server ist auf _site_ gebunden. Kibana soll den Server aber unter localhost erreichen und das scheitert.

Geben Sie in einem solchen Fall den Rechnernamen explizit an und verwenden Sie nicht localhost.
cara upgrade schleupen.cs.pi.tm.server 3.21.1.51 „C:elasticUpdateChocoPackages“ -Parameters „/ElasticHost:RECHNERNAME“

Fehlermeldung „Es ist nicht möglich, einen Index auf ein NULL-Array anzuwenden“

Ersetzen Sie in der kibana.yml (standardmäßig zu finden in: /kibana/config) die Zeile

elasticsearch.url: "http://xxx:9200"

durch

elasticsearch.hosts: "http://xxx:9200"

Serviceangebot

Gerne unterstützen wir Sie dabei, die o.g. Schritte auf Ihren Systemen zu überwachen und dafür Sorge zu tragen, dass der CS.PM-Server auf dem aktuellen Stand gehalten wird und zur jeweiligen Schleupen.CS-Version passt.