Install BEA Weblogic

From AlfrescoWiki

Jump to: navigation, search


Back to Server Installation

These are some simple instructions for installing Alfresco into BEA Weblogic, targeted at the Weblogic administrator.


[edit] Example Deployment for Alfresco versions 2.0 and greater

Alfresco versions 2.0 and greater have been successfully deployed on Weblogic 9.2 and MySQL DB with the following steps:

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 9.2, but do not create any domains or servers yet

Installation Steps:

  1. Create a new Weblogic domain and server
  2. Create a new empty directory called 'alfresco' in a convenient location
  3. Rename alfresco.war to alfresco.zip and extract it to the directory created in step 2
  4. Download mysql-connector-java-5.0.3-bin.jar and place it in the WEB-INF/lib directory
  5. Open the WEB-INF/classes/alfresco/repository.properties file in a text editor:
    1. set 'dir.root' to the fully qualified name of the directory where you wish to place the Alfresco repository
  6. Copy the following jars from WEB-INF/lib to the Weblogic domain's lib directory:
    1. cryptix-jce-provider.jar
    2. mysql-connector-java-5.0.3-bin.jar
    3. rhino-js-1.6R4.jar
    4. xercesImpl-2.8.0.jar
  7. Edit domain's startWebLogic script so that rhino-js-1.6R4.jar is loaded onto CLASSPATH before WebLogic JARs (e.g. in Windows change the line - 'set CLASSPATH=%CLASSPATH%;%MEDREC_WEBLOGIC_CLASSPATH%', to - 'set CLASSPATH=C:\PROGRA~1\BEA\user_projects\domains\alfresco\lib\rhino-js-1.6R4.jar;%CLASSPATH%;%MEDREC_WEBLOGIC_CLASSPATH%')
  8. Start or restart the Weblogic domain
  9. Configure a new web application called 'alfresco', either by configuring Weblogic to use the directory created in step 2, or by copying that same directory to the domain's 'autodeploy' directory
  10. Test the installation by opening http://localhost:7001/alfresco in a browser

Notes:

  • Step 7 allows Advanced Workflows to function
  • Currently Alfresco cannot be deployed to Weblogic 9.2 as a war file.
  • There have been some reports of port conflicts for the RMI registry (port 50500).
  • Turning on the '<prefer-web-inf-classes>' setting (to avoid step 6) causes the problem described at http://forums.bea.com/bea/message.jspa?messageID=400002106&tstart=0.
  • You may need to increase the maximum amount of memory the Weblogic JVM can allocate (JVM command line option -Xmx)
  • You may need to increase the size of the garbage collector's permanent generation for the Weblogic JVM (JVM command line option -XX:MaxPermSize - 256m should be enough)
(these two settings are controlled by the startWeblogic.cmd / startWeblogic.sh scripts in the Weblogic domain's bin directory)

[edit] Example Deployment for 1.4

  • Install the pre-requites for Alfresco (JDK 1.5, MySQL, OpenOffice [optional]).
  • Once you have MySQL installed, Connect to MySQL and run the following commands: 
create database alfresco;
grant all on alfresco.* to 'alfresco'@'localhost' identified by 'alfresco' with grant option;
grant all on alfresco.* to 'alfresco'@'localhost.localdomain' identified by 'alfresco' with grant option;
  • Install BEA Weblogic 9.1.
  • Create a Server within Weblogic to host the Alfresco application (should be prompted as part of the install process).
  • The default administrative login details are weblogic/weblogic.
  • Download the Alfresco WAR package, and extract it to your chosen location.
  • Copy the 'mysql-connector-java-3.1.12-bin.jar' file from the Alfresco WAR package, and copy it into the following location: bea\weblogic91\samples\domains\wl_server\lib as appropriate for your domain (this is the default). Or you can add it to the BEA CLASSPATH, or add it to the CLASSPATH statement in the Weblogic startup script (e.g. startWebLogic.cmd).
  • Install and Deploy the Alfresco WAR from within the BEA Weblogic Server Administration Console (please read the Weblogic documentation if you don't know how to do this).
  • The 'Alfresco.log' file should be found in the 'wl_server' directory, check this file to ensure that Alfresco has deployed correctly.
  • When Alfresco reaches the 'Active' state within Weblogic, it can be accessed from: http://machinename:7001/alfresco
Retrieved from "http://wiki.alfresco.com/wiki/Install_BEA_Weblogic"