This page will give you the steps needed to get Magnolia running with JBoss. 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
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
JBoss EAP 7.1
JBoss EAP 7.2
JBoss EAP 7.3
2 - Determine Which Java Version To Use
3 - Verify With Magnolia’s Certified Stack
Verify with Magnolia’s certified stack to ensure that the Java version is also compatible with the Magnolia version you wish to use: Magnolia Certified Stack.
4 - Download JBoss
Versions Below JBoss EAP 7.0 / JBoss AS
Click here: https://jbossas.jboss.org/downloads
Download the ZIP file with the description saying “Java EE Full & Web Distribution”.
Versions With JBoss EAP 7.0 and Above
Click here: https://wildfly.org/downloads/
Download the ZIP file with the description saying “Java EE Full & Web Distribution”
5 - Add Magnolia to JBoss
- 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.
- Drop the Magnolia WAR file into this newly created folder.
- Explode the added WAR file: How to Explode a WAR.
6 - Configure Magnolia With JBoss
- Within standalone/deployments/<name_of_Magnolia_instance>.war/WEB-INF folder, create a new file and name it “jboss-deployment-structure.xml”.
- Paste the following code into this newly created file:
- 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_of_folder_with_exploded_WAR>.dodeploy”. As an example, if you named the folder magnoliaAuthor.war, the name of this new file will be “magnoliaAuthor.war.dodeploy”. No other changes will be made to this file.
8 - Start The Server
Open a console window and change directory to “<JBoss_folder>/bin”. And execute the following command: ./standalone.sh
9 - Access The Page
The page name is the name of the folder you created.
10 - Stop The Server
You can shut off the server by doing ctrl+c on the console that you started the server with.