Behandeln von Problemen beim Upgrade der Websitesammlung in SharePoint Server 2016

GILT FÜR:2013 2016 2019 Subscription Edition SharePoint in Microsoft 365

Wenn Sie ein Upgrade einer Websitesammlung auf SharePoint Server 2019 durchführen, können gelegentlich Fehler auftreten. Mit den Informationen in diesem Artikel können Sie diese Fehler besser nachvollziehen und effektiver beheben.

Überprüfen des Upgradestatus und der Protokolldateien

Die Upgradestatusindikatoren und die Protokolldateien sollten Ihnen Hinweise darauf geben, wo im Verlauf des Upgradeprozesses ein Fehler aufgetreten ist. Es wird empfohlen, alle Fehler in den Upgradeprotokolldateien aufmerksam zu lesen. Warnmeldungen weisen nicht immer auf einen Fehler hin, aber Sie sollten sie alle lesen, um herauszufinden, ob eine der Warnungen möglicherweise noch weitere Probleme verursachen könnte.

1. Sehen Sie die Seite mit dem Upgradestatus für die Websitesammlung durch.

   Klicken Sie auf der Seite Websiteeinstellungen für die Websitesammlung im Abschnitt Websitesammlungsverwaltung auf Websitesammlungsupdate. Klicken Sie auf der Seite Websitesammlungsupdate auf Status des Websitesammlungsupdates überprüfen.

2. Wenn Seiten nicht ordnungsgemäß gerendert werden, können Sie die Seite Websiteeinstellungen überprüfen. Falls die Seite Websiteeinstellungen funktioniert und das Upgrade erfolgreich ausgeführt wurde, ist das Problem möglicherweise bei der Gestaltungsvorlage oder der Homepage zu suchen. Falls die Seite Websiteeinstellungen nicht funktioniert, überprüfen Sie die Websitesammlungsupgrade-Protokolldatei auf zusätzliche Informationen zu dem Problem.

3. Überprüfen Sie die Upgradeprotokolldateien für die Websitesammlung. Dies können Sie an folgenden Stellen tun:

• Für Websitesammlungsadministratoren: Es gibt auch Protokolldateien für das Websitesammlungsupgrade, die in der Websitesammlung selbst gespeichert sind, im Wartungsprotokollkatalog unter (http://<SiteName>/_catalogs/MaintenanceLogs/YYYYMMDD-HHMMSS-SSS.txt , wobei JJJJMMDD das Datum und HHMMSS-SSS die Zeit ist (Stunden im 24-Stunden-Format, Minuten, Sekunden und Millisekunden).

• Für Farmadministratoren: Die Protokolldatei und die Fehlerprotokolldatei für das Websitesammlungsupdate befinden sich im Verzeichnis %COMMONPROGRAMFILES%\Microsoft Shared\Web server extensions\16\LOGS. Die Protokolle werden im folgenden Format benannt: SiteUpgrade- YYYYMMDD-HHMMSS-SSS.log, wobei JJJJMMDD das Datum und HHMMSS-SSS die Uhrzeit ist (Stunden im 24-Stunden-Format, Minuten, Sekunden und Millisekunden). Diese Dateisystemprotokolle bieten mehr Informationen, wenn Sie Einzelheiten zu Fehlern benötigen.

Häufig auftretende Probleme

Stellen Sie fest, ob eines der folgenden Probleme einen Upgradefehler, eine Warnmeldung oder ein Problem in der Website verursacht.

F: Ich kann ein UI-Steuerelement, das vorher noch da war, nicht auf der Seite finden.

• A: Setzen Sie die Seite auf die Standardversion zurück (d. h., führen Sie reghost aus).

Wenn Sie Änderungen an der Benutzeroberfläche der Website vornehmen, kann dies Probleme bei Websiteupgrades verursachen. Wenn Sie beispielsweise ein UI-Steuerelement an einer nicht standardmäßigen Stelle platziert haben, können Sie die Seite auf die Standardversion zurücksetzen, um das Steuerelement wiederherzustellen.

Zum Zurücksetzen der Seite können Sie den Link Auf Websitedefinition zurücksetzen unter Websiteaktionen auf der Seite Websiteeinstellungen oder den Befehl Auf Vorlage zurücksetzen in SharePoint Designer verwenden.

F: Bei einer umfangreichen Liste funktioniert die Ansicht nicht mehr.

• A: Erstellen Sie für umfangreiche Listen indizierte Spalten, Ordner oder neue Ansichten. Möglicherweise müssen Sie die indizierte Spalte den vorhandenen Ansichten hinzufügen.

Falls eine Liste sehr umfangreich ist und die Benutzer eine Ansicht verwenden oder eine Abfrage ausführen, die den Grenzwert oder den Einschränkungsschwellenwert überschreitet, ist die Ansicht oder Abfrage nicht zulässig. Sie können mithilfe gefilterter Ansichten indizierte Spalten erstellen, Elemente in Ordnern anordnen, einen Elementgrenzwert auf der Seite für eine umfangreiche Ansicht festlegen oder eine externe Liste verwenden. Weitere Informationen zur Drosselung großer Listen und zum Beheben von Problemen mit großen Listen finden Sie unter Verwalten von Listen und Bibliotheken mit vielen Elementen.

F: Ich erhalte einen Fehler über einen doppelt vorhandenen Namen eines Inhaltstyps.

• A: Benennen Sie Inhaltstypen oder Felder um, die mit bereits vorhandenen Standardnamen kollidieren.

Es kann vorkommen, dass ein benutzerdefiniertes Element (z. B. ein Inhaltstyp) einen Namen hat, der mit einem Namen in der neuen Version identisch ist.

In den Upgradeprotokolldateien finden Sie dann eine Fehlermeldung ähnlich der folgenden:

Hinweis

Beachten Sie, dass durch das Umbenennen oder Entfernen eines Inhaltstyps Anpassungen, in denen dieser Inhaltstyp verwendet wird, möglicherweise nicht mehr funktionieren.

F: Meine Website sieht durcheinander aus, verhält sich nicht wie erwartet, oder es werden Skriptfehler angezeigt.

• A: Bearbeiten Sie die Seite entweder, setzen Sie die Seite auf die Standardversion zurück, oder entfernen oder ersetzen Sie die benutzerdefinierten Dateien.

  Diese Symptome können durch ein Problem mit benutzerdefinierten oder Inline-JavaScript- oder -CSS-Dateien verursacht werden.

F: Benutzerdefinierte Inhalte meiner Website sind verschwunden oder funktionieren nicht.

• A: Ändern Sie die Gestaltungsvorlage, oder ändern Sie den Inhalt so, dass er keine bestimmten Zonen erfordert.

  The master page might have different zone layouts and the content might no longer reference it correctly. As a last resort, you can also reset the page to the default version. However, if you reset the page, you might lose zone specific content.

F: Ich erhalten eine Fehlermeldung, dass ein Steuerelement oder eine Seite nicht gerendert werden kann.

• A: Führen Sie einen der folgenden Schritte aus:

  • Wenn ein Webpart hinzugefügt wurde, das nicht installiert ist, wenden Sie sich an den Farmadministrator, um es zu installieren. Wenn ein Webpart ist, das nicht mehr verfügbar oder nicht unterstützt wird, verwenden Sie die Webpart-Wartungsansicht, um das Webpart von der Seite zu entfernen (entfernen, schließen Sie nicht einfach das Webpart).

  • Wenn eine Seite direkt bearbeitet wurde, bearbeiten Sie sie entweder erneut, um das Steuerelement bzw. Webpart zu entfernen, oder setzen Sie die Seite auf die Standardversion zurück.

    Möglicherweise wurde der Seite ein Webpart oder ein anderes Steuerelement hinzugefügt, das nicht installiert ist oder nicht mehr unterstützt wird. Entweder wurde ein Webpart einer Zone hinzugefügt, oder die Seite wurde direkt bearbeitet, um einen Verweis auf ein Steuerelement oder Webpart direkt inline hinzuzufügen (wahrscheinlich in einer Gestaltungsvorlage).

    Es muss möglicherweise ein SharePoint-Feature aktiviert werden. Weitere Informationen finden Sie unter Aktivieren oder Deaktivieren von Websitesammlungsfeatures und Öffnen und Verwenden der Webpartwartungsseite.

F: Meine aktualisierte Seite rendert überhaupt nicht, stattdessen wird mir ein "unerwarteter Fehler" mit einer Korrelations-ID angezeigt

A: Für Ihr benutzerdefiniertes Branding wird möglicherweise eine benutzerdefinierte Gestaltungsvorlage verwendet, die einen benutzerdefinierten Inhaltsplatzhalter verwendet.

Wenn Ihre benutzerdefinierte Gestaltungsvorlage einen benutzerdefinierten Inhaltsplatzhalter verwendet und die benutzerdefinierten Seitenlayouts diesen Platzhalter ebenfalls enthalten, wird das Rendern der Startpage Ihrer Website nach dem Upgrade möglicherweise aufgrund eines Fehlers verhindert. Stattdessen wird nach dem Upgrade möglicherweise die Fehlermeldung angezeigt, dass ein unerwarteter Fehler aufgetreten ist.

Siehe auch

Konzepte

Aktualisieren einer Websitesammlung auf SharePoint Server 2019