launcher_help.txt

Scripts and JARs from launcher project
--------------------------------------

$Id: launcher_help.txt,v 1.9 2002/03/05 18:16:42 niksilver Exp $

launcher
--------

Usage: launcher [-D<propertyname>=<value>]* [-cache-limit <size>] [-jdb] 
                <options>

Starts the launcher/management console. It is started as an
external netlet on its own node.

Arguments:

    -D<propertyname>=<value>
        Passed straight through to the Java interpreter which uses it
        to set a system property.
    -cache-limit <size>
        Limits the amount of disk space used by the cache. The size is
        specified in bytes and applies to the total size of the contents
        of the directory where the cached jars are kept. This means that 
        if the cache directory is shared between several launcher's, the
        size of the cache will never grow larger than the maximum of the
        arguments given to each of them. A size of 0 means no limitatation
        to the size of the cache.
    -jdb
        Starts the Java interpreter with debugging.
    <options>
        Passed directly to launcher.jar.

Files:

    launcher.policy
             Java security policy used for launcher.jar.

launcher.jar
------------

Usage: java -jar launcher.jar <dir> [-cache <cdir>] [-shared <shaddr>]+
                     [-preload <jardir>|<jarfile>]*
                     [-gui true|false]
                     -msgbus <mbaddr> <mbport>
                     [-boot <script> | -run <script>] <arg>*

Starts the launcher/management console. It is started as an
external netlet on its own node.

Arguments:

    <bindir>
        Base directory in which it will run, containing all the relevant
        Jtrix JARs.
    -cache <cdir>
        Let node use directory <cdir> to cache JARs etc.
    -shared <shaddr>
        Specify which IP address the launcher may use. Must be specified
        at least once.
    -preload <jardir>|<jarfile>
        Load one or more jar files (.jar) at bootup in order to accelerate
        descriptors uploading.
        Each jar file must be preceded by '-preload'. If a directory is specified
        (instead of a single jar file) all the jar files (files with 
        extension .jar) in that directory are preloaded.
    -gui true|false
        Choose whether to use the Swing-based front end (true, default)
        or the console.
    -msgbus <mbaddr> <mbport>
        Says which IP address and port the node should listen on for
        messages from other nodes. If <mbport> is set to 0 then the
        port is dynamically chosen to be something currently unused.
    -boot <script>
        Script to execute on startup. Each line of the file specified
        is executed as if it was typed in on the launcher command line.
        After they have all completed control returns to the user.
    -run <script>
        Like -boot, but at the end the launcher quits.
    <arg>
        Any additional parameters. These get passed into the launcher
        command line as variables %0, %1, %2, etc.

Files:

    launcher.policy
             Java security policy used for launcher.jar.

(ends)