polymap.org

Voraussetzungen

Sie müssen über die notwendigen Rechte verfügen, um POLYMAP als Dienst auf diesem Computer einrichten zu dürfen!

Sie benötigen folgende Programme und Tools:

1. JSmooth ab Version 0.9.9-5 zum Erstellen einer ausführbaren Programm-Datei.
2. Resource Kit Tools von Microsoft zum Einrichten der vorher erstellten Programm-Datei als Dienst.

Erstellen einer ausführbaren Programm-Datei mit JSmooth

1. Installieren Sie JSmooth in ein Verzeichnis Ihrer Wahl und starten Sie das Programm.
   Das Programmfenster ist etwas zu klein dimensioniert. Ziehen Sie es auf eine akzeptable Grösse.
2. Klicken Sie links auf Skeleton und wählen Sie dann rechts im Bereich Skeleton Selection den Eintrag Console Wrapper.
3. Wählen Sie im linken Bereich Executable und geben Sie rechts bei Executable Binary einen Programmnamen mit der Endung .exe ein. Z.B. polymap2.exe.
   Dies ist das Programm, das JSmooth später erzeugt und welches dann als Dienst eingerichtet werden wird! Achten Sie darauf, dass dieses Programm im Wurzelverzeichnis Ihrer Jetty-Installation liegen muss!
4. Aktivieren Sie rechts das Häkchen “Sets the executable folder as current directory of the application”.
5. Wählen Sie nun links Application und geben Sie rechts in das Feld Main class die Klasse “org.mortbay.start.Main” ein, aktivieren Sie darunter das Häkchen “Use an embeded jar” und geben Sie den Pfad zur Datei start.jar im Wurzelverzeichnis Ihrer jetty-Installation ein.
6. Klicken Sie im linken Bereich auf JVM Selection und geben Sie rechts bei Minimum JVM Version die Zeichenkette “1.4.2” ein.
7. Wählen Sie nun links den letzten Bereich JVM Configuration und geben Sie rechts in das Feld Maximum Memory die Zahl 256 ein und achten Sie darauf, dass dahinter MB ausgewählt ist. In das Feld Initial Memory Allocation tragen Sie die Zahl 128 ein. Achten Sie wieder darauf, dass dahinter MB ausgewählt ist.
8. Speichern Sie das Projekt auch in das Wurzelverzeichnis Ihrer Jetty-Installation!
9. Nun klicken Sie im Menü auf Project / Compile… oder auf das entsprechende Icon um die Programm-Datei zu erzeugen.

Im Wurzelverzeichnis Ihrer Jetty-Installation sollte nun die Programm-Datei polymap2.exe vorhanden sein. Natürlich nur, wenn Sie vorhin diesen Namen auch eingegeben haben ;-)

Resource Kit Tools installieren

Falls noch nicht geschehen, laden Sie die Resource Kit Tools aus dem Internet herunter und installieren Sie diese in ein Verzeichnis Ihrer Wahl ohne Leerzeichen.
Überprüfen Sie die Installation, indem Sie eine Konsole öffnen und dort instsrv eingeben.
Als Ergebnis sollte folgendes erscheinen:

Installs and removes system services from NT
INSTSRV <service name> (<exe location> | REMOVE)
  [-a <Account Name>] [-p <Account Password>]
  Install service example:

    INSTSRV MyService C:\MyDir\DiskService.Exe
    -OR-
    INSTSRV MyService C:\mailsrv\mailsrv.exe -a MYDOMAIN\joebob -p foo

  Remove service example:

    INSTSRV MyService REMOVE

Informationen von Microsoft

• Erstellen eines benutzerdefinierten Dienstes
• Anleitung zu srvany.exe

Dienst einrichten und starten

1. Öffnen Sie eine Konsole
   Z.B. über Start/Programme/Zubehör/Eingabeaufforderung oder
   gleichzeitiges drücken von Windows-Taste + R, Eingabe von cmd und anschliessendem Return bzw. Enter

1. Geben Sie folgende Befehlszeile ein: instsrv POLYMAP <Pfad zu Resource Kit Tools>\srvany.exe>
   Sollte srvany.exe nicht auf Ihrem System vorhanden sein, dann müssen Sie sich die sog. Resource Kit Tools von Microsoft besorgen (hier vom Windows Server 2003) und installieren. Führen Sie dann bitte die o.a. Befehlszeile nochmal aus.
   Sie sollten folgende Rückmeldung erhalten:

The service was successfuly added!

Make sure that you go into the Control Panel and use
the Services applet to change the Account Name and
Password that this newly installed service will use
for its Security Context.

1. Registrierung anpassen
   Öffnen Sie den Registrierungseditor indem Sie regedt32 ausführen.
   Wechseln Sie zu dem Schlüssel HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\POLYMAP
   Erzeugen Sie einen neuen Schlüssel mit dem Namen Parameters und klicken Sie diesen an
   Erzeugen Sie in diesem Schlüssel eine neue Zeichenfolge mit dem Namen Application und geben Sie als Wert den vollständigen Pfad zur vorhin erzeugten polymap2.exe im Jetty-Verzeichnis (z.B. C:\jetty-5.1.4\polymap2.exe) an.
   Erzeugen Sie noch eine Zeichenfolge mit dem Namen AppDirectory und geben Sie als Wert das Jetty-Verzeichnis an.
   
   Sie können aber auch einen Beispiel-Schlüssel in die Registrierung importieren und anpassen. Allerdings ist dies immer mit Vorsicht zu geniessen!
2. Startoptionen des Dienstes einstellen
   Öffnen Sie Start/Programme/Verwaltung/Dienste
   Öffnen Sie die Eigenschaften des Eintrags POLYMAP
   Legen Sie fest, ob POLYMAP automatisch beim Starten des Computers oder manuell gestartet werden soll (Starttyp)
   Starten Sie den Dienst indem Sie auf den Button Starten klicken