Beheben von Problemen beim Upgrade (SharePoint Foundation 2010)

Artikel
12/02/2016

Gilt für: SharePoint Foundation 2010

Letztes Änderungsdatum des Themas: 2016-11-30

Selbst nach dem Testen des Upgradeprozesses auf mögliche Probleme kann es sein, dass während eines Upgrades von Windows SharePoint Services 3.0 auf Microsoft SharePoint Foundation 2010 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.

In diesem Artikel werden allgemeine Grundsätze zum Erkennen und Beheben von Problemen beim Upgrade beschrieben. Sie finden hier auch eine Liste häufig auftretender Probleme. Nachdem Sie die jeweiligen Probleme erkannt und behoben haben, können Sie das Upgrade fortsetzen. Weitere Informationen zum Fortsetzen des Upgrades finden Sie unter Fortsetzen des Upgrades (SharePoint Foundation 2010).

Inhalt dieses Artikels:

Allgemeine Grundsätze zum Erkennen von Problemen
Häufig auftretende Probleme
- Fehlende oder veraltete serverseitige Dateien oder Anpassungen
- Falsch konfigurierte oder fehlende Einstellungen für die Serverfarm, die Webanwendung oder Dienste
- Inkonsistente oder falsche Updatestufen
- Fehlende globale Navigation für Blogs
- Probleme bei Daten
- Änderungen in der Benutzeroberfläche
- Speicherplatzmangel
- Formularbasierte Authentifizierung
- Sicherheit und Berechtigungen
- "STP"-Dateien funktionieren nach der Aktualisierung nicht
- Neue Versionen der "Fabulous 40"-Anwendungsvorlagen können nicht gefunden werden

Allgemeine Grundsätze zum Erkennen von Problemen

Überprüfen Sie zuerst den Upgradestatus, um herauszufinden, an welcher Stelle das Upgrade ggf. unterbrochen wurde. Untersuchen Sie die Protokolldateien auf etwaige Fehler oder Warnmeldungen. Beheben Sie dann die Probleme, bevor Sie das Upgrade fortsetzen.

Überprüfen Sie zuerst den Upgradestatus und die 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, 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.

Überprüfen Sie den Upgradestatus, indem Sie einen der folgenden Schritte oder beide ausführen:
- Lesen Sie die Seite Upgradestatus auf der Website für die SharePoint-Zentraladministration.
- Verwenden Sie den localupgradestatus-Vorgang in Stsadm.exe, um den Upgradestatus zu überprüfen.
Weitere Informationen zum Überprüfen des Upgradestatus finden Sie unter Überprüfen der Aktualisierung und der aktualisierten Websites (SharePoint Foundation 2010).
Überprüfen Sie die folgenden Protokolldateien:
- Die Protokolldatei zu Setup.exe.
- Die Protokolldateien des Konfigurations-Assistent für SharePoint-Produkte (Psconfig.exe).
- 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\14\LOGS gespeichert und heißen Servername_JJJJMMTT-mmss.log.
- Die Anwendungsereignis-Protokolldatei.
  
  Diese Datei können Sie in der Ereignisanzeige ansehen.
Weitere Informationen zu den Dateien Setup.exe und PSconfig.exe sowie zu den Upgradeprotokolldateien finden Sie unter Überprüfen der Aktualisierung und der aktualisierten Websites (SharePoint Foundation 2010). Weitere Informationen zur Ablaufverfolgungs-Protokolldatei finden Sie unter Ablaufverfolgungsprotokolle (https://go.microsoft.com/fwlink/?linkid=182380&clcid=0x407) in MSDN.

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:

Fehlende serverseitige Dateien oder Anpassungen, z. B. Features oder Webparts.
Konfigurationsprobleme in der Serverfarm, der Webanwendung oder in Diensten, z. B. verwaltete Pfade oder Dienste, die nicht gestartet werden.
Weitere Probleme, die Sie entdeckt haben, Website für Website, wobei Sie mit den Websites beginnen, bei denen die Auswirkungen am gravierendsten sind und die am stärksten genutzt werden.

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.

Fehlende oder veraltete serverseitige Dateien oder Anpassungen

Ein häufig vorkommendes Problem während des Upgrades stellen fehlende serverseitige Dateien dar – entweder Dateien, die mit Windows SharePoint Services 3.0 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 Ihre Websites benötigen. (Diese Elemente können Sie mithilfe des Tools zum Ausführen einer Überprüfung vor dem Upgrade ermitteln.) Stellen Sie anhand dieser Bestandsliste sicher, dass alle Dateien, die für Ihre Anpassungen benötigt werden, in der Upgradeumgebung installiert werden.

Wenn Sie ein Upgrade durch Datenbankanfügungen ausführen, können Sie vor dem Upgrade der Datenbank das test-SPContentDatabaseWindows PowerShell-Cmdlet verwenden, um etwaige fehlende Dateien zu identifizieren. Sie können auch anhand des enumallwebs-Vorgangs in Stsadm.exe feststellen, welche serverseitigen Anpassungen verwendet werden.

In den Upgradeprotokolldateien können 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]
FEHLER Auf die Datei [Relativer Dateipfad] wird in der Datenbank [Verweiszahl] Mal verwiesen, sie ist jedoch für die aktuelle Farm nicht installiert.
WARNUNG Auf die WebPart-Klasse [Webpartbezeichner] wird in der Datenbank [Verweiszahl] Mal verwiesen, sie ist jedoch für die aktuelle Farm nicht installiert.
WARNUNG Auf die Assembly [Assemblypfad] wird in der Datenbank verwiesen, sie ist jedoch für die aktuelle Farm nicht 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 test-SPContentDatabase-Cmdlet in Windows PowerShell auf einem Testserver, um herauszufinden, ob weitere Dateien für diese Datenbank fehlen. Wenn Sie nur das Tool zum Ausführen einer Überprüfung vor dem Upgrade ausführen oder das Upgrade erneut ausführen, taucht der Fehler vielleicht nicht in den Protokolldateien auf, obwohl er u. U. nach wie vor vorliegt.

Falsch konfigurierte oder fehlende Einstellungen für die Serverfarm, die Webanwendung oder Dienste

Überprüfen Sie die Einstellungen für die Farm und die Webanwendung, und erstellen und starten Sie fehlende Dienste.

Überprüfen Sie, ob etwaige verwaltete Pfade (eingeschlossene oder ausgeschlossene Pfade) für jede Webanwendung korrekt konfiguriert sind.

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

FEHLER Vorlage Vorlagen-ID: SPSite-ID=Website-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.

Inkonsistente oder falsche Updatestufen

Sie müssen Windows SharePoint Services 3.0 mit Service Pack 2 ausführen, um das Upgrade ausführen zu können. Ist diese Mindestvoraussetzung nicht erfüllt, wird ein Fehler ausgegeben, und das Upgrade wird nicht ausgeführt.

Ein weiterer häufiger Fehler ist das Fehlen der globalen Navigation in aktualisierten Blogs. Die Ursache dafür ist, dass das Feature MySiteNavigation (6adff05c-d581-4c05-a6b9-920f15ec6fd9) während der Aktualisierung nicht aktiviert wird. Um dieses Feature zu aktivieren, führen Sie das Windows PowerShell 2,0-Cmdlet Enable-SPFeature aus.

Weitere Informationen finden Sie unter Enable-SPFeature.

Probleme bei Daten

Die folgenden Probleme in Bezug auf Daten können Fehler oder Warnmeldungen während des Upgrades zur Folge haben:

Herstellen von Verbindungen zu Datenquellen. Wenn die Server keine Verbindung zu den Datenbanken herstellen können, können sie nicht geupgradet werden.
Verwaiste Websites oder Listen oder andere Datenbankbeschädigungen. Weitere Informationen finden Sie unter Bereinigen der Umgebung vor dem Upgrade (SharePoint Foundation 2010).
Verborgene Spaltendaten. Wenn einer Liste beim Upgradeprozess eine Spalte hinzugefügt wird und bereits eine benutzerdefinierte Spalte mit dem gleichen Namen in der Liste vorhanden ist, wird die benutzerdefinierte Spalte umbenannt. Nach dem Upgrade müssen Sie u. U. die Ansichten erneut anpassen, damit die umbenannte Spalte mit angezeigt wird.

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

WARNUNG Die verwaisten Websites verursachen ggf. Upgradefehler.
FEHLER Datenbank [Name der Inhaltsdatenbank] enthält eine Website (ID = [Websitesammlungsbezeichner], URL = [Websitesammlungs-URL]), die in der Siteübersicht nicht gefunden wurde.

Beheben Sie Probleme mit verwaisten Elementen, oder reparieren Sie Datenbankbeschädigungen, und führen Sie dann das Upgrade erneut aus.

Änderungen in der Benutzeroberfläche

Änderungen in der Benutzeroberfläche (User Interface, UI), z. B. die Hinzufügung der Fluent-Benutzeroberfläche (auch als Menüband bezeichnet) oder die Einhaltung von XHTML-Standards, können Probleme in Websites verursachen. Es kann vorkommen, dass benutzerdefinierte Elemente (etwa ein Inhaltstyp) einen Namen haben, der mit einem Namen in der neuen Version in Konflikt steht, oder dass Sie bestimmte Seiten auf die Standard-Websitedefinition zurücksetzen oder für umfangreiche Listen neue Ansichten erstellen müssen.

Weitere Informationen zum Analysieren von Problemen mit der Benutzeroberfläche in Websites finden Sie unter Überprüfen der Aktualisierung und der aktualisierten Websites (SharePoint Foundation 2010).

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

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 Office 12 ein "Zusammenfassungsinformationen"-Inhaltstyp eines Drittanbieters hinzugefügt wurde, dessen Name während des Upgrades auf Office 14 mit unserem sofort zu verwendenden "Zusammenfassungsinformationen"-Inhaltstyp in Konflikt stand. Löschen Sie den Inhaltstyp des Drittanbieters auf der angegebenen Website, oder geben Sie ihm einen anderen Namen als Zusammenfassungsinformationen, und führen Sie dann das Upgrade erneut aus.

Speicherplatzmangel

Wenn nicht mehr genügend Speicherplatz vorhanden ist (z. B. für Transaktionsprotokolldateien auf den Datenbankservern), kann das Upgrade nicht fortgesetzt werden. Geben Sie Speicherplatz frei, oder setzen Sie die Größe der Transaktionsprotokolldatei herauf, bevor Sie das Upgrade fortsetzen. Weitere Informationen finden Sie unter Verwalten der Größe der Transaktionsprotokolldatei (https://go.microsoft.com/fwlink/?linkid=124882&clcid=0x407).

Formularbasierte Authentifizierung

Zusätzliche Schritte sind erforderlich, wenn Sie ein Upgrade für eine Umgebung ausführen, in der formularbasierte Authentifizierung verwendet wird. Führen Sie die Schritte unter Konfigurieren der formularbasierten Authentifizierung für eine forderungsbasierte Webanwendung (SharePoint Foundation 2010) aus, um formularbasierte Authentifizierungsanbieter zu upgraden.

Sicherheit und Berechtigungen

Überprüfen Sie Folgendes, falls ein Fehler wegen eines unbekannten Benutzerkontos angezeigt wird oder falls für eine Datenbank kein Upgrade ausgeführt wird:

Stellen Sie für ein direktes Upgrade sicher, dass das Benutzerkonto, unter dem der Konfigurations-Assistent für SharePoint-Produkte ausgeführt wird, ein Mitglied der festen Datenbankrolle db_owner für alle Datenbanken ist, die Sie upgraden möchten. Andernfalls wird möglicherweise eine Fehlermeldung wegen eines unbekannten Benutzerkontos angezeigt, wenn der Assistent mit dem Upgraden der Datenbanken beginnt.
Wenn Sie bei einem Upgrade durch Datenbankanfügungen Datenbanken zwischen SQL Server-Instanzen verschieben, müssen Sie sicherstellen, dass die Sicherheit ordnungsgemäß konfiguriert ist. Überprüfen Sie, ob die verwendeten Benutzerkonten die entsprechenden festen Rollen und Berechtigungen in den Datenbanken aufweisen, und dass die Konten auch beim domänenübergreifenden Upgraden weiterhin gültig sind.

STP-Dateien funktionieren nach der Aktualisierung nicht

Websitevorlagen (STP-Dateien) sind in SharePoint Foundation 2010 veraltet und können nicht für die Erstellung neuer Websites verwendet werden. Vorhandene, auf STP-Dateien basierende Websites funktionieren weiterhin wie gewohnt. Die unterstützte Methode in SharePoint Foundation 2010 für die Erstellung von Websites, die auf einer Vorlage basieren, sind Lösungspakete (WSP-Dateien). Sie können eine STP-Datei in eine WSP-Datei konvertieren, um die Vorlage nach der Aktualisierung weiterhin zu verwenden.

So konvertieren Sie eine "STP"-Datei in eine "WSP"-Datei

Erstellen Sie in Windows SharePoint Services 3.0 eine auf der Vorlage basierende Website, und aktualisieren Sie die Website zu SharePoint Foundation 2010.
Klicken Sie in SharePoint Foundation 2010 in der aktualisierten Website im Menü Websiteaktionen auf Websiteeinstellungen.
Klicken Sie auf der Seite Websiteeinstellungen unter Websiteaktionen auf Website als Vorlage speichern.
Geben Sie auf der Seite Als Vorlage speichern einen Dateiname und Vorlagenname ein, und klicken Sie auf OK.

Die Websitevorlage wird im Lösungskatalog für diese Websitesammlung als WSP-Datei gespeichert, und Sie können auf der Grundlage dieser Lösung weitere Websites erstellen.

Neue Versionen der "Fabulous 40"-Anwendungsvorlagen können nicht gefunden werden

Zahlreiche Entwickler haben die "Fabulous 40"-Vorlagen verwendet, die für Windows SharePoint Services 3,0 erstellt wurden. Einige dieser Vorlagen wurden als Vorlagen für Websiteadministratoren (STP-Dateien) und einige als Vorlagen für Serveradministratoren (WSP-Dateien) erstellt. Microsoft wird keine neuen Versionen dieser Vorlagen für SharePoint 2010-Produkte veröffentlichen. Darüber hinaus sind STP-Dateien veraltet und können nach einer Aktualisierung zu SharePoint Foundation 2010 nicht für die Erstellung neuer Websites verwendet werden.

Sie können auf diesen Vorlagen basierende Websites aktualisieren. Sie sollten diese Websites jedoch nach Möglichkeit in einer Testumgebung aktualisieren, bevor Sie die Produktionsumgebung aktualisieren, um mögliche Probleme festzustellen. Verwenden Sie zu diesem Zweck das Tool zum Ausführen einer Überprüfung vor dem Upgrade. (Es wurde von Problemen mit benutzerdefinierten Workflows oder CAML-basierten Ansichten in den Vorlagen berichtet.) Beachten Sie, dass Sie nach dem Upgrade STP-Dateien nicht mehr für die Erstellung neuer Vorlagen verwenden können.

In der folgenden Tabelle wird erläutert, wie die Vorlagen verwendet werden können.

Typ der Vorlage	Kann ich auf dieser Vorlage basierende Websites aktualisieren?	Kann ich die Vorlage nach dem Upgrade verwenden?
Websiteadministrator (STP-Datei oder Websitevorlage)	Ja	Nein
Serveradministrator (WSP-Datei oder Lösungspaket)	Ja*	Ja*

*Mit einigen WSP-Dateien gibt es nach dem Upgrade Probleme. Zum Beispiel konnten einige Kunden nach dem Upgrade keine neuen Websites auf der Grundlage der folgenden Vorlagen erstellen: Abwesenheitsanforderung und Urlaubsplanungsverwaltung, Callcenter, Help Desk, IT-Team Workspace, Knowledge Base sowie Inventarüberwachung und -verwaltung. Wenn Sie Probleme bei der Verwendung einer dieser Vorlagen haben, können Sie im TechNet-Forum "SharePoint 2010 - Setup, Upgrade, Verwaltung und Betrieb" (https://go.microsoft.com/fwlink/?linkid=201600&clcid=0x407) ein Problem veröffentlichen oder sich an den Microsoft Customer Support wenden.

Wenn Sie in SharePoint Foundation 2010 weiterhin Websites auf der Grundlage von Vorlagen für Websiteadministratoren (STP-Dateien) erstellen möchten, müssen Sie diese in Lösungspakete (WSP-Dateien) konvertieren. Weitere Informationen finden Sie im Abschnitt "STP"-Dateien funktionieren nach der Aktualisierung nicht, weiter oben in diesem Artikel.

Freigeben über