Downloading Wookie
Wookie is designed to be downloaded using subversion; to checkout the latest code:
svn co https://svn.apache.org/repos/asf/incubator/wookie/trunk
This will downloaded the latest source code to your current folder. You then need to enter:
cd PROJECT_HOME_DIRECTORY
ant
The first time you run this command all dependencies will be downloaded so you must be online and it will take some time. Subsequent builds will be much faster.
You can run Wookie in a number of different configurations, as described in the following sections.
Running Wookie in "standalone" mode
The quickest way to run Wookie is in "standalone" mode; in this mode Wookie uses a local database and embedded server. This is a good way to experiment with Wookie in development.
To run Wookie in standalone mode:
ant run
The first 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
To access the administration menu (http://localhost:8080/wookie/admin) use the username 'java' and password 'java'.
If you want to start with a completely clean build then use:
ant clean-build run
If you want to clean the database use:
ant clean-db
Running Wookie with Tomcat and MySQL
The following will compile and run the server in Tomcat with a MySQL database. The database tables will be set up automatically, however you must have previously created a database called "widgetdb" with username "java" and password "java". (If you want to change the database connection settings, then you need to alter the scripts/mysql/hibernate.cfg.xml.)
1. edit the "build.properties" file:
- uncommenting "project.using.mysql=true"
- set "servletEngine.webapp.dir=" to the location of your tomcat webapps directory.
ant clean-build deploy-webapp
To access the administration menu (http://localhost:8080/wookie/admin) use the username 'java' and password 'java'.
If you want to start with a completely clean build then use:
ant clean-build deploy-webapp
If you want to clean the database use:
ant clean-db