Jargon Tunnel Broker
Running as a Service on Windows NT/2000/2003


Overview:

The Jargon Tunnel Broker can be set up to run as a service on Windows NT/2000/2003. This allows you to start and stop it using the Services applet from the Control Panel, and avoids the need to keep open the Tunnel Broker GUI Control Panel or a command prompt window.

This document describes how to set up the Jargon Tunnel Broker to run as a Service on Windows NT/2000/2003.

Requirements:

Installation Instructions:

1. From a command-prompt on the NT Server, type:
      instsrv TunnelBroker c:\ntreskit\srvany.exe

2. Open up the Control Panel-->Services icon.
    Select the TunnelBroker service and edit its properties in the "Startup ..." dialog:

   Startup Type: manual
   Log on As:
     (x) This account: DOMAIN\Administrator
             Password: <your administrator password>
     Confirm Password: <repeat password>
     (Note: Administrator is used because a user must have network
     permissions to use srvany.exe)

3. Run RegEdt32.exe.

   Note 1: the following assumes that the Jargon Tunnel Broker is
              installed in the folder: "C:\tunnel". If installed elsewhere,
              substitute the correct folder name for this value.
   Note 2: do NOT enter any quote marks around the values

   3.1 Create Key:
       HKLM\SYSTEM\CurrentControlSet\Services\TunnelBroker\Parameters
       (Note: "HKLM" is "HKEY_LOCAL_MACHINE", abbreviated here for brevity)

   3.2 Under "Parameters", create an "Application" value (of type REG_SZ):
       C:\Program Files\JavaSoft\JRE\1.2\bin\java.exe
       (or wherever the Java executable is).

   3.3 Also create an "AppParameters" Value (of type REG_SZ):
       -classpath C:\tunnel\lib\jtunnel.jar;C:\tunnel\lib\o4glrt.zip
                  b.Server C:/tunnel/system/tunnel.ini
        (all on one line, split here only for readability)
        (NOTE: Yes, the value has both "\" and "/" slashes)

   3.4 Also create an "AppDirectory" value (of type REG_SZ):
       C:\tunnel\win32

4. Start the service and watch it run.
 

Screen Samples

See the attached screen images for examples of the Registry entries for a sample Tunnel Broker setup. Note that this sample uses different directories for the java.exe program and the tunnel broker working directory, compared to the above examples. The above examples are the recommended default values, but you can use whatever directories you want.

The first screen shows the TunnelBroker service values that were created in steps 1 and 2 above. NOTE: ObjectName in this image is the user that the service runs as. This user must have network permissions. This service cannot run as the LocalSystem account. "Administrator" will work.

The second screen shows two of the three values that should be added to the Parameters key in step 3. (AppDirectory is not shown, but it should be added as well to specify the tunnel broker working directory. Otherwise all scripts and parameters must use full pathnames instead of relative ones).


Copyright © 2000, 2001, 2004 Jargon Software, Inc. All rights reserved.