Zum Hauptinhalt springen

Daemon einrichten

Daemon unter Windows als Dienst einrichten​

Diese Dokumentation beschreibt die Vorgehensweise, um einen Dienst unter Windows einzurichten, damit der Daemon beim Start des Servers mitgestartet wird.

JavaService.exe​

Um eine Javaklasse als Dienst einzurichten, benötigt man die Anwendung JavaService.exe Unter http://javaservice.ow2.org/docs/devdocs/devcmds.html kann man die wichtigsten Funktionen, Konfigurationen und Informationen nachlesen.

In den Installation ab Version 6.8 findet man dieses Tool unter Service\Tools\javaservice-xxx, wobei xxx fĂĽr die derzeitig genutzte Version steht. In diesem Ordner liegt auch eine Beispiel Jar Datei, um den Dienst zu testen und eine Batchdatei, welche den Dienst installiert.

Konfiguration des Dienstes​

Ist der Dienst erfolgreich installiert, kann es sein, dass noch Informationen fehlen, die man bei der ersten Installation nicht berücksichtigt hat, damit man die Installation nicht nochmal machen muss, hat man zwei verschiedene Möglichkeiten:

Dienst-Eigenschaften​

Die Eigenschaften Seite des Dienstes erlaubt noch einige Bearbeitungen im Nachinein. Bei Aufrufen auf Netzlaufwerken zum Beispiel ist noch wichtig, dass man den Benutzer einträgt, mit dem sich der Dienst verbinden kann.

Tip:

Da dialog EDV keine Domain eingerichtet hat, kann im Dienst eigentlich kein Netzwerkbenutzer angegeben werden, der die Berechtigung hat, die Freigabe zu sehen.

Lösung 1: Freigabeberechtigung auf "jeder" setzen.

Lösung 2: Den eingetragenen Benutzer auch auf dem Freigabeserver anlegen, mit demselben Passwort, so kann man den Dienst "austricksen"

Registrierung​

CAUTION:

Das Editieren der Registrierung kann zu irreperablen Schäden am Betriebssystem führen. Alle Handlungen sind auf eigene Gefahr und mit äußerster Sorgfalt zu behandeln

In der Registrierung den SchlĂĽssel HKEY_LOCAL_MACHINE\ SYSTEM\ CurrentControlSet\ Services\ {SERVICE_NAME}\ suchen

Auf dieser Ebene kann auch der Pfad zu der eigentlichen Exe (JavaServiceDebug.exe) geändert werden.

Tip:

Es kann sein, dass der Dienst nur auf der Rechnerebene gestartet werden kann. Wenn also der Dienst hochfährt und sich ohne Meldung einfach wieder beendet, sollte man die JavaServiceDebug.exe mal nach 'C:\Temp' verschieben, und diese von dort ausführen. Möglicherweise ist auch ein Leerzeichen im Pfad die Ursache, das es nicht funktioniert.

Im Abschnitt 'Parameters' können vorhandene Parameter geändert werden, oder sogar neue angelegt werden

Tip: Beispiel

Bei dem oberen Aufruf fehlt noch die Angabe einer Logdatei fĂĽr Fehlermeldungen und System.Outs des Java Dienstes

Hierzu lege ich bei den Parametern eine neue Zeichenfolge an mit dem Namen System.err File bzw System.out File.

Dann den Parameter doppelklicken und man kann den Wert/Pfad eintragen.

Wenn ein Wert geändert oder hinzugefügt wird, muss der Dienst neu gestartet werden

Beispiel Supportverwaltung​

Hier das Beispiel diaLIMS-Supportverwaltung


1: @rem echo off
2: @echo .
3: setlocal
4: @rem note that if JVM not found, service 'does not report an error' when startup fails,
although event logged
5: if "%JAVA_HOME%" == "" set JAVA_HOME=\\dialog69\dialims\Programm\java\bin\client
6: set JVMDIR=%JAVA_HOME%
7: set JSBINDIR=%CD%
8: set JSEXE=\\dialog69\dialims\Programm\JavaServiceDebug.exe
9: set SSBINDIR=\\dialog69\dialims\Programm
10: @echo . Using following version of JavaService executable:
11: @echo .
12: %JSEXE% -version
13: @echo .
14: @echo Installing service... Press Control-C to abort
15: @pause
16: @echo .
17: %JSEXE% -install diaLIMS-Supportverwaltung %JVMDIR%\jvm.dll
"-Djava.class.path=.;diaLIMS-kunden.jar;diaLIMS.jar"
"-DXmx128m" -start com.dialog.dialims.limsworker.Daemon
-params DIALOG \\dialog69\dialims\Programm\dbconnection.properties
-current \\dialog69\dialims\Programm

Dies ist der Inhalt der Batchdatei, um den Dienst zu installieren, hierzu ein paar Infos, welche nicht Vollständigkeit beanspruchen, aber hilfreich sind zum Verständnis.

Zeile 5:​

Hier wird die Systemvariable JAVA_HOME abgefragt, diese ist normalerweise auf den Standard Java Pfad gesetzt. Ist diese leer, wird die alternative \\dialog69\dialims\Programm\java\bin\client genommen.

CAUTION:

Netzlaufwerke können hier nicht verwendet werden, da diese für den Dienst ohne weiteres nicht sichtbar sind

CAUTION:

Hier ist der Javapfad der diaLIMS-Installation gesetzt. Auf dem Server ist eventuell gar kein Java installiert. In dem Ordner muss die Datei jvm.dll liegen. Diese muss passend zur verwendeten Java-Version aus dem Verzeichnis bin/server kopiert werden. Da wir zurzeit 32bit Java ausliefern muss die jvm.dll auch 32 bit sein, da ansonsten eine Fehlermeldung beim Starten des Dienstes in die Windows-Ergeignisanzeige geschrieben wird: Load Library ist keine zulässige Win32 Anwendung.

Zeile 7:​

Das aktuelle AusfĂĽhrungsverzeichnis von der Anwendung JavaService.exe. Hier wird der aktuelle Ordner genommen, in diesem Fall der Ort, wo die Batch Datei liegt.

Zeile 8:​

Pfad zur Anwendung

Zeile 9:​

diaLIMS\Programm, da wo die *.jars liegen.

Zeile 12:​

Info, welche Version von der Anwendung JavaService.exe verwendet wird.

Zeile 17:​

Diese Zeile ist der wichtigste Aufruf, hier wird der Dienst eingerichtet.

  1. -install:
  2. Dieser Parameter gibt an, dass der Dienst angelegt werden soll
  3. diaLIMS-Supportverwaltung:
  4. frei wählbarer Name des Services. Sollte so gewählt werden, dass man den Dienst a) leicht wieder findet und b) erkennbar ist, wofür er ist. Diese Info gehört in die Serverdoku des Kunden
  5. %JVMDIR%\jvm.dll:
  6. Pfad zur jvm.dll, liegt normalerweise bei jeder Java JRE-Installation bei. Falls nicht muss die entsprechende Datei kopiert werden (wir liefern sie nicht mit aus).
  7. "-Djava.class.path=.;diaLIMS-kunden.jar;diaLIMS.jar" "-DXmx128m":
  8. Das sind die JVM Optionen, hier können der Classpath und andere JVM Parameter, wie zum Beispiel der zugesicherte Speicher konfiguriert werden. Muss im Normalfall nicht geändert werden
  9. -start com.dialog.dialims.limsworker.Daemon:
  10. Welche Klasse soll gestartet werden?
    • Man kann noch weitere Parameter ĂĽbergeben, zum Beispiel welche Klasse ausgefĂĽhrt werden soll, wenn der Dienst beendet wird, oder aber eine Methode auĂźer der main-Methode gestartet werden soll. Infos dazu siehe Link am Anfang des Kapitels.
  11. -params DIALOG \\dialog69\dialims\Programm\dbconnection.properties:
  12. Das sind die Parameter, die an die main Methode der Startklasse ĂĽbergeben werden. DIALOG ist der Name des Daemons in der Datenbank und dbconnection.properties ist die Konfigurationsdatei fĂĽr die Datenbankverbindung
  13. -current \\dialog69\dialims\Programm:
  14. Das ist das Arbeitsverzeichnis der Klasse, wenn in der Funktion später auf Dateien zugegriffen wird, dann relativ von diesem Arbeitsverzeichnis aus.

Daemon unter Linux einrichten​

Bei Linux geht es einfacher, hier kann man einfach eine Shell-Datei mit in den Startprozess mit einbauen. Einfach eine .sh Datei erstellen, ĂĽber chmod der Datei AusfĂĽhrungsrechte geben und diese Datei im Ordner /etc/init.d/ ablegen.

#!/bin/sh # # os 22.04.2012 # Dieses Skript startet den Serverdaemon fĂĽr Hintergrundprozesse vom diaLIMS # Java6 JRE muss auf dem System instaliert sein. java -cp .:./diaLIMS-kunden.jar:./diaLIMS.jar:/usr/bin/bsh com.dialog.dialims.limsworker.Daemon DokumenteProben ./Einstellungen/dbconnection.properties