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 alfresco-one-ear-distribution-5.1.5.zip 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 alfresco-global.properties.sample file in the <JBOSS_EAP_HOME>\modules\org\alfresco\configuration\main directory.

      See Modifying the global properties file for more information.

    4. Save the alfresco-global.properties.sample 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">
          <resources>
           <resource-root path="."/>
          </resources>
        </module>
    6. Extract the EAR file and check the contents of the META-INF\jboss-deployment-structure.xml:

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

Sending feedback to the Alfresco documentation team

You don't appear to have JavaScript enabled in your browser. With JavaScript enabled, you can provide feedback to us using our simple form. Here are some instructions on how to enable JavaScript in your web browser.