To set up Seam, use the following software:

Software edit

  • JBoss 4.2.2.GA
  • JBoss Seam 2.0.0.GA
  • Eclipse Europa for JEE developers
  • JDK 1.5.x or above
  • Apache Ant 1.6.x (do not use 1.7!)

Configuration edit

Environment variables edit

  • Ensure that JAVA_HOME is pointing to the JDK
  • Ensure that ANT_HOME is pointing to the Ant directory
  • Make sure that "%ANT_HOME%\bin" is in the PATH variable

Seam edit

  • Put the location of the JBOSS AS in the file (has to be absolute)

Eclipse edit

  • Set up the JBoss AS Runtime
    • Go to Windows --> Preferences --> Server --> Installed Runtimes
    • Click Add
    • Select JBoss 4.2 Runtime
    • Browse for the installation directory
  • Set up the server to run off the runtime
    • In the JBoss Server View, select New Server
    • Select your newly created runtime
  • Test the server by starting it up
    • If there are problems, check the end of this guide for technical issues on JBoss

HSQLDB (a.k.a. Hypersonic) edit

  • The embedded database within JBoss
  • I am using it in its default configuration, which means that data will not be retained when the JBoss Application Server is shut down

Notes edit

The above configuration is for Windows XP. I've set up the same environment on Linux (Kubuntu 7.10) without much difficulty as well.