Installing into BEA Weblogic 9.x

Document created by resplin Employee on Jun 6, 2015
Version 1Show Document
  • View in full screen mode

Obsolete Pages{{Obsolete}}

The official documentation is at: http://docs.alfresco.com



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.
Pre-requisites:


  • 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 alfresco.zip 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.

    <weblogic-web-app
    xmlns='http://www.bea.com/ns/weblogic/90'
    xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'
    xsi:schemaLocation='http://www.bea.com/ns/weblogic/90 http://www.bea.com/ns/weblogic/90/weblogic- web-app.xsd'>
         <container-descriptor>
             <prefer-web-inf-classes>true</prefer-web-inf-classes>
          </container-descriptor>
    </weblogic-web-app>

  5. Open web.xml and change the following:

    <context-param>
       <param-name>contextConfigLocation</param-name>
       <param-value>
         classpath:alfresco/application-context.xml
         classpath:alfresco/webscript-framework-application-context.xml
         classpath:alfresco/web-client-application-context.xml
         classpath:alfresco/web-scripts-application-context.xml
         classpath:alfresco/web-services-application-context.xml
    classpath*:alfresco/extension/custom-web-context.xml
    </param-value>
    <description>Spring config file locations</description>
    </context-param>

    to


    <context-param>
    <param-name>contextConfigLocation</param-name>
    <param-value>
    /WEB-INF/classes/alfresco/application-context.xml,/WEB-INF/classes/alfresco/webscript-framework-application-context.xml,
    /WEB-INF/classes/alfresco/web-client-application-context.xml,/WEB-INF/classes/alfresco/web-scripts-application-context.xml,
    /WEB-INF/classes/alfresco/web-services-application-context.xml
    </param-value>
    <description>Spring config file locations</description>
    </context-param>

    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 custom-hibernate-dialect.properties 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 custom-repository.properties 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):

    dir.root=c:\alfresco\alf_data
    db.user=alfresco
    db.password=alfresco
    db.url=jdbc:mysql://localhost/alfresco

  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 xml-apis.zip, 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).

Troubleshooting


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/setDomainEnv.sh/bat 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.

Notes:


  • 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 http://issues.alfresco.com/browse/ETWOTWO-345
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(LicenseComponent.java:142)

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:

<enforce-valid-basic-auth-credentials>false</enforce-valid-basic-auth-credentials>


  1. Restart user project in particular alf_domain.

3.0
2.2
Weblogic
Installation

Attachments

    Outcomes