[jboss-user] Doc about jboss5 deployment descriptors and "Unable to process deployment descriptor"

[Olivier Cailloux]

Dear list,

I am currently learning J2EE development using the sun tutorial 
[http://java.sun.com/javaee/6/docs/tutorial/doc/bnadx.html]. But instead 
of using sun's enterprise server, I would like to learn to use JBoss.

I have read JBoss "Installation and Getting Started Guide" 
[https://www.jboss.org/community/docs/DOC-12923] and had a look on the 
"Administration and Configuration Guide" 
[https://www.jboss.org/community/docs/DOC-12927] for JBoss 5.0.0GA 
(links found here [http://www.jboss.org/jbossas/docs/index.html]).

However, I don't find a good doc about jboss specific deployment 
descriptors, e.g. jboss-web.xml for a war. Altough naturally possible to 
find some informations using Google, I would appreciate being able to 
refer to an official doc as good and complete as the Administration and 
Configuration Guide.  Apparently there was some information available 
for jboss4 
[http://docs.jboss.org/jbossas/jboss4guide/r4/html/ch9.chapt.html]... 
But not for the 5th version.

I also have a problem with a very simple example I am trying to deploy 
on jboss5. I built a war containing:
0-21h05-~/Programmation/eclipse/web1/target$jar -tf web1-0.0.1-SNAPSHOT.war
META-INF/
META-INF/MANIFEST.MF
WEB-INF/
WEB-INF/classes/
WEB-INF/jboss-web.xml
index.html

The jboss-web.xml contains:
<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE jboss-web PUBLIC "-//JBoss//DTD Web Application 5.0//EN" 
"http://www.jboss.org/j2ee/dtd/jboss-web_5_0.dtd">
<jboss-web>
        <context-root>web1</context-root>
</jboss-web>

But when moving the .war file to the jboss deploy dir (hot deploying 
it), the server says:
20:34:32,280 INFO  [TomcatDeployment] undeploy, ctxPath=/web1-0.0.1-SNAPSHOT
20:34:32,355 INFO  [TomcatDeployment] deploy, ctxPath=/web1-0.0.1-SNAPSHOT
20:34:32,428 WARNING [config] Unable to process deployment descriptor 
for context '/web1-0.0.1-SNAPSHOT'
20:34:32,428 INFO  [config] Initializing Mojarra (1.2_12-b01-FCS) for 
context '/web1-0.0.1-SNAPSHOT'

The application works (i.e., I can see the content of the index.html 
file when browsing to the /web1-0.0.1-SNAPSHOT context), but why does 
jboss reject my context-root specification?

Thank you for any pointer or help.
Olivier