microsoft-sqljdbc.jar deployment errors on JBoss

While deploying your application on jboss you may run into a zip error type deal, something like this:

Caused by: java.lang.Error: Error visiting DelegatingHandler@1463636387[path=cf.ear/railo.war/WEB-INF/lib/microsoft-sqljdbc.jar context=file:/home/coldshen/deploy2/ real=file:/home/coldshen/deploy2/cf.ear/railo.war/WEB-INF/lib/microsoft-sqljdbc.jar]

Which means the VFS deployer just choked on the (IMO) malformed microsfot jdbc driver jar [Ed Note: yes, I left the spelling error in there, cuz I'm cool like that].

See this thread for long, technical discussion:

http://www.jboss.org/index.html?module=bb&op=viewtopic&p=4182061#4182061

And the solution is to edit your vfs.xml file (given the context location above, the path is /home/coldshen/deploy2, you'll have to edit yours) and add this entry to the VFSCache bean:

Which basically tells JBoss that there's a fscked-up jar in, or under, that directory.

The vfs.xml file should be located at: {jboss_home}/server/{your_server}/conf/bootstrap/vfx.xml