1. Book Example Installation

The book comes with the source code for the examples discussed in the book. The examples are included with the book archive. When you unzip the JBossBook_323.zip archive this creates an AdminDevel directory that contains an examples subdirectory. This is the examples directory referred to by the book.

The only customization needed before the examples may be used it to set the location of the JBoss server distribution. This may be done by editing the examples/build.xml file and changing the jboss.dist property value. This is shown in bold below:

<project name="JBossBook 3.2.x examples" default="build-all" basedir=".">

<!-- Allow override from local properties file -->

<property file=".ant.properties" />

<!-- Override with your JBoss/Web server bundle dist location -->

<property name="jboss.dist" value="/tmp/JBoss/jboss-3.2.3"/>

<property name="jboss.deploy.dir" value="${jboss.dist}/server/default/deploy"/>

or by creating a `.ant.properties" file in the examples directory that contains a definition for the jboss.dist property. For example:

jboss.dist=/usr/JBoss3.2/jboss-3.2/build/output/jboss-3.2.3

Part of the verification process validates that the version you are running the examples against matches what the book examples were tested against. If you have a problem running the examples first look for the output of the validate target such as the following:

validate:

[java] ImplementationTitle: JBoss-3.0.8 CVSTag=JBoss_3_0_8

[java] WARNING: requested version: 3.2 does not match the run.jar version: 3.0.8

[java] ImplementationVendor: JBoss Group, LLC

[java] ImplementationVersion: 3.0.8 (CVSTag=JBoss_3_0_8 Date=200306050849)

[java] SpecificationTitle: JBoss-3.0.8

[java] SpecificationVendor: JBoss Group, LLC

[java] SpecificationVersion: 3.0.8

[java] JBoss version is: 3.0.8

[java] Java Result: 1