De:WinService

Aus YaCyWiki
Wechseln zu: Navigation, Suche

Anleitung zur Installation von YaCy als Windows Service.

Diese Anleitung ist alt (2007). YAJSW wurde als funktionierend getestet (2012).

Voraussetzungen

  • Betriebsystem: Windows NT 4.0, Win2000, Windows 2003 oder XP, Windows Vista, Windows 7
  • Java Runtime: Sun JDK 1.7 und kompatible JDKs
  • YaCy Version: YaCy aber SVN Rev. 1507
  • JSL Version: Java Service Launcher v0.99f

Installation

YaCy - Installation

Achtung: Damit YaCy vom Windows Service Manager gestartet werden kann, muß YaCy auf einer der lokalen Festplatten installiert werden. Der Start von YaCy von einem Netzwerklaufwerk funktioniert leider nicht.

Java Service Launcher - Installation

  • JSL downloaden
  • bin/jsl.exe aus heruntergeladenem Archiv entpacken und in das YaCy Hauptverzeichnis speichern
  • bin/jsl.ini aus heruntergeladenem Archiv entpacken und in das YaCy Hauptverzeichnis speichern

bei 64-bit System bin/jsl64.exe und jsl64.ini verwenden

Java Service Launcher - Konfiguration

Nun muß das entpackte JSL Konfigurationdatei jsl.ini wie unten beschieben angepaßt werden. Ein Beispiel für eine vollständige Konfigurationsdatei gibt's hier.

Service Namen vergeben und Startuptyp wählen:

Wenn kein automatischer Start von YaCy erwünscht ist, den Startuptyp auf demand stellen.

[service]
appname = Yacy
servicename = Yacy
displayname = Yacy
dependencies=Tcpip
starttype=auto

Useraccount konfigurieren:

Den Benutzeraccount, unter dem YaCy als Service laufen soll, geeignet (keine Administratorrechte!) konfigurieren. Default ist system

;account=.\administrator
;password=somewpd

Shutdown Methode konfigurieren:

Diese Einstellungen sind notwendig, um YaCy beim Windows Shutdown oder beim manuellen Beenden des YaCy-Services über den Windows Service Manager geordnet herunterzufahren.

stopclass=yacy
stopmethod=shutdown  
stopsignature=()V

Logging konfigurieren:

Falls eine Umleitung der Java System.out und System.err Output-Streams erwünscht ist, kann das wie folgend gemacht werden:

systemout=c:\systemout.log
systemoutappend=yes
systemerr=c:\systemerr.log
systemerrappend=yes

Anmerkung: Im Normalfall ist diese Umleitung nicht notwendig, da YaCy seine Logging-Ausgaben standardmäßig im Verzeichnis DATA/LOG speichert.

Vorsicht: Die Logdatei kann sehr groß werden.

Java Runtime konfigurieren:

Konfiguration der zu verwendenden Java Runtime.

[java]
;jrepath=c:\java\jdk15

Anmerkung: Bleibt diese Option auskommentiert, versucht JSL den Pfad zur Java Runtime aus der Windows Registry auszulesen.

YaCy Commandline konfigurieren:

Konfiguration des YaCy Working-Directories (param00; das Verzeichnis in dem YaCy installiert wurde) und Konfiguration des für YaCy zu verwendenden Hauptspeichers (param00 und param01). Der Java Classpath param03 sollte so wie unten angegeben verwendet werden (Stand: YaCy v1.1/9000 vom 24.08.2012).

wrkdir=C:\yacy
params = 5
param00 = -Xmx600m
param01 = -Xms180m
param02 = -cp 
param03 = htroot;lib/J7Zip-modified.jar;lib/activation.jar;lib/apache-mime4j-0.6.jar;lib/apache-solr-core-3.6.1.jar;lib/apache-solr-solrj-3.6.1.jar;lib/arq-2.8.7.jar;lib/bcmail-jdk15-145.jar;lib/bcprov-jdk15-145.jar;lib/commons-codec-1.6.jar;lib/commons-compress-1.4.1.jar;lib/commons-fileupload-1.2.2.jar;lib/commons-httpclient-3.1.jar;lib/commons-io-2.1.jar;lib/commons-jxpath-1.3.jar;lib/commons-lang-2.6.jar;lib/commons-logging-1.1.1.jar;lib/fontbox-1.7.0.jar;lib/geronimo-stax-api_1.0_spec-1.0.1.jar;lib/guava-r05.jar;lib/htmllexer.jar;lib/httpclient-4.2.1.jar;lib/httpcore-4.2.1.jar;lib/httpmime-4.2.1.jar;lib/icu4j-core.jar;lib/iri-0.8.jar;lib/jakarta-oro-2.0.8.jar;lib/jcifs-1.3.15.jar;lib/jcl-over-slf4j-1.6.1.jar;lib/jempbox-1.7.0lib/jena-2.6.4.jar;lib/jetty-6.1.26-patched-JETTY-1340.jar;lib/jetty-util-6.1.26-patched-JETTY-1340.jar;lib/jsch-0.1.42.jar;lib/json-simple-1.1.jar;lib/jsoup-1.6.3.jar;lib/log4j-1.2.16.jar;lib/log4j-over-slf4j-1.6.1.jar;lib/lucene-analyzers-3.6.1.jar;lib/lucene-core-3.6.0.jar;lib/lucene-highlighter-3.6.0.jar;lib/lucene-phonetic-3.6.0.jar;lib/lucene-spatial-3.6.0.jar;lib/lucene-spellchecker-3.6.0.jar;lib/metadata-extractor-2.4.0-beta-1.jar;lib/mysql-connector-java-5.1.12-bin.jar;lib/pdfbox-1.7.0.jar;lib/poi-3.6-20091214.jar;lib/poi-scratchpad-3.6-20091214.jar;lib/sax-2.0.1.jar;lib/servlet-api-2.5-20081211.jar;lib/slf4j-api-1.6.1.jar;lib/slf4j-jdk14-1.6.1.jar;lib/webcat-0.1-swf.jar;lib/wstx-asl-3.2.7.jar;lib/xercesImpl.jar;lib/xml-apis.jar;lib/yacycore.jar
param04 = net.yacy.yacy

YaCy Service - Anmeldung

Als letzen Schritt muß dann noch das Service beim Windows Service Manager registriert werden. Dazu öffnet man die Windows Eingabeaufforderung, wechselt in das YaCy Verzeichnis und gibt folgenden Befehl ein:

jsl.exe -install

Anmerkung: Unter Windows Vista muss vor der Eingabe des Befehls die Benutzerkontensteuerung ausgeschaltet werden.

Danach erscheint YaCy als neues Service im Windows Service Manager und kann von dort (falls als Starttyp nicht ohnehin auto konfiguriert wurde) gestartet und gestoppt werden.

YaCy Service - Abmeldung

Um das YaCy Service beim Windows Service Manager wieder abzumelden, öffnet man wiederum eine Windows Eingabeaufforderung, wechselt ins YaCy Verzeichnis und gibt folgenden Befehl ein:

jsl.exe -remove

Betrieb

Nachdem YaCy als Service erfolgreich konfiguriert und gestartet wurde, kann wie gewohnt über einen Browser mit der URL http://localhost:8090/ auf das YaCy Webinterface zugegriffen werden.

YaCy Service - Starten/Beenden

Windows Service Manager

Falls nicht der Starttyp auto gewählt wurde, kann da YaCy Service manuell über den Windows Service Manager (Unter Windows XP: Start -> Einstellungen -> Systemsteuerung -> Verwaltung -> Dienste) gestartet werden. Beendet werden kann das YaCy Service über das YaCy Webinterface (zugänglich mit einem Browser über die URL http://localhost:8090) oder über den Windows Service Manager.

Wurde der Starttype auto gewählt, so wird YaCy beim Windows Start automatisch gestartet und beim Windows Shutdown automatisch beendet.

Links