Support deployment on Jboss 4.x

Hi David,

Not sure what you are suggesting here. This should be documented for sure. However this is a configuration issue. If you are suggesting XWiki core should be changed, could you please give me a hint of what you have in mind.

I see on the Installation page that Ben Walding has added information to run XWiki on Resin (as a comment, which someone needs to move in the document proper). This looks like a similar configuration issue.

Thanks!

Hi All,

I also agree with Vincent Massol. This is a configuration issue, The web.xml has the following entry as a resource-ref.

<resource-ref>
<description>DB Connection</description>
<res-ref-name>jdbc/XWikiDS</res-ref-name>
<res-type>javax.sql.DataSource</res-type>
<res-auth>Container</res-auth>
</resource-ref>

There should be a jboss-web.xml and in that there should be a resource-ref tag having details of the resource.

<resource-ref>
<res-ref-name>jdbc/XWikiDS</res-ref-name>
<jndi-name>java:/jdbc/XWikiDS</jndi-name>
</resource-ref>

Thanks............

HI David,

If your datasource is a MySQL database then there should be a file called "mysql-xa-ds.xml" in the directory "$JBOSS_HOME/server/default/deploy" containing following details. Don't forget to put the relevant mysql java connector jar file to the "$JBOSS_HOME/server/default/lib".

<?xml version="1.0" encoding="UTF-8"?>
<datasources>
<xa-datasource>
<jndi-name>/jdbc/XWikiDS</jndi-name>
<xa-datasource-class>com.mysql.jdbc.jdbc2.optional.MysqlDataSource</xa-datasource-class>
<xa-datasource-property name="URL">jdbc:mysql://localhost:3307/xwiki</xa-datasource-property>
<xa-datasource-property name="User">xwiki</xa-datasource-property>
<xa-datasource-property name="Password">xwiki</xa-datasource-property>
<track-connection-by-tx>true</track-connection-by-tx>
<exception-sorter-class-name>org.jboss.resource.adapter.jdbc.vendor.MySQLExceptionSorter</exception-sorter-class-name>
<metadata>
<type-mapping>mySQL</type-mapping>
</metadata>
</xa-datasource>
</datasources>

Best Regards,
Tharindu Jayasuirya

This is the configuration file for JBoss - MySql combination.

Hi Tharindu,

I think the best would be to explain how to set up XWiki on JBoss on http://www.xwiki.org/xwiki/bin/view/AdminGuide/Installation#HInstallandconfigureaServletContainer. Do you think you could add a link and a page explaining how to do that, in the same way as it's done for other containers?

Thanks a lot
-Vincent

Hi Vincent,

Yes, I think I can explain that in a new Page. Do I have to it outside as External link to my blog or will there be a page created internally for that. Do I have rights to create a page at xwiki called --> AdminGuide.InstallationJBoss

Best Regards,
Tharindu Jayasuirya

Internally. Yes you have rights. Just create a user for you on xwiki.org if you haven't already done so.

Thanks
-Vincent

Hi Vincent,

I just added a page regarding the JBoss Installation. this page is http://www.xwiki.org/xwiki/bin/view/AdminGuide/InstallationJBoss. Please feel free to point out any mistakes or additional information needed.

Best Regards,
Tharindu Jayasuirya.

Hi Tharindu,

Thanks! I do have some comment. Would you mind joining us on IRC so that we can discuss how to improve this page even further? (http://www.xwiki.org/xwiki/bin/view/Community/IRC)

-Vincent

HI Vincent,

I joined the your IRC I think we can discuss about the comments you have to mention to me to improve the configuration page of JBoss.

Best Regards,
Tharindu Jayasuirya.

Tharindu, I've checked http://www.xwiki.org/xwiki/bin/view/AdminGuide/InstallationJBoss and commented in there:

These instructions need to be improved:

• the DS definition is optional as by default XWiki doesn't require it and isn't configured to use it (you need to modify the hibernate.cfg.xml file to use the DS)
• The MySQL java connector is only required if you use the DS as XWiki already bundles the MySQL java connector jar
• Need to explain why there's a need for jboss-web.xml as I don't believe it's required
• Last the dfault/deploy directory is only valid if the user is using the default server configuration. Need to make this more explicit and more generic

Thanks

I see you've answered but I'm not sure I understand your answer and the instructions haven't been updated. Do you think you could finish the documentation on that page so that we can close this issue?

Thanks a lot!

HI Vincent,

I corrected some of the mistakes that I've done. I think that I can finish the documentation. If its up to the standard then the issue can be finished.

Best Regards,
Tharindu Jayasuirya.

Done