Bevor Sie die Kontextsuche nutzen können, müssen Sie die Suchmaschine unter Ihrem Betriebssystem
installieren und starten. Nach der Umbenennung eines Servers müssen Sie die
Suchmaschine für Kontextsuche neu starten, damit sie auf den neuen
Repository-URL zeigt.
Vorgehensweise
- Öffnen Sie auf Ihrer Plattform eine Eingabeaufforderung und rufen Sie das Unterverzeichnis
Maschineninstallationsverzeichnis/jazz/searchengine/eclipse auf. Hier steht
Maschineninstallationsverzeichnis für das Verzeichnis, in dem Sie die Suchmaschine extrahiert
haben. Sie können die Komponente mit den Script-Dateien oder der ausführbaren Datei
(search_engine.exe bzw. search_engine) ausführen.
Möglicherweise müssen Sie die Script-Datei in einem Texteditor bearbeiten, um sicherzustellen, dass die Umgebungsvariable
JAVA_HOME auf die richtige Position der
IBM® JRE gesetzt ist.
Standardmäßig wird im aktuellen Arbeitsverzeichnis ein Verzeichnis catt erstellt, in das Daten geschrieben werden. Sie können das Arbeitsverzeichnis ändern, indem Sie
den Befehl
search_engine mit dem Parameter -baseOutputDir verwenden. Wenn Sie den Befehl search_engine ohne
Parameter ausführen, wird eine Nachricht angezeigt, in der die Parameteroptionen angegeben sind. Sie können die Suchmaschine mit einem der folgenden
Befehle starten:
- Windows:
search_engine.bat -repository Repository-URL -userId Benutzername
-pass Kennwort -engineId Maschine
oder search_engine.exe -vm JRE-Pfad/bin/java -repository Repository-URL
-userId Benutzername -pass Kennwort -engineId Maschine
- Linux, Linux für z/OS, Linux für Power PC, AIX oder Solaris:
./search_engine.sh -repository Repository-URL -userId Benutzername
-pass Kennwort -engineId Maschine
oder ./search_engine -vm JRE-Pfad/bin/java -repository Repository-URL
-userId Benutzername -pass Kennwort -engineId Maschine
Hierbei gilt Folgendes:
- JRE-Pfad ist der Pfad zur IBM JRE. Die JRE kann sich abhängig von der Installationsmethode im Unterverzeichnis
jdk oder
eclipse/jdk befinden.
- Repository-URL ist der URL Ihres Repositorys, z. B.
https://hostname.example.com:9443/ccm/.
- Benutzername ist der Name eines Benutzers mit Lesezugriff auf die zu indizierenden Projektbereiche.
- Kennwort ist das Benutzerkennwort.
- Maschine ist die Kennung der Suchmaschine.
- Optional: -passwordFile Pfad zur
Kennwortdatei ist der Pfad zu einer Datei mit einem verschlüsselten Kennwort, die mit dem (unten beschriebenen) Parameter
-createPasswordFile erstellt wurde.
- Optional: Sie können -baseOutputDir Verzeichnis als zusätzlichen
Parameter verwenden. In dem Fall gibt Verzeichnis ein Basisverzeichnis an, in das Dateien geschrieben und in dem Dateien gelesen werden. Dieser Parameter ist notwendig, wenn das
aktuelle Arbeitsverzeichnis schreibgeschützt ist. Standardmäßig wird unter dem aktuellen Arbeitsverzeichnis ein Verzeichnis catt erstellt und als Basisverzeichnis verwendet.
Anmerkung: Wenn Sie versuchen, eine weitere Suchmaschineninstanz
auszuführen und für diese das Ausgabeverzeichnis verwenden, das Sie mit dem Parameter
-baseOutputDir für eine zurzeit aktive Instanz konfiguriert haben,
wird die neue Instanz mit der folgenden Nachricht beendet:
Diese Anwendung wird beendet. Das Ausgabeverzeichnis wird von einer aktiven Suchmaschineninstanz verwendet.
- Optional: Mit -verbose können Sie eine ausführliche Ausgabe aktivieren.
- Optional: -createPasswordFile pass.txt.
Hier steht pass.txt für den Pfad zu der Datei mit einem verschlüsselten Kennwort, die mit dem Parameter
-createPasswordFile erstellt wurde. Die Angabe pass.txt kann auf eine Datei mit beliebigem Namen zeigen.
Anmerkung: Geben Sie den
Befehl wie folgt mit dem Parameter
-createPasswordFile ein:
- Windows:
search_engine.bat -createPasswordFile pass.txt
- Linux, Linux für z/OS, Linux für Power PC, AIX oder Solaris:
./search_engine.sh -createPasswordFile pass.txt
- IBM i:
./search_engine.sh -createPasswordFile pass.txt
- Wenn Sie eine Suchmaschine stoppen möchten, drücken Sie in der Befehlsanzeige der Suchmaschine die Tasten STRG + C. Wenn Sie die Suchmaschine unter IBM i im Dialogbetrieb ausführen, drücken Sie die Taste F3, um die Qshell zu verlassen und die
Suchmaschine zu stoppen.