SearchService-Befehle

Die SearchService-Befehle werden zum Erstellen, Abrufen, Aktualisieren und Löschen von Definitionen für geplante Tasks für die Operationen der Anwendung "Suche", "Indexierung" und "Optimierung", verwendet.

SearchService-Befehle

Mit den unten aufgelisteten MBean-Befehlen können Sie Verwaltungstasks für die Anwendung "Suche" ausführen. Die Befehle werden in alphabetischer Reihenfolge aufgeführt.

Um die Befehle auszuführen, müssen Sie zunächst die Konfigurationsumgebung der Anwendung "Suche" initialisieren. Weitere Informationen finden Sie im Abschnitt Auf die Konfigurationsumgebung der Anwendung "Suche" zugreifen.

SearchService.addBackupIndexTask(String taskName, String schedule, String startbySchedule)

Definiert eine neue geplante Task zur Indexsicherung.

Dieser Befehl akzeptiert die folgenden Argumente:

taskName. Der Name der Task, die hinzugefügt werden soll.
schedule. Der Zeitpunkt, zu dem die geplante Task gestartet wird. Dieses Argument ist ein Zeichenfolgewert, der im "cron"-Format angegeben werden muss.
startbySchedule. Der Zeitraum, in dem eine Task ausgeführt werden kann, bevor sie automatisch abgebrochen wird. Dieses Argument ist ein Zeichenfolgewert, der im "cron"-Format angegeben werden muss.

Zum Beispiel:

SearchService.addBackupIndexTask("WeeklyIndexBackup","0 0 2 ? * SAT","0 10 2 ? * SAT")

Wenn der Befehl erfolgreich ausgeführt wird, wird eine 1 (Eins) an die wsadmin-Konsole ausgegeben. Wenn der Befehl nicht erfolgreich ausgeführt wird, wird eine 0 (Null) an die wsadmin-Konsole ausgegeben.

SearchService.addFileContentTask(String taskName, String schedule, String startBy, String applicationNames, String all_configured, Boolean failuresOnly)

Erstellt eine geplante Task zum Abrufen von Dateiinhalten.

Dieser Befehl benötigt die folgenden Argumente:

taskName. Der Name der geplanten Task. Dieses Argument ist ein Zeichenfolgewert, der eindeutig sein muss.
schedule. Der Zeitpunkt, zu dem die geplante Task gestartet wird. Dieses Argument ist ein Zeichenfolgewert, der im "cron"-Format angegeben werden muss.
startBy. Bestimmter Zeitraum, in dem eine Task ausgelöst werden kann, bevor sie automatisch abgebrochen wird. Dieses Argument ist ein Zeichenfolgewert, der im "cron"-Format angegeben werden muss.
applicationNames. Der Name der IBM® Connections-Anwendung(en), die indexiert werden soll(en), wenn die Task ausgelöst wird. Dieses Argument ist ein Zeichenfolgewert. Zur Indexierung mehrerer Anwendungen können Sie eine durch Kommas begrenzte Liste verwenden. Die folgenden Werte sind gültig:
- ecm_files - Ruft Dateien aus dem Enterprise Content Management-Repository ab. Nur veröffentlichte Dateien werden abgerufen; Entwurfsdateien sind nicht enthalten.
- files - Ruft Dateien aus der App "Dateien" ab.
- wikis - Ruft Dateien aus der App "Wikis" ab.
- activities - Ruft Dateien aus der App "Aktivitäten" ab.
- forums - Ruft Dateien aus der App "Foren" ab.
all_configured. Gibt an, dass die Operation für alle Anwendungen durchgeführt wird.
failuresOnly. Gibt an, dass nur die Inhalte von Dateien abgerufen werden, für die die Tasks zum Herunterladen und Konvertieren fehlgeschlagen sind. Bei diesem Argument handelt es sich um einen booleschen Wert.

Zum Beispiel:

SearchService.addFileContentTask("mine", "0 0 1 ? *
  MON-FRI", "0 10 1 ? * MON-FRI", "wikis,files","true")

SearchService.addFileContentTask("mine", "0 0 1 ? *
  MON-FRI", "0 10 1 ? * MON-FRI", "all_configured","true"

Sie können die Taskdefinition für die Standardtask 20min-file-retrieval-task auch mithilfe des Befehls SearchService.addFileContentTask ersetzen. Diese Task wird standardmäßig alle 20 Minuten ausgeführt. Dies gilt nicht für die Zeit zwischen 01:00 und 02:00 Uhr. Um die Standardeinstellungen für die Task zu ersetzen, entfernen Sie zunächst mithilfe des Befehls "SearchService.deleteTask(String taskName)" die vorhandene Task. Erstellen Sie anschließend mithilfe des Befehls "SearchService.addFileContentTask" eine neue Task mit den von Ihnen angegebenen Werten.

Zum Beispiel:

SearchService.deleteTask("20min-file-retrieval-task")
SearchService.addFileContentTask("20min-file-retrieval-task",
  "0 1/20 0,2-23 * * ?", "0 10/20 0,2-23 * * ?",
  "all_configured", "false")

SearchService.addFileContentIndexingTask(String taskName, String schedule, String startBy, String applicationNames, String all_configured, Integer, duration)

Erstellt eine geplante Task zur Indexierung von Dateiinhalten. Die Task zur Indexierung von Dateiinhalten iteriert durch die Liste von Dateien, deren Inhalte noch nicht indexiert wurden. Diese Liste enthält möglicherweise nur einige Elemente. In diesem Fall ist die Ausführung der Task schnell beendet. In einigen Fällen könnte ein großer Rückstand an nicht verarbeiteten Dateien vorhanden sein. Sie können die Ausführungszeit der Task mithilfe des Arguments "duration" begrenzen. Alle verbleibenden Dateien werden bei der nächsten Ausführung der Task verarbeitet.

Dieser Befehl benötigt die folgenden Argumente:

taskName. Der Name der geplanten Task. Dieses Argument ist ein Zeichenfolgewert, der eindeutig sein muss.
schedule. Der Zeitpunkt, zu dem die geplante Task gestartet wird. Dieses Argument ist ein Zeichenfolgewert, der im "cron"-Format angegeben werden muss.
startBy. Bestimmter Zeitraum, in dem eine Task ausgelöst werden kann, bevor sie automatisch abgebrochen wird. Dieses Argument ist ein Zeichenfolgewert, der im "cron"-Format angegeben werden muss.
applicationNames. Der Name der IBM Connections-Anwendung(en), die indexiert werden soll(en), wenn die Task ausgelöst wird. Dieses Argument ist ein Zeichenfolgewert. Zur Indexierung mehrerer Anwendungen können Sie eine durch Kommas begrenzte Liste verwenden. Die folgenden Werte sind gültig:
- ecm_files - Ruft Dateien aus dem Enterprise Content Management-Repository ab. Nur veröffentlichte Dateien werden abgerufen; Entwurfsdateien sind nicht enthalten.
- files - Ruft Dateien aus der App "Dateien" ab.
- wikis - Ruft Dateien aus der App "Wikis" ab.
- activities - Ruft Dateien aus der App "Aktivitäten" ab.
- forums - Ruft Dateien aus der App "Foren" ab.
all_configured. Gibt an, dass die Operation für alle Anwendungen durchgeführt wird.
duration. Ein Wert, der in Sekunden angegeben wird. Er gibt die maximal zulässige Ausführungszeit für die Task an.

Zum Beispiel:

SearchService.addFileContentIndexingTask("file-indexing-task", "0 1/30 0,2-23 * * ?", "0 10/30 0,2-23 * * ?",
    "activities,files,wikis", "600")

SearchService.indexFileContentNow(String applicationNames, Integer duration)

Erstellt eine Task zur Indexierung von Dateiinhalten für eine sofortige Ausführung.

Dieser Befehl benötigt die folgenden Argumente:

applicationNames. Der Name der IBM Connections-Anwendung(en), die indexiert werden soll(en), wenn die Task ausgelöst wird. Dieses Argument ist ein Zeichenfolgewert. Zur Indexierung mehrerer Anwendungen können Sie eine durch Kommas begrenzte Liste verwenden. Die folgenden Werte sind gültig:
- ecm_files - Ruft Dateien aus dem Enterprise Content Management-Repository ab. Nur veröffentlichte Dateien werden abgerufen; Entwurfsdateien sind nicht enthalten.
- files - Ruft Dateien aus der App "Dateien" ab.
- wikis - Ruft Dateien aus der App "Wikis" ab.
- activities - Ruft Dateien aus der App "Aktivitäten" ab.
- forums - Ruft Dateien aus der App "Foren" ab.
duration. Ein Wert, der in Sekunden angegeben wird. Er gibt die maximal zulässige Ausführungszeit für die Task an.

Zum Beispiel:

SearchService.indexFileContentNow("activities,files,wikis", "600")

SearchService.addIndexingTask(String taskName, String schedule, String startBy, String applicationNames, string all_configured, Boolean optimizeFlag)

Erstellt eine neue Definition für geplante Indexierungstasks in der Homepage-Datenbank.

Dieser Befehl benötigt die folgenden Argumente:

taskName. Der Name der geplanten Task. Dieses Argument ist ein Zeichenfolgewert, der eindeutig sein muss.
schedule. Der Zeitpunkt, zu dem die geplante Task gestartet wird. Dieses Argument ist ein Zeichenfolgewert, der im "cron"-Format angegeben werden muss.
startBy. Bestimmter Zeitraum, in dem eine Task ausgelöst werden kann, bevor sie automatisch abgebrochen wird. Dieses Argument ist ein Zeichenfolgewert, der in "cron"-Format angegeben werden muss.
Dieser Parameter sollte verwendet werden, damit keine Indexierungstask in die Warteschlange gestellt und in Zeiten hoher Systemauslastung ausgeführt wird. Unter normalen Bedingungen kann eine Task nur verzögert werden, weil überlappende oder voneinander unabhängige Tasks gleichzeitig ausgelöst werden oder weil die Ausführung einer früheren Task lange dauert.
applicationNames. Der Name der IBM Connections-Anwendung(en), die indexiert werden soll(en), wenn die Task ausgelöst wird. Dieses Argument ist ein Zeichenfolgewert. Zur Indexierung mehrerer Anwendungen können Sie eine durch Kommas begrenzte Liste verwenden. Die folgenden Werte sind gültig:
- activities
- blogs
- calendar
- communities
- dogear
- ecm_files
- files
- forums
- people_finder
- profiles
- status_updates
- wikis
all_configured. Gibt an, dass die Operation für alle Anwendungen durchgeführt wird.
optimizeFlag. Ein Flag, das angibt, ob nach der Indexierung ein Optimierungsschritt ausgeführt werden soll. Bei diesem Argument handelt es sich um einen booleschen Wert.
Anmerkung: Der Optimierungsvorgang ist sowohl CPU- als auch E/A-intensiv. Der Vorgang sollte daher nur selten und wenn möglich zu Zeiten geringer Systemauslastung durchgeführt werden. Weitere Informationen finden Sie auf der folgenden Webseite:
http://lucene.apache.org/core/old_versioned_docs/versions/3_0_3/api/all/org/apache/lucene/index/IndexWriter.html#optimize%28%29
Beachten Sie, dass beim Installieren von IBM Connections eine Task zur Suchoptimierung so konfiguriert wird, dass sie standardmäßig jede Nacht ausgeführt wird. Weitere Informationen finden Sie im Abschnitt Standardtasks der Anwendung "Suche".

Alle Argumente sind erforderlich.

Zum Beispiel:

SearchService.addIndexingTask("customDogearAndBlogs", "0 0 1 ? * MON-FRI", "0 10 1 ? * MON-FRI", "dogear,blogs", "true")

Anmerkung: Der Befehl "refreshTasks()" sollte im Anschluss an diesen Befehl verwendet werden, damit die neuen Taskdefinitionen unmittelbar wirksam werden. Andernfalls werden die Änderungen erst beim nächsten Starten der Suchanwendung wirksam.

Sie können die 15min-search-indexing-task, die beim Installieren von IBM Connections automatisch konfiguriert wird, auch mithilfe des Befehls "SearchService.addIndexingTask" ersetzen. Standardmäßig werden alle installierten IBM Connections-Anwendungen alle 15 Minuten durchsucht und indexiert. Dies gilt nicht für die Zeit von 01:00 bis 02:00 Uhr. Um die Standardeinstellungen der Indexierungstask zu ersetzen, entfernen Sie zunächst mithilfe des Befehls "SearchService.deleteTask(String taskName)" die vorhandene Indexierungstask. Erstellen Sie anschließend mithilfe des Befehls "SearchService.addIndexingTask" eine neue Indexierungstask mit den von Ihnen angegebenen Werten.

Zum Beispiel:

SearchService.deleteTask("15min-search-indexing-task")
SearchService.addIndexingTask("15min-search-indexing-task", "0 1/15 0,2-23 * * ?", "0 10/15 0,2-23 * * ?", "all_configured", "false")

SearchService.addOptimizeTask(String taskName, String schedule, String startBy)

Erstellt eine neue Definition einer geplanten Task zur Indexoptimierung.

Dieser Befehl akzeptiert die folgenden Argumente:

taskName. Der Name der geplanten Task. Dieses Argument ist ein Zeichenfolgewert, der eindeutig sein muss.
schedule. Der Zeitpunkt, zu dem die geplante Task gestartet wird. Dieses Argument ist ein Zeichenfolgewert, der im "cron"-Format angegeben werden muss.
startBy. Bestimmter Zeitraum, in dem eine Task ausgelöst werden kann, bevor sie automatisch abgebrochen wird. Dieses Argument ist ein Zeichenfolgewert, der im "cron"-Format angegeben werden muss.
Dieser Parameter sollte verwendet werden, damit keine Indexierungstask in die Warteschlange gestellt und in Zeiten hoher Systemauslastung ausgeführt wird. Unter normalen Bedingungen kann eine Task nur verzögert werden, weil überlappende oder voneinander unabhängige Tasks gleichzeitig ausgelöst werden oder weil die Ausführung einer früheren Task lange dauert.

Alle Argumente sind erforderlich.

Anmerkung: Der Optimierungsvorgang ist sowohl CPU- als auch E/A-intensiv. Der Vorgang sollte daher nur selten und wenn möglich zu Zeiten geringer Systemauslastung durchgeführt werden. Weitere Informationen finden Sie auf der folgenden Webseite:
http://lucene.apache.org/core/old_versioned_docs/versions/3_0_3/api/all/org/apache/lucene/index/IndexWriter.html#optimize%28%29

Beachten Sie, dass beim Installieren von IBM Connections eine Task zur Suchoptimierung so konfiguriert wird, dass sie standardmäßig jede Nacht ausgeführt wird. Weitere Informationen finden Sie im Abschnitt Standardtasks der Anwendung "Suche".

Zum Beispiel:

SearchService.addOptimizeTask("customOptimize", "0 0 1 ? * MON-FRI", "0 10 1 ? * MON-FRI")

Sie können den Befehl "SearchService.addOptimizeTask" auch zum Ersetzen der nightly-optimize-task verwenden, die beim Installieren von IBM Connections automatisch konfiguriert wird. Diese Task wird standardmäßig jede Nacht um 01:30 Uhr ausgeführt. Um die Standardeinstellungen der Optimierungstask zu ersetzen, entfernen Sie zunächst mithilfe des Befehls "SearchService.deleteTask" die vorhandene Optimierungstask. Erstellen Sie anschließend mithilfe des Befehls "SearchService.addOptimizeTask" eine neue Optimierungstask mit den von Ihnen angegebenen Werten.

Zum Beispiel:

SearchService.deleteTask("nightly-optimize-task")
SearchService.addOptimizeTask("nightly-optimize-task", "0 30 1 * * ?", "0 35 1 * * ?")

SearchService.addSandTask(String taskName, String schedule, String startBy, String jobs)

Erstellt eine neue Definition für eine geplante Task für den Service für soziale Analysen in der Homepage-Datenbank.

Dieser Befehl benötigt die folgenden Argumente:

taskName. Der Name der geplanten Task. Dieses Argument ist ein Zeichenfolgewert, der eindeutig sein muss.
schedule. Der Zeitpunkt, zu dem die geplante Task gestartet wird. Dieses Argument ist ein Zeichenfolgewert, der in "cron"-Format angegeben werden muss.
startBy. Bestimmter Zeitraum, in dem eine Task ausgelöst werden kann, bevor sie automatisch abgebrochen wird. Dieses Argument ist ein Zeichenfolgewert, der in "cron"-Format angegeben werden muss.
Dieser Parameter sollte verwendet werden, um sicherzustellen, dass geplante Tasks nicht in die Warteschlange gestellt und zu Zeiten hoher Serverauslastung ausgeführt werden. Unter normalen Bedingungen kann eine Task nur verzögert werden, weil überlappende oder voneinander unabhängige Tasks gleichzeitig ausgelöst werden oder weil die Ausführung einer früheren Task lange dauert.
jobs. Der Name des Jobs bzw. die Namen der Jobs, die ausgeführt werden, wenn die Task ausgelöst wird. Dieses Argument ist ein Zeichenfolgewert. Zur Indexierung mehrerer Jobs können Sie eine durch Kommas begrenzte Liste verwenden. Die folgenden Werte sind gültig: evidence, graph, manageremployees, tags, taggedby und communitymembership.

Alle Argumente sind erforderlich.

Zum Beispiel:

SearchService.addSandTask("customSaNDIndexTask", "0 0 1 ? * MON-FRI", "0 10 1 ? * MON-FRI",
   "evidence,graph,manageremployees,tags,taggedby,communitymembership")

Sie können mithilfe des Befehls "SearchService.addSandTask" auch die nightly-sand-task ersetzen, die beim Installieren von IBM Connections automatisch konfiguriert wird. Die Task wird standardmäßig jede Nacht um 01:00 Uhr ausgeführt. Um die Standardeinstellungen der SAND-Task zu ersetzen, entfernen Sie zunächst mithilfe des Befehls "SearchService.deleteTask(String taskName)" die vorhandene Task. Erstellen Sie anschließend mithilfe des Befehls "SearchService.addSandTask" eine neue SAND-Task mit den von Ihnen angegebenen Werten.

Zum Beispiel:

SearchService.deleteTask("nightly-sand-task")
SearchService.addSandTask("nightly-sand-task", "0 0 1 * * ?", "0 5 1 * * ?", 
   "evidence,graph,manageremployees,tags,taggedby,communitymembership")

SearchService.backupIndexNow()

Sichert den Index an der Speicherposition, die durch die IBM WebSphere Application Server-Variable SEARCH_INDEX_BACKUP_DIR angegeben ist. Das Ausführen der Sicherung kann sich verzögern, wenn Indexierungstasks in Bearbeitung sind.

Dieser Befehl erfordert keine Argumente.

Nachdem Sie den Suchindex mit wsadmin-Befehlen gesichert haben, sollten Sie eine vollständige Sicherung der HOMEPAGE-Datenbank durchführen. Beachten Sie, dass eine Abhängigkeit zwischen dem Suchindex und den Daten in der HOMEPAGE-Datenbank besteht.

SearchService.deleteFeatureIndex(String featureName)

Entfernt und löscht die Inhalte für die angegebene Anwendung aus dem Suchindex.

Anmerkung: Verwenden Sie diesen Befehl nur, wenn Sie eine Anwendung von IBM Connections deinstallieren. Nach Ausführen des Befehls kann der Inhalt der gelöschten Anwendung nicht erneut indexiert werden. Weitere Informationen finden Sie im Abschnitt Inhalt aus dem Index löschen.

Für diesen Befehl ist die Eingabe eines Zeichenfolgewerts erforderlich, der dem Namen der Anwendung entspricht, deren Inhalte gelöscht werden sollen. Die folgenden Werte sind gültig:

activities
blogs
calendar
communities
dogear
ecm_files
files
forums
people_finder
profiles
status_updates
"wikis".

Zum Beispiel:

SearchService.deleteFeatureIndex("activities")

SearchService.deleteAllTasks()

Löscht alle Taskdefinitionen aus der Datenbank "Homepage".

Dieser Befehl akzeptiert keine Parameter.

SearchService.deleteGlobalSandProperty(String propertyName)

Löscht die angegebene globale Eigenschaft für soziale Analysen.

Zum Beispiel:

SearchService.deleteGlobalSandProperty("sand.tag.freq.threshold")

Wenn die Eigenschaft erfolgreich hinzugefügt oder aktualisiert wird, wird eine 1 (Eins) an die wsadmin-Konsole ausgegeben. Wenn die Eigenschaft nicht erfolgreich hinzugefügt oder aktualisiert wird, wird eine 0 (Null) an die wsadmin-Konsole ausgegeben. Wenden Sie sich in diesem Fall an die Suchclusteradministration und suchen Sie in der Datei SystemOut.log nach weiteren Details.

SearchService.deleteTask(String taskName)

Löscht die Taskdefinition mit dem angegebenen Namen aus der Homepage-Datenbank.

Für diesen Befehl ist die Eingabe eines Zeichenfolgewerts zulässig, der dem Namen der zu löschenden Task entspricht. Informationen zum Abrufen der Namen von Tasks in der Homepage-Datenbank finden Sie unter Geplante Tasks auflisten.

Zum Beispiel:

SearchService.deleteTask("profilesIndexingTask")

SearchService.disableAllTasks()

Inaktiviert alle geplanten Tasks für die Anwendung "Suche".

Dieser Befehl erfordert keine Argumente.

SearchService.disableIndexingOnServer("nodename","servername")

Inaktiviert die Indexierung auf dem angegebenen Server. Verwenden Sie den Befehl "SearchService.enableIndexingOnServer("nodename","servername")", um die Indexierung später erneut zu aktivieren.

Vorsicht:

Verwenden Sie diesen Befehl nur, wenn Sie von dem IBM Support dazu aufgefordert wurden. Wenn Sie die Indexierung temporär inaktivieren möchten, verwenden Sie stattdessen die Befehle zum Inaktivieren von geplanten Tasks.

Dieser Befehl benötigt die folgenden Parameter:

nodename. Ein Zeichenfolgewert, der den Namen des Knotens angibt, auf dem Sie die Indexierung inaktivieren möchten.
servername. Ein Zeichenfolgewert, der den Namen des Servers angibt, auf dem Sie die Indexierung inaktivieren möchten.

Zum Beispiel:

SearchService.disableIndexingOnServer("Node01","cluster1_server1")

SearchService.disableTask(String taskName)

Inaktiviert die geplante Task mit dem angegebenen Namen.

Dieser Befehl akzeptiert ein einziges Argument:

taskName. Der Name der Task, die inaktiviert werden soll. Dieses Argument ist ein Zeichenfolgewert.

Zum Beispiel:

SearchService.disableTask("mine")

Die Verwendung dieses Befehls wirkt sich wie folgt auf den Indexierungsprozess aus:

Wenn der Befehl vor dem Auslösen der geplanten Task ausgeführt wird, wird der Start des Indexierungsvorgangs verhindert.
Wenn der Befehl während des Indexierungsvorgangs einer Anwendung ausgeführt wird, hält die Anwendung "Suche" die Indexierung an.

Die Ergebnisse der Anwendung, die derzeit indexiert wird, werden verworfen. Wenn allerdings einige Anwendungen im Rahmen einer geplanten Task erfolgreich durchsucht wurden, sind diese Anwendungen im Index auf einem aktuellen Stand. Wenn beispielsweise eine Task zum Indexieren der Anwendungen Lesezeichen, Blogs und Aktivitäten (in genau dieser Reihenfolge) ausgelöst wird und der Inaktivierungsbefehl aufgerufen wird, während die Anwendung Blogs indexiert wird, wird die Indexierung der Anwendungen Blogs und Aktivitäten nach dem erneuten Aktivieren der Task genau an dem Punkt fortgesetzt, an dem sie mit dem vorherigen Befehl angehalten wurde. Inaktivierte Tasks bleiben inaktiviert, bis sie erneut aktiviert werden.

SearchService.enableAllTasks()

Aktiviert alle geplanten Tasks für die Anwendung "Suche" erneut.

Dieser Befehl erfordert keine Argumente.

SearchService.enableIndexingOnServer("nodename","servername")

Aktiviert die Indexierung auf dem angegebenen Server erneut. Dieser Befehl wird in Verbindung mit dem Befehl "SearchService.disableIndexingOnServer("nodename","servername")" verwendet.

Dieser Befehl benötigt die folgenden Parameter:

nodename. Ein Zeichenfolgewert, der den Namen des Knotens angibt, auf dem Sie die Indexierung erneut aktivieren möchten.
servername. Ein Zeichenfolgewert, der den Namen des Servers angibt, auf dem Sie die Indexierung erneut aktivieren möchten.

Zum Beispiel:

SearchService.enableIndexingOnServer("node1","server1")

SearchService.enableTask(String taskName)

Aktiviert die geplante Task mit dem angegebenen Namen erneut. Dieser Befehl verwendet den aktuellen Zeitplan.

Dieser Befehl akzeptiert ein einziges Argument:

taskName. Der Name der Task, die aktiviert werden soll. Dieses Argument ist ein Zeichenfolgewert.

Zum Beispiel:

SearchService.enableTask("mine")

SearchService.flushPersistedCrawlContent()

Löscht aktuelle als persistent definierte Basislisten.

Anmerkung: Mit diesem Befehl werden nur als persistent definierte Basislisten an der Standardpersistenzposition gelöscht. Mithilfe des Befehls "startBackgroundCrawl", "startBackgroundFileContentExtraction" oder "startBackgroundIndex" gesuchte Basislisten müssen manuell gelöscht werden.

Dieser Befehl erfordert keine Eingabeparameter.

Anmerkung: Führen Sie diesen Befehl nicht aus, während eine Crawlersuche ausgeführt wird.

SearchService.getFileContentNow(String applicationNames)

Startet die Task zum Abrufen von Dateiinhalten. Dieser Befehl iteriert durch den Dateicache und lädt Dateien ohne Inhalt herunter und konvertiert diese.

Für diesen Befehl ist die Eingabe eines Zeichenfolgewerts erforderlich, der dem Namen der Anwendung entspricht, deren Inhalte abgerufen werden sollen. Die folgenden Werte sind gültig:

ecm_files - Ruft Dateien aus dem Enterprise Content Management-Repository ab. Nur veröffentlichte Dateien werden abgerufen; Entwurfsdateien sind nicht enthalten.
files - Ruft Dateien aus der App "Dateien" ab.
wikis - Ruft Dateien aus der App "Wikis" ab.
activities - Ruft Dateien aus der App "Aktivitäten" ab.
forums - Ruft Dateien aus der App "Foren" ab.

Zum Beispiel:

SearchService.getFileContentNow("files")

SearchService.getIndexStatus(String createdTaskName)

Gibt einen Status einer bestimmten von SearchService.indexNow erstellten Indextask oder einer geplanten Indextask an.

Dieser Befehl akzeptiert ein einziges Argument:

createdTaskName. Der Name einer von SearchService.indexNow erstellten Task oder einer geplanten Indextask.

Zum Beispiel:

SearchService.getIndexStatus("roi-dogear-blogs-SunMay1109:45:02EDT2014")

Der Befehl gibt eine Ausgabe wie die folgende zurück:

{
"success": true, 
"result": [
"INDEX_COMPLETED" 
]
}

Wenn der Befehl erfolgreich ausgeführt wird, wird "success": true in der wsadmin-Konsole ausgegeben. Wenn der Befehl nicht erfolgreich ausgeführt wird, wird "success": false in der wsadmin-Konsole ausgegeben. Der Taskstatus innerhalb des Ergebnisses kann einen der folgenden Werte aufweisen:

UNKNOWN,
CRAWL_STARTED,
WAITING_FOR_CRAWL,
DB_EMPTY,
INDEX_COMPLETED

SearchService.indexNow(String applicationNames)

Erstellt eine einmalige Task, die für die angegebenen Anwendungen 30 Sekunden nach dem Aufruf Indizes erstellt.

Dieser Befehl akzeptiert ein einziges Argument:

applicationNames. Der Name der IBM Connections-Anwendung(en), die indexiert werden soll(en), wenn die Task ausgelöst wird. Dieses Argument ist ein Zeichenfolgewert. Zur Indexierung mehrerer Anwendungen können Sie eine durch Kommas begrenzte Liste verwenden. Die folgenden Werte sind gültig:
- activities
- all_configured
- blogs
- calendar
- communities
- dogear
- ecm_files
- files
- forums
- people_finder
- profiles
- status_updates
- wikis.

Verwenden Sie all_configured , anstatt alle indexierbaren Services aufzulisten, wenn Sie alle Anwendungen indexieren möchten.

Anmerkung: Nach Abschluss des Indexierungsvorgangs wird keine Operation zur Optimierung ausgeführt.

Zum Beispiel:

SearchService.indexNow("dogear, blogs")

Der Befehl gibt eine Ausgabe im JSON-Format zurück, die der folgenden ähnelt:

{ 
"success": true, 
"result": [ 
"roi-dogear-blogs-SunMay1109:45:02EDT2014" 
]
}

Wenn der Befehl erfolgreich ausgeführt wird, wird "success": true an die wsadmin-Konsole ausgegeben. Wenn der Befehl nicht erfolgreich ausgeführt wird, wird "success": false an die wsadmin-Konsole ausgegeben. Der erstellte Taskname innerhalb von "result" wird immer zurückgegeben.

SearchService.indexNowWithOptimization(String applicationNames)

Erstellt eine einmalige Task, die für die angegebenen Anwendungen 30 Sekunden nach dem Aufruf Indizes erstellt und am Ende der Indexierung eine Optimierungsoperation ausführt.

Dieser Befehl akzeptiert ein einziges Argument:

applicationNames. Der Name der IBM Connections-Anwendung(en), die indexiert werden soll(en), wenn die Task ausgelöst wird. Dieses Argument ist ein Zeichenfolgewert. Zur Indexierung mehrerer Anwendungen können Sie eine durch Kommas begrenzte Liste verwenden. Die folgenden Werte sind gültig:
- activities
- all_configured
- blogs
- calendar
- communities
- dogear
- ecm_files
- files
- forums
- people_finder
- profiles
- status_updates
- wikis.

Zum Beispiel:

SearchService.indexNowWithOptimization("dogear, blogs")

SearchService.listFileContentTasks()

Listet alle geplanten Tasks zum Abrufen von Dateiinhalten auf.

Dieser Befehl erfordert keine Eingabeparameter.

SearchService.listFileContentIndexingTasks()

Listet alle geplanten Tasks zum Abrufen und Indexieren von Dateiinhalten auf.

Dieser Befehl erfordert keine Eingabeparameter.

SearchService.listGlobalSandProperties()

Listet alle globalen Eigenschaften für den Service für soziale Analysen auf.

Die Eigenschaften werden als Zuordnung von Schlüsseln zu Werten zurückgegeben. Die folgende Ausgabe gibt beispielsweise an, dass der Wert der Eigenschaft "sand.tag.freq.threshold" 32000 ist.

{sand.tag.freq.threshold=32000}

SearchService.listIndexingNodes()

Gibt eine Liste der Indexierungsknoten der Anwendung "Suche" in Ihrer Implementierung zurück.

Dieser Befehl erfordert keine Argumente.

Wenn der Befehl erfolgreich ausgeführt wird, werden die Namen der Indexierungsknoten der Anwendung "Suche" zusammen mit Informationen zu den einzelnen Knoten in die wsadmin-Konsole ausgegeben. Die Ausgabe enthält eine Versionszeitmarke und Informationen, die angeben, ob es sich bei dem Knoten um einen Indexierungsknoten handelt, ob der Index auf dem Server über 30 Tage alt ist und ob der Index auf dem Server mit dem aktuellsten Index im Cluster synchronisiert ist.

Zum Beispiel:

Indexing Node Id: dubxpcvm084-0Node02:server1, Last Crawl Version: 1,340,285,460,074, Indexer: true, Out of Date: false, Out of Sync: false

SearchService.listIndexingTasks()

Listet alle Definitionen für geplante Indexierungstasks auf, die in der Homepage-Datenbank definiert sind.

Dieser Befehl erfordert keine Eingabeparameter.

SearchService.listOptimizeTasks()

Listet alle Definitionen für geplante Optimierungstasks auf, die in der Homepage-Datenbank definiert sind.

Dieser Befehl erfordert keine Eingabeparameter.

SearchService.listRunningTasks()

Listet alle Tasks auf, die derzeit für die Anwendung "Suche" ausgeführt werden. Dieser Befehl erfordert keine Eingabeparameter.

Der Befehl gibt eine Liste der Tasks zurück, die derzeit ausgeführt werden, und enthält für jede Task die folgenden Informationen:

Interne Task-ID
Taskname
Startzeit der Task

Zum Beispiel:

wsadmin>SearchService.listRunningTasks()
>>>51
roi-profiles-WedDec0715:23:09GMT2011
Wed Dec 07 15:23:09 GMT 2011

SearchService.listSandTasks()

Listet alle Tasks auf, die für den Service für soziale Analysen geplant und in der Datenbank "Homepage" definiert sind.

Dieser Befehl erfordert keine Eingabeparameter.

SearchService.listTasks()

Listet alle Definitionen für geplante Tasks der Suchfunktion (Indexierung und Optimierung) auf, die in der Homepage-Datenbank definiert sind.

Dieser Befehl erfordert keine Eingabeparameter.

SearchService.notifyRestore(Boolean isNewIndex)

Versetzt die Datenbank in einen konsistenten Zustand, sodass Crawler an dem Punkt starten, an dem die Sicherung durchgeführt wurde.

Der Befehl "notifyRestore" aktualisiert die Indexverwaltungstabellen in der Datenbank "HOMEPAGE", sodass Crawler-Fortsetzungspunkte von einem wiederhergestellten Index erneut geladen werden. Dabei wird sichergestellt, dass alle zukünftigen Crawlersuchen am richtigen Punkt beginnen. Der Befehl löscht auch zwischengespeicherten Inhalt in der Datenbank "HOMEPAGE".

Der Befehl "notifyRestore" entfernt optional alle Einträge aus der Datenbanktabelle "HOMEPAGE", die im Rahmen des Prozesses zum Extrahieren von Inhalt den Status einzelner Dateien nachverfolgt. Diese Tabelle wird von der Anwendung "Suche" beim Indexieren des Inhalts von Dateianhängen verwendet.

Dieser Befehl benötigt einen einzigen Parameter:

isNewIndex: Wenn dieser Parameter auf "true" gesetzt ist, werden alle Einträge aus der Datenbanktabelle entfernt, die vom Prozess zum Extrahieren von Dateiinhalt zum Nachverfolgen des Status einzelner Dateien verwendet wird.
Setzen Sie diesen Parameter auf "true", wenn Sie einen neu erstellten Index wiederherstellen. Setzen Sie diesen Parameter auf "false", wenn Sie eine Indexsicherung wiederherstellen.

Zum Beispiel:

SearchService.notifyRestore("true")

SearchService.optimizeNow()

Erstellt eine einmalige Task, die 30 Sekunden nach dem Aufruf am Suchindex eine Operation zur Optimierung ausführt.

Der Befehl akzeptiert keine Eingabeparameter.

Dieser Vorgang sollte nicht während eines Indexierungsvorgangs aufgerufen werden. Wenn er ausgeführt werden muss, sollte dies in Zeiten geringer Systemauslastung erfolgen, wenn von der Anwendung nicht die Durchführung intensiver E/A-Operationen für den Index erwartet wird.

SearchService.optIntoSandByEmail(String email)

Schließt den Benutzer mit der angegebenen E-Mail-Adresse in den Service für soziale Analysen ein.

Dieser Befehl akzeptiert ein einziges Argument:

email. Die E-Mail-Adresse des Benutzers, der in den Service für soziale Analysen eingeschlossen werden soll. Dieses Argument ist ein Zeichenfolgewert.

Zum Beispiel:

SearchService.optIntoSandByEmail("ajones10@example.com")

SearchService.optIntoSandByExId(String externalId)

Schließt den Benutzer mit der angegebenen externen ID in den Service für soziale Analysen ein.

Dieser Befehl akzeptiert ein einziges Argument:

externalId. Die externe ID des Benutzers, der in den Service für soziale Analysen eingeschlossen werden soll. Dieses Argument ist ein Zeichenfolgewert.

Zum Beispiel:

SearchService.optIntoSandByExId("11111-1111-1111-1111")

SearchService.optOutOfSandByEmail(String email)

Schließt den Benutzer mit der angegebenen E-Mail-Adresse aus dem Service für soziale Analysen aus.

Dieser Befehl akzeptiert ein einziges Argument:

email. Die E-Mail-Adresse des Benutzers, der aus dem Service für soziale Analysen ausgeschlossen werden soll. Dieses Argument ist ein Zeichenfolgewert.

Zum Beispiel:

SearchService.optOutOfSandByEmail("ajones10@example.com")

SearchService.optOutOfSandByExId(String externalId)

Schließt den Benutzer mit der angegebenen externen ID aus dem Service für soziale Analysen aus.

Dieser Befehl akzeptiert ein einziges Argument:

externalId. Die externe ID des Benutzers, der aus dem Service für soziale Analysen ausgeschlossen werden soll. Dieses Argument ist ein Zeichenfolgewert.

Zum Beispiel:

SearchService.optOutOfSandByExId("11111-1111-1111-1111")

SearchService.refreshTasks()

Ruft den Server auf, Taskeinstellungen aus den Definitionstabellen für Tasks der Anwendung "Suche" zu lesen, und synchronisiert die konfigurierten Tasks mit den Tasks in den Tabellen des IBM WebSphere Application Server-Schedulers.

Dieser Befehl sollte im Anschluss an die folgenden Befehle verwendet werden, damit die Änderungen der Taskdefinitionen unmittelbar wirksam werden. Andernfalls werden die Änderungen erst beim nächsten Starten der Anwendung "Suche" wirksam.

SearchService.addIndexingTask(String taskName, String schedule, String startBy, String applicationNames, Boolean optimizeFlag)
SearchService.addOptimizeTask(String taskName, String schedule, String startBy)
SearchService.deleteTask(String taskName)

Der Befehl akzeptiert keine Eingabeparameter.

SearchService.reloadIndex()

Lädt den Suchindex auf dem aktuellen Knoten erneut, jedoch ohne die Suchanwendung erneut zu starten.

Anmerkung: Wenn Sie Änderungen an der Konfiguration des Service für soziale Analysen vornehmen, müssen Sie die Suchanwendung zum Anwenden der Änderungen immer noch erneut starten.

SearchService.reloadIndexAllNodes()

Lädt den Suchindex auf allen Knoten im Cluster erneut, ohne die Suchanwendung erneut zu starten.

Anmerkung: Wenn Sie Änderungen an der Konfiguration des Service für soziale Analysen vornehmen, müssen Sie die Suchanwendung zum Anwenden der Änderungen immer noch erneut starten.

SearchService.reloadSearchConfiguration()

Lädt die Datei search-config.xml zur Suche auf dem aktuellen Knoten erneut, jedoch ohne erneutes Starten der Suchanwendung.

Anmerkung: Wenn Sie Änderungen an der Konfiguration des Service für soziale Analysen vornehmen, müssen Sie die Suchanwendung zum Anwenden der Änderungen immer noch erneut starten.

SearchService.reloadSearchConfigurationAllNodes()

Lädt die Datei search-config.xml zur Suche auf allen Knoten im Cluster erneut, ohne die Suchanwendung erneut zu starten.

Anmerkung: Wenn Sie Änderungen an der Konfiguration des Service für soziale Analysen vornehmen, müssen Sie die Suchanwendung zum Anwenden der Änderungen immer noch erneut starten.

SearchService.removeIndexingNode(String nodeName)

Entfernt den angegebenen Knoten aus der Indexverwaltungstabelle.

Dieser Befehl akzeptiert ein einziges Argument:

nodeName. Der Name des Knotens, der entfernt werden soll. Dieses Argument ist ein Zeichenfolgewert mit dem folgenden Format:
```
nodeName:serverName
```
Um eine Liste der Indexierungsknoten in Ihrer Implementierung abzurufen, führen Sie den Befehl "SearchService.listIndexingNodes()" aus. Weitere Informationen finden Sie unter Indexierungsknoten auflisten.

Zum Beispiel:

SearchService.removeIndexingNode("Node01:cluster1_server1")

SearchService.resetAllTasks()

Löscht alle Definitionen geplanter Tasks aus der Datenbank "Homepage" und stellt die Standardgruppe der Tasks wieder her. Weitere Informationen zu diesen Tasks finden Sie unter Standardmäßige geplante Tasks suchen.

Dieser Befehl akzeptiert keine Parameter.

SearchService.retryContentFailuresNow(String applicationNames)

Wiederholt fehlgeschlagene Versuche, Dateien für die angegebene Anwendung herunterzuladen und zu konvertieren.

Für diesen Befehl ist die Eingabe eines Zeichenfolgewerts erforderlich, der dem Namen der Anwendung entspricht, deren Inhalte heruntergeladen und konvertiert werden sollen. Die folgenden Werte sind gültig:

files - Ruft Dateien aus der App "Dateien" ab.
wikis - Ruft Dateien aus der App "Wikis" ab.
activities - Ruft Dateien aus der App "Aktivitäten" ab.
forums - Ruft Dateien aus der App "Foren" ab.

Eine Task zum Herunterladen oder Konvertieren einer Datei kann aus vielen verschiedenen Gründen, z. B. wegen Hardware- oder Netzwerkproblemen fehlschlagen. Fehlgeschlagene Tasks sind im Cache mit einem Flag versehen und können wiederholt werden.

Zum Beispiel:

SearchService.retryContentFailuresNow("wikis,files")

SearchService.retryIndexing(String service, String id)

Versucht, ein Inhaltselement zu indexieren, das bei der ersten oder inkrementellen Indexierung nicht erfolgreich indexiert wurde.

Anmerkung: retryIndexing funktioniert nicht bei ecm_files.

Dieser Befehl benötigt zwei Parameter:

service: Die Anwendung, aus der die Inhalte stammen.
id: Die Atom-ID der Inhalte. Informationen zum Abrufen der Atom-ID für die Inhalte finden Sie in der Dokumentation zur IBM Connections-API im IBM Social Business Development Wiki.

Zum Beispiel:

SearchService.retryIndexing('activities', 'b63cabf8-0533-45cf-9636-d63cd6a6f3ca')

Wenn der Befehl erfolgreich ausgeführt wird, wird eine 1 (Eins) an die Konsole ausgegeben. Wenn der Befehl nicht erfolgreich ausgeführt wird, wird eine 0 (Null) an die Konsole ausgegeben.

SearchService.sandIndexNow(String jobs)

Erstellt eine einmalige Task für soziale Analysen, die für die angegebenen Services 30 Sekunden nach dem Aufruf Indizes erstellt.

Dieser Befehl akzeptiert ein einziges Argument:

jobs. Der Name des Jobs bzw. die Namen der Jobs, die ausgeführt werden, wenn die Task ausgelöst wird. Dieses Argument ist ein Zeichenfolgewert. Zur Ausführung mehrerer Jobs können Sie eine durch Kommas begrenzte Liste verwenden. Die folgenden Werte sind gültig: evidence, graph, manageremployees, tags, taggedby und communitymembership.

Zum Beispiel:

SearchService.sandIndexNow("evidence,graph,manageremployees,tags,taggedby,communitymembership")

SearchService.saveMetricsToFile(String filePath)

Erfasst interne Kennzahlen und schreibt sie in die angegebene Datei.

Dieser Befehl akzeptiert ein einziges Argument:

filePath: Der vollständige Pfad zu einer Textdatei, in der die Kennzahlen gespeichert werden sollen. Dieses Argument ist ein Zeichenfolgewert.

Eine Datei wird in dem angegebenen Verzeichnis erstellt. Der Dateiname enthält die Zeichenfolge "searchMetrics-" als Präfix und enthält eine Zeitmarke, die angibt, wann die Kennzahlen erfasst wurden. Die Dateiausgabe erfolgt im folgenden Format:

================================================================
ACTIVITIES

Average entry indexing time: 0.03 seconds
Max entry indexing time: 0.17
Min entry indexing time: 0.01
Entry count: 54

Average seedlist request time: 1.83 seconds
Max seedlist request time: 4.16
Min seedlist request time: 0.1
Seedlist request count: 3

================================================================
PROFILES

Average entry indexing time: 0.07 seconds
Max entry indexing time: 1.48
Min entry indexing time: 0.04
Entry count: 1763

Average seedlist request time: 8.6 seconds
Max seedlist request time: 13.06
Min seedlist request time: 0.14
Seedlist request count: 5

SearchService.setGlobalSandIntegerProperty(String propertyName, String integerProperyValue)

Fügt eine dynamische globale Eigenschaft für soziale Analysen hinzu, die Auswirkungen auf die API für soziale Analysen oder das Indexierungsverhalten hat, oder aktualisiert sie. Die Änderungen werden beim Start des nächsten Indexierungsjobs für soziale Analysen übernommen.

Derzeit wird nur für die Eigenschaft sand.tag.freq.threshold für soziale Analysen Unterstützung bereitgestellt. Für diese Eigenschaft ist ein ganzzahliger Wert zulässig.

Die Eigenschaft wird wie folgt vom Algorithmus "Recommend API" verwendet:

Rufen Sie die Personen und Tags ab, zu denen der Benutzer gehört.
- Wenn der Tag häufiger oder genauso häufig im Suchindex enthalten ist, wie durch den für die Eigenschaft "sand.tag.freq.threshold" angegebenen Wert vorgegeben, löschen Sie ihn. Diese Aktion verhindert, dass Benutzer Empfehlungen erhalten, die auf allgemeinen Tags basieren, also Tags, die häufig vorkommen.
Rufen Sie die Dokumente ab, denen die Personen und Tags, die in der ersten Abfrage zusammengestellt wurden, zugeordnet sind.
Geben Sie dem Benutzer die Ergebnisse zurück.

Zum Beispiel:

SearchService.setGlobalSandIntegerProperty("sand.tag.freq.threshold",100)

Notes:

Dies ist eine globale Einstellung. Sie wirkt sich auf alle IBM Connections-Benutzer aus. Die Einstellung sollte nur von einem Administrator geändert werden.

Sie können die Datei SystemOut.log zu Rate ziehen, wenn die Indexierung für soziale Analysen damit beginnt, die Häufigkeitsverteilung der beliebtesten 100 Tags im System zu prüfen.

In Zeile 1 des folgenden Auszugs wird beispielsweise angezeigt, dass der Tag "brown" im Index die Ordinalzahl 1718 (eine Ordinalzahl ist eine Facetten-ID) und die Häufigkeit 1 aufweist. Dies bedeutet, dass nur eine Instanz eines Dokuments vorhanden ist, das im Index mit den Tags für das Schlüsselwort "brown" versehen ist.

[5/30/11 15:41:13:544 IST] 00000025 CommonTagsCac I com.ibm.lotus.connections.sand.tags.impl.CommonTagsCache buildCacheUsingTermEnum {1718:brown:1} 
[5/30/11 15:41:13:548 IST] 00000025 CommonTagsCac I com.ibm.lotus.connections.sand.tags.impl.CommonTagsCache buildCacheUsingTermEnum {1730:summaries:1} 
[5/30/11 15:41:13:551 IST] 00000025 CommonTagsCac I com.ibm.lotus.connections.sand.tags.impl.CommonTagsCache buildCacheUsingTermEnum {1737:public_holiday:1} 
[5/30/11 15:41:13:554 IST] 00000025 CommonTagsCac I com.ibm.lotus.connections.sand.tags.impl.CommonTagsCache buildCacheUsingTermEnum {1721:chronicle:1} 
[5/30/11 15:41:13:558 IST] 00000025 CommonTagsCac I com.ibm.lotus.connections.sand.tags.impl.CommonTagsCache buildCacheUsingTermEnum {1716:hollis:1} 
[5/30/11 15:41:13:561 IST] 00000025 CommonTagsCac I com.ibm.lotus.connections.sand.tags.impl.CommonTagsCache buildCacheUsingTermEnum {1700:inquirer:1} 
[5/30/11 15:41:13:565 IST] 00000025 CommonTagsCac I com.ibm.lotus.connections.sand.tags.impl.CommonTagsCache buildCacheUsingTermEnum {1684:gazette:5} 
[5/30/11 15:41:13:568 IST] 00000025 CommonTagsCac I com.ibm.lotus.connections.sand.tags.impl.CommonTagsCache buildCacheUsingTermEnum {1679:ibm:7} 
[5/30/11 15:41:13:572 IST] 00000025 CommonTagsCac I com.ibm.lotus.connections.sand.tags.impl.CommonTagsCache buildCacheUsingTermEnum Cache:{1679=7, 1684=5, 1700=1, 1716=1, 1718=1, 1721=1, 1730=1, 1737=1} 
[5/30/11 15:41:13:633 IST] 00000025 IndexBuilderQ I com.ibm.lotus.connections.search.admin.index.impl.IndexBuilderQueue startSaNDIndexingService CLFRW0483I: SAND indexing has started.

SearchService.startBackgroundCrawl(String persistenceLocation, String components)

Durchsucht die Basislisten der angegebenen Anwendungen und speichert die Basislisten anschließend an der angegebenen Position. Dieser Befehl erstellt keinen Index.

Der Befehl erfordert die folgenden Parameter:

persistenceLocation

Eine Zeichenfolge, die den Pfad angibt, unter dem die Basislisten gespeichert werden sollen.

components

Eine Zeichenfolge, die die Anwendungen angibt, deren Basislisten durchsucht werden sollen. Die folgenden Werte sind gültig:

activities
all_configured
blogs
calendar
communities
dogear
ecm_files
files
forums
people_finder
profiles
status_updates
wikis

Verwenden Sie "all_configured", anstatt alle indexierbaren Services aufzulisten, wenn Sie alle Anwendungen durchsuchen möchten.

Zum Beispiel:

SearchService.startBackgroundCrawl("/opt/IBM/Connections/backgroundCrawl", "Aktivitäten, Foren, Communitys, Wikis")

SearchService.startBackgroundFileContentExtraction(persistence dir, components, extracted text dir, thread limit)

Extrahiert Dateiinhalt für alle Dateien, auf die in der als persistent definierten Basisliste in einem Prozess verwiesen wird, der unabhängig von der Indexierungstask ist.

Dieser Befehl benötigt die folgenden Parameter:

persistence dir

Eine Zeichenfolge, die die Position der als persistent definierten Basislisten der Dateien angibt.

components

Eine Zeichenfolge, die die Anwendung(en) angibt, für die Dateiinhalt extrahiert werden soll. Die folgenden Werte sind gültig:

files - Extrahiert Dateiinhalte aus der App "Dateien".
wikis - Extrahiert Dateiinhalte aus der App "Wikis".
activities - Extrahiert Dateiinhalte aus der App "Aktivitäten".
forums - Extrahiert Dateiinhalte aus der App "Foren".
ecm_files - Extrahiert Dateiinhalte aus Community-Bibliothektsdateien, die in Enterprise Content Management-Systemen gespeichert sind.

extracted text dir

Eine Zeichenfolge, die die Zielposition für den extrahierten Text angibt. Für dieses Verzeichnis werden dieselbe Verzeichnisstruktur und dasselbe Benennungsschema wie für das Verzeichnis für extrahierten Text bei der Implementierung connections shared data/ExtractedText verwendet. Beispiel: ExtractedText/121/31/36cdb7a0-92b2-4cf9-91f3-c4e7e527a5e1.

thread limit

Die maximale Anzahl der Basislistenthreads.

Zum Beispiel:

SearchService.startBackgroundFileContentExtraction("/bg_index/seedlists", "files", "/bg_index/extractedText", 10)

Für gewöhnlich wird dieser Befehl ausgeführt, nachdem der Befehl startBackgroundCrawl zum Bearbeiten aktueller Basislisten ausgeführt wurde. Wenn keine als persistent definierten Basislisten verfügbar sind, entspricht das Verhalten dem beim Ausführen des Befehls "startBackgroundCrawl", d. h., zuerst werden Basislisten durchsucht und als persistent definiert.

SearchService.startBackgroundIndex(String persistenceLocation, String extractedFileContentLocation, String indexLocation, String applications, String jobs, Boolean isIndexingMultiThreaded)

Erstellt einen Hintergrundindex an der angegebenen Position.

Dieser Befehl durchsucht die Basislisten für die angegebenen Anwendungen, speichert die Basislisten an der angegebenen Persistenzposition und extrahiert den Dateiinhalt. Anschließend erstellt er einen Suchindex für die Anwendungen an der angegebenen Indexspeicherposition.

Sie können am Ende des Vorgangs zur Hintergrundindexierung auch Indexierungsjobs für soziale Analysen ausführen. Alternativ dazu können Sie "SearchService.startSandBackgroundIndex" ausführen, wenn Sie einen Hintergrundindex für den Service für soziale Analysen erstellen möchten. Weitere Informationen hierzu finden Sie unter Hintergrundindex für den Service für soziale Analysen erstellen.

Anmerkung: Bei diesem Befehl muss die Groß-/Kleinschreibung beachtet werden, sogar unter Windows. Beispiel: Wenn Sie c:\temp als Position zum Erstellen der Basisliste angeben, das Verzeichnis aber C:\Temp ist, wird eine Fehlernachricht zurückgegeben.

Dieser Befehl benötigt die folgenden Argumente:

persistenceLocation

Ein Zeichenfolgewert, der die Speicherposition angibt, an der Sie die Anwendungsbasislisten speichern möchten.

extractedFileContentLocation

Die Position für den extrahierten Dateiinhalt. Verwenden Sie dieselbe Position, die Sie angegeben haben, als Sie bereits Dateiinhalte mithilfe des Befehls "SearchService.startBackgroundFileContentExtraction" oder des Befehls "SearchService.startBackgroundIndex" extrahiert haben. Geben Sie andernfalls ein leeres Verzeichnis als Speicherposition für den extrahierten Dateiinhalt an.

indexLocation

Ein Zeichenfolgewert, der die Speicherposition angibt, an der Sie den Hintergrundindex erstellen möchten.

applications

Ein Zeichenfolgewert, der die Namen der Anwendungen angibt, die Sie in den Indexsuchlauf einschließen möchten. Die folgenden Werte sind gültig:

activities
all_configured
blogs
calendar
communities
dogear
ecm_files
files
forums
people_finder
profiles
status_updates
wikis

Verwenden Sie "all_configured", anstatt alle indexierbaren Anwendungen aufzuführen, wenn Sie alle Anwendungen indexieren möchten.

Um mehrere Anwendungen zur Indexierung in die Warteschlange zu stellen, führen Sie eine einzelne Instanz des Befehls SearchService.startBackgroundIndex mit den Namen der Anwendungen aus, die Sie indexieren möchten. Trennen Sie die Namen dabei durch Kommas voneinander. Wenn Sie mehrere Instanzen des Befehls ausführen und eine einzige Anwendung als Parameter angegeben ist, wird beim ersten Ausführen des Befehls eine Sperre eingerichtet, sodass nur die erste angegebene Anwendung erfolgreich indexiert wird.

jobs

Ein Zeichenfolgewert, der die Namen der Indexierprogramme für die Nachverarbeitung für soziale Analysen angibt, die neue Ausgabe basierend auf den Daten im Index überprüfen, indexieren und produzieren. Die folgenden Werte sind gültig: evidence, graph, manageremployees, tags, taggedby und communitymembership. Verwenden Sie ein Komma, um mehrere Werte voneinander zu trennen. Dieser Parameter ist optional.

isIndexingMultiThreaded

Ein boolescher Wert, der angibt, ob die Indexerstellung als Multithread-Prozess ausgeführt werden soll. Dieser Parameter ist optional.

Beispiele:

SearchService.startBackgroundIndex("/opt/IBM/Connections/data/local/search/backgroundCrawl", 
"/opt/IBM/Connections/data/local/search/backgroundExtracted", 
"/opt/IBM/Connectios/data/local/search/background/backgroundIndex",
"activities, blogs, calendar, communities, dogear, files, forums,
profiles, wikis, status_updates", "communitymembership, graph")

SearchService.startBackgroundIndex("/opt/IBM/Connections/data/local/search/backgroundCrawl",
"/opt/IBM/Connections/data/local/search/backgroundExtracted",
"/opt/IBM/Connections/data/local/search/background/backgroundIndex",
"all_configured")

SearchService.startBackgroundSandIndex(String indexLocation, String jobs)

Erstellt einen Hintergrundindex für den Service für soziale Analysen an der angegebenen Position. Dieser Befehl darf nur für einen Index ausgeführt werden, der bereits über Inhalte verfügt, die über die IBM Connections-Anwendungen und den ECM-Service indexiert wurden.

Dieser Befehl akzeptiert die folgenden Argumente:

indexLocation: Ein Zeichenfolgewert, der die Speicherposition angibt, an der Sie den Hintergrundindex erstellen möchten.
jobs: Ein Zeichenfolgewert, der die Namen der Indexierprogramme für die Nachverarbeitung für soziale Analysen angibt, die neue Ausgabe basierend auf den Daten im Index überprüfen, indexieren und produzieren. Die folgenden Werte sind gültig: evidence, graph, manageremployees, tags, taggedby und communitymembership. Verwenden Sie ein Komma, um mehrere Werte voneinander zu trennen.

Zum Beispiel:

SearchService.startBackgroundSandIndex("/bkg2/index/","communitymembership,graph")

SearchService.updateResumeTokens(String components, String date, String indexLocation)

Aktualisiert die Fortsetzungstokens im Index.

Anmerkung: Sie können diesen Befehl nur für Hintergrundindizes ausführen.

Dieser Befehl benötigt die folgenden Argumente:

components

Die Anwendung, deren Fortsetzungstokens bearbeitet werden sollen. Die folgenden Werte sind gültig:

activities
all_configured
blogs
calendar
communities
dogear
ecm_files
files
forums
people_finder
profiles
status_updates
wikis

Verwenden Sie all_configured , anstatt alle indexierbaren Services aufzulisten, wenn Sie die Fortsetzungstokens bearbeiten möchten.

date: Das Datum, auf das die Fortsetzungstokens gesetzt werden, im Format MM-tt-jjjj HH:mm:ss:SSSZ.
Beispiel: 08-01-2013 14:00:00:000-0000

indexLocation: Die Position, die den Index enthält, für den die Fortsetzungstokens aktualisiert werden.
Beispiel: /opt/IBM/Connections/data/search/index_backup
.

Wenn der Befehl ordnungsgemäß ausgeführt wird und die Fortsetzungstokens aktualisiert werden, wird der Wert "1" in der Befehlszeile zurückgegeben. Wenn die Fortsetzungstokens nicht aktualisiert werden, wird der Wert "0" in der Befehlszeile zurückgegeben.

Anmerkung:

Beispiele:

SearchService.updateResumeTokens("all_configured","08-01-2013 14:00:00:000-0000", 
"/opt/IBM/Connections/data/search/index_backup") 
SearchService.updateResumeTokens("profiles, 
activities,blogs,communities,forums,files,dogear","08-01-2013 14:00:00:000-0000", 
"/opt/IBM/Connections/data/search/index_backup")

SearchService.startBackgroundFeatureReindex(String persistenceLocation, String extractedFileContentLocation, String indexLocation, String application, Boolean isIndexingMultiThreaded)

Indexiert eine Anwendung im Hintergrund an der angegebenen Position erneut.

Dieser Befehl indexiert die angegebene Anwendung erneut, indem er die folgenden Schritte ausführt:

Er entfernt den gesamten indexierten Inhalt für diese Funktion aus dem Index.
Er führt eine erneute Crawlersuche für die Basislisten für die angegebene Anwendung durch.
Er speichert die Basislisten an der angegebenen permanenten Position.
Er extrahiert den Dateiinhalt (falls verfügbar).
Er erstellt den Index für diese Anwendung an der angegebenen Indexposition erneut.

Andere Indizes im angegebenen Hintergrundindex sind nicht betroffen.

Dieser Befehl akzeptiert die folgenden Argumente:

persistenceLocation: Ein Zeichenfolgewert, der die Speicherposition angibt, an der Sie die Anwendungsbasislisten speichern möchten.

extractedFileContentLocation: Die Position für den extrahierten Dateiinhalt. Verwenden Sie dieselbe Position, die Sie angegeben haben, als Sie Dateiinhalte mithilfe des Befehls SearchService.startBackgroundFileContentExtraction oder SearchService.startBackgroundIndex extrahiert haben. Geben Sie andernfalls ein leeres Verzeichnis als Speicherposition für den extrahierten Dateiinhalt an.

indexLocation: Ein Zeichenfolgewert, der die Position des vorhandenen Hintergrundindex angibt.

application

Ein Zeichenfolgewert, der den Namen der Anwendung, die Sie erneut indexieren möchten, angibt. Die folgenden Werte sind gültig:

activities
blogs
calendar
communities
dogear
ecm_files
files
forums
people_finder
profiles
status_updates
wikis

isIndexingMultiThreaded: Ein boolescher Wert, der angibt, ob die Indexerstellung als Multithread-Prozess ausgeführt werden soll. Dieser Parameter ist optional.

Beispiel:

SearchService.startBackgroundFeatureReindex("/opt/IBM/Connections/data/local/search/backgroundCrawl",
"/opt/IBM/Connections/data/local/search/backgroundExtracted", "/opt/IBM/Connections/data/local/search/backgroundIndex", 
"activities")

SearchService.deleteBackgroundFeatureIndex(String indexLocation, String application)

Entfernt alle indexierten Inhalte aus einer angegebenen Anwendung in einem Hintergrundindex.

Dieser Befehl akzeptiert die folgenden Argumente:

indexLocation: Ein Zeichenfolgewert, der die Position des vorhandenen Hintergrundindex angibt.

application

Ein Zeichenfolgewert, der den Namen der Anwendung angibt, deren Index entfernt werden soll. Die folgenden Werte sind gültig:

activities
blogs
calendar
communities
dogear
ecm_files
files
forums
people_finder
profiles
status_updates
wikis

Beispiel:

SearchService.deleteBackgroundFeatureIndex("/opt/IBM/Connections/data/local/search/backgroundIndex","activities")