Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Document Overview

This page will give you the steps needed to get Magnolia running with JBoss.  Using a DB outside of derby is not covered here. If you would like more details into what each step does or how it works, please see : Understanding JBoss With Magnolia

1 - Determine Which JBoss Version To Use

JBoss EAP Version

WildFly Version

JBoss EAP 6.0

JBoss AS 7.1

JBoss EAP 6.1

JBoss AS 7.2

JBoss EAP 6.2

JBoss AS 7.3

JBoss EAP 6.3

JBoss AS 7.4

JBoss EAP 6.4

JBoss AS 7.5

JBoss EAP 7.0

WildFly 10

JBoss EAP 7.1

WildFly 11

JBoss EAP 7.2

WildFly 14

JBoss EAP 7.3

WildFly 18

2 - Determine Which Java Version To Use

...

Verify with Magnolia’s certified stack to ensure that the Java version is also compatible with the Mangolia version you wish to use.: Magnolia Certified Stack 

...

Versions With JBoss EAP 7.0 and Above

Clcik Click here:  https://wildfly.org/downloads/ 

...

5 - Add Magnolia to JBoss

 5a  - Unzip the file you downloaded and create a new folder within the "standalone/deployments" folder. Name this folder “<name_of_Magnolia_instance>.war”. This is a regular folder and it will not be a war file, we will just be having “.war” as part of the name. 

 5b  - Drop the Magnolia WAR file into the newly created folder.

 5c  - Explode the added WAR file How to Explode a WAR

6 - Configuring Magnolia With JBoss

6a - Within standalone/deployments/<name_of_Magnolia_instance>.war/WEB-INF folder, create a new file and name it “jboss-deployment-structure.xml”. -Screenshot-

6b - Paste the following code into this newly created file:

Code Block
titleJboss-deployment-structure.xml
<?xml version="1.0"?>
<jboss-deployment-structure xmlns="urn:jboss:deployment-structure:1.2">
    <deployment>
        <exclude-subsystems>
            <subsystem name="weld" />
            <subsystem name="jaxrs" />
            <subsystem name="webservices" />
        </exclude-subsystems>
        <exclusions>
            <module name="org.apache.log4j" />
            <module name="org.slf4j" />
            <module name="org.bouncycastle" />
        </exclusions>
    </deployment>
</jboss-deployment-structure>

6c  - Open your magnolia.properties file and add the following line : magnolia.definitions.classpath=info.magnolia

7 - Deploy Your Magnolia Instance

Create a new file within standalone/deployments and name it “<name<name_of_folder_with_exploded_WAR>.dodeploy”dodeploy. As an example, if you named the folder magnoliaAuthor.war, the name of this new file will be “magnoliaAuthormagnoliaAuthor.war.dodeploy”dodeploy. No other changes will be made to this file.

...

Open a console window and change directory to “<JBoss<JBoss_folder>/bin”bin. And execute the following command: ./standalone.sh

...

You can shut off the server by doing ctrl+c on the console that you started the server with.

...