Child pages
  • Servlet Deployment Setup

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


  1. Right-Click on your project and select "WOLips Ant Tools" and then "Instal"
  2. Look in the Finder at your /Library/WebObjects/Application/ directory and you should find 3 files for your project
    ## YourApp.woa
    1. YourApp directory - this is a Single Servlet Directory Deployment (SSDD) it contains all of the Frameworks on the build path embedded in it.
    2. YourApp.war - this is your webapp archive. It contains all the same files as the SSDD, but zipped up.


Copy the MyApp.war file to your servlet container's webapps directory.

Notes about JBoss

I wouldn't consider myself a WAR expert, but I do deploy my WebObjects application using JBoss and it works very well.

Have you tried a "Hello World" type example application? If you can get a simple application running under JBoss then you should be okay with a more complicated one. I suggest starting with "Hello World" and then adding a simple EOF and that should cover everything.

There were a few tricky configurations in the initial setup. To be clear, I am using XCode, but it probably doesn't matter. Here are a few things to check.

Check you jboss-web.xml file. You definitely need to configure this file properly if you are using EOF. The application will never get started properly without this file configured correctly.

Make sure your deployment license gets built into the WAR file for deployment by setting the SERVLET_DEPLOY_LICENSE item.

Make sure the servlet project settings are correct:

  • SERVLET_WEBAPPS_DIR = /Library/JBoss/3.2/deploy

Also, I explicitly defined a package for all of my classes. This prevents JBoss from complaining upon startup, however, JBoss still ran the application just fine anyway.