Teilen über

Upgraden der Erfassungs-Agents von Azure Operator Insights

  • Artikel

Der Erfassungs-Agent ist ein Softwarepaket, das auf einer Linux-VM (virtueller Computer) installiert und von Ihnen verwaltet wird. Eventuell müssen Sie den Agent upgraden.

In diesem Artikel wird beschrieben, wie Sie ihren Aufnahme-Agent aktualisieren und ein Rollback eines Upgrades durchführen.

Voraussetzungen

Entscheiden Sie, auf welche Version des Aufnahme-Agents Sie upgraden möchten. Wenn Sie beim Upgrade keine Version angeben, führen Sie ein Upgrade auf die neueste Version durch.

Sehen Sie sich die Neuerungen mit dem Azure Operator Insights-Aufnahme-Agent für eine Liste der neuesten Versionen an und um zu sehen, was in jeder Version geändert wurde. Wenn Sie nach einer Agent-Version suchen, die mehr als sechs Monate alt ist, sehen Sie sich das Archiv der Versionshinweise an.

Wenn Sie die Authentizität des Aufnahme-Agent-Pakets vor dem Upgrade überprüfen möchten, lesen Sie, wie Sie den GPG-Repositorysignaturschlüsselverwenden.

Ausführen eines Upgrades für die Agent-Software

Wenn Sie ein Upgrade auf ein neues Agent-Relese durchführen möchten, wiederholen Sie die folgenden Schritte auf jeder VM mit dem alten Agent.

  1. Stellen Sie eine SSH-Verbindung mit der VM her.
  2. Speichern Sie eine Kopie der vorhandenen Konfigurationsdatei /etc/az-aoi-ingestion/config.yaml.
  3. Aktualisieren Sie den Agent mithilfe des Paket-Managers Ihrer VM. Beispiel: für Red Hat-basierte Linux-Distributionen: 
    sudo dnf upgrade az-aoi-ingestion
    Antwort Sie mit y, wenn Sie dazu aufgefordert werden.
    1. Wenn Sie ein Upgrade auf eine bestimmte Version des Agents durchführen möchten, geben Sie alternativ die Versionsnummer im Befehl an. Verwenden Sie z. B. für Version 2.0.0 auf einem RHEL8-System den folgenden Befehl:
    sudo dnf install az-aoi-ingestion-2.0.0
  4. Nehmen Sie Änderungen an der Konfigurationsdatei vor, die von Ihrem Supportkontakt oder der Dokumentation für die neue Version beschrieben wird. Für die meisten Upgrades sind keine Konfigurationsänderungen erforderlich.
  5. Starten Sie den Agent neu. 
    sudo systemctl restart az-aoi-ingestion.service
  6. Sobald der Agent ausgeführt wird, konfigurieren Sie den Dienst „az-aoi-ingestion“ so, dass er automatisch bei einem Neustart gestartet wird. 
    sudo systemctl enable az-aoi-ingestion.service
  7. Vergewissern Sie sich, dass der Agent ausgeführt wird und Dateien wie unter Überwachen von und Problembehandlung für Erfassungs-Agents für Azure Operator Insights beschrieben kopiert.

Ausführen eines Rollbacks für ein Upgrade

Wenn ein Upgrade oder eine Konfigurationsänderung fehlschlägt:

  1. Führen Sie ein Downgrade auf die vorherige Version durch erneutes Installieren der vorherigen Version des Agents durch. Verwenden Sie z. B. zum Downgrade auf Version 1.0.0 auf einem RHEL8-System den folgenden Befehl: 
    sudo dnf downgrade az-aoi-ingestion-1.0.0
  2. Kopieren Sie die gesicherte Konfigurationsdatei vor der Änderung in die Datei /etc/az-mcc-edr-uploader/config.yaml.
  3. Starten Sie den Agent neu. 
    sudo systemctl restart az-aoi-ingestion.service
  4. Sobald der Agent ausgeführt wird, konfigurieren Sie den Dienst „az-aoi-ingestion“ so, dass er automatisch bei einem Neustart gestartet wird. 
    sudo systemctl enable az-aoi-ingestion.service

Zugehöriger Inhalt

In diesem Artikel werden folgende Themen erläutert: