MID-Server-Pre-Upgrade-Test

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 5 Minuten Lesedauer

    • Vor einem Upgrade führt der MID-Server Tests durch, um Probleme zu identifizieren, die dazu führen könnten, dass der Upgrade-Prozess fehlschlägt oder zu einem Ausfall des MID-Servers führen.

    Jeder MID-Server enthält einen AutoUpgrade-Monitor, der die MID-Server-Version mit der der Instanz vergleicht, um festzustellen, ob der MID-Server aktualisiert werden muss. Wenn der AutoUpgrade-Monitor feststellt, dass die Version des MID-Servers veraltet ist, führt er für diesen MID-Server Pre-Upgrade-Validierungstests durch. Wenn ein Problem entdeckt wird, wird eine Nachricht in der Tabelle MID-Server-Problem [ecc_agent_issue] protokolliert, und das Upgrade wird blockiert. Die AutoUpgrade-Überwachung wird weiterhin jede Stunde ausgeführt, bis alle Tests bestanden sind. Wenn keine Blockierungsprobleme vorliegen, lädt der MID-Server das entsprechende Upgrade-Paket herunter und beginnt mit dem Upgrade-Vorgang. Die Prüfung vor dem Upgrade des MID-Servers wird auch für die Upgrades ausgeführt, die von der Instanz ausgelöst wurden, als die Instanz aktualisiert wurde, sowie für manuelle Upgrades.

    Pre-Upgrade-Tests

    Vor dem Upgrade werden zwei Sätze von Tests ausgeführt: obligatorische Testsund Warnungstests. Alle obligatorischen Tests sind erforderlich, um das MID-Server-Upgrade zu starten. Wenn ein obligatorischer Test nicht bestanden wurde, wird der Test im Protokoll des Service Desk-Mitarbeiters aufgezeichnet, und in der Tabelle „MID-Server-Problem“ [ecc_agent_issue] wird ein aktives MID-Server-Problem erstellt. Diese Fehler werden vor dem eigentlichen MID-Server-Upgrade veröffentlicht und müssen behoben werden, bevor das Upgrade fortgesetzt werden kann. Der MID-Server stoppt den Upgrade-Prozess und ändert den Status basierend auf Status des MID-Servers. Wenn ein Warnungstest nicht bestanden wurde, wird im Agent-Protokoll und in der MID-Server-Problemtabelle eine Meldung hinzugefügt, die Prüfung vor dem Upgrade wird jedoch fortgesetzt, und das MID-Upgrade wird nicht angehalten.

    Validierungstests vor dem Upgrade überprüfen die folgenden obligatorischen Tests:
    • Mindestens 1 GB freier Speicherplatz
    • Greifen Sie auf die Download-Website unter install.service-now.com zu
    • Überprüft die digitale Signatur einer heruntergeladenen Beispieldatei
    • Ausführungsberechtigung, die Folgendes umfasst:
      • Extrahieren Sie einen ZIP-Archiver in einen temporären Ordner
      • Kopieren Sie die Datei aus dem temporären Ordner in den Agent-Ordner
      • Liest eine Textdatei und validiert den Inhalt
      • Löschen Sie den Inhalt der Prüfung vor dem Upgrade
    • Der MID-Server-Hostcomputer ist kein 32-Bit-System
    • Auf Linux-MID-Servern ist die glibC-Version mindestens 2.17
    Auf Windows-MID-Servern werden im Rahmen der Validierung vor dem Upgrade die folgenden Warnungstests ausgeführt:
    • Alle MID-Server-Upgrade-Blockerservices werden auf dem Hostcomputer ausgeführt
    • Status der Anwendungs-Experience auf dem Hostcomputer
    • Der MID Server muss ohne Administratorrechte ausgeführt werden. Wenn „ Anmelden als“ -Benutzeraccount für den MID-Server „LocalSystem“ oder ein Benutzer ist, der Teil der Administratorgruppe ist, schlägt das Upgrade fehl und es wird ein Fehlerprotokoll generiert.

    Fehler, die das Upgrade blockieren

    Diese Nachrichten beschreiben das Fehlschlagen eines obligatorischen Tests und werden in der Tabelle „MID-Serverproblem“ [ecc_agent_issue] veröffentlicht. Bei einem Ausfall bei einem dieser Tests wird das Upgrade blockiert.
    Nicht genügend freier Speicherplatz. Die Systemberichte<n> Byte frei
    Diese Meldung wird angezeigt, wenn auf dem MID-Serverhost weniger als 1 GB freier Speicherplatz erkannt wird. Dieser Fehler wird auch in das Agent-Protokoll des MID-Servers geschrieben.
    Updates können nicht vom Installationsserver heruntergeladen werden
    Diese Meldung gibt an, dass entweder der MID-Server-Host nicht berechtigt ist, das Installationspaket von install.service-now.com herunterzuladen, oder Netzwerkprobleme verhindern die Verbindung. Dieser Fehler wird auch in das Agent-Protokoll des MID-Servers geschrieben.
    Signaturverifizierung fehlgeschlagen:<message>
    Diese Meldung gibt an, dass eine Überprüfungsausnahme aufgetreten ist, wenn die Prüfung vor dem Upgrade versucht, die digitale Signatur der heruntergeladenen Prüfdatei zu überprüfen.
    Digitale Signatur kann nicht verifiziert werden:<message>
    Diese Nachricht gibt an, dass der Signaturprozess der Verifizierung durch eine Ausnahme unterbrochen wurde.
    Der Inhalt der ZIP-Prüfung vor dem Upgrade kann nicht extrahiert werden
    Diese Meldung gibt an, dass das Servicekonto auf dem MID-Serverhost nicht berechtigt ist, das ZIP-Archiv vor dem Upgrade in den temporären Ordner zu extrahieren.
    Ordner kann nicht erstellt werden<upgrade check file path>
    Diese Meldung gibt an, dass das MID-Server-Servicekonto nicht berechtigt ist, den Ordner „upgradeCheck“ für die Prüfungsdateien vor dem Upgrade im Agent-/Paketpfad zu erstellen.
    Dateiberechtigungen können nicht verifiziert werden:<message>
    Diese Nachricht gibt an, dass beim Überprüfen von Dateiberechtigungen eine Ausnahme aufgetreten ist, z. B. eine nicht vorhandene Datei oder ein Zugriffsfehler.
    Der Windows-Dienst für den MID-Server wird nicht als lokales System oder als lokaler Administrator ausgeführt
    Diese Meldung warnt davor, dass der Windows-Service nicht mit den gewünschten Berechtigungen ausgeführt wird.
    Fehler beim Upgrade: Der Hostcomputer erfüllt nicht die Mindestsystemanforderungen für das Upgrade des MID-Servers.
    MID-Upgrade wird auf 32-Bit-Hosts nicht unterstützt. Weitere Informationen finden Sie unter KB0863694.
    Upgradefehler: Der Host erfüllt nicht die Mindestsystemanforderungen für das Upgrade des MID-Servers. Weitere Informationen finden Sie in der MID-Server-Produktdokumentation in der GlibC-Bibliothek
    Dieser Fehler kann nur für Linux-MID-Server auftreten. Weitere Informationen finden Sie unter Unterstützung von Java-Versionen.

    Nicht blockierende Warnungen

    Diese Warnungen werden in der Tabelle „MID-Server-Problem“ [ecc_agent_issue] angezeigt und verhindern nicht, dass ein Windows-MID-Server aktualisiert wird:
    $logOnAsUser kann nicht analysiert werden
    Diese Nachricht warnt davor, dass der Wert „Als Benutzer anmelden“ für den Windows-Service nicht in einem der erwarteten Formate vorliegt:
    • user@domain.company.com
    • Domäne\Benutzer
    Gruppen des angemeldeten Anwenders können nicht gesucht werden

    Wenn die Instanz versucht, die Gruppenmitgliedschaften des angemeldeten Benutzers zu suchen, führt sie den Netzwerkbenutzer aus<username> Befehl. Nach diesem Befehl erwartet die Instanz vom Windows-Dienst eine bestimmte Ausgabestruktur und gibt diese Warnung aus, wenn die erwartete Ausgabe nicht mit der tatsächlichen Ausgabe übereinstimmt.

    Diese PowerShell-Warnungen werden nur in das Protokoll des MID-Server-Agents geschrieben. Da PowerShell keinen MID-Server verwenden muss, wird ein Upgrade eines Windows-MID-Servers durch diese Konfigurationsprobleme nicht verhindert. Diese Warnungen können jedoch auf Probleme in Ihrer Umgebung hinweisen, die Aufmerksamkeit erfordern.

    PowerShell-Upgradeprüfungen werden übersprungen, da PowerShell nicht verwendbar ist
    PowerShell 3.0 (mindestens) ist nicht installiert, oder „powershell.exe“ ist für den Benutzer des MID-Server-Services nicht verfügbar.
    PowerShell-Test wird übersprungen: Zielordner wurde nicht initialisiert
    PowerShell-Test wird übersprungen: Der Servicename konnte nicht erkannt werden
    Der Service CiscoAMP, der auf dem MID-Server-Hostcomputer ausgeführt wird, wird als MID-Server-Upgrade-Blocker identifiziert
    Weitere Informationen finden Sie unter KB0870329.
    Die Anwendungs-Experience ist auf dem MID-Server-Host deaktiviert, was dazu führen kann, dass der automatische Upgrade-Prozess fehlschlägt und der MID-Server ausfällt. Aktivieren Sie den Service auf dem Host, um ein erfolgreiches automatisches Upgrade sicherzustellen
    Weitere Informationen finden Sie unter KB0597552.
    Upgrade wird fortgesetzt, aber bei upgradeCheck ist das folgende Problem aufgetreten:<exception message>
    Diese Meldung gibt an, dass beim Ausführen des PowerShell-Teils der Tests vor dem Upgrade ein Problem aufgetreten ist.

    Pre-Upgrade-Prüfung deaktivieren

    Ein als mid.upgrade.run_precheck benannter MID-Server-Konfigurationsparameter wird standardmäßig auf true gesetzt, wodurch das Ausführen des automatischen Pre-Upgrade-Tests erlaubt wird. Um diese Tests für einen einzelnen MID-Server zu deaktivieren, fügen Sie diesen Parameter der Datei config.xml dieses MID-Servers hinzu, und legen Sie ihn auf falsefest. Um diese Tests für alle MID-Server zu deaktivieren, fügen Sie der Tabelle „MID-Server-Eigenschaft“ [ecc_agent_property] einen neuen Datensatz hinzu, der mid.upgrade.run_precheck genannt ist. Setzen Sie den Wert dieser Eigenschaft auf false, und lassen Sie das Feld MID-Server leer.