De:WinService
Anleitung zur Installation von YaCy als Windows Service.
Diese Anleitung ist alt (2007). YAJSW wurde als funktionierend getestet (2012).
Inhaltsverzeichnis
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
- YaCy installieren, als normale Anwendung starten und fertig konfigurieren.
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
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.