Nextcloud-Upgrade hängt: needsDbUpgrade bleibt true, oc_sharing_classmap existiert bereits

Du hast ein Nextcloud-Upgrade gestartet. Die Verarbeitung bricht mit einem Tabellenfehler ab, der Wartungsmodus bleibt aktiv und needsDbUpgrade steht weiter auf true. Vielleicht hast du bereits ein altes Container-Image oder eine Datenbanksicherung zurückgespielt. Trotzdem erscheint der Hinweis erneut. Jetzt ist die wichtigste Aufgabe, den aktuellen Zustand und den ersten Abbruch zu verstehen, bevor weitere Änderungen hinzukommen.

Diese Anleitung hilft dir, einen tatsächlichen Migrationsabbruch von einer bloßen Schemawarnung zu unterscheiden und die Angaben für eine kontrollierte Wiederherstellung zusammenzustellen. Sie enthält bewusst nur einen lesenden Statusaufruf als Befehlsbeispiel. Der passende Reparaturweg hängt von Installationsart, Versionen und Sicherungsstand ab.

Passt dein Fehler zu diesem Fall?

Der untersuchte Ausgangsfall betrifft Nextcloud in Docker auf einem QNAP-System mit MariaDB. Beim Wechsel von 34.0.5 auf 35.0.2 erscheint eine SchemaException: Die Tabelle oc_sharing_classmap existiere bereits. Der Melder beschreibt einen aktiven Wartungsmodus und einen weiterhin gesetzten Upgradebedarf, auch nach dem Zurückspielen einer vorherigen Datenbanksicherung und des älteren Images. Ein bestätigter Abschluss durch diesen Melder ist im sichtbaren Verlauf nicht enthalten. Q1

Achte auf die Kombination, nicht auf ein einzelnes Wort im Protokoll:

• Das Upgrade meldet ausdrücklich einen Abbruch oder eine Ausnahme.
• Der Wartungsmodus bleibt bestehen oder die Anwendung fordert weiterhin ein Upgrade.
• needsDbUpgrade wird als true angezeigt.
• Eine Meldung nennt eine bereits vorhandene Tabelle, etwa oc_sharing_classmap oder oc_sharing_share.
• Der für dich wichtige Zugriff auf Dateien, Freigaben oder einen anderen benötigten Bereich funktioniert nicht wie vorgesehen.

Ein ähnlicher Containerbericht nennt eine bereits vorhandene Sharing-Tabelle und einen nicht wieder gestarteten Dienst. Das zugehörige Ticket wurde als Duplikat geschlossen. Dieser Status ist kein Nachweis einer Reparatur. Q5

Wartungsmodus und Schemawarnung sind verschiedene Situationen

Bei einem tatsächlichen Abbruch muss zuerst geklärt werden, welcher Zustand vorliegt. Eine andere Situation ist ein erfolgreich beendetes Upgrade, nach dem lediglich Unterschiede zwischen erwartetem und vorhandenem Datenbankschema gemeldet werden. Der Herstellertracker sammelt auch solche Warnungen bei bereits erfolgreich aktualisierten Instanzen. Daraus lässt sich nicht ableiten, dass jeder dort genannte Tabellenhinweis einen vollständigen Ausfall bedeutet. Q6

Für die Auswirkung zählt dein eigener Betrieb. Wenn mehrere Kollegen keine gemeinsam benötigten Unterlagen erreichen, ist ein Arbeitsablauf blockiert. Bei einer privaten Installation kann der Zugang zu persönlichen Dateien ebenso dringend sein; ein geschäftlicher Umsatzschaden ist daraus aber nicht automatisch abzuleiten. Notiere daher konkret, wer welche Funktion gerade braucht und welcher Ersatzweg vorhanden ist.

Was needsDbUpgrade aussagt

Der offizielle Statusbefehl zeigt unter anderem Version, Wartungszustand und needsDbUpgrade. Diese Angaben helfen, den Installationszustand zu beschreiben. Sie liefern für sich genommen noch keine Erklärung, warum eine bestimmte Tabelle bereits vorhanden ist. Q2

Auch gleiche Versionsangaben sind noch keine vollständige Abnahme. Die offizielle Beschreibung des eingebauten Updaters trennt das Ersetzen von Programmdateien von der anschließenden Migration von Datenbank und Apps. Q4 Daraus folgt für die Diagnose: Halte sowohl den Stand der Dateien als auch den tatsächlich erreichten Migrationsschritt fest. Übertrage die Bedienung des eingebauten Updaters dabei nicht ungeprüft auf Docker, AIO, Snap oder ein verwaltetes Hosting.

Sichere Ersthilfe: Zustand erfassen und den Reparaturweg vorbereiten

1. Die bisherigen Schritte chronologisch festhalten. Notiere Ausgangsversion, gewünschte Zielversion, Beginn des Versuchs und die erste erkennbare Fehlermeldung. Ergänze danach vorgenommene Änderungen, etwa einen Imagewechsel oder das Einspielen eines Datenbank-Dumps. Halte jeweils fest, ob die Maßnahme vollständig beendet wurde. Eine kurze, genaue Zeitleiste ist hilfreicher als mehrere ungeordnete Bildschirmfotos.

2. Die tatsächliche Installationsart klären. Handelt es sich um ein bestimmtes Container-Image, Nextcloud AIO, eine Archivinstallation, Snap oder einen vom Hoster verwalteten Dienst? Dokumentiere vorhandene Versions- oder Imagekennungen und den zuständigen Betreiber. Nextcloud verweist für unterschiedliche Installationsarten auf deren jeweils passende Upgradeanleitung. Q3 Wenn du nur die Weboberfläche administrierst, ist das bereits ein wichtiger Zuständigkeitshinweis; du brauchst keine fremden Serverbefehle auszuprobieren.

3. Den aktuellen Status lesen. Ein zuständiger Administrator kann im vorhandenen Nextcloud-Installationsverzeichnis und im dafür vorgesehenen Dienst- oder Containerkontext beispielsweise ausführen:

php occ status --output=json_pretty

Dieser Statusaufruf liefert eine strukturierte Übersicht. Q2 Ersetzt werden müssen gegebenenfalls der PHP-Aufruf und die Art, in den vorhandenen Dienstkontext zu gelangen. Ein universeller sudo- oder Docker-Befehl wäre für unterschiedliche Installationen irreführend. Sichere die Ausgabe mit Zeitpunkt. Ändere maintenance oder Versionsfelder nicht, um ein gewünschtes Ergebnis zu erzwingen.

4. Den ersten Abbruch im richtigen Protokoll suchen. Bewahre die Ausgabe des fehlgeschlagenen Upgradeversuchs und zeitlich passende Anwendungs- beziehungsweise Containerprotokolle auf. Bei Nutzung des eingebauten Updaters kann dessen updater.log die betroffene Phase zeigen. Q4 Unterscheide einen Tabellenkonflikt von einer expliziten Berechtigungsverweigerung und von nachträglichen Schemahinweisen. Übernimm nur die zum Fehler gehörenden Ausschnitte in eine öffentliche Anfrage; Pfade, Benutzernamen und Inhalte gegebenenfalls bereinigen.

5. Sicherungen und Wiederherstellbarkeit dokumentieren. Stelle fest, welche Sicherungen vor dem Upgrade vorhanden waren und welche Bestandteile sie enthalten. Halte Datenbank, Konfiguration, Datenverzeichnis und zugehörigen Softwarestand getrennt fest. Eine automatische Sicherung des eingebauten Updaters umfasst laut Dokumentation nicht Datenbank und Datenverzeichnis. Q4 Überschreibe eine vorhandene Sicherung nicht mit einem unklaren Zwischenzustand. Wenn Bestandteile oder zeitliche Zuordnung fehlen, gehört das ausdrücklich in die weitere Planung.

6. Einen begrenzten nächsten Schritt vereinbaren. Mit Status, erster Ausnahme, Installationsart und Sicherungsübersicht lässt sich entscheiden, was in einer getrennten Wiederherstellungsumgebung geprüft werden muss. Bei einem eindeutigen Berechtigungsfehler kann der zuständige Datenbankbetreiber die effektiven Rechte untersuchen. Bei einer bereits vorhandenen Tabelle müssen Herkunft und Migrationszustand geklärt werden. Das Tabellenobjekt nur wegen seines Namens zu löschen, erklärt diesen Zustand nicht. Eine Fortsetzung des Upgrades oder eine Wiederherstellung wird erst anhand dieser Befunde geplant.

Woran du eine erfolgreiche Wiederherstellung erkennst

Die Abnahme sollte den technischen Zustand und die tatsächlich benötigte Nutzung umfassen. Dokumentiere die vereinbarte Zielversion und den Abschluss des vorgesehenen Upgrade- oder Wiederherstellungswegs. Danach sollen Status und Betrieb zusammenpassen: Die Instanz verlangt kein weiteres Datenbankupgrade, befindet sich im normalen Betrieb und der betreffende Arbeitsvorgang funktioniert.

Prüfe mit einem berechtigten Testkonto eine vorhandene unkritische Datei und eine ausdrücklich dafür vorbereitete Testfreigabe. Bei genutzter Synchronisierung oder Office-Anbindung gehört ein entsprechender Test dazu. Kontrolliere anschließend die relevanten Protokolle auf neue Fehler. Ein abgeschalteter Wartungsmodus oder eine sichtbare Anmeldeseite allein ist keine ausreichende Abnahme einer unterbrochenen Datenbankmigration.

Häufige Fragen

Kann ich maintenance einfach auf false setzen?

Eine Freigabe des Zugriffs ist noch kein Nachweis, dass die Migration vollständig abgeschlossen ist. In diesem Fehlerfall wird deshalb zuerst der Abbruch geklärt und der vorgesehene Reparaturweg durchgeführt. Der normale Betrieb wird anschließend zusammen mit den benötigten Funktionen geprüft.

Soll ich die bereits vorhandene Tabelle löschen?

Die Meldung sagt zunächst, dass eine erwartete Operation auf einen vorhandenen Namen trifft. Sie sagt nicht, dass die zugehörigen Daten entbehrlich sind. Beiträge, die Tabellenlöschungen beschreiben, sind keine allgemeine Reparaturanleitung für deine Instanz. Für einen solchen Eingriff fehlen ohne genaue Zustandsprüfung wesentliche Informationen.

Kann ich einfach das alte Container-Image starten?

Nextcloud unterstützt keinen einfachen Downgrade und verweist für eine Rückkehr auf eine neue Installation mit Wiederherstellung aus Sicherungen. Q3 Ein älterer Programmstand allein klärt nicht, ob die vorhandene Datenbank zum passenden Zeitpunkt gehört. Dokumentiere deshalb bereits erfolgte Imagewechsel genau, damit der weitere Weg auf dem tatsächlichen Zustand aufbaut.

Ist jede Meldung über ein abweichendes Datenbankschema gefährlich?

Ein Schemahinweis nach einem erfolgreichen Update ist anders zu behandeln als eine Ausnahme, die das Upgrade abbricht. Der offene Übersichtsbericht enthält auch Hinweise nach erfolgreichem Abschluss. Q6 Entscheidend sind das vollständige Ergebnis, der aktuelle Status und konkrete Funktionsprobleme, nicht nur die Überschrift der Warnung.

Wurde dieser Fehler mit Nextcloud 35.0.2 behoben?

Das lässt sich aus den geprüften Quellen nicht behaupten: Der Ausgangsfall beschreibt gerade einen Versuch auf 35.0.2. Ein anderer Teilnehmer meldet später Erfolg nach mehreren eigenen Eingriffen; das bestätigt weder eine allgemeine Reparatur noch den Erfolg beim ursprünglichen Melder. Q1

Welche Informationen sollte ich an einen Helfer weitergeben?

Installationsart, Ausgangs- und Zielversion, Zeitpunkt, erste Ausnahme, aktueller Status, bisherige Eingriffe und Umfang der Sicherungen. Ergänze, welche Nutzung blockiert ist. Eine vollständige config.php, Datenbankpasswörter oder echte Dateiinhaltssicherungen gehören nicht in die öffentliche Anfrage.

Wo du Hilfe findest

Die Nextcloud-Administrationsdokumentation ist der Ausgangspunkt für Status und den zur Installationsart passenden Upgradeweg. Q2 Q3 Konkrete Installationsprobleme werden im Nextcloud-Hilfeforum diskutiert. Q1 Für einen eingegrenzten Softwarefehler ist der Herstellertracker geeignet; prüfe den vorhandenen Verlauf und seine genaue Bedeutung. Ein als Duplikat geschlossener Bericht ist dabei keine Bestätigung eines behobenen Fehlers. Q5 Q6

Fall beschreiben

Deine Nextcloud bleibt nach einem Upgrade unerreichbar oder verlangt weiter eine Datenbankmigration? Beschreibe KAN KAI den aktuellen Zustand und den letzten sicher funktionierenden Stand. Mit den Informationen aus der Diagnosefolge lässt sich klären, welche Untersuchung möglich ist, welche Sicherungen benötigt werden und ob Betreiber oder Hersteller beteiligt werden müssen.

Angaben für deine Anfrage: private oder geschäftliche Nutzung · blockierte Funktion · Installationsart · Versionen · erste Fehlermeldung · aktueller Status · bereits vorgenommene Änderungen · Sicherungsstand. So entsteht eine konkrete Grundlage für einen begrenzten Diagnose- oder Wiederherstellungsauftrag.