Externe Anwendungen für die Suchindizierung nutzen

Zur Indexierung von Office-Dokumenten (PDF, DOC, XLS, etc.) ist es zu den Systemvoraussetzungen (hier: Systembefehle über exec) erforderlich, dass der Inhalt dieser Binärdateien gelesen werden kann. Hierfür bedient sich Weblication® CMS externer Anwendungen, die das Auslesen der Dateien übernehmen. Beachten Sie hierzu die Hinweise am Artikelende! Andernfalls kann nur der Dateiname und die parallele Dokumentenerweiterung dieser Dateien indexiert werden.

Erfahren Sie nachfolgend, wie Sie diese externen Anwendungen für das Zusatzmodul Volltextsuche (PDF-Suche bzw. Office-Suche) einbinden und nutzen.

Die Downloadseiten für die empfohlenen externen Anwendungen finden Sie nachfolgend. Beachten Sie hinsichtlich des Einsatzes die Hinweise am Ende dieses Artikels.

Entpacken Sie die Anwendungen in das Verzeichnis:

• /weblication/grid5/appsExtern/
  
• /pdftotext/
  Xpdf-Anwendung für PDF-Dateien
• /wordtotext/[os]/
  Antiword-Anwendung für DOC-Dateien
  [os] steht für das jeweilige Betriebssystem (bei Linux: lin)
  
• /excelppttotext/[os]/
  xlhtml-Anwendung für XLS-und PPT-Dateien
  [os] steht für das jeweilige Betriebssystem (bei Linux: lin)
  

Sofern Sie die Dateien via FTP/SSH übertragen, achten Sie darauf, dass Sie alle Dateien im Binär-Modus übertragen.

• Beim Einsatz auf einem Linux-Server (z.B. bei Domainfactory):
  
  • Für PDF-Dateien (pdf):
    /weblication/grid5/appsExtern/pdftotext/
    
    • Ausführenrechte müssen haben:
      /weblication/grid5/appsExtern/pdftotext/pdftotext (Datei ohne Endung)
  • Für Word-Dateien (doc):
    /weblication/grid5/appsExtern/wordtotext/lin/antiword/
    /weblication/grid5/appsExtern/wordtotext/lin/bin/
    
    • Ausführenrechte müssen haben:
      /weblication/grid5/appsExtern/wordtotext/lin/antiword/antiword (Datei ohne Endung)
    • Schreibrechte sind erforderlich auf:
      /weblication/grid5/appsExtern/wordtotext/lin/bin/ (je nach Server chmod 777 erforderlich)
  • Für Excel/Powerpoint-Dateien (xls|ppt):
    /weblication/grid5/appsExtern/excelppttotext/lin/xlHtm/
    /weblication/grid5/appsExtern/excelppttotext/lin/bin/
    
    • Ausführenrechte müssen haben:
      /weblication/grid5/appsExtern/excelppttotext/lin/xlHtm/ppthtml (Datei ohne Endung)
      /weblication/grid5/appsExtern/excelppttotext/lin/xlHtm/xlhtml (Datei ohne Endung)
• Beim Einsatz auf einem Windows-Server (mit Apache):
  
  • Für PDF-Dateien (pdf):
    /weblication/grid5/appsExtern/pdftotext/
    
    • Ausführenrechte müssen haben:
      /weblication/grid5/appsExtern/pdftotext/pdftotext.exe
  • Für Word-Dateien (doc):
    /weblication/grid5/appsExtern/wordtotext/
    
    • Ausführenrechte müssen haben:
      /weblication/grid5/appsExtern/wordtotext/win/antiword/antiword.exe
    • Schreibrechte sind erforderlich auf:
      /weblication/grid5/appsExtern/wordtotext/lin/bin/
  • Für Excel/Powerpoint-Dateien (xls|ppt):
    /weblication/grid5/appsExtern/excelppttotext/lin/xlHtm/
    /weblication/grid5/appsExtern/excelppttotext/lin/bin/
    
    • Ausführenrechte müssen haben:
      /weblication/grid5/appsExtern/excelppttotext/win/xlHtm/ppthtml.exe
      /weblication/grid5/appsExtern/excelppttotext/win/xlHtm/xlhtml.exe

Ob die externen Anwendungen korrekt abliegen und auch die erforderlichen Ausführenrechte besitzen, erfahren Sie über den Funktionstest zu Beginn jeder Indexierung. Ein grünes "ok" hinter der genannten Anwendung bedeutet, dass die externe Anwendung verwendet werden kann.

Sofern Sie beim Funktionstest ein "error" anstatt des "ok" zum jeweiligen Application Check erhalten, prüfen Sie bitte über das Register "Debuginformationen" die detaillierte Fehlermeldung hierzu. Bei der PDF-Applikation könnte dies z.B. wie folgt aussehen:

Prüfen Sie in solch einem Fall zuerst einmal, ob Sie auch wirklich die Ausführenrechte auf die entsprechende Datei (z.B. pdftotext) gesetzt haben. Wenn dies der Fall ist, setzen Sie den in der Meldung genannten Aufruf (command) direkt in der Shell ab. Vergewissern Sie sich zuvor, daß die angegebene PDF-Datei im tmp-Verzeichnis mit dem Namen auch abliegt (kann eine Test-Datei sein). Nach einem erfolgreichen Aufruf muß parallel zu dieser PDF-Datei eine .html-Datei mit gleichem Namen abliegen (im Beispiel also die in der Fehlermeldung genannte Datei: tmp_pdf_891604.html). Wird diese Datei nicht angelegt, wenden Sie sich bitte an Ihren Provider, der sich anhand des direkten Shellaufrufes auf die Fehlersuche machen kann.

Tipp:
Damit Sie beim Debuggen nicht immer auf den kompletten Suchindex-Durchlauf warten müssen, geben Sie in den Sucheinstellungen einfach eine falsche Start-URL an.

Weitere mögliche error-Ursachen:

• aktivierter Safe Mode
  Lösung: Deaktivieren Sie beim Einsatz älterer PHP-Versionen den Safe-Mode.