Appendix B. 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_326.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-3.2.6"/>
    <property name="jboss.deploy.dir" value="${jboss.dist}/server/default/deploy"/>

or by creating an .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.6

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 [WonderLand]
     [java] ImplementationVendor: JBoss.org
     [java] ImplementationVersion: 3.2.6RC2 (build: CVSTag=Branch_3_2 date=200409270100)
     [java] SpecificationTitle: JBoss
     [java] SpecificationVendor: JBoss (http://www.jboss.org/)
     [java] SpecificationVersion: 3.2.6
     [java] JBoss version is: 3.2.6