Behandeln von Problemen beim Upgrade der Websitesammlung in SharePoint 2013

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

Beim Upgrade einer Websitesammlung auf SharePoint 2013 können gelegentlich Fehler auftreten. Mit den Informationen in diesem Artikel können Sie diese Fehler besser nachvollziehen und effektiver beheben.

Weitere Informationen zum Analysieren von Problemen mit der Benutzeroberfläche in Websites finden Sie unter Überprüfen der auf SharePoint 2013 aktualisierten Websitesammlungen.

Ü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\15\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:

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

Dieser Fehler weist darauf hin, dass der angegebenen Website in SharePoint Server 2010 ein Inhaltstyp eines Drittanbieters hinzugefügt wurde. Während des Upgrades auf SharePoint 2013 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.

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. Weitere Informationen finden Sie unter Branding issues that may occur when upgrading to SharePoint 2013 [Migrated].

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. Dabei können jedoch möglicherweise zonenspezifische Inhalte verloren gehen. Weitere Informationen finden Sie unter Branding issues that may occur when upgrading to SharePoint 2013 [Migrated].

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: Ich erhalte eine Fehlermeldung, wonach ich eine Unterwebsite nicht auf Basis einer Websitevorlage erstellen kann, weil die Websitevorlage die 2010er Version verwendet und meine Websitesammlung in der Version 2013 vorliegt.

• A: Erstellen Sie die Websitevorlage in der 2013er Benutzeroberfläche neu.

  Zum Neuerstellen der Websitevorlage legen Sie eine neue Unterwebsite auf der Grundlage der 2013er Benutzeroberfläche an, passen diese erneut an, sodass sie der Vorlage entspricht, die Sie vorher hatten, und speichern die angepasste Unterwebsite dann als Vorlage (klicken Sie dazu auf der Seite Websiteeinstellungen auf Website als Vorlage speichern).

F: Ich erhalte einen Fehler beim Versuch, eine FAST-Suchcenter-Website auf die 2013er-Umgebung zu aktualisieren.

• A: Erstellen Sie die Website mithilfe der Vorlage Unternehmenssuchcenter erneut.

  FAST-Suchcenter-Websites können nicht auf die 2013er-Umgebung aktualisiert werden. Bestehende FAST-Suchcenter-Websites funktionieren nach dem Upgrade weiterhin im 2010-Modus. Wenn Sie auf die neue Funktion zugreifen möchten, müssen Sie neue Unternehmenssuchcenter-Websites im 2013-Modus erstellen.

F: Mein benutzerdefiniertes Branding sieht nicht richtig aus, oder es gibt Fehler auf der aktualisierten Website

A: Erstellen Sie eine Websitesammlung zur Evaluierung, und erstellen Sie anschließend die Gestaltungsvorlage in der SharePoint 2013-Website erneut.

Zur Unterstützung einer neuen, flüssigeren Benutzeroberfläche in SharePoint 2013 wurden Änderungen an den Standardgestaltungsvorlagen und den CSS-Dateien vorgenommen. Aus diesem Grund ist es nicht möglich, eine Gestaltungsvorlage, die in SharePoint 2012 erstellt wurde, auf eine Website in SharePoint 2013 anzuwenden. Wenn Sie allerdings Ihre SharePoint 2010-Website auf SharePoint 2013 aktualisieren, wird die Gestaltungsvorlage zurückgesetzt, und Sie erhalten die Standardgestaltungsvorlage in SharePoint 2013. Nach dem Upgrade wird das benutzerdefinierte Branding der Website also nicht angezeigt.

Zum Beheben dieses Problems sollten Sie zuerst eine Websitesammlung zur Evaluierung erstellen und anschließend die Gestaltungsvorlage in SharePoint 2013 erneut erstellen. Weitere Informationen finden Sie unter Branding issues that may occur when upgrading to SharePoint 2013 [Migrated].

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 "Ein unerwarteter Fehler ist aufgetreten" angezeigt. Weitere Informationen finden Sie unter Brandingprobleme, die beim Upgrade auf SharePoint 2013 [Migriert] auftreten können.

Siehe auch

Weitere Ressourcen

Überprüfen der auf SharePoint 2013 aktualisierten Websitesammlungen

Upgrade a site collection to SharePoint 2013

Tests und Problembehandlung bei einem Upgrade auf SharePoint 2013

Use a trial upgrade to SharePoint 2013 to find potential issues