Kennen Sie das Gefühl? Sie sitzen vor Ihrem Bildschirm, versuchen, etwas Wichtiges in SharePoint zu finden, und plötzlich erscheint diese kryptische Fehlermeldung: Fehler 3007/10021. Der Gatherer-Dienst hat ein Problem. Die Suchfunktion, das Herzstück jeder effizienten SharePoint-Umgebung, streikt. Das ist frustrierend, nicht wahr? Keine Sorge, Sie sind nicht allein. Dieser hartnäckige Fehler ist eine bekannte Herausforderung für SharePoint-Administratoren. Aber die gute Nachricht ist: Mit dem richtigen Wissen und einem systematischen Ansatz können Sie ihn beheben.
In diesem umfassenden Leitfaden werden wir den Gatherer-Dienst-Fehler 3007/10021 von Grund auf analysieren und Ihnen detaillierte Schritte an die Hand geben, wie Sie ihn endlich bezwingen können. Wir tauchen tief in die möglichen Ursachen ein und zeigen Ihnen bewährte Lösungen – von einfachen Überprüfungen bis hin zu fortgeschrittenen Reparaturstrategien. Machen Sie sich bereit, die Kontrolle über Ihre SharePoint-Suche zurückzugewinnen!
Was ist der Gatherer-Dienst und warum ist Fehler 3007/10021 so kritisch?
Bevor wir uns in die Fehlerbehebung stürzen, lassen Sie uns kurz klären, worüber wir hier sprechen. Der Gatherer-Dienst, auch bekannt als Crawler, ist eine zentrale Komponente der SharePoint-Sucharchitektur. Seine Hauptaufgabe besteht darin, Inhalte aus verschiedenen Quellen – seien es SharePoint-Websites, Dateifreigaben, Datenbanken oder externe Websites – zu durchforsten und diese Informationen in den Suchindex zu überführen. Ohne einen funktionierenden Gatherer-Dienst kann die SharePoint-Suche keine aktuellen Daten liefern, was die Produktivität massiv beeinträchtigt.
Der Fehler 3007/10021 ist eine generische Meldung, die darauf hindeutet, dass der Gatherer-Dienst beim Versuch, auf eine Inhaltsquelle zuzugreifen oder diese zu durchforsten, auf ein Hindernis gestoßen ist. Meistens deutet er auf Probleme bei der Konnektivität, bei Berechtigungen oder bei der Konfiguration hin. Er kann in verschiedenen SharePoint-Versionen (2013, 2016, 2019) auftreten und erfordert eine methodische Untersuchung.
Erste Schritte und grundlegende Überprüfungen
Bevor Sie tiefer graben, beginnen Sie immer mit den Grundlagen. Diese Schritte können viele Probleme bereits im Keim ersticken:
1. ULS-Logs und Ereignisprotokolle analysieren
Dies ist Ihr bester Freund bei der Fehlerbehebung. Die SharePoint Unified Logging System (ULS-Logs) und die Windows-Ereignisprotokolle enthalten detailliertere Informationen über die Ursache des Fehlers. Suchen Sie nach Einträgen, die zeitlich mit dem Auftreten des Fehlers 3007/10021 zusammenfallen. Achten Sie auf zusätzliche Fehlermeldungen, Stack Traces oder spezifische Ausnahmen, die auf ein tieferliegendes Problem hindeuten könnten.
Tipp: Verwenden Sie Tools wie den ULS Viewer, um die Logs effizient zu filtern und lesbar zu machen. Suchen Sie nach den Stichworten „Gatherer”, „3007”, „10021” und „Error”.
2. Status des Suchdienstes überprüfen
Stellen Sie sicher, dass alle relevanten Suchkomponenten in der Zentraladministration unter „Dienstanwendungen verwalten” –> „Suchdienstanwendung” –> „Topologie der Suchdienstanwendung” den Status „Online” haben. Insbesondere der Suchcrawler und der Suchprozess sind hier entscheidend.
3. Grundlegende Serverkonnektivität testen
Können die SharePoint-Server, die die Suchkomponenten hosten, die Inhaltsquelle (z.B. die Webanwendung oder einen Dateiserver) über Ping oder Telnet erreichen? Stellen Sie sicher, dass keine grundlegenden Netzwerkprobleme vorliegen.
Detaillierte Fehlerbehebung: Schritt für Schritt
Nach den grundlegenden Prüfungen gehen wir nun die häufigsten Ursachen und deren Lösungen durch.
1. Überprüfung der Dienstkonten und Berechtigungen (Der Klassiker!)
Dies ist die bei weitem häufigste Ursache für Gatherer-Fehler. Der Crawler benötigt spezifische Berechtigungen, um auf Inhalte zugreifen zu können.
a. Das Crawl-Konto (Content Access Account)
Das Crawl-Konto, das für die Durchforstung der Inhaltsquellen konfiguriert ist, muss über die notwendigen Lesezugriffe verfügen:
- Auf SharePoint-Inhalte: Das Crawl-Konto muss Lesezugriff auf die Webanwendungen haben, die es durchforsten soll. Dies wird in der Regel durch die Richtlinie der Webanwendung („Web Application Policy”) in der Zentraladministration konfiguriert. Stellen Sie sicher, dass das Konto mit „Full Read” oder „Full Control” hinzugefügt ist.
- Auf SQL-Server: Das Crawl-Konto benötigt Lesezugriff auf die SQL-Datenbanken, die die SharePoint-Inhalte hosten. Dies wird meist durch Mitgliedschaft in der db_datareader Rolle auf den Inhaltsdatenbanken erreicht.
- Auf Dateifreigaben: Wenn Sie Dateifreigaben durchforsten, muss das Crawl-Konto NTFS-Lesezugriff auf diese Freigaben haben.
- Auf lokale Server: Das Crawl-Konto benötigt zudem lokale Anmelderechte auf den Servern, die die Suchkomponenten hosten, sowie möglicherweise Rechte, um auf lokale Ordner zuzugreifen, in denen temporäre Dateien oder Indizes gespeichert werden.
b. Die Identität des Suchdienstanwendungs-Anwendungspools
Das Konto, unter dem der Anwendungspool der Suchdienstanwendung läuft, benötigt ebenfalls ausreichende Berechtigungen, insbesondere für die Kommunikation mit SQL Server und anderen SharePoint-Komponenten. Stellen Sie sicher, dass es Mitglied der WSS_ADMIN_WPG Gruppe auf allen SharePoint-Servern ist und die notwendigen SQL-Rollen besitzt.
c. SharePoint-Dienstkonten
Überprüfen Sie alle Dienstkonten in der Zentraladministration unter „Sicherheit” –> „Dienstkonten konfigurieren”. Stellen Sie sicher, dass keine Passwörter abgelaufen sind und die Konten die erforderlichen Berechtigungen erhalten haben (z.B. durch die AutoSPInstaller-Bereitstellung oder manuelle Konfiguration).
2. Netzwerkkonnektivität und Firewall-Einstellungen
Netzwerkprobleme sind ein weiterer häufiger Übeltäter. Der Gatherer-Dienst benötigt eine reibungslose Kommunikation mit seinen Quellen.
a. Firewall-Regeln
Überprüfen Sie die Firewall-Regeln auf allen beteiligten Servern (SharePoint-Server, SQL-Server, Dateiserver, Webserver für externe Quellen). Stellen Sie sicher, dass die notwendigen Ports für HTTP (80), HTTPS (443), SQL (1433, falls nicht standardmäßig) und SMB (445 für Dateifreigaben) geöffnet sind, sowohl eingehend als auch ausgehend.
b. DNS-Auflösung
Kann der SharePoint-Server, der den Crawler beherbergt, die Hostnamen der Inhaltsquellen korrekt auflösen? Führen Sie einen nslookup oder ping vom SharePoint-Server auf die Inhaltsquelle aus, um sicherzustellen, dass die DNS-Auflösung einwandfrei funktioniert.
c. Load Balancer oder Reverse Proxies
Wenn Ihre Inhaltsquelle hinter einem Load Balancer oder Reverse Proxy liegt, stellen Sie sicher, dass dieser den Traffic korrekt an die Backend-Server weiterleitet und keine Session-Timeouts oder andere Unterbrechungen verursacht.
3. SSL-Zertifikatsprobleme (für HTTPS-Quellen)
Wenn Sie HTTPS-basierte SharePoint-Websites oder externe Websites durchforsten, können SSL-Zertifikatsprobleme den Fehler 3007/10021 auslösen.
a. Vertrauen in Zertifikate
Der Crawler muss dem SSL-Zertifikat der durchforsteten Website vertrauen. Wenn die Website ein Zertifikat von einer internen CA oder einem selbstsignierten Zertifikat verwendet, muss dieses Zertifikat als SPTrustedRootAuthority in SharePoint hinzugefügt werden. Gehen Sie dazu in der Zentraladministration zu „Sicherheit” –> „Vertrauensstellungen verwalten” und fügen Sie das Root-Zertifikat der ausstellenden CA hinzu.
b. Zertifikatsablauf oder -fehler
Überprüfen Sie, ob die SSL-Zertifikate der durchforsteten Websites noch gültig sind und korrekt konfiguriert wurden. Abgelaufene oder fehlerhafte Zertifikate verhindern den Zugriff.
4. Proxy-Einstellungen
Wenn Ihr SharePoint in einer Umgebung mit einem Proxy-Server betrieben wird, müssen die Proxy-Einstellungen für den Crawler korrekt konfiguriert sein.
a. Proxy-Umgehung für lokale Adressen
Es ist entscheidend, dass der Gatherer-Dienst den Proxy für lokale SharePoint-Websites umgeht. Dies kann im Internet Explorer unter „Internetoptionen” –> „Verbindungen” –> „LAN-Einstellungen” –> „Erweitert” konfiguriert werden, indem die URLs der SharePoint-Websites in die Liste der Ausnahmen eingetragen werden. Alternativ kann dies auch über die SharePoint Management Shell mit Set-SPEnterpriseSearchServiceApplicationProxy konfiguriert werden.
Beispiel PowerShell-Befehl zum Umgehen des Proxys für eine Domäne:
Set-SPEnterpriseSearchServiceApplicationProxy -Identity
5. Überprüfung des Content-Quellen-Status
Ist die Inhaltsquelle selbst überhaupt verfügbar und funktionsfähig?
- SharePoint-Webanwendungen: Stellen Sie sicher, dass die durchforstete Webanwendung läuft und unter der konfigurierten URL erreichbar ist.
- SQL-Datenbanken: Ist die Datenbank online und für Verbindungen verfügbar?
- Dateiserver: Ist der Dateiserver erreichbar und die Freigabe korrekt konfiguriert?
- Authentifizierung: Funktioniert die Authentifizierung an der Inhaltsquelle?
6. Löschen des Crawl-Verlaufs und Neustart des Crawls
Manchmal können temporäre Inkonsistenzen im Crawl-Verlauf zu Problemen führen. Das Löschen des Verlaufs kann helfen:
- Gehen Sie in der Zentraladministration zu „Anwendungsverwaltung” –> „Dienstanwendungen verwalten” –> Ihre Suchdienstanwendung –> „Inhaltsquellen”.
- Wählen Sie die betreffende Inhaltsquelle aus und klicken Sie auf „Crawl-Verlauf löschen”. Bestätigen Sie die Aktion.
- Starten Sie danach einen Vollständigen Crawl für diese Inhaltsquelle. Beobachten Sie die ULS-Logs während des Crawls genau.
7. Cache-Löschung und Dienstneustart
Einige Probleme können durch einen veralteten Konfigurationscache oder hängende Dienste verursacht werden.
- SharePoint-Konfigurationscache löschen: Dies ist ein oft unterschätzter Schritt. Stoppen Sie den SharePoint Timer Service auf allen Servern, löschen Sie den Inhalt des Cache-Ordners (üblicherweise C:ProgramDataMicrosoftSharePointConfig
), löschen Sie die cache.ini und starten Sie den Timer Service wieder. - Relevante Dienste neu starten: Führen Sie einen IISReset auf allen SharePoint-Servern durch und starten Sie den „SharePoint Search Host Controller” Dienst neu.
8. Erneuerung des Suchindex und der Suchkomponenten (Fortgeschritten)
Wenn alle Stricke reißen und der Fehler 3007/10021 weiterhin besteht, könnte ein korrupter Suchindex oder eine beschädigte Suchkomponente die Ursache sein. Dieser Schritt ist drastischer und erfordert sorgfältige Planung, da er die Suchfunktion vorübergehend außer Betrieb setzt.
- Löschen des Suchindex: Gehen Sie in der Zentraladministration zu „Suchdienstanwendung” –> „Index zurücksetzen”. Wählen Sie „Alle indexierten Inhalte entfernen”. Dies löscht den gesamten Suchindex.
- Neuerstellung der Suchkomponenten: Dies kann bedeuten, eine oder mehrere Suchkomponenten (z.B. den Inhaltsprozessor oder den Abfrageprozessor) aus der Suchtopologie zu entfernen und neu hinzuzufügen. Im Extremfall müssen Sie die gesamte Suchdienstanwendung neu erstellen, was eine vollständige Neukonfiguration erfordert. Dokumentieren Sie Ihre aktuelle Topologie und Einstellungen sorgfältig, bevor Sie diesen Schritt ausführen.
- Nach dem Zurücksetzen des Index oder der Neuerstellung der Komponenten ist ein Vollständiger Crawl der gesamten Farm unerlässlich.
Best Practices zur Vorbeugung
Der beste Weg, mit dem Fehler 3007/10021 umzugehen, ist, ihn gar nicht erst entstehen zu lassen:
- Regelmäßige Überwachung: Behalten Sie die Suchdiagnose in der Zentraladministration und die ULS-Logs im Auge. Richten Sie Alerts für kritische Ereignisse ein.
- Sorgfältiges Dienstkontomanagement: Verwalten Sie Ihre Dienstkonten nach dem Prinzip der geringsten Rechtevergabe und stellen Sie sicher, dass Passwörter regelmäßig aktualisiert werden, ohne dass Dienste darunter leiden.
- SharePoint auf dem neuesten Stand halten: Installieren Sie regelmäßig die neuesten Cumulative Updates (CUs) und Service Packs, da diese oft Fehlerbehebungen für den Suchdienst enthalten.
- Dokumentation: Pflegen Sie eine detaillierte Dokumentation Ihrer SharePoint-Umgebung, insbesondere der Suchtopologie, Dienstkonten und Berechtigungen.
Fazit
Der Gatherer-Dienst-Fehler 3007/10021 kann eine echte Herausforderung sein, aber er ist nicht unüberwindbar. Mit einem systematischen Ansatz, beginnend bei den grundlegenden Berechtigungen und Netzwerkeinstellungen bis hin zu fortgeschrittenen Schritten wie der Neuerstellung von Suchkomponenten, können Sie die Ursache identifizieren und beheben.
Denken Sie daran: Geduld und eine methodische Vorgehensweise sind der Schlüssel. Nutzen Sie die ULS-Logs als Ihre primäre Informationsquelle und arbeiten Sie sich durch die Liste der potenziellen Ursachen. Mit diesem Leitfaden sind Sie bestens gerüstet, um den hartnäckigen Fehler 3007/10021 endlich in den Griff zu bekommen und die Leistungsfähigkeit Ihrer SharePoint-Suche wieder vollständig herzustellen. Viel Erfolg!