Installation und Konfiguration der Fabasoft Integration für Mindbreeze
Copyright Fabasoft R&D GmbH, A-4020 Linz, 2008. Alle Rechte vorbehalten. Alle verwendeten Hard- und Softwarenamen sind Handelsnamen und/oder Marken der jeweiligen Hersteller. Diese Unterlagen sind streng vertraulich. Durch die Übermittlung und Präsentation dieser Unterlagen alleine werden keine Rechte an unserer Software, an unseren Dienstleistungen und Dienstleistungsresultaten oder sonstigen geschützten Rechten begründet. Die Weitergabe, Veröffentlichung oder Vervielfältigung ist nicht gestattet. Aus Gründen der einfacheren Lesbarkeit wird auf die geschlechtsspezifische Differenzierung, z. B. Benutzer/-innen, verzichtet. Entsprechende Begriffe gelten im Sinne der Gleichbehandlung grundsätzlich für beide Geschlechter. 2
Inhalt 1 Einleitung 4 2 Softwarevoraussetzungen 4 3 Installation 4 3.1 Mindbreeze Enterprise Search 4 3.2 Fabasoft Integration für Mindbreeze Enterprise Search 4 3.3 Konfiguration 8 3.3.1 Konfiguration der aktuellen Domäne 8 3.3.2 Filterservice 8 3.3.3 Indizierungsservice 9 3.3.4 Fabasoft Components Stores 11 3.3.5 Konfigurationsobjekt von Mindbreeze Enterprise Search 11 3.3.6 Konfiguration von Mindbreeze Enterprise Search 12 4 Recover und Restore 14 5 Konfiguration der automatischen Aufgabe (AT-Job) 14 6 Weiterführende Konfigurationsmöglichkeiten 15 6.1 Indizierung von ausgewählten Stores 15 6.2 Indizierung von Archivinhalten 16 6.3 Veränderung des Timeout-Verhaltens 16 6.4 Konfigurationsobjekt von Mindbreeze Enterprise Search 17 6.5 Indizierungsservice für Mindbreeze Enterprise Search 19 6.6 Indizierung über UNC-Pfade 20 7 Indizierungsskripte 21 7.1 Skript für BuildIndex 4 Threads 21 7.2 Skript für Recover Index 4 Threads 22 7.3 Skript für die Deltaindizierung 22 7.4 Skript für Buildindex with 4 Threads (Datumseinschränkung) 24 7.5 Skript für Recover Contents 4 Threads (Neuer Filter) 25 7.6 Skript für Recover Objects 4 Threads (Neue Eigenschaft) 25 3
1 Einleitung Dieses Dokument beschreibt die Installation und Konfiguration der Fabasoft Integration für Mindbreeze Enterprise Search. Die Fabasoft Integration für Mindbreeze Enterprise Search ermöglicht die Integration der Suche über Mindbreeze Enterprise Search in Fabasoft Components. 2 Softwarevoraussetzungen Systemumgebung: Die Informationen in diesem Dokument beziehen sich auf eine Microsoft Windows-Systemumgebung und Fabasoft Softwareprodukte der Version 2008 Production. Unterstützte Plattformen: Detaillierte Informationen zu unterstützten Betriebssystemen und unterstützter Software finden Sie im Readme-Dokument im Hauptverzeichnis Ihrer Fabasoft Produkt-CD bzw. Produkt-DVD. Beschreibungen in diesem Dokument basieren auf folgender Software: Mindbreeze Enterprise Search 3.0 SP3 Hinweis: Das Softwareprodukt Fabasoft Integration für Mindbreeze Enterprise Search muss in der Fabasoft Components Domäne installiert sein. Eine Produktlizenz, in der die Fabasoft Integration für Mindbreeze Enterprise Search eingetragen ist, muss in der Fabasoft Components Domäne installiert sein. 3 Installation 3.1 Mindbreeze Enterprise Search Voraussetzung für die Integration der Suche über Mindbreeze Enterprise Search in die Fabasoft Softwareprodukte ist die Installation des Drittprodukts Mindbreeze Enterprise Search. 1. Führen Sie die Installation von Mindbreeze Enterprise Search gemäß den Anleitungen dieses Drittprodukts durch. 2. Der Serverknoten von Mindbreeze Enterprise Search, der als Suchservice konfiguriert wurde, muss in der Microsoft Windows-Systemumgebung unter einem dedizierten Benutzer ausgeführt werden. 3.2 Fabasoft Integration für Mindbreeze Enterprise Search Die Installation des Softwareprodukts Fabasoft Integration für Mindbreeze Enterprise Search erfolgt automatisch beim Installieren bzw. Aktualisieren der Fabasoft Components Domäne, wenn die Integration für die zu installierende Software Edition bzw. Software Solution vorgesehen ist. Um das Service für die Fabasoft Integration für Mindbreeze Enterprise Search zu installieren, führen Sie folgende Schritte aus: 1. Legen Sie die Fabasoft Produkt-DVD in das DVD-Laufwerk Ihres Servers ein, auf dem das Suchservice von Mindbreeze Enterprise Search installiert ist (dieses muss bereits laufen). Der Fabasoft Server Setup -Dialog wird automatisch geöffnet. Hinweis: Falls dieser Dialog nicht automatisch angezeigt wird, führen Sie setup.exe im Hauptverzeichnis der Fabasoft Produkt-DVD aus. Stellen Sie sicher, dass der Benutzer, mit dem Sie auf dem Serverknoten von Mindbreeze Enterprise Search angemeldet sind, als privilegierter Benutzer in der Fabasoft Components Domäne eingetragen ist. 4
2. Akzeptieren Sie die Fabasoft Legal Terms und klicken Sie auf die Schaltfläche Next. 3. Wählen Sie Install additional Fabasoft services and products for existing domain aus und klicken Sie auf die Schaltfläche Next. 4. Markieren Sie das Kontrollkästchen neben dem Eintrag Fabasoft Integration for Mindbreeze Enterprise Search und klicken Sie auf die Schaltfläche Next. 5
Hinweis: Sofern auf dem Server kein Fabasoft Components Server Management und kein Fabasoft Components Kernel installiert sind, werden diese ebenfalls installiert. 5. Die Voraussetzungen werden überprüft. Das Ergebnis der Überprüfung wird in einer Übersicht angezeigt. Vergewissern Sie sich, dass Ihr System die Anforderungen erfüllt (wird durch ein grünes Kontrollzeichen dargestellt) und klicken Sie auf die Schaltfläche Next. 6. Geben Sie im Feld Username den Benutzernamen ein, unter dem das Service für die Fabasoft Integration von Mindbreeze Enterprise Search ausgeführt wird. Geben Sie im Feld Password das Passwort dieses Benutzers ein und klicken Sie auf die Schaltfläche Next. 6
7. Die Konfiguration der Fabasoft Integration für Mindbreeze Enterprise Search kann durch einen Klick auf die Schaltfläche Edit angezeigt und angepasst werden. Klicken Sie auf die Schaltfläche Install, um die Installation zu starten. 8. Klicken Sie auf die Schaltfläche Finish. 7
3.3 Konfiguration Folgende Einstellungen wurden bei der Installation der Fabasoft Integration für Mindbreeze Enterprise Search innerhalb der Fabasoft Components Domäne vorgenommen: Die aktuelle Domäne wurde konfiguriert. Ein neues Filterservice wurde erzeugt und konfiguriert. Ein neues Indizierungsservice wurde erzeugt und konfiguriert. Das erzeugte Indizierungsservice wurde den Fabasoft Components COO-Stores zugeordnet. Die Konfiguration für Mindbreeze Enterprise Search wurde angepasst. Eine automatische Aufgabe wurde eingerichtet. Diese Einstellungen können entsprechend den Anforderungen geändert werden. 3.3.1 Konfiguration der aktuellen Domäne Für den Benutzer des Suchservice von Mindbreeze Enterprise Search wurde ein Benutzer in der Fabasoft Components Domäne angelegt. Dieser wurde in der aktuellen Domäne als privilegierter Benutzer eingetragen. 1. Wechseln Sie in der Domänenadministration in den Domänenobjekten auf die Registerkarte Domänen. 2. Öffnen Sie die Aktuelle Domäne im Lesemodus. 3. Im Feld Privilegierte Benutzer wurde der Benutzer eingetragen, unter dem das Suchservice von Mindbreeze Enterprise Search ausgeführt wird. 3.3.2 Filterservice Es wurde ein Filterservice für Mindbreeze Enterprise Search erzeugt, das mit Standardeinstellungen konfiguriert wurde: 1. Wechseln Sie in der Domänenadministration in den Domänenobjekten auf die Registerkarte Services. 2. Öffnen Sie das Filterservice für Mindbreeze Enterprise Search im Bearbeitungsmodus. 3. Folgende Felder stehen für die Konfiguration des Filterservice zur Verfügung: o Filterservice URL-Liste In diesem Feld wurden die URL und der Port des Filterservice für Mindbreeze Enterprise Search eingetragen. Es können mehrere Filterservice-URLs angegeben werden, auf die die zu indizierenden Daten verteilt werden. Die Verteilung erfolgt bevorzugt anhand des Hostnamens des Indizierungsservice, damit die Daten nicht unnötig vom Filterservice über das Netzwerk zum Indizierungsservice geschickt werden. 8
Hinweis: Standardmäßig verwendet Mindbreeze Enterprise Search den Port 23400 für das Filterservice. o Datei-Endungen In diesem Feld werden alle Dateiendungen eingetragen, die die Dateitypen identifizieren, die indiziert werden sollen. Die Angabe von doc bewirkt beispielsweise, dass der Inhalt von Microsoft Office Word-Objekten indiziert wird. 3.3.3 Indizierungsservice Es wurde ein Indizierungsservice für Mindbreeze Enterprise Search erzeugt und konfiguriert: 1. Wechseln Sie in der Domänenadministration in den Domänenobjekten auf die Registerkarte Services. 2. Öffnen Sie das Indizierungsservice für Mindbreeze Enterprise Search im Bearbeitungsmodus. 3. Folgende Felder stehen für die Konfiguration des Indizierungsservice zur Verfügung: o Indizierungsservice URL-Liste In diesem Feld wurden die URL und der Port des Indizierungsservice für Mindbreeze Enterprise Search eingetragen. Es können mehrere Indizierungsservice-URLs angegeben werden, auf die die Daten verteilt werden. Hinweis: Standardmäßig verwendet Mindbreeze Enterprise Search den Port 23100 für das Indizierungsservice. o Suchservice URL-Liste In diesem Feld wurden die URL und der Port des Suchservice für Mindbreeze Enterprise Search eingetragen. Es können mehrere Suchservice-URLs in der Liste angegeben werden. Hinweis: Standardmäßig verwendet Mindbreeze Enterprise Search das Protokoll HTTPS und den Port 23300 für das Suchservice. 9
o Filterservices In diesem Feld sind die durch das Indizierungsservice von Mindbreeze Enterprise Search verwendeten Filterservices eingetragen. o Client Zertifikat Für die HTTPS-Verschlüsselung ist ein PKCS12 Client Authentication Certificate mit eingebettetem Private Key notwendig. Aus diesem müssen der Private Key und das Client- Zertifikat getrennt und in zwei separaten Dateien gespeichert werden. Das Trennen kann mit dem frei erhältlichen Werkzeug OpenSSL durchgeführt werden. Das so generierte Client-Zertifikat kann als Objekt der Objektklasse Zertifikat im Objekt Indizierungsservice im Feld Client Zertifikat importiert werden. Das CA-Zertifikat, das zum Generieren des Client-Zertifikats verwendet wurde, muss im Mindbreeze Client auf der Registerkarte Certificates importiert werden. Diese Zertifikate werden durch das Setup automatisch generiert und entsprechend abgelegt (sowohl in der Fabasoft Components Domäne, als auch im Mindbreeze Client). Im Dateisystem befinden sich diese Zertifikate unter C:\Program Files\Fabasoft\Components\MindbreezeIntegration. Das Zertifikat muss im Mindbreeze Client aktiviert werden, indem das Kontrollkästchen neben dem Eintrag des Zertifikats im Feld Trusted Peer Certificate Issuer markiert wird. o Privater Schlüssel In diesem Feld wird der Pfad zum generierten privaten Schlüssel angegeben (z. B. C:\Program Files\Fabasoft\Components\MindbreezeIntegration\request.key). Diese Datei muss für jeden Fabasoft Components Kernel, von dem eine Suche abgesetzt wird, verfügbar sein. Nach der Installation der Fabasoft Integration für Mindbreeze Enterprise Search befindet sich der private Schlüssel im lokalen Dateisystem in jenem Pfad, der in der Fabasoft Components Domäne in der entsprechenden Eigenschaft eingetragen wurde. Bei einer verteilten Installation muss die Datei auf allen Servern, die Fabasoft Components Webservices bereitstellen, abgelegt werden. o Passphrase des Privaten Schlüssels Hier muss die Passphrase des privaten Schlüssels eingetragen werden (z. B. C:\Program Files\Fabasoft\Components\MindbreezeIntegration\passwd). 10
3.3.4 Fabasoft Components Stores Das Indizierungsservice für Mindbreeze Enterprise Search wurde allen Fabasoft Components COO- Stores zugeordnet, deren Fabasoft Components Objekte über dieses Service indiziert werden sollen. 1. Wechseln Sie in der Domänenadministration in den Domänenobjekten auf die Registerkarte Stores. 2. Öffnen Sie einen Fabasoft Components COO-Store im Lesemodus. 3. Im Feld Indizierungsservice wurde das erzeugte Indizierungsservice für Mindbreeze Enterprise Search eingetragen. Hinweis: Archivierte Fabasoft Components Objekte bleiben dem originären Fabasoft Components COO-Store zugeordnet. Sie werden beim Indizieren aus dem Archiv geladen und an Mindbreeze Enterprise Search übergeben. Somit können archivierte Objekte in Fabasoft Softwareprodukten über Mindbreeze Enterprise Search gesucht werden. 3.3.5 Konfigurationsobjekt von Mindbreeze Enterprise Search Durch die Installation des Softwareprodukts Fabasoft Integration für Mindbreeze Enterprise Search wird das Konfigurationsobjekt FSCMINDBREEZE@1.1001:MindbreezeDefaultConfig zur Verfügung gestellt. In diesem Konfigurationsobjekt kann die Indizierung von definierten Eigenschaften von Fabasoft Components Objekten festgelegt werden. Hier werden je nach Installation der Fabasoft Components Domäne verschiedene Eigenschaften eingetragen, die indiziert werden sollen: 1. Wechseln Sie in der Domänenadministration auf die Registerkarte Konfigurationsobjekte. 11
2. Öffnen Sie das Konfigurationsobjekt FSCMINDBREEZE@1.1001:MindbreezeDefaultConfig im Bearbeitungsmodus. 3. In diesem Konfigurationsobjekt wird standardmäßig die Indizierung von fünf Eigenschaften der Objektklasse Benutzer, sowie die Indizierung aller Dokumente mit Inhalt, die im Filterservice für Mindbreeze Enterprise Search angegeben sind, festgelegt. Das Konfigurationsobjekt wird bei der Installation der Fabasoft Integration für Mindbreeze Enterprise Search in der Aktuellen Domäne hinterlegt, damit diese Einstellungen herangezogen werden. Wechseln Sie in der Domänenadministration in den Domänenobjekten auf die Registerkarte Domänen. Öffnen Sie die Aktuelle Domäne im Bearbeitungsmodus und wechseln Sie auf die Registerkarte Komponenten-Konfiguration. Im Feld FSC Mindbreeze Konfiguration wird das verwendete Konfigurationsobjekt angezeigt. 3.3.6 Konfiguration von Mindbreeze Enterprise Search Damit eine Volltextsuche mittels Mindbreeze Enterprise Search möglich ist, muss auch Mindbreeze Enterprise Search entsprechend konfiguriert werden. Es wurde ein Indizierungsservice erzeugt, dem ein Filterservice zugewiesen ist. Fabasoft Components wurde diesem Indizierungsservice als Datenquelle hinzugefügt. 12
Damit Suchergebnisse über den Mindbreeze Client geöffnet werden können, ist eine Anpassung der MAPI-Konfiguration innerhalb der Fabasoft Components Domäne erforderlich. Wechseln Sie in der Domänenadministration auf die Registerkarte Konfigurationsobjekte und öffnen sie die MAPI- Konfiguration. Die Felder URL-Schema (Protokoll) für HTML-Mail und Host und URL-Wurzel für HTML-Mail müssen entsprechend angepasst werden. 13
4 Recover und Restore Im Falle eines Restore einer Fabasoft Components Domäne kann es aufgrund von fehlenden Backups des Index notwendig sein, Objekte, die bereits indiziert wurden, ein weiteres Mal an das Indizierungsservice von Mindbreeze Enterprise Search zu senden. Dazu steht die Aktion RecoverIndex zur Verfügung. Diese Aktion kann im Kontextmenü des Indizierungsservice durch den Befehl Status des Index wiederherstellen aufgerufen werden. 5 Konfiguration der automatischen Aufgabe (AT-Job) Damit ein aktueller Index für die Suche zur Verfügung steht, ist es notwendig, die Indizierung regelmäßig und automatisiert durchzuführen. Diese Aufgabe erfolgt über ein Fabasoft Components AT-Service. Nach der Installation eines Fabasoft Components AT-Service befindet sich im Fabasoft Components Server Management unter Fabasoft Components > Computers > <Rechnername> der Eintrag Fabasoft Components/AT. Wurde das Fabasoft Components AT-Service bei der Installation der Fabasoft Integration für Mindbreeze Enterprise Search angegeben, so wurde automatisch ein Fabasoft Components AT-Service für die Indizierung angelegt. Falls dies nachträglich durchgeführt werden soll, öffnen Sie das Kontextmenü des Eintrags Fabasoft Components/AT und erzeugen Sie ein neues Fabasoft Components AT-Service. Konfiguration in der Fabasoft Components Domäne Wenn bei der Installation der Fabasoft Integration für Mindbreeze Enterprise Search das Fabasoft Components AT-Service angegeben wurde, wurde auch die Konfiguration innerhalb der Fabasoft Components Domäne für das Fabasoft Components AT-Service durchgeführt. Damit Hintergrundaktivitäten automatisch durch dieses Fabasoft Components AT-Service abgearbeitet werden, müssen Automatische Aufgaben erzeugt und der Aufgabenliste (Objektklasse Automatische Aufgaben) des Benutzers, unter dem dieses Fabasoft Components AT-Service ausgeführt wird, zugeordnet werden. Gehen Sie dazu folgendermaßen vor: 1. Wechseln Sie in der Domänenadministration in den Benutzerobjekten auf die Registerkarte Automatische Aufgaben. 2. Ein Objekt der Objektklasse Automatische Aufgaben sollte verfügbar sein. Öffnen Sie die Eigenschaften dieses Objekts im Bearbeitungsmodus. 14
3. Geben Sie im Feld Aufgaben Objekte der Objektklasse Automatische Aufgabe an. Wählen Sie die Objekte aus der Dropdownliste aus oder klicken Sie auf die Schaltfläche Erzeugen, um eine neue Automatische Aufgabe zu erzeugen. 4. Öffnen Sie die Automatische Aufgabe im Bearbeitungsmodus. Hinterlegen Sie im Feld Aufgaben die Aufgaben. Beispiel für eine im Feld Aufgaben hinterlegte Automatische Aufgabe: Diese Aufgabe enthält als Objekt das Indizierungsservice für Mindbreeze Enterprise Search. Als Aktion wurde die Aktion Index erstellen/aktualisieren (COOSYSTEM@1.1:BuildIndex) ausgewählt. In den Feldern Wiederholung und Art der Wiederholung kann der zeitliche Ablauf des Skripts gesteuert werden. 5. Klicken Sie auf die Schaltfläche Weiter, um die Angaben zu übernehmen. 6 Weiterführende Konfigurationsmöglichkeiten Dieses Kapitel beschreibt weiterführende Konfigurationsmöglichkeiten und Einstellungen für die Umstellung vom Microsoft Indexdienst auf Mindbreeze Enterprise Search. 6.1 Indizierung von ausgewählten Stores Wurde kein Eintrag im Feld Indizierungsservice im Fabasoft Components COO-Store vorgenommen, würde Fabasoft Components zur Volltextsuche den Microsoft Indexdienst heranziehen. Um dieses Verhalten zu unterdrücken, ist es notwendig, im zum Fabasoft Components COO-Store gehörigen MMC-Service-Objekt das Kontrollkästchen Volltextsuche aktiv auf Nein zu setzen. 15
6.2 Indizierung von Archivinhalten Für die Indizierung von Inhalten und Objekten, die mittels Fabasoft iarchive in einem Archivsystem abgelegt wurden, sind keine weiteren Einstellungen notwendig. Der Fabasoft Components Kernel berücksichtigt diese Objekte automatisch, holt sie aus dem Archiv und sendet sie an Mindbreeze Enterprise Search. Wurde jedoch vor der Installation der Fabasoft Integration für Mindbreeze Enterprise Search der Microsoft Indexdienst für die Indizierung der Archivinhalte verwendet, ist es notwendig, in der aktuellen Domäne die Eigenschaft Volltextabfrage auch in Archiven durchführen auf Nein zu setzen. 6.3 Veränderung des Timeout-Verhaltens Bei einer Volltextsuche werden Limits für die Anzahl der Treffer sowie für die maximale Suchzeit übergeben. Diese sind standardmäßig 10000 für die maximale Anzahl der Treffer sowie 5 Sekunden für maximale Suchzeit. Diese Standardwerte können am Fabasoft Components Webserver in der Registry angepasst werden: [HKEY_LOCAL_MACHINE\SOFTWARE\Fabasoft\FscWeb\Modules\FSC] @="//?/C:/Program Files/Fabasoft/Components/Web/1_FSC/ASP/content/bin/fscvext.dll" [HKEY_LOCAL_MACHINE\SOFTWARE\Fabasoft\FscWeb\Modules\FSC\FTSCOUNT] @="5000" [HKEY_LOCAL_MACHINE\SOFTWARE\Fabasoft\FscWeb\Modules\FSC\FTSTIMEOUT] @="20" Außerdem können diese Werte bei der Durchführung einer Suche direkt angegeben werden: <Suchbegriff> count:1000 timeout:15 Die Anzahl der maximalen Suchtreffer, kann bei der Schnellsuche nur mit dem zusätzlichen Parameter count:<anzahl> angegeben werden, ansonsten ist der Standardwert 100. 16
6.4 Konfigurationsobjekt von Mindbreeze Enterprise Search Die Einstellungen für die Indizierung, die im Konfigurationsobjekt von Mindbreeze Enterprise Search getroffen werden, gelten für alle Indizierungsservices. Um das Konfigurationsobjekt von Mindbreeze Enterprise Search zu bearbeiten, gehen Sie folgendermaßen vor: 1. Wechseln Sie in der Domänenadministration auf die Registerkarte Konfigurationsobjekte. 2. Öffnen Sie das Konfigurationsobjekt FSCMINDBREEZE@1.1001:MindbreezeDefaultConfig im Bearbeitungsmodus. Folgende Eigenschaften stehen zur Verfügung: Metadaten-Volltextsuche verwenden In diesem Feld wird festgelegt, ob die kombinierte Metadaten-Volltextsuche über Mindbreeze Enterprise Search verwendet wird. Wenn diese Eigenschaft auf Nein bzw. Undefiniert gesetzt ist, dann werden Volltextanfragen zu Metadaten an das Fabasoft Components COO-Service gesendet und nicht zu Mindbreeze Enterprise Search. Externe Referenzen generieren In diesem Feld wird festgelegt, ob konfigurierte Eigenschaften bzw. Eigenschaftspfade für die kombinierte Metadaten-Volltextsuche über Mindbreeze Enterprise Search berücksichtigt werden, auch wenn keine explizite Referenz im Feld Zuordnungen zu Metadaten definiert ist. Hinweis: Erfolgt eine Änderung in diesem Feld bzw. einer Referenz, ist eine Neuindizierung erforderlich. Zuordnungen für Metadaten bzw. Zuordnungen für Inhalte In dieser Liste wird angegeben, welche Eigenschaften welcher Objektklassen indiziert werden 17
sollen. Hinweis: Eigenschaften, auf die der Zugriff durch spezielle Zugriffstypen geschützt ist, können nicht angegeben werden (Sicherheit). Folgende Felder stehen zur Verfügung: o Objektklasse In diesem Feld wird die Objektklasse angegeben, deren Eigenschaften indiziert werden sollen. o Beschreibung der Eigenschaften In diesem Feld wird der Eigenschaftspfad zur Eigenschaft der im Feld Objektklasse definierten Objektklasse angegeben, die indiziert werden sollen. o Softwarekomponente In diesem Feld wird die Softwarekomponente angegeben, der die Angaben zugeordnet werden sollen. Dadurch bleiben die Einstellungen nach einem Update der Fabasoft Components Domäne erhalten. Hinweis: Damit die Einstellungen nicht überschrieben werden können, muss in der angegebenen Softwarekomponente im Feld Erweiterte Komponenten die Softwarekomponente Integration für Mindbreeze Enterprise Search (FSCMINDBREEZE@1.1001) eingetragen werden. Die Softwarekomponenten der Objektklassen der zu indizierenden Objekte müssen im Feld Vorausgesetzte Komponenten eingetragen werden. Hinweis: Um im Mindbreeze Client auch nach Metadaten von Inhalten suchen zu können, wie z. B. Erzeugt von, Erzeugt am, muss im Feld Zuordnungen für Metadaten Folgendes hinzugefügt werden: Einschränkungen nach Domäne / Mandant verwenden Wird die Einschränkung auf JA gestellt, kann im Mindbreeze Client die Suche auf eine Domäne bzw. einen Mandant des jeweiligen Benutzers eingeschränkt werden. Einschränkung nach Suchbereich verwenden Wird die Einschränkung auf JA gestellt, kann im Mindbreeze Client die Suche auf den Suchbereich des jeweiligen Benutzers eingeschränkt werden. Vordefinierte Einschränkungen In diesem Feld kann eine Eigenschaft/Referenz eingetragen werden, die als spezielle Einschränkung im Mindbreeze Client gehandhabt wird. Beispiel: Die Objektklasse Word-Objekt wird als Objekt für Name und Symbol mit der Einschränkung.doc ausgewählt. Dadurch wird jedesmal, wenn im Mindbreeze Client die Einschränkung Word-Objekt markiert wird, zu jeder Abfrage.doc hinzugefügt, sodass nur Word-Objekte gefunden werden. 18
6.5 Indizierungsservice für Mindbreeze Enterprise Search Die im Indizierungsservice für Mindbreeze Enterprise Search vorgenommenen Einstellungen, gelten nur für dieses Indizierungsservice. Um das Indizierungsservice für Mindbreeze Enterprise Search zu bearbeiten, gehen Sie folgendermaßen vor: 1. Wechseln Sie in der Domänenadministration in den Domänenobjekten auf die Registerkarte Services. 2. Öffnen Sie das Indizierungsservice für Mindbreeze Enterprise Search im Bearbeitungsmodus. Zusätzlich zu den Einstellungen, die während der Installation der Fabasoft Installation von Mindbreeze Enterprise Search vorgenommen wurden, können folgende Konfigurationen durchgeführt werden, um die Indizierung der Dateien einzuschränken: Kategorie Im diesem Feld kann eine neue Kategorie definiert werden, die zusätzlich zur Fabasoft Components Domäne im Mindbreeze Client angezeigt wird. (z. B: Fabasoft Kontakte). Im Mindbreeze Client können für diese Kategorien spezielle Icons verwendet werden. Blockgröße In diesem Feld wird die Anzahl der Objekte angegeben, die pro Transaktion verarbeitet werden sollen. Standardmäßig wird der Wert 100 verwendet. 19
Beginnzeitpunkt In diesem Feld wird festgelegt, zu welchem Zeitpunkt (Datum/Uhrzeit) die Indizierung beginnen soll. Endzeitpunkt In diesem Feld wird festgelegt, zu welchem Zeitpunkt (Datum/Uhrzeit) die Indizierung enden soll. Anzahl der Threads In diesem Feld wird die Anzahl der zu verwendenden Threads festgelegt. Alternative Bedingung In diesem Feld können die zu indizierenden Objekte eingeschränkt werden. Standard-Geltungsbereich ignorieren Wird in diesem Feld Ja gewählt, erfolgt die Indizierung über alle Fabasoft Components COO- Stores hinweg, auf allen Objekten, auf die die alternative Bedingung zutrifft, auch wenn das Indizierungsservice nicht explizit in den Fabasoft Components COO-Stores definiert wurde. Verzeichnis für Protokolldateien In diesem Feld kann ein Pfad im Dateisystem definiert werden, wo die Protokolldateien gespeichert werden. 6.6 Indizierung über UNC-Pfade Um die Indizierung über UNC-Pfade vorzunehmen, gehen Sie folgendermaßen vor: 1. Wechseln Sie in der Domänenadministration in den Domänenobjekten auf die Registerkarte Services. 2. Öffnen Sie das MMC-Service im Bearbeitungsmodus. 3. Öffnen Sie die Detailansicht im Feld MMC-Bereich. Wurde im Feld Pfad zum Verzeichnis am Server ein UNC-Pfad (Universal Naming Convention) eingetragen, wird dieser an das Filterservice für Mindbreeze Enterprise Search weitergegeben. Bei der Indizierung holt sich das Filterservice die zu indizierenden Dateien direkt aus dem Fabasoft 20
Components MMC-Bereich. Diese Einstellung führt zu einer Verbesserung der Performance, da die zu indizierenden Daten nicht mehr über mehrere Server zum Filterservice kopiert werden müssen. Hinweis: Jedes Service, das eine Indizierung starten soll, benötigt Zugriff auf den Fabasoft Components MMC-Bereich bzw. auch die nötigen Rechte, die Dateien zu lesen. Ebenso benötigt auch das Filterservice für Mindbreeze Enterprise Search diese Rechte. 7 Indizierungsskripte Für die Indizierung können neben den dafür definierten Aktionen auch Skripte verwendet werden. In diesem Kapitel sind einige beispielhafte Indizierungsskripte angeführt. Hinweis: <COO-Adresse> ist der Platzhalter für die Adresse des Indizierungsservice-Objekts. Passen Sie diese Adresse entsprechend an. Weiters muss bei den Protokolldateien immer darauf geachtet werden, dass der Pfad zur Logdatei je nach Microsoft Windows Webservice oder Linux Webservice entsprechend angepasst werden muss. Sollten Fabasoft Components MMC-Bereiche ohne Logging vorhanden sein, müssen diese abgeschlossen sein (eine Deltaindizierung dieser Bereiche ist nicht möglich). Für die Indizierung dieser Bereiche ist es notwendig, den Indizierungsparameter CONTENT IS NOT NULL (z. B.: meth.setparameter2(5, "STRING", "CONTENT IS NOT NULL"); ) zu setzen. 7.1 Skript für Build Index 4 Threads /*========================================================================== Copyright Fabasoft R&D Software GmbH, 2008. Der Nutzer des Computerprogramms anerkennt, dass der oben stehende Copyright-Vermerk im Sinn des Welturheberrechtsabkommens an der vom Urheber festgelegten Stelle in der Funktion des Computerprogramms angebracht bleibt, um den Vorbehalt des Urheberrechtes genuegend zum Ausdruck zu bringen. Dieser Urheberrechtsvermerk darf weder vom Kunden, Nutzer und/oder von Dritten entfernt, veraendert oder disloziert werden. ==========================================================================*/ //LANGUAGE="JavaScript" // Dieses Skript kann für die Erstindizierung verwendet werden. // Es sendet alle Objekte, die im Mindbreeze Konfigurationsobjekt // definiert wurden, an Mindbreeze Enterprise Search. // Es werden 400 Objekte gemeinsam in 4 Threads bearbeitet. // Definieren des Indizierungsservice anhand der Objektadresse. var indexservice = coort.getobject("<coo-adresse>"); // Definieren der Log-Datei. // Das Verzeichnis "C:\Logs" muss existieren. var datetime = coort.parse( cootx, "STRING(coort.GetCurrentDateTime(this))", 2).Evaluate3(cootx, null, indexservice).getitem(0); datetime = datetime.replace(new RegExp(/:/g), "-"); var logfilename = "C:\\Logs\\Index-" + datetime + ".log"; cootx.setvariable2("coosystem@1.1", 2, "BOOLEAN", true); cootx.setvariable2("coosystem@1.1", 14, "STRING", logfilename); // Setzen der Indizierungsparameter. // 400 Objekte gemeinsam in 4 Threads bearbeiten. var meth = indexservice.getmethod(cootx, "BuildIndex"); meth.setparameter2(1, "INTEGER", 400); meth.setparameter2(4, "INTEGER", 4); 21
try { indexservice.callmethod(cootx, meth); catch(e) { coort.trace(e); 7.2 Skript für Recover Index 4 Threads /*========================================================================== Copyright Fabasoft R&D Software GmbH, 2008. Der Nutzer des Computerprogramms anerkennt, dass der oben stehende Copyright-Vermerk im Sinn des Welturheberrechtsabkommens an der vom Urheber festgelegten Stelle in der Funktion des Computerprogramms angebracht bleibt, um den Vorbehalt des Urheberrechtes genuegend zum Ausdruck zu bringen. Dieser Urheberrechtsvermerk darf weder vom Kunden, Nutzer und/oder von Dritten entfernt, veraendert oder disloziert werden. ==========================================================================*/ //LANGUAGE="JavaScript" // Dieses Skript wird für die Wiederherstellung des Index zu einem // bestimmten Zeitpunkt verwendet. // Es werden alle nach dem angegebenen Datum indizierten Objekte // zur erneuten Indizierung markiert. // Definieren des Indizierungsservice anhand der Objektadresse. var indexservice = coort.getobject("<coo-adresse>"); // Definieren der Log-Datei. // Das Verzeichnis "C:\Logs" muss existieren. var datetime = coort.parse( cootx, "STRING(coort.GetCurrentDateTime(this))", 2).Evaluate3(cootx, null, indexservice).getitem(0); datetime = datetime.replace(new RegExp(/:/g), "-"); var logfilename = "C:\\Logs\\RecoverIndex-" + datetime + ".log"; cootx.setvariable2("coosystem@1.1", 2, "BOOLEAN", true); cootx.setvariable2("coosystem@1.1", 14, "STRING", logfilename); // Markieren aller nach "2005-01-01 00:00:00" indizierten // Objekte zur erneuten Indizierung. // 1000 Objekte gemeinsam in 4 Threads bearbeiten. var meth = indexservice.getmethod(cootx, "RecoverIndex"); meth.setparameter(1, "DATETIME", "2005-01-01 00:00:00"); meth.setparameter(2, "INTEGER", 1000); meth.setparameter(5, "INTEGER", 4); try { indexservice.callmethod(cootx, meth); catch(e) { coort.trace(e); 7.3 Skript für die Deltaindizierung /*========================================================================== Copyright Fabasoft R&D Software GmbH, 2008. 22
Der Nutzer des Computerprogramms anerkennt, dass der oben stehende Copyright-Vermerk im Sinn des Welturheberrechtsabkommens an der vom Urheber festgelegten Stelle in der Funktion des Computerprogramms angebracht bleibt, um den Vorbehalt des Urheberrechtes genuegend zum Ausdruck zu bringen. Dieser Urheberrechtsvermerk darf weder vom Kunden, Nutzer und/oder von Dritten entfernt, veraendert oder disloziert werden. ==========================================================================*/ //LANGUAGE="JavaScript" // Dieses Skript kann für die Re-Indizierung von Objekten verwendet werden. // Es werden weniger Objekte gemeinsam verarbeitet und somit nicht // für die Benutzer gesperrt. Die Angabe des Datums der letzten // vollständigen Indizierung erhöht die Performance. var currdate = new Date(); // Definieren der Log-Datei. // Das Verzeichnis "C:\Logs" muss existieren. var logfilename = "C:\\Logs\\Re-Index-" + FormatDate(currdate, true) + ".log"; // Definieren des Indizierungsservice anhand der Objektadresse. var indexservice = coort.getobject("<coo-adresse>"); // Datum entsprechend des gewünschten Deltaindizierungsinterval anpassen. var hourstosubtract = 1; // Diese Anzahl an Stunden wird zurückgerechnet, um das Datum // der letzten Indizierung zu setzen. var fullindexhour = 23; // Angabe, zu welcher Stunde eine vollständige Indizierung // (bis zur letzten vollständigen Indizierung) durchgeführt werden soll. var lastindex = "2008-00-00 00:00:00"; // Datum der letzten vollständigen Indizierung. cootx.setvariable2("coosystem@1.1", 2, "BOOLEAN", true); cootx.setvariable2("coosystem@1.1", 14, "STRING", logfilename); var hour = currdate.gethours(); if (hour == fullindexhour){ indexfrom = lastindex; else { currdate.sethours(hour - hourstosubtract); indexfrom = FormatDate(currdate, false); // Setzen der Indizierungsparameter. // 20 Objekte gemeinsam in 4 Threads bearbeiten. coort.trace("indexfrom: " + indexfrom); var meth = indexservice.getmethod(cootx, "BuildIndex"); meth.setparameter2(1, "INTEGER", 20); meth.setparameter2(2, "DATETIME", indexfrom); meth.setparameter2(4, "INTEGER", 4); try { indexservice.callmethod(cootx, meth); catch(e) { coort.trace(e); 23
function FormatInt(input){ return (input < 10)? "0" + input : input; function FormatDate(input, filename){ return input.getfullyear() + "-" + FormatInt(input.getMonth()+1) + "-" + FormatInt(input.getDate()) + ((filename==true)? "_" : " ") + FormatInt(input.getHours()) + ((filename==true)? "_" : ":") + FormatInt(input.getMinutes()) + ((filename==true)? "_" : ":") + FormatInt(input.getSeconds()) 7.4 Skript für Build Index 4 Threads (Datumseinschränkung) /*========================================================================== Copyright Fabasoft R&D Software GmbH, 2008. Der Nutzer des Computerprogramms anerkennt, dass der oben stehende Copyright-Vermerk im Sinn des Welturheberrechtsabkommens an der vom Urheber festgelegten Stelle in der Funktion des Computerprogramms angebracht bleibt, um den Vorbehalt des Urheberrechtes genuegend zum Ausdruck zu bringen. Dieser Urheberrechtsvermerk darf weder vom Kunden, Nutzer und/oder von Dritten entfernt, veraendert oder disloziert werden. ==========================================================================*/ //LANGUAGE="JavaScript" // Dieses Skript kann für die Erstindizierung von Inhalten verwendet werden. // Die Einschränkung des Datums ermöglicht die Indizierung in Tranchen // bzw. mit mehreren Servern. // Es sendet alle Inhalte, deren Endungen im Filterservice-Objekt des // Indizierungsservice-Objekts definiert wurden, an Mindbreeze Enterprise Search. // Es werden 400 Objekte gemeinsam in 4 Threads bearbeitet. // Definieren des Indizierungsservice anhand der Objektadresse. var indexservice = coort.getobject("<coo-adresse>"); // Definieren der Log-Datei. // Das Verzeichnis "C:\Logs" muss existieren. var datetime = coort.parse( cootx, "STRING(coort.GetCurrentDateTime(this))", 2).Evaluate3(cootx, null, indexservice).getitem(0); datetime = datetime.replace(new RegExp(/:/g), "-"); var logfilename = "C:\\Logs\\BuildIndex-" + datetime + ".log"; cootx.setvariable2("coosystem@1.1", 2, "BOOLEAN", true); cootx.setvariable2("coosystem@1.1", 14, "STRING", logfilename); // Setzen der Indizierungsparameter. // 400 Objekte gemeinsam in 4 Threads bearbeiten. var meth = indexservice.getmethod(cootx, "BuildIndex"); meth.setparameter2(1, "INTEGER", 400); meth.setparameter2(2, "DATETIME", "<Startdatum (objchangedat)>"); meth.setparameter2(3, "DATETIME", "<Enddatum (objchangedat)>"); meth.setparameter2(4, "INTEGER", 4); try { indexservice.callmethod(cootx, meth); catch(e) { coort.trace(e); 24
7.5 Skript für Recover Contents 4 Threads (Neuer Filter) /*========================================================================== Copyright Fabasoft R&D Software GmbH, 2008. Der Nutzer des Computerprogramms anerkennt, dass der oben stehende Copyright-Vermerk im Sinn des Welturheberrechtsabkommens an der vom Urheber festgelegten Stelle in der Funktion des Computerprogramms angebracht bleibt, um den Vorbehalt des Urheberrechtes genuegend zum Ausdruck zu bringen. Dieser Urheberrechtsvermerk darf weder vom Kunden, Nutzer und/oder von Dritten entfernt, veraendert oder disloziert werden. ==========================================================================*/ //LANGUAGE="JavaScript" // Wenn nach einer erfolgten Indizierung die Liste der zu indizierenden // Dateiendungen erweitert wird, muss zuvor dieses Script ausgeführt werden. // Danach kann die Dateiendung im Filterservice hinzugefügt und // die Indizierung erneut gestartet werden. // Definieren des Indizierungsservice anhand der Objektadresse. var indexservice = coort.getobject("<coo-adresse>"); // Definieren der Log-Datei. // Das Verzeichnis "C:\Logs" muss existieren. var datetime = coort.parse( cootx, "STRING(coort.GetCurrentDateTime(this))", 2).Evaluate3(cootx, null, indexservice).getitem(0); datetime = datetime.replace(new RegExp(/:/g), "-"); var logfilename = "C:\\Logs\\AddFilterExtensions-" + datetime + ".log"; cootx.setvariable2("coosystem@1.1", 2, "BOOLEAN", true); cootx.setvariable2("coosystem@1.1", 14, "STRING", logfilename); // Markieren aller nach "2000-01-01 00:00:00" indizierten // Objekte zur erneuten Indizierung. // 1000 Objekte gemeinsam in 4 Threads bearbeiten. var meth = indexservice.getmethod(cootx, "RecoverIndex"); meth.setparameter2(1, "DATETIME", "2000-01-01 00:00:00"); meth.setparameter2(2, "INTEGER", 1000); meth.setparameter2(4, "STRING", ".objlogcontmap.objlogmapindexedat=1900-01-01 00:00:00"); meth.setparameter2(5, "INTEGER", 4); try { indexservice.callmethod(cootx, meth); catch(e) { coort.trace(e); 7.6 Skript für Recover Objects 4 Threads (Neue Eigenschaft) /*========================================================================== Copyright Fabasoft R&D Software GmbH, 2008. Der Nutzer des Computerprogramms anerkennt, dass der oben stehende Copyright-Vermerk im Sinn des Welturheberrechtsabkommens an der vom Urheber festgelegten Stelle in der Funktion des Computerprogramms angebracht bleibt, um den Vorbehalt des Urheberrechtes genuegend zum Ausdruck zu bringen. Dieser Urheberrechtsvermerk darf weder vom Kunden, 25
Nutzer und/oder von Dritten entfernt, veraendert oder disloziert werden. ==========================================================================*/ //LANGUAGE="JavaScript" // Manchmal kann es notwendig sein, nach einer erfolgten Indizierung // Objekte einer Objektklasse zurückzusetzen, um diese erneut // an den Index zu senden, z.b. durch Hinzufügen einer weiteren // zu indizierenden Eigenschaft. // Definieren des Indizierungsservice anhand der Objektadresse. var indexservice = coort.getobject("<coo-adresse>"); // Definieren der Log-Datei. // Das Verzeichnis "C:\Logs" muss existieren. var datetime = coort.parse( cootx, "STRING(coort.GetCurrentDateTime(this))", 2).Evaluate3(cootx, null, indexservice).getitem(0); datetime = datetime.replace(new RegExp(/:/g), "-"); var logfilename = "C:\\Logs\\RecoverObjects-" + datetime + ".log"; cootx.setvariable2("coosystem@1.1", 2, "BOOLEAN", true); cootx.setvariable2("coosystem@1.1", 14, "STRING", logfilename); // Markieren aller nach "2005-01-01 00:00:00" indizierten // Objekte zur erneuten Indizierung. // 1000 Objekte gemeinsam in 4 Threads bearbeiten. var meth = indexservice.getmethod(cootx, "RecoverIndex"); meth.setparameter2(1, "DATETIME", "2005-01-01 00:00:00"); meth.setparameter2(2, "INTEGER", 1000); meth.setparameter2(3, "OBJECT", "<COO-Adresse der Objektklasse>"); meth.setparameter2(5, "INTEGER", 4); try { indexservice.callmethod(cootx, meth); catch(e) { coort.trace(e); 26