You are here

Installing Alfresco on JBoss

You can install and deploy the Alfresco WAR on the JBoss application server.
Ensure that JBoss and JDK7 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.

    http://support.alfresco.com

  2. Download the alfresco-enterprise-ear-4.2.8.zip file. For information on the correct version to download for your version of Alfresco see Supported stacks.
  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. Unzip the alfresco-enterprise-4.2.8.ear file and check/modify the META-INF\jboss-deployment-structure.xml to have the following contents:

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