[Dev] Important: ZipTie client/server running and debugging

[Brett Wooldridge]

The ZipTie client now launches the server as an independent process (and
destroys it on shutdown).  The following is some information that can make
working with the client, server, and client/server easier.

When launching the ZipTie client from Eclipse you should use the following
VM argument (replacing macosx with your OS), assuming you have run Œant
dbreset¹:

-Dderby.system.home=${workspace_loc}/dist/ziptie/<macosx>

This ensures that it looks for the derby database in your dist directory.

These are additional arguments you can supply to the client launch:
  
-Dnoserver=true
      Don¹t start the server from the client, this allows you to start the
server from Eclipse or the command-line.  See the note
      below.
-Ddebug.server=true
      Direct the client to start the server in remote debugging mode.
You¹ll get an error dialog or two, ignore them. You
      will then need to attach Eclipse to the server process.  It¹s on
localhost:8787.

If you use the ³noserver² option, then when you launch the server it needs
to know a path into the workspace of client (to find credentials).  I use
the following option when launching the server independently from Eclipse:

-Dziptie.dir=/Users/brettw/workspace/.metadata/.plugins/org.ziptie.core

(assuming that the client workspace is /Users/brettw/workspace)

There are of course additional parameters that must be supplied to the
server, so my complete set looks like this:

-Dorg.osgi.service.http.port=8080
-Dziptie.dir=/Users/brettw/workspace/.metadata/.plugins/org.ziptie.core
-Dderby.system.home=${workspace_loc}/dist/ziptie/macosx/derby

When running the server from the server.sh or server.bat file you need to
define ³ziptie.dir² in the environment before launching:

Linux/OS X:
   export 
JAVA_OPTIONS=-Dziptie.dir=/Users/brettw/workspace/.metadata/.plugins/org.zip
tie.core

Windows:
   set 
JAVA_OPTIONS=-Dziptie.dir=/Users/brettw/workspace/.metadata/.plugins/org.zip
tie.core

-Brett (who will be happy when the server is independing of the client!)

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://mailman.ziptie.org/pipermail/dev/attachments/20070605/347c52f4/attachment.html