Behandeln von Problemen beim Datenbankupgrade in SharePoint 2013

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

Selbst nach dem Testen des Upgradeprozesses auf mögliche Probleme kann es sein, dass während eines Upgrades von SharePoint 2010-Produkte auf SharePoint 2013 unerwartete Probleme auftreten. Sollte dies der Fall sein, können Sie die Benutzerfreundlichkeit des Systems umso besser sicherstellen, je früher Sie das jeweilige Problem erkennen und beheben.

Dieser Artikel enthält eine Liste häufig auftretender Probleme und beschreibt allgemeine Prinzipien, die Ihnen helfen, Upgradeprobleme zu identifizieren und zu beheben. Nachdem Sie die Probleme identifiziert und behoben haben, können Sie das Upgrade fortsetzen. Weitere Informationen zum Fortsetzen des Upgrades finden Sie unter Neustarten eines Upgrades an die Datenbank oder eines Websitesammlungsupgrades auf SharePoint 2013.

Allgemeine Prinzipien zur Erkennung von Problemen

Überprüfen Sie den Upgradestatus, um festzustellen, wo das Upgrade beendet wurde (falls es beendet wurde), und überprüfen Sie die Protokolldateien, um Fehler oder Warnungen zu finden. Beheben Sie als Nächstes die Probleme, die Sie finden, bevor Sie das Upgrade fortsetzen.

Überprüfen Sie zuerst den Upgradestatus und die Protokolldateien

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

1. Überprüfen Sie die Seite "Upgradestatus" in der die Website für die SharePoint-Zentraladministration.

   Weitere Informationen zum Überprüfen des Upgradestatus finden Sie unter Überprüfen der Datenbankupgrades in SharePoint 2013.

2. Überprüfen Sie die folgenden Protokolldateien:

• Die Upgradefehler-Protokolldatei und die Upgradeprotokolldatei (letztere enthält mehr Informationen).

• ULS- oder Ablaufverfolgungs-Protokolldateien.

  Diese Dateien werden im Ordner %COMMONPROGRAMFILES%\Microsoft Shared\Web Server Extensions\15\LOGS gespeichert und heißen Servername_ JJJJMMDD- MMSS.log.

• Die Anwendungsereignis-Protokolldatei.

  Diese Datei können Sie in der Ereignisanzeige ansehen.

  Weitere Informationen zu den Upgradeprotokolldateien finden Sie unter Überprüfen der Datenbankupgrades in SharePoint 2013. Weitere Informationen zur Ablaufverfolgungs-Protokolldatei finden Sie unter Ablaufverfolgungsprotokolle auf der MSDN-Website.

Beheben Sie dann die Probleme in der richtigen Reihenfolge

Manche Probleme haben mehr Auswirkungen als andere. Beispielsweise kann eine fehlende serverseitige Datei viele scheinbar nicht damit zusammenhängende Fehler auf Websiteebene verursachen.

Beheben Sie die Probleme in der folgenden Reihenfolge:

1. Fehlende serverseitige Dateien oder Anpassungen, z. B. Features oder Webparts.

   Achten Sie darauf, alle serverseitigen Anpassungen wie Features, Webparts usw. zu installieren. Stellen Sie sicher, dass Sie Anpassungen am richtigen Speicherort in Ihrer neuen Farm installieren. Beispielsweise sollten zusätzliche Stylesheets, die Sie für SharePoint 2010-Produkte benötigen, im Pfad /14 und nicht im neuen Pfad /15 installiert werden, damit Websitesammlungen, die Sie nicht aktualisiert haben, diese verwenden können. Stellen Sie außerdem sicher, dass Sie alle eindeutigen Einstellungen aus den Web.config Dateien für jede Webanwendung auf die neuen Server übertragen.

2. Konfigurationsprobleme in der Serverfarm, der Webanwendung oder in Dienstanwendungen, wie z. B. verwaltete Pfade oder Dienstanwendungen, die nicht gestartet werden.

3. Weitere Probleme, die Sie entdeckt haben, Website für Website, wobei Sie mit den Websites beginnen, bei denen die Auswirkungen am gravierendsten sind oder die sehr wichtig sind.

Während der Behebung der wichtigsten Probleme können Sie versuchen, das Upgrade erneut auszuführen, um herauszufinden, ob dadurch Probleme, die später im Upgradeprozess aufgetreten sind, ebenfalls behoben wurden.

Häufig auftretende Probleme

Überprüfen Sie, ob eines der folgenden Probleme einen Upgradefehler oder eine Warnmeldung verursacht.

F: Ich möchte ein Upgrade von einer Vorabversion von SharePoint 2013 durchführen

• A: Ein Upgrade von einer Vorabversion von SharePoint 2013 auf die veröffentliche Version von SharePoint 2013 wird nicht unterstützt.

  Vorabversionen sind nur zu Testzwecken bestimmt und sollten nicht in Produktionsumgebungen verwendet werden. Deshalb wird ein Upgrade von einer Vorabversion zu einer anderen Version nicht unterstützt.

F: Laut Protokollen fehlen mir Vorlagen, Features oder serverseitige Anpassungen

• A: Ermitteln Sie alle serverseitigen Anpassungen und installieren Sie diese vor dem Upgrade.

Ein häufiger Fehler beim Upgrade sind fehlende serverseitige Dateien – entweder Dateien, die mit SharePoint 2010-Produkten installiert wurden, oder angepasste Dateien. Bei der Vorbereitung des Upgrades sollten Sie einen Bestand der serverseitigen Anpassungen (z. B. Websitedefinitionen, Vorlagen, Features, Webparts und Assemblys) erstellt haben, die Sie für die Websites benötigen. Stellen Sie anhand dieser Bestandsliste sicher, dass alle Dateien, die für Ihre Anpassungen benötigt werden, in der neuen Upgradeumgebung installiert werden.

Mithilfe des test-spcontentdatabase Microsoft PowerShell-Cmdlets können Sie die fehlenden Dateien vor dem Upgrade ermitteln. Sie können auch anhand des enumallwebs -Vorgangs in "Stsadm.exe" feststellen, welche serverseitigen Anpassungen verwendet werden.

In den Upgradeprotokolldateien können z. B. Fehler wie die folgenden aufgeführt sein:

• FEHLER Verweiszahl Web(s) gefunden, in denen die fehlende Webvorlage Websitevorlagenbezeichner (lcid: Sprachcode der Websitevorlage) in Inhaltsdatenbank Name der Inhaltsdatenbank verwendet wird.

• FEHLER: Fehlende Feature-ID gefunden = [Featurebezeichner]

• WARNUNG Die Datei [Relativer Dateipfad] wird in der Datenbank mal auf [Verweisanzahl] verwiesen, aber nicht in der aktuellen Farm installiert.

• WARNING WebPart-Klasse [Webpartbezeichner] wird in der Datenbank mal auf [Reference Count] verwiesen, aber nicht in der aktuellen Farm installiert.

• WARNING Assembly [Assembly Path] wird in der Datenbank referenziert, aber nicht in der aktuellen Farm installiert.

• WARNUNG Das Feature wurde nicht geupgradet. Ausnahme: Die Featuredefinitions-ID "Featurebezeichner" wurde nicht gefunden.

Wenn Sie eine fehlende serverseitige Datei oder Abhängigkeit beschaffen können, installieren Sie sie, und führen Sie dann das Upgrade für die betroffenen Websites erneut aus. Ist die Datei oder Abhängigkeit (z. B. ein Webpart) veraltet, müssen Sie herausfinden, ob Sie die Website, die Seite oder das Webpart neu erstellen möchten, um eine andere Vorlage, ein anderes Feature oder ein anderes Webpart zu verwenden. Wenn Sie die Anpassung mithilfe von nicht veralteten Abhängigkeiten erneut vornehmen können, können Sie das Upgrade für die betroffenen Websites erneut ausführen. Lässt sich die Abhängigkeit nicht entfernen, können Sie die Website nicht upgraden.

Nachdem Sie die fehlende Datei oder Abhängigkeit installiert haben, verwenden Sie das Microsoft PowerShell-Cmdlet test-SPContentDatabase auf einem Testserver, um zu ermitteln, ob andere Dateien für diese Datenbank fehlen. Wenn Sie nur das Upgrade erneut ausführen, taucht der Fehler vielleicht nicht in den Protokolldateien auf, obwohl er u. U. nach wie vor vorliegt.

F: Die Protokolldatei besagt, dass mit den Konfigurationseinstellungen meiner Farm, Webanwendungen oder Dienstanwendungen etwas nicht stimmt

• A: Überprüfen Sie die Einstellungen Ihrer Farm und der Webanwendung.

• A: Erstellen und starten Sie fehlende Dienstanwendungen.

• A: Stellen Sie sicher, dass verwaltete Pfade (eingeschlossene Pfade) für jede Webanwendung korrekt konfiguriert sind.

In den Upgradeprotokolldateien können z. B. Fehler wie die folgenden aufgeführt sein:

• FEHLER Vorlagen-ID: SPSite Id= Site ID konnte aufgrund einer Ausnahme nicht zugegriffen werden. SPWeb-ID= Web-ID wird für das Upgrade der Vorlage übersprungen. Ausnahme: System.IO.FileNotFoundException: Die Website mit der ID Website-ID wurde nicht gefunden.

  Dieser Fehler weist darauf hin, dass ein verwalteter Pfad fehlt. Fügen Sie der Webanwendung den verwalteten Pfad für die Websitesammlung hinzu, und starten Sie das Upgrade für die Inhaltsdatenbank neu, in der diese Websitesammlung enthalten ist.

F: Während des Upgrades werden Fehler und Warnungen zur Konnektivität oder Beschädigungen angezeigt

• A: Überprüfen Sie die Stromverbindung sowie die Verbindung zum Netzwerk und zu SQL Server. Störungen bei der Konnektivität zu Datenquellen können Fehler verursachen. Wenn die Server keine Verbindung zu den Datenbanken herstellen können, kann kein Upgrade durchgeführt werden.

F: Ich benötige mehr Festplattenspeicherplatz

• Eine: Geben Sie Speicherplatz frei, oder erhöhen Sie die Größe der Transaktionsprotokolldatei, bevor Sie das Upgrade fortsetzen. Wenn nicht mehr genügend Speicherplatz vorhanden ist (z. B. für Transaktionsprotokolldateien auf den Datenbankservern), kann das Upgrade nicht fortgesetzt werden.

  Weitere Informationen finden Sie unter Verwalten der Größe der Transaktionsprotokolldatei.

F: Es ist ein Fehler bei der Authentifizierung aufgetreten

• A: Stellen Sie sicher, dass die Webanwendung die richtige Authentifizierungsmethode verwendet.

Konflikte der Authentifizierungsmethoden können beim Upgrade zu Problemen führen. Mithilfe der folgenden Ressourcen können Ihnen bei einem Konflikt zwischen Authentifizierungsmethoden helfen:

• von klassischer zu anspruchsbasierter Authentifizierung

  Stellen Sie sicher, dass die Webanwendungen, die Sie in SharePoint 2013 erstellt haben, dieselbe Authentifizierungsmethode wie in SharePoint 2010-Produkte verwenden. Die anspruchsbasierte Authentifizierung ist die Standardauthentifizierungsmethode für Webanwendungen in SharePoint 2013. Wenn die Webanwendung den klassischen Modus verwendet hat, können Sie sie vor dem Upgrade der Datenbank zur anspruchsbasierten Authentifizierung aktualisieren, oder Sie können die Webanwendung im klassischen Modus erstellen und dann zur anspruchsbasierten Authentifizierung migrieren. Weitere Informationen zum Erstellen einer Webanwendung, die den klassischen Modus verwendet, und zum anschließenden Migrieren zu Ansprüchen finden Sie unter [Erstellen von Webanwendungen, die die Authentifizierung im klassischen Modus in SharePoint Server verwenden]/previous-versions/office/sharepoint-server-2010/gg276326(v=office.14)) und Migrieren von der klassischen zur anspruchsbasierten Authentifizierung in SharePoint 2013

• Formularbasierte Authentifizierung

  Zusätzliche Schritte sind erforderlich, wenn Sie ein Upgrade für eine Umgebung ausführen, in der die formularbasierte Authentifizierung verwendet wird. Führen Sie die Schritte unter Configure forms-based authentication for a claims-based web application in SharePoint Server für ein Upgrade von formularbasierten Authentifizierungsanbietern aus.

F: SQL Server besagt, dass mir Berechtigungen fehlen

• A: Wenn Sie eine Fehlermeldung über ein unbekanntes Konto erhalten, oder wenn eine Datenbank nicht aktualisiert wurde, überprüfen Sie die Berechtigungen für die Datenbank. Stellen Sie vor allem zwischen SQL Server-Instanzen sicher, dass die Sicherheit korrekt konfiguriert wurde. Überprüfen Sie, dass die verwendeten Anmeldekonten die entsprechenden festen Rollen und Berechtigungen für die Datenbanken besitzen und dass noch gültig sind, wenn Sie ein domänenübergreifendes Upgrade durchführen.

• A: Stellen Sie sicher, dass das Konto, mit dem Sie die Datenbanken anfügen, Mitglied der festen Datenbankrolle db_owner für die zu aktualisierenden Datenbanken ist.

F: Das Upgrade einer Datenbank ist nicht erfolgreich

• **A: ** Stellen Sie sicher, dass der Schreibschutz der Datenbank nicht aktiviert ist. Für eine schreibgeschützte Datenbank kann kein Upgrade ausgeführt werden. Sie müssen sicherstellen, dass Sie den Schreibschutz der Datenbanken aufheben, bevor Sie die Datenbanken anfügen und aktualisieren.

F: Ich habe den Namen einer Datenbank während der Wiederherstellung geändert, kann jedoch die Dateien mit diesem Namen nicht finden

• **A: ** Wenn Sie eine Datenbank während der Wiederherstellung umbenennen, müssen Sie auch die Datenbank- und Protokolldateinamen im Dateisystem (die MDF- und LDF-Dateien) entsprechend umbenennen.

F: Es gelingt mir nicht, die Verwaltungsdatenbank der Suchdienstanwendung zu sichern

• **A: ** Before you can back up the Search service application Administration database, you must stop the Search service on your SharePoint Server 2010 farm. To stop the Search service, on the original farm, on the Start menu, click Administrative Tools, and then click Services. Right-click SharePoint Server Search 14, and then click Stop. Be sure to start the service again after you back up the database.

F: Die vertrauenswürdigen Verbindungen für Excel Services funktionieren nach dem Upgrade nicht

• **A: ** Nach dem Upgrade müssen Sie alle vertrauenswürdigen Datenverbindungen für Excel Services manuelle erstellen.

F: Die Zuordnung meiner Workflows stimmt nicht mehr

• **A: ** Stellen Sie sicher, dass der Zeitgeberauftrag "Automatischer Workflowcleanup" deaktiviert ist. Wenn der Zeitgeberauftrag "Automatischer Workflowcleanup" in Ihrer SharePoint 2010-Produkte-Umgebung deaktiviert war, müssen Sie diesen auch in der neuen Umgebung deaktivieren. Wenn dieser Zeitgeberauftrag in Ihrer neuen Umgebung aktiviert ist und in der SharePoint 2010-Produkte-Umgebung deaktiviert war, gehen beim Upgrade möglicherweise Workflowzuordnungen verloren.

F: Ich habe Sie Benutzer von der klassischen Windows-Authentifizierung zur anspruchsbasierten Authentifizierung migriert. Doch einige Benutzer verfügen jetzt über veraltete Daten

• **A: ** Stellen Sie zum Vermeiden von Problemen mit Benutzerprofilen sicher, dass der Auftrag "Vollständige Synchronisierung des Benutzerprofils mit SharePoint" ausgeführt wurde.

  Wenn Sie den Auftrag Benutzerprofil für die vollständige Synchronisierung von SharePoint (entweder automatisch oder manuell) gestartet haben, bevor der Migrationsprozess abgeschlossen wurde, werden einige Benutzer möglicherweise nicht migriert. Sie können das folgende Cmdlet in Microsoft PowerShell ausführen, nachdem die Migration abgeschlossen ist, um die Synchronisierungsdaten zu löschen. Anschließend können Sie den Vollständigen Synchronisierungsauftrag für Benutzerprofil für SharePoint erneut ausführen, um die zusätzlichen Benutzer einzuschließen.

  $database = Get-SPContentDatabase "DatabaseName"
  [Microsoft.Office.Server.UserProfiles.WSSProfileSynch]::ClearSyncDataForContentDatabase($database)
  

  Dabei ist DatabaseName der Name der Inhaltsdatenbank für die Websitesammlung, die dem veralteten Benutzerprofil zugeordnet ist.

• **A: ** Vergewissern Sie sich, dass der Benutzer in der Active Directory-Domäne vorhanden ist.

  Falls der Benutzer nicht vorhanden ist, können Sie ihn in der Tabelle "UserInfo" als gelöscht kennzeichnen. Ist er vorhanden, können Sie die Migration erneut ausführen. Weitere Informationen finden Sie unterMigrieren von der klassischen Authentifizierung zur anspruchsbasierten Authentifizierung in SharePoint 2013.

Siehe auch

Weitere Ressourcen

Use a trial upgrade to SharePoint 2013 to find potential issues

Überprüfen der Datenbankupgrades in SharePoint 2013

Überprüfen der auf SharePoint 2013 aktualisierten Websitesammlungen

[Neustarten eines Upgrades zum Anfügen einer Datenbank oder eines Websitesammlungsupgrades auf SharePoint 2013] (/previous-versions/office/sharepoint-server-2010/ff382638(v=office.14)