Running the Examples Using the Binary Distribution

The process for running the distribution of the examples is quite simple. All you need is a working J2EE application server like Tomcat, JBoss, Jetty, Resin, WebSphere, etc. and the war file from the examples distribution. Basically the process is outlined as follows:

  • Download the distribution
  • Unpack the distribution
  • Deploy the war file
  • Start your application server
  • Start your browser

In the following sections each step is described in more detail.

Download the Distribution

In order to run the examples from the distribution (so you don't have to build the examples yourself) you need to download the latest release from a mirror close to you. After the download you have to unpack the archive which will give you

  • a war archive,
  • a file containing the Apache license
  • the source files and
  • a directory containing some basic documentation.

Using an Existing Application Server

Next you need to copy the war archive in your deployment directory of your application server. For example:

Server Default deployment directory relative to installation
JBoss $(JBOSS_HOME)/server/default/deploy
Jetty $(JETTY_HOME)/webapps
Tomcat ${TOMCAT_HOME)/webapps
Resin ${RESIN_HOME)/webapps

If your application server is not listed here, please consult your manual on how to deploy web archives (war files).

Run the Examples

If you're done copying, all you need to do is start your application server and point your browser to http://localhost:8080/wicket-examples (this link will not work when the listening port of your application server is configured to listen to another port than port 8080 ).