Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info
titleOfficial documentation available

There is also official documentation available regarding the JBoss application server. Please check the pages

https://documentation.magnolia-cms.com/display/DOCS/JBoss+AS+configuration and

Because I had to install a newer version of JBoss / WildFly recently, I'll describe the setup process I did because it was in the end slightly easier than described in the documents mentioned above. This guide is for the JetBrains IDEA (Ultimate) IDE but you might be able to adjust it also for an Eclipse environment.

This guide was checked with created with Magnolia 5.4.4JBoss WildFly version versions 8.2.1.Final and 10.0.10.Final on with IDEA 15 Utilmate on Mac OS X Yosemite.

...

Code Block
languagexml
titleMAGNOLIA_WEBAPP_DIRECTORY/WEB-INF/jboss-deployment-structure.xml
<jboss-deployment-structure xmlns="urn:jboss:deployment-structure:1.2">
  <deployment>
    <exclude-subsystems>
      <subsystem name="jaxrs"/>
      <subsystem name="webservices"/>
      <subsystem name="weld" />
    </exclude-subsystems>
    <!-- Exclusions allow you to prevent the server from automatically adding some dependencies -->
    <exclusions>
      <module name="org.apache.log4j" />
      <module name="org.slf4j" />
    </exclusions>
  </deployment>
</jboss-deployment-structure>

Optional: Create a specifc

...

deployment context

Because I want Magnolia to load my specific development profile (see WAR configurations) I configure JBoss to be started under the /dev context path of my local WildFly server.

Code Block
languagexml
titleMAGNOLIA_WEBAPP_DIRECTORY/WEB-INF/jboss-web.xml
<?xml version="1.0" encoding="UTF-8"?>
<jboss-web>
  <context-root>/dev</context-root>
</jboss-web>

IDEA runtime configuration

As usual, create your runtime configuration in IDEA (Utlimate). From the "Run" menu, choose "Edit configurations..." to open the configuration dialog.

Image Added

Click the plus sign for adding a new JBoss server configuration, then Local for a WIldFly installation located on the hard disk of your development machine.

If you don't have a JBoss configuration yet, you just have to select the directory where JBoss resides on your disk.

Image Added

IDEA automatically offers you to create the needed deployment for your new server configuration - choose the "exploded" option.

Image Added

Then add fill in the other options for your new runtime configuration:

Image Added

After that, you should be able to start up your Magnolia project on JBoss WildFly with your IDEA IDE.

Further notes

Info

In this guide, I only describe my development setup. The configuration of a standalone deployment JBoss webserver will involve different steps. There was also no need to configure the Bouncy Castle libraries as described in the offcial guide, because entering a license worked for me and in this setup I don't care about other instances for publication - I even turn them off in my /dev context because I want to be able to delete configuration.