Symbolic links inside ear/war are not followed by EAP 6

Solution Verified - Updated

Environment

  • Red Hat JBoss Enterprise Application Platform (EAP) 6.x

Issue

  • Can't use symbolic links inside my war / ear deployment in EAP 6.
  • Seeing issue that looks like Content from issues.jboss.org is not included.AS7-3414
  • Is there any settings to allow the symbolic links to be visible?
  • we are unable to deploy the EAR file. The EAR file has symbolic links in it. As per the suggestion in your blog/website we tried to do a folder(exploded file) deployment. Still it wont work. The deployment succeeds only when the links are removed. It is also not working even using the EAR flat file as well.

Resolution

To allow Symbolic links inside deployed ear/war, you need to deploy it as a exploded archive and

  • Upgrade to EAP 6.1.0 or later

or

Then you can create a war with a symlink html page and specify <symbolic-linking-enabled> to true in your web application's WEB-INF/jboss-web.xml:

<jboss-web>
   <symbolic-linking-enabled>true</symbolic-linking-enabled>
</jboss-web>

Root Cause

This is captured in the following JIRA/Bugzilla:

Components
Category

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.