Was passiert ist
Ein aktuelles 3CX-Update hat bei mehreren unserer Kundenanlagen mitten im Lauf festgehangen. Die Telefonanlage war danach nicht mehr erreichbar, systemctl zeigte keine 3CX-Dienste mehr an.
Der Übeltäter war nicht 3CX selbst, sondern ein Debian-Paket, das der 3CX-Updater nebenbei mit einspielt: grub-pc. In diesem Artikel zeigen wir dir, wie du eine hängende Anlage wieder flott bekommst und wie du alle anderen Anlagen vorab absicherst, damit es gar nicht erst so weit kommt.
Die Ursache: grub-pc fragt nach einer Platte
Das Update hängt, weil grub-pc während der Installation interaktiv wissen will, auf welche Platte der Bootloader geschrieben werden soll. Der 3CX-Updater läuft im Hintergrund, niemand kann die Frage beantworten, und alles bleibt stehen.
Warum fragt grub-pc überhaupt? Debian merkt sich das Installationsziel in der debconf-Datenbank unter grub-pc/install_devices. Bei vielen Anlagen passt dieser Eintrag nicht mehr zur Realität:
- Die VM wurde migriert oder aus einem Image geklont, und aus
/dev/vdaist/dev/sdageworden. - Der Eintrag war nie gesetzt, etwa bei Installationen aus Cloud-Images oder Vorlagen.
Findet grub-pc das gespeicherte Gerät nicht, landet es im Dialog „Continue without installing GRUB?“. Das Paket bleibt halb konfiguriert, dpkg ist blockiert, und das eigentliche 3CX-Paket wird nicht mehr fertig eingerichtet. Im 3CX-Forum berichten andere Admins von genau diesem Muster.
Betroffen sind nur Systeme, die per BIOS (Legacy) booten und deshalb grub-pc nutzen. UEFI-Systeme mit grub-efi haben dieses Problem nicht.
Die Reparatur: Anlage wieder zum Laufen bringen
Wenn deine Anlage schon hängt, melde dich per SSH als root an und arbeite die folgenden Schritte ab. Mach vorher einen Snapshot der VM, falls das möglich ist.
# 1. Hängende Prozesse beenden
pkill -f grub-pc.postinst; pkill -f debconf/frontend; pkill dpkg; pkill apt-get
sleep 3
ps -ef | grep -E 'apt|dpkg|grub|debconf' | grep -v grep
# 2. Richtige Bootplatte ermitteln und in debconf hinterlegen
DISK=$(grub-probe -t disk /boot); echo "Bootplatte: $DISK"
echo "grub-pc grub-pc/install_devices multiselect $DISK" | debconf-set-selections
# 3. Abgebrochene Paketkonfiguration ohne Rückfragen abschließen
DEBIAN_FRONTEND=noninteractive dpkg --configure -a
# 4. 3CX auf die letzte funktionierende Version setzen
apt-get -y --allow-downgrades install 3cxpbx=20.0.10.1785
# 5. Prüfen, ob die Dienste wieder da sind
systemctl list-units '3CX*' --all
Was dabei passiert:
- Prozesse beenden: Der hängende grub-Dialog und die blockierten apt- und dpkg-Prozesse werden gestoppt. Der
ps-Aufruf danach sollte nichts mehr ausgeben. - Bootplatte setzen:
grub-probeliefert die Platte, von der das System tatsächlich bootet. Diese tragen wir in debconf ein, damit grub-pc nicht mehr fragen muss. - Konfiguration abschließen:
dpkg --configure -arichtet alle halb installierten Pakete fertig ein, diesmal ohne Dialog. - 3CX-Version festsetzen: Wir installieren gezielt die Version 20.0.10.1785 nach, die bei uns stabil lief.
- Kontrolle: Die 3CX-Dienste sollten wieder als
activeerscheinen.
Die Prävention: grub vor dem 3CX-Update aktualisieren
Besser als reparieren ist, wenn das Problem gar nicht erst auftritt. Unser Skript setzt die Bootplatte in debconf und spielt das grub-Update schon vorab ein. Wenn der 3CX-Updater später läuft, gibt es für ihn bei grub nichts mehr zu tun.
#!/bin/bash
set -e
# Nur Systeme mit BIOS-grub betreffen
dpkg -s grub-pc >/dev/null 2>&1 || { echo "$(hostname): kein grub-pc, nichts zu tun"; exit 0; }
# Nicht reinfunken, wenn gerade ein Update läuft
pgrep -x apt-get >/dev/null || pgrep -x dpkg >/dev/null && { echo "$(hostname): apt/dpkg läuft gerade, Abbruch"; exit 1; }
DISK=$(grub-probe -t disk /boot)
[ -b "$DISK" ] || { echo "$(hostname): Bootplatte nicht ermittelbar ($DISK)"; exit 1; }
echo "grub-pc grub-pc/install_devices multiselect $DISK" | debconf-set-selections
echo "grub-pc grub-pc/install_devices_empty boolean false" | debconf-set-selections
# grub-Update jetzt schon einspielen, damit der 3CX-Updater nicht drüberstolpert
export DEBIAN_FRONTEND=noninteractive
apt-get update -qq
apt-get install -y --only-upgrade grub-pc grub-pc-bin grub-common grub2-common
echo "$(hostname): OK, grub auf $DISK"
debconf-show grub-pc | grep install_devices
Das Skript ist bewusst defensiv gebaut:
- UEFI-Systeme werden übersprungen. Ist grub-pc nicht installiert, beendet sich das Skript sofort mit Erfolg.
- Kein Eingriff in laufende Updates. Läuft gerade apt oder dpkg, bricht es ab, statt sich dazwischenzudrängen.
- Plausibilitätsprüfung. Liefert
grub-probekein gültiges Blockgerät, wird nichts verändert. - Nur grub wird aktualisiert. Dank
--only-upgradeinstalliert das Skript keine neuen Pakete und fasst 3CX selbst nicht an.
Am Ende zeigt debconf-show den gesetzten Wert an. So siehst du in der Ausgabe direkt, auf welche Platte grub künftig installiert wird.
Ausgerollt über Tactical RMM
Wir verwalten die 3CX-Anlagen unserer Kunden mit Tactical RMM. Dort haben wir das Präventionsskript als Skript hinterlegt und auf allen 3CX-Systemen ausgeführt. Das hat bei uns drei Vorteile:
- Eine Aktion für alle Anlagen. Statt jede Telefonanlage einzeln per SSH anzufassen, läuft das Skript in einem Rutsch auf allen Agents.
- Ergebnis auf einen Blick. Jede Anlage meldet ihren Hostnamen und die gesetzte Bootplatte zurück. Ein Exit-Code ungleich 0 zeigt sofort, wo wir noch einmal hinschauen müssen.
- Wiederholbar. Weil das Skript idempotent ist, können wir es gefahrlos erneut ausführen, etwa bei neu aufgesetzten Anlagen.
Du nutzt ein anderes RMM oder Ansible? Das Skript ist reines Bash und läuft überall, wo du root-Rechte auf der Anlage hast.
Fazit
Das kaputte Update war im Kern ein Debian-Problem, das 3CX nur ausgelöst hat: Ein veralteter debconf-Eintrag reicht, damit ein unbeaufsichtigtes Update stehen bleibt. Mit dem Präventionsskript sind deine BIOS-Anlagen gegen genau diesen Fall abgesichert, und das Reparaturskript holt eine hängende Anlage in wenigen Minuten zurück.
Du betreibst selbst 3CX-Anlagen und willst dich um solche Updates nicht mehr kümmern müssen? Sprich uns an, die Helsinki Systems GmbH übernimmt das gerne für dich.