Installing Alfresco Labs 3 on openSUSE 11.1

As we transition to the new Hyland Community, some post links may be temporarily disrupted as we finalize redirects. We apologize for the inconvenience and are working to resolve this as quickly as possible. Details.

resplin

Obsolete Pages{{Obsolete}}

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

This guide is a work in progress, as it stands now it shows how to install Alfresco Document Management and Collaboration (a.k.a Share).  I intend to show how to install all aspects including WCM and integration with Drupal and MediaWiki etc.

1) Minimal install, fully updated



2) Install Apache, Java, MySQL, PHP, OpenOffice and Tomcat

zypper in apache2 apache2-mod_php5 java-1_6_0-sun mysql mysql-connector-java php5 php5-mysql OpenOffice_org tomcat6 (agree to license)



3) Download Alfresco Labs 3 from here to a temp dir and extract.  The files I downloaded are:

alfresco-labs-war-3Stable.tar.gz

alfresco-labs-wcm-3Stable.tar.gz

alfresco-web-service-client-3Stable.tar.gz



alfresco-mmt-3Stable.jar

vti-module.amp

aggadget.zip

org.alfresco.module.mediawikiintegration.amp

alfresco-truncateMalformedXml.amp

phpIntegration.amp



4) Due to Bug BNC 471639  edit /usr/bin/dtomcat6 and add the output to echo $JAVA_HOME

For me this was /usr/lib/jvm/jre



Add this just above # CLASSPATH munging



5) Create required directories -

mkdir -p /srv/tomcat6/shared/lib

mkdir /srv/tomcat6/shared/classes

mkdir -p /opt/alfresco/alf_data

6) Copy/Move the .war files from the directory you extracted alfresco-labs-war-3Stable.tar.gz to /srv/tomcat6/webapps



7) Edit /etc/tomcat6/catalina.properties and change the line that starts with shared.loader=



It should now be shared.loader=/srv/tomcat6/shared/classes,/srv/tomcat6/shared/lib/*.jar



😎 Copy the MySQL java connector to the correct directory:



cp /usr/share/java/mysql-connector-java-5.1.6.jar /srv/tomcat6/shared/lib/



9) Setup the database using the sql schema provided which is located in $UNPACKED_WAR_DIR/extras/databases/mysql



~> mysql -u root -p<br><br>mysql> source db_setup.sql

10) Download the sample configuration files alfresco-labs-sample-extensions-3Stable.tar.gz and extract into /srv/tomcat6/shared/classes

11)Go into /srv/tomcat6/shared/classes/alfresco/extension and create a sample directory - move all .sample and .zip into the sample dir

mv *.sample* sample/<br><br>mv *.zip sample/

12) We need a few of the sample files back here as real files so:

cp sample/custom-hibernate-dialect.properties.sample custom-hibernate-dialect.properties<br><br>cp sample/custom-repository-context.xml.sample custom-repository-context.xml<br><br>cp sample/custom-repository.properties.sample custom-repository.properties<br><br>

13) Edit custom-hibernate-dialect.properties and ensure that the MySQL dialect line is uncommented - hibernate.dialect=org.hibernate.dialect.MySQLInnoDBDialect

14) Edit custom-repository.properties to

   
• Set the location you want your content stored -

dir.root=/opt/alfresco/alf_data

   
• Uncomment the database connection properties -

db.username=alfresco

db.password=alfresco

db.pool.initial=10

db.pool.max=100

   
• If you want you can enable the index tracking & recovery by uncommenting the appropriate section -

index.tracking.cronExpression=0/5 * * * * ?

index.recovery.mode=AUTO

   
• Enable the MySQL connection -

db.driver=org.gjt.mm.mysql.Driver

db.url=jdbc:mysql://localhost/alfresco

   
• As this is a test machine I am using the single port for all RMI services. You can, as you will see, configure them to use different ports - 

alfresco.rmi.services.port=50500

15) Ensure that the correct permissions are set on the directories

chown -R tomcat:tomcat /srv/tomcat6<br><br>chown -R tomcat:tomcat /opt/alfresco



16) Ensure that the logfile is created in the correct place

Edit /srv/tomcat6/alfresco/WEB-INF/classes/log4j.properties and /srv/tomcat6/share/WEB-INF/classes/log4j.properties to have:

log4j.appender.File.File=/var/log/alfresco.log



17) Edit /etc/sysconfig/tomcat6 and add

JAVA_OPTS='$JAVA_OPTS -Xms128m -Xmx512m -XX:MaxPermSize=128m -server'



18) Start OpenOffice using the following command:

soffice '-accept=socket,host=localhost,port=8100;urp;StarOffice.ServiceManager' -nologo -headless



19) Start tomcat rctomcat6 start

check to see if .war files have extracted  - /srv/tomcat6/webapps should now have directories called alfresco and share. If not restart tomcat rctomcat6 restart





 

Installation3.2OpenSUSE

• NOTE* When Installing to OpenSuse11.1 , REMEMBER to Do the step for CHOWN tomcat:tomcat to the alfresco directories and the data directory in which you setup for the data of alfresco to be installed.   Also, as a precaution, due to the fact that OpenSuse11.1 Has default Java-Openjdk active, you will need to uninstall OpenJDK and install Sun-Java6-1.6.0 and let it update so that it makes the active java ---> point to java-sun-java6-1.6.0 vs. the openjdk alternative.  If you do not do this step, your alfresco will error out with 'Unknown Language Error for All' and will fail.  
  

Steps for this to be inserted above :

After install :
1.  Remove OpenJDK from the Suseinstallation using Software Manager or Yast.
2.  Search for latest version of Sun-Java6-1.6.0 or similiar and install that.
3.  Then configure as noted above and things should work fine.