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 | ||
---|---|---|
| ||
<?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 “magnoliaAuthor“magnoliaAuthor.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.
...