Installing into BEA Weblogic 9.x

Showing results for 
Search instead for 
Did you mean: 

Installing into BEA Weblogic 9.x

0 0 1,478

Obsolete Pages{{Obsolete}}

The official documentation is at:

This information applies to Alfresco Version 2.1.

This page provides instructions for installing Alfresco as a WAR into BEA Weblogic 10.3 and 9.2.

Note that currently Alfresco is not designed to be deployed as a WAR due to the fact that at bootstrap, it uses file system lookups for certain configuration files. The bootstrap fails because these files are in the WAR and have not been exploded out. The instruction steps on this page modify the files within the WAR so that it can be deployed as a WAR. Future versions of Alfresco will be changed so that WAR deployment can happen without any modifications.

Example deployment

The following instructions are for Version 3.0 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 (or 9.2), but do not create any domains or servers yet

To install on Windows platforms:

  1. Use the BEA Configuration Wizard to create a new domain, for example alf_domain
  2. Open the Alfresco WAR using your preferred zip file editor (or rename it to to open it).
  3. Expand the archive into a temporary directory, for example, c:\tmp_dir\alfresco.
  4. Add weblogic.xml to the c:\tmp_dir\alfresco\WEB-INF dirrectory.

    xsi:schemaLocation=' web-app.xsd'>

  5. Open web.xml and change the following:

    <description>Spring config file locations</description>


    <description>Spring config file locations</description>

    Note : all *.xml must be in a single line.

  6. Copy contents of the c:\temp_dir\extensions folder into the c:\bea\user_projects\domains\alf_domain\lib\alfresco folder.
  7. Edit the file in the c:\bea\user_projects\domains\alf_domain\lib\alfresco\extension folder to configure an appropriate database dialect.
  8. Comment/uncomment the appropriate line.
  9. Edit the file in the c:\bea\user_projects\domains\alf_domain\lib\alfresco\extension folder.
  10. Specify a fully qualified name to folder for the Alfresco repository, user name and password, and the correct path for the database driver. For example (MySQL example):


  11. Put license file into c:\bea\user_projects\domains\alf_domain\lib\alfresco\extension\license folder.
  12. Move the following libraries from c:\tmp_dir\alfresco\WEB-INF\lib folder to C:\bea\user_projects\domains\alf_domain\lib\.

    • xercesImpl-2.8.0.jar
    • xml-apis.jar
    • rhino-js-1.6R7.jar
    • Rename xml-apis.jar to, and unzip and remove the folder \javax\xml\namespace\, then zip back and rename to xml-apis.jar.
  13. Delete c:\tmp_dir\alfresco\WEB-INF\lib\wstx-asl-3.2.1.jar and c:\tmp_dir\alfresco\WEB-INF\lib\wstx-asl-3.2.4.jar.
  14. Remove the \javax\xml\namespace\ folders from c:\tmp_dir\alfresco\WEB-INF\lib\stax-api-1.0.1.jar, c:\tmp_dir\alfresco\WEB-INF\lib\jaxrpc.jar, and c:\tmp_dir\alfresco\WEB-INF\lib\xpp3-1.1.3_8.jar.
  15. Place the MySQL Connector in the Alfresco Domain's lib directory (for example, C:\bea\user_projects\domains\alf_domain\lib directory).
  16. Edit the setDomainEnv.cmd/sh file in the C:\bea\user_projects\domains\alf_domain\bin\ folder (or Linux equivalent).

    • Edit the PRE_CLASSPATH variable and add the following:
    • set PRE_CLASSPATH=%PRE_CLASSPATH%;C:\bea\user_projects\domains\alf_domain\lib\xercesImpl-2.8.0.jar
    • set PRE_CLASSPATH=%PRE_CLASSPATH%;C:\bea\user_projects\domains\alf_domain\lib\xml-apis.jar
    • set PRE_CLASSPATH=%PRE_CLASSPATH%;C:\bea\user_projects\domains\alf_domain\lib\rhino-js-1.6R7.jar
    • set PRE_CLASSPATH=%PRE_CLASSPATH%;c:\bea\user_projects\domains\alf_domain\lib
  17. For Weblogic 9.2 only: copy c:\tmp_dir\alfresco\WEB-INF\lib\stax-api-1.0.1.jar and c:\tmp_dir\alfresco\WEB-INF\lib\geronimo-ws-metadata_2.0_spec-1.1.2.jar to <JAVA_HOME> \jre\lib\endorsed\
  18. Copy the alfresco folder from c:\temp_dir\ into the C:\bea\user_projects\domains\alf_domain\autodeploy folder.
  19. Start Weblogic (for example C:\bea\user_projects\domains\alf_domain\startWebLogic.cmd/sh).


Note: If you still have errors starting Alfresco:

  1. Remove alfresco from C:\bea\user_projects\domains\alf_domain\autodeploy.
  2. Start Weblogic (for example, C:\bea\user_projects\domains\alf_domain\startWebLogic.cmd/sh).
  3. Go to BEA WebLogic Server Administration Console
  4. Deploy Alfresco from folder c:\temp_dir\alfresco:
    1. Click Lock & Edit (Weblogic 9.2 only)
    2. In the left pane of the Administration Console, click Deployments.
    3. In the right pane, click Install.
    4. Using the Install Application Assistant, locate c:\temp_dir\alfresco. When you have located the file or directory to install, click Next.
    5. Check Install this deployment as an application radio button, and then click Next.
    6. Click Finish. Click Activate Changes.
    7. Restart Weblogic.

Using Alfresco extension mechanism

To use the Alfresco Extension mechanism to configure Alfresco without modifying core configuration files:

  1. Place the extension files somewhere, for example, in the BEA domain's lib directory.
    The directory structure should then be .../bea/user_projects/domains/alf_domain/lib/alfresco/extension/.
  2. Add the '.../bea/user_projects/domains/alf_domain/lib' directory to the classpath so that these files can get picked up.
  3. Edit the .../bea/user_projects/domains/alf_domain/bin/ file and include the above directory in one of the classpath setting statements (for example, PRE_CLASSPATH='.../bea/user_projects/domains/alf_domain/lib').
  4. Move the license files into the .../bea/user_projects/domains/alf_domain/lib/alfresco/extension/license directory.


  • Because some web scripts were not loaded at bootstrap, trying to use these could cause issues in the web client.
  • You may see the following error (observed on 2.1.3 and 2.2). Contact Alfresco support for resolution to the issue. It is being tracked at
11:38:34,877 ERROR [org.springframework.web.context.ContextLoader] Context initialization failed
org.alfresco.service.license.LicenseException: Failed to install license file enterprise-network-customer-unlimited.lic
        at org.alfresco.license.LicenseComponent.verifyLicense(

WebDAV configuration

To configure WebDAV, edit the config.xml file in the domain folder. These steps assume that Weblogic is installed into the C:\BEA folder and alf_domain is created.

The steps are as follows:

  1. Navigate to the C:\BEA\user_projects\domains\alf_domain\config folder.
  2. In the config.xml file, add the following tag before the end of the </security-configuration> section:


  1. Restart user project in particular alf_domain.