This page provides instructions for installing Alfresco as an Enterprise ARchive format (EAR) into Oracle Weblogic 10.3.
Note that due to certain components of Alfresco requiring access to the ear file contents as files, these instructions require expanding the .ear into exploded format, as described in the Weblogic documentation. On other application servers, this may not be necessary. Alfresco's Weblogic deployment solution now makes use of a Filter Classloader, configured in the weblogic-application.xml, in order to ensure that the unmodified contents of the alfresco web module will run in Weblogic.
The following instructions are for Version 3.1 Enterprise and above.
Install OpenOffice and ensure the binaries are in the path
Install MySQL and create an alfresco database and user with appropriate permissions
Install Weblogic 10.3, but do not create any domains or servers yet
Download alfresco_enterprise.ear and a license file (.lic)
To install on UNIX platforms:
Choose a directory to host the exploded .ear file and copy alfresco_enterprise.ear to that directory
Run the following commands in that directory to explode the ear file:
jar xvf ../alfresco_enterprise.ear
mv alfresco.war alfresco.war.tmp
mv share.war share.war.tmp
jar xvf ../alfresco.war.tmp
jar xvf ../share.war.tmp
Use the BEA Configuration Wizard (<Weblogic Home>/common/bin/config.sh on Unix) to create a new domain, for example alf_domain.
Create a directory <Weblogic Home>/user_projects/domains/alf_domain/alfresco/extension/license, for example on Unix:
In <Weblogic Home>/user_projects/domains/alf_domain/bin/setDomainEnv.sh edit all of the lines prefixed with MEM_MAX_PERM_SIZE line to increase the PermGen space. Note, depending on whether you have installed on a 64 or 32 bit platform you may see different combinations of these lines.
Also in this file, set the heap size parameter appropriately. The following is a recommendation:
For Weblogic 10.3.2.0 this extra edit is required to ensure that alf_domain is in the global classpath.
To enable automatic control of your Alfresco server:
Create a 'machine' with the details of the machine running the domain. This will allow the node manager to control servers on that machine. Refer to the Weblogic documentation to find out how to do this.
Create a server, AlfrescoServer, within that machine. Refer to the Weblogic documentation for more inforamtion. Note that you have to choose a unique port number. A good port number to choose is 8080, because it is preconfigured in Share. Note that you can leave the host name blank if you want it to listen on all network adapters.
Ensure that the node manager is running (for example, <Weblogic Home>/wlserver_10.3/server/bin/startNodeManager.sh). Now you will be able to use the admin server Change Center panel to start and stop your Alfresco server.
In the left pane of the Administration Console, click Deployments.
In the right pane, click Install.
Using the Install Application Assistant, locate the directory of your exploded .ear file (the one containing alfresco.war and share.war directories) and click Next. Make sure you have selected the directory and not any of its files.
Check Install this deployment as an application radio button, and then click Next.
Click Finish. Click Activate Changes.
Using the Change Center panel, restart AlfrescoServer.
To use the Alfresco Extension mechanism to configure Alfresco without modifying core configuration files, place the extension files in <Weblogic Home>/user_projects/domains/alf_domain/alfresco/extension.