3 Hauptgründe und andere häufige Probleme für das Scheitern Ihres Upgrades.

Nach der Veröffentlichung der Beta 1 von V20 und Update 9 hatten wir also bereits eine ganze Reihe von Upgrades – genug, um statistisch signifikant zu sein. Und die Ergebnisse sind interessant. Dies sind die häufigsten Gründe dafür, dass ein Upgrade nicht startet:

Nummer 1 – Unzureichende CPU-Kerne – 2+ erforderlich

Der häufigste Grund für ein fehlgeschlagenes Upgrade ist, dass die Maschine nicht über zwei oder mehr Kerne verfügt. Um 3CX ordnungsgemäß auszuführen, benötigen Sie 2 Kerne. 3CX ist eine Echtzeitanwendung, die Audio – und in manchen Fällen auch Video – verarbeitet und es sich nicht leisten kann, dass die CPU auch nur für ein paar Sekunden inactiv wird. Dies führt zu Audioproblemen, sorgt für ein schlechtes Erlebnis und wirkt sich letztendlich negativ auf unseren Markennamen aus. Wenn die Maschine nicht über genügend Kerne verfügt, schlägt das Upgrade nicht fehl, es wird lediglich nicht ausgeführt. Sie müssen die Maschine zunächst auf 2 Kerne aufrüsten.

Nummer 2 – Quellenliste wurde bearbeitet

Der zweite Grund, warum Ihr Upgrade fehlschlägt, ist die Installation nicht unterstützter Pakete auf der ISO. In diesem Fall können wir das Ergebnis des Upgrades nicht vorhersagen und führen das Upgrade daher nicht durch. In diesem Fall besteht die einzige Möglichkeit für ein Upgrade darin, eine Sicherung und Wiederherstellung durchzuführen. Einige Beispielquellenlisten, die wir gefunden haben, sind osconfig_managed_7a718e6aad.list, busylight.list, mysql.list, hetzner-mirror.list.

Nummer 3 – Nicht genügend RAM – 2 GB erforderlich

Neben der Echtzeitverarbeitung von Audio und Video hostet 3CX auch einen Webserver mit vollständigem Web-Client. Dies erfordert etwas Speicher. 1 Gig ist heutzutage nichts mehr. Um ein geschäftskritisches Kommunikationssystem zu betreiben, sind 2 Gigabyte wirklich das erforderliche Minimum. Daher müssen Sie Ihr System aufrüsten, um über ausreichend Speicher zu verfügen.

Getestete Umgebungen

  • Installation basierend auf der 3CX ISO ohne Änderungen an Barebones und unterstützten virtuellen Umgebungen.
  • Führende Anbieter von Cloud-Plattformen
    • Google Cloud (Compute Engine)
    • Amazon AWS (+LightSail)
    • DigitalOcean
    • Microsoft Azure
    • Vultr

Verfahren

Was passiert also, wenn Sie ein Upgrade durchführen? Ihr System wird von Debian 10 auf Debian 11 und dann auf 12 aktualisiert. Abhängig von den Spezifikationen der Maschine, der Größe Ihrer 3CX-Installation, Ihrer Internetverbindung und davon, ob das System auf dem neuesten Stand ist, kann das Upgrade 10-15 Minuten bis hin zu einer Stunde oder mehr in Anspruch nehmen. Nach erfolgreichem Upgrade wird Ihr System neu gestartet. Eine E-Mail mit dem Ergebnis des Upgrades wird an den Systemadministrator gesendet. In der E-Mail werden Sie darüber informiert, ob das Upgrade abgebrochen, fehlgeschlagen oder erfolgreich war.

Wichtig

  • Versuchen Sie nicht, während des Upgrade-Vorgangs mit dem System/der Instanz zu interagieren
  • Erstellen Sie ein vollständiges Backup von 3CX und speichern Sie es außerhalb der Instanz
  • Erstellen Sie nach Möglichkeit einen vollständigen Snapshot der VM
  • Während des Upgrades ist 3CX nicht verfügbar. Stellen Sie daher sicher, dass Sie es außerhalb der Bürozeiten planen.v

Andere häufige Probleme

  • Manuell hinzugefügte/entfernte Repositorys
  • Manuell installierte Pakete, die Abhängigkeitsprobleme verursachen
  • Remote-Verwaltungs- oder Überwachungstools, die den Upgrade-Prozess stören könnten (z. B. Sperren von APT, Versuche, Dienste neu zu starten)
  • Geändertes Gebietsschema oder TZdata
  • Geänderte/defekte Konfigurationsdateien/Pakete
  • Manipulierte Stammzertifikate
  • Eingeschränkter Internetzugang
  • Benutzer interagieren mit dem System, während das Upgrade ausgeführt wird.

Was tun, wenn das Upgrade fehlschlägt?

Wenn das Upgrade fehlschlägt, überprüfen Sie die Systemanforderungen, beheben Sie das Problem und führen Sie es erneut aus. Wenn es immer noch fehlschlägt, müssen Sie eine vollständige Sicherung durchführen und auf einem neuen System wiederherstellen.

Die Anforderungen nochmal in Kürze

  • Mindestens 2vCPU, 2GB RAM und 5GB freier Festplattenspeicher
  • Keine Quelldateien Dritter unter /etc/apt/sources.list.d/ (außer 3CX und den Anbieteragenten)
  • Keine Software von Drittanbietern installiert
  • Ununterbrochene Verbindung zu repo.3cx.com und deb.debian.org

Hinweis: Wir sammeln Protokolle ausschließlich zu Debugging-Zwecken, die kurz nach Abschluss eines Upgrades gelöscht werden. Protokolle fehlgeschlagener Upgrades werden von unseren Technikern überprüft, um mögliche Fallstricke zu ermitteln und den Upgrade-Prozess zu verbessern.

Zusammenfassung

Für die Ausführung einer dedizierten Instanz ist eine Instanz mit der richtigen Größe erforderlich. Für sehr kleine Installationen (weniger als 5–10 Nebenstellen) sollten Sie die Verwendung von 3CX SMB oder 3CX FREE in Betracht ziehen. Wenn der Kunde wirklich ein dediziertes System benötigt, muss er verstehen, dass die Spezifikationen an die aktuellen und absolut angemessenen Anforderungen angepasst werden müssen. Viel Spaß beim Upgrade!

Folgen Sie uns

Teilen Sie uns Ihre Meinung im Forum mit. Klicken Sie auf unseren X– und LinkedIn-Seiten auf die Schaltfläche „Folgen“, um über weitere Entwicklungen auf dem Laufenden zu bleiben.