Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Document new initDB command line option

...

To run Wookie in standalone mode:

ant clean-db run

The first time you run wookie (or compile it) any required libraries will be downloaded, this can take some time and requires a network connection.

The "clean-db" target ensures that your development environment starts in a consistent state. However, any modifications you have made to the database during previous runs will be lost. To run the development server without cleaning the database you need to set initDB=false. See the next section for more details.

Once the server is running command will download any required libraries for Wookie. The second will start a server running on port 8080. To access it, go to http://localhost:8080/wookie

...

If you want to start with a completely clean build then use:

ant clean-build runIf you want to clean the database use:

ant clean-db

Note that if you shut down the server and restart it you MUST clean the database, or you will get an error.

Running on a different port

If the default port of 8080 is not suitable for your environment you can change it by adding a line like the one following to local.build.properties:

...

-db run

Running options

To set run mode options you can either add properties to the local.build.properties file or you can pass properties in via the command line using -Drun.args="<property_name>=<property_value> <property_name>=<property_value>". For example:

-Drun.args="port=8080 initDB=false"

Available properties are:

Property

Values

Description

Default

initDB

True or False

Initialise the DB to a default configuration

True

port

Integer

Set the port on which the server is to run

8888

Running Wookie in debug mode

...

ant -Djvmargs="-Xdebug -Xrunjdwp:transport=dt_socket,address=80008001,server=y,suspend=n" run

Running Wookie with Tomcat and MySQL

...