Behandeln von Problemen beim Upgrade der Websitesammlung in SharePoint Server 2016

 

**Gilt für:**SharePoint Server 2016

**Letztes Änderungsdatum des Themas:**2016-12-30

Zusammenfassung: Hier erfahren Sie, wie Sie Probleme behandeln, die nach dem Upgrade einer Website auf SharePoint Server 2016 auftreten können.

Beim Upgrade einer Websitesammlung auf SharePoint Server 2016 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: Protokolldateien für Websitesammlungsupdates werden auch innerhalb der Websitesammlung selbst gespeichert, im Katalog für Wartungsprotokolle unter http://<Websitename>/_catalogs/MaintenanceLogs/JJJJMMTT-SSMMss-sss.txt, wobei JJJJMMTT das Datum und SSMMss-sss die Uhrzeit 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 Protokolldateien werden im folgenden Format benannt: SiteUpgrade-YYYYMMDD-HHMMSS-SSS.log, wobei YYYYMMDD das Datum und HHMMSS-SSS die Uhrzeit ist (Stunden im 24-Stunden-Format, Minuten, Sekunden, 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 zum Einschränken von umfangreichen Listen und Beheben von Problemen bei umfangreichen Listen finden Sie unter Verwalten von Listen und Bibliotheken mit vielen Elementen auf Office Online.

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:

  • Fehler beim Aktivieren der Websitesammlungsfeatures auf der Website Website-URL. Ausnahme: Ein doppelter Inhaltstypname "name" wurde gefunden.

Dieser Fehler weist darauf hin, dass der angegebenen Website in SharePoint Server 2013 with Service Pack 1 (SP1) ein Inhaltstyp eines Drittanbieters hinzugefügt wurde. Während des Upgrades auf SharePoint Server 2016 stellte sich dann heraus, dass dessen Name mit dem Namen des Standardinhaltstyps identisch ist. Geben Sie dem Inhaltstyp eines Drittanbieters in der angegebenen Website einen anderen Namen, und führen Sie das Upgrade erneut aus. Weitere Informationen finden Sie unter Erstellen oder Anpassen eines Inhaltstyps auf Office Online.

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.

    Die Gestaltungsvorlage hat möglicherweise mehrere Zonenlayouts, die von den Inhalten nicht mehr korrekt referenziert werden. Notfalls können Sie die Seite auch auf die Standardversion zurücksetzen. Dabei können jedoch u.&amp;nbsp;U. zonenspezifische Inhalte verloren gehen.

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, bitten Sie den Farmadministrator, es zu installieren. Ist das Webpart nicht mehr verfügbar, oder wird es nicht unterstützt, dann verwenden Sie die Webpart-Wartungsansicht, um das Webpart aus der Seite zu entfernen. (Sie müssen das Webpart entfernen, nicht einfach nur schließen.)

    • 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 Seite zum Warten von Webparts auf Office Online.

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.

See also

Upgrade einer Websitesammlung auf SharePoint Server 2016