Packaging EJBs

Troubleshooting

DTD Not Found

I get an error telling me that the DTD for my deployment descriptor can't be located.

First, be sure that you've included an entry at the top of your deployment descriptor that defines the DTD that applies to the file. If you have, be sure you have the URL for the DTD correctly specified. Also, the machine on which you're deploying might need access to the Internet to locate the DTD being referenced. If this isn't possible, consider using a local copy of the DTD and changing the URL to reference it.

XML Format Errors

I get an error telling me that a tag in my deployment descriptor isn't supported.

You must pay close attention to the order defined for the XML elements of the deployment descriptor. The order specified by the DTD must be followed or the XML parser will reject your descriptor.

Deployment Tool Cannot Locate Descriptor Files

I get an error telling me that the deployment descriptors are missing from my ejb-jar file.

You must place deployment descriptors in a META-INF subdirectory one level below the root directory of the JAR file for them to be recognized. Be sure that you placed the files in this directory and that the directory was created with an all-uppercase name .

Missing Dependent Classes

I get ClassDefNotFound exceptions when I compile or deploy my ejb-jar file.

The ejb-jar file must include all classes and interfaces referenced by your EJBs (other than those defined by the API). Be sure you include class files for everything you reference, such as helper classes, primary key classes, and exceptions.