Raible's Wiki

Raible Designs
Wiki Home
News
Recent Changes

AppFuse

Homepage
  - Korean
  - Chinese
  - Italian
  - Japanese

QuickStart Guide
  - Chinese
  - French
  - German
  - Italian
  - Korean
  - Portuguese
  - Spanish
  - Japanese

User Guide
  - Korean
  - Chinese

Tutorials
  - Chinese
  - German
  - Italian
  - Korean
  - Portuguese
  - Spanish

FAQ
  - Korean

Latest Downloads

Other Applications

Struts Resume
Security Example
Struts Menu

Set your name in
UserPreferences

Edit this page


Referenced by
AppFuseSupport




JSPWiki v2.2.33

[RSS]


Hide Menu

AppFuseOnJBoss


AppFuse 1.8+ and JBoss 4.0.2

Contributed by Ivan Coro (ivcoro at hotmail)

(1) First, you need to copy the entire appfuse deployment dir under jboss deploy dir. The default deploy dir in JBoss is something like "/server/default/deploy/". I needed to rename the dir as "appfuse.war" (Notice the .war in the name) so that jboss can detect it and reload it without errors. You can also simply deploy the WAR to this directory. To enable automatic refreshing of JBoss AS WAR deployments add the following entries to your configuration files.

  • Add your JBoss home directory to build.properties:
jboss.home=D:/JBossAS-4.0.3-SP1/server/default
  • Add the following Ant targets to the build.xml in the root of your project:
     <!-- =================================================================== -->
     <!-- The "jboss-undeploy" target deletes the web application archive     -->
     <!-- from the JBoss servlet container.                                   -->
     <!-- =================================================================== -->
     <target name="jboss-undeploy" if="jboss.home"
         description="Undeploy '${webapp.name}.war' from JBoss AS">
         <echo message="Undeploying '${webapp.name}.war' from JBoss AS..."/>
         <delete file="${jboss.home}/deploy/${webapp.war}"/>
     </target>

     <!-- =================================================================== -->
     <!--            Refresh - Stops JBoss AS, and refreshes everything       -->
     <!-- =================================================================== -->
     <target name="jboss-refresh" depends="jboss-undeploy,clean,jboss-deploy"
         description="Undeploys, cleans, then re-deploys"/>

     <!-- =================================================================== -->
     <!-- The "jboss-deploy" target deploys the web application in the war    -->
     <!-- format to JBoss AS.                                                 -->
     <!-- =================================================================== -->
     <target name="jboss-deploy" depends="package-web" if="jboss.home"
         description="Deploy '${webapp.name}.war' to JBoss AS">
         <echo message="Deploying '${webapp.name}.war' to JBoss AS..."/>
         <copy file="${webapp.dist}/${webapp.war}"
             todir="${jboss.home}/deploy"/>
     </target>
  • Run ant jboss-refresh to refresh your webapp deployment.
NOTE: If you're using AppFuse 1.9+ - you're done! If you'd rather use a JNDI DataSource than the Spring-managed connection pool, you can follow the instructions below. You'll also need to change applicationContext-resources.xml so the dataSource bean reads from JNDI.

(2) Next, you need to configure the datasource in jboss. For this, you need another file named "appfuse-ds.xml" and this file needs to be placed in the "deploy" dir of JBoss, at the same level of your deployed app dir, i.e., /server/default/deploy/. The contents of the file are:

<datasources>
    <local-tx-datasource>
        <jndi-name>jdbc/appfuse</jndi-name>
        <connection-url>jdbc:mysql://localhost:3306/appfuse</connection-url>
        <driver-class>com.mysql.jdbc.Driver</driver-class>
        <user-name>test</user-name>
        <password>test</password>
    </local-tx-datasource>
</datasources>

(3) Next, You need a new file named "jboss-web.xml" which should be inside WEB-INF dir of you app. This file is needed for jboss deployment. The contents of this file is as follows:

<?xml version="1.0" encoding="UTF-8" ?>
<jboss-web>
    <context-root>/appfuse</context-root>
    <resource-ref>
    <res-ref-name>jdbc/appfuse</res-ref-name>
    <res-type>javax.sql.DataSource</res-type>
    <jndi-name>java:jdbc/appfuse</jndi-name>
    </resource-ref>
</jboss-web>
NOTE: You need to change the word "appfuse" to the name of the app instance you created if you are not using the default app that comes with appfuse.

(4) Restart JBoss service.

You might also checkout Ken Yee's blog for how he automated deploying AppFuse to JBoss.

AppFuse 1.7 and JBoss 3.x.

Contributed by Rick Hightower.

AppFuse Security

Setting up AppFuse security in JBoss I was surprise how easy it was.

    <application-policy name = "appfuse">
       <authentication>
          <login-module code = "org.jboss.security.auth.spi.DatabaseServerLoginModule"
             flag = "required">
             <module-option name = "dsJndiName">jdbc/mysql</module-option>
             <module-option name = "principalsQuery">
	     select password from app_user where username=?
	     </module-option>
             <module-option name = "rolesQuery">
	     select role_name, 'Roles' from user_role where username=?
	     </module-option>

	   </login-module>
       </authentication>
    </application-policy>

It took me less time to setup Security than it did for me to setup logging. (Which is a bit of a nightmare!)

The above assumes you have a database driver mapped under jdbc/mysql.

Create DS file as follows, and put it in the deploy dir: (C:\tools\jboss-3.2.3\server\default\deploy/mysql-ds.xml)

<datasources>
  <local-tx-datasource>
    <jndi-name>jdbc/mysql</jndi-name>
    <connection-url>jdbc:mysql://localhost:3306/mysql</connection-url>
    <driver-class>com.mysql.jdbc.Driver</driver-class>
    <user-name>root</user-name>
    <password></password>
  </local-tx-datasource>
</datasources>

The login security stuff goes in the config directory of the server, e.g., C:\tools\jboss-3.2.3\server\default\conf\login-config.xml.

I attached the login-config.xml(info) file. Note the name has to be the name of your war (appfuse.war = appfuse). In reality, it has to be the name of the web context, but since my web context and war file name are the same it works.

mysql-ds.xml(info) has to be in the deploy dir, e.g., C:\tools\jboss-3.2.3\server\default\deploy\mysql-ds.xml.

(The war file goes into the deploy dir as well).

WARNING:

JBoss holds onto the cache of users and roles. So if you changed a users role, they would not be able to see it for 1/2 an hour.

I subclassed UserManagerImpl, and created a version specific to JBoss, then I changed UserManagerImpl to use a stub method called flushAuthCache. UserManagerJBossSpecific invalidates the user cache using JMX. JBoss is pretty cool!

Since I am using Spring. I did not have to change any other code in the system. Just one configuration file!

Spring change:

	<bean id="userManager" class="org.appfuse.webapp.service.UserManagerJBossSpecific">
		<property name="userDAO"><ref local="userDAO"/></property>
	</bean>

UserManagerJBossSpecific.java

Logging

Setting up logging is a pain in JBoss. Don't mess with the console log... it misbehaves. Create a file logger and tail it.

Here is my log4j.xml(info) file (which has to be in the conf dir like the login-config.xml).

I just tail -f the log file.


Attachments:
jboss-web.xml Info on jboss-web.xml 355 bytes
mysql-ds.xml Info on mysql-ds.xml 992 bytes
log4j.xml Info on log4j.xml 5811 bytes
login-config.xml Info on login-config.xml 6280 bytes


Go to top   Edit this page   More info...   Attach file...
This page last changed on 14-Apr-2007 04:04:50 MDT by BasCancrinus.