You are here

Installing Alfresco on JBoss

You can install and deploy the Alfresco WAR on the JBoss application server.
Ensure that JBoss and Java 8 are installed. Review the Supported Platforms page on the Support Portal for more information.
The following instructions:
  • Assume that you know the path of the JBoss directory, which is represented as <JBOSS_EAP_HOME>.
  • Are written for Windows Server 2008 R2 installation with MySQL as data source. See the JBoss Enterprise Application Platform 6 guide for more details on JBoss EAP 6 configuration.
  1. Browse to the Alfresco Support Portal.
  2. Download the file.
  3. Create a temporary directory (the path for it is represented as <TEMP>) and uncompress the zip file here.
  4. Create a module with Alfresco configuration.
    1. Create a main directory, for example at <JBOSS_EAP_HOME>\modules\org\alfresco\configuration\main.
    2. Copy the contents of <TEMP>\web-server\classpath to the <JBOSS_EAP_HOME>\modules\org\alfresco\configuration\main directory.

      Note: Do not set the database properties at this stage.
    3. Modify the file in the <JBOSS_EAP_HOME>\modules\org\alfresco\configuration\main directory.

      See Modifying the global properties file for more information.

    4. Save the file without the .sample extension.
    5. Create the Alfresco configuration file, module.xml in the <JBOSS_EAP_HOME>\modules\org\alfresco\configuration\main directory with the following content:

      <?xml version="1.0" encoding="UTF-8"?>
        <module xmlns="urn:jboss:module:1.0" name="org.alfresco.configuration">
           <resource-root path="."/>
    6. Extract the EAR file and check the contents of the META-INF\jboss-deployment-structure.xml:

      <?xml version="1.0" encoding="UTF-8"?>
         <sub-deployment name="alfresco.war">
           <module name="org.alfresco.configuration" />
            <module name="org.apache.xalan" />
         <sub-deployment name="share.war">
           <module name="org.alfresco.configuration" />
  5. Follow the instructions for configuring JBoss for Alfresco.