Watch Me Install Alfresco

Watch Me Install Alfresco 3.1 Richard Im Solutions Engineering Manager www.alfresco.com

Agenda Watch me Install

from scratch (tomcat bundle)‏

Basic Configurations- How and Where

The Repo

The DB

Externals

CIFS Configuration

Choices...

Tomcat Bundle

Easy...pretty much works OOTB. Just start up!

WAR file + Extensions

Download the war and sample extensions for your configurations

EAR Distribution

For AS deployment

Installers

Good for evaluation. Developers + Administrators: Use the bundle or WAR distro.

First and Foremost

Unpack the zip/tar.gz

Pretty standard Tomcat installation with some root level folders and scripts

/amps – place alfresco extension amps here and use the supplied apply_amps.sh to add to your alfresco.war

alfresco.sh – the main script file to start and stop alfresco (see next slide).

WCM – Unpack alfresco-enterprise-wcm-3.1.zip/tar.gz

Contains additional files and virtual tomcat to install on a DM alfresco instance.

virtual_alf.sh & /virtual-tomcat can be dropped at the same root for your alfresco tomcat

Copy wcm-bootstrap-context.xml to /$TOMCAT_HOME/shared/classes/alfresco/extension/

Startup Scripts

Default alfresco.sh & virtual_alf.sh (.bat for windows)‏

Depending on your environment set up:

export JAVA_HOME=/usr

virtual_alf.sh

Issue in alfresco.sh, references virtual_start.sh. Incorrect!

Fix this so its the right file and 'start'/'stop' argument appropriately

JVM Parameters

Default alfresco.sh (.bat for windows)‏

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

export JAVA_OPTS="${JAVA_OPTS} -Dalfresco.home=${ALF_HOME} -Dcom.sun.management.jmxremote"

JAVA_OPTS Additions

-Xdebug -Xrunjdwp:transport=dt_socket,address=5001,server=y,suspend=n

-Didentifier=alfrepo -uniquely identify

Virt Server – Add in alfresco.sh or in virtual_alf.sh

export VIRT_JAVA_OPTS=' -Xms128m -Xmx512m -XX:MaxPermSize=128m -server'

export VIRT_JMX_OPTS=' -Duser.language=en -Didentifier=alfvirtual -Dcom.sun.management.jmxremote.port=29999 -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false'

One off config tip

WCM – Web projects dependent on path based resource files

Due to spring requiring resource files being on disk location

Can't use standard RMI based classloading of your webproject to the virtual server

i.e. getRealPath() to work properly

Around this: you can use CIFS to your advantage here:

Configure the Repo

Alfresco Configurations

Use $TOMCAT_HOME/shared/classes/alfresco/extensions

Safe for restarts/upgrades

Again, Tomcat bundle wins!

custom-repository-context.xml

This spring file loads existing properties and adds additional

<value>classpath:alfresco/extension/custom-repository.properties</value>

Because of this override mechanism, we can define keys in custom-repository.properties

Configure the Repo...cont.

custom-repository.properties

dir.root=./alf_data

relative path – BAD! set to a real path

dir.root is also a var used through out the file to define: index dirs, oouser dirs, etc.

Indexes on another volume? Yes, just get the keys from repository.properties

Configure the DB

Alfresco Default DB Driver/URL

Comment out the default:

db.driver=org.apache.derby.jdbc.EmbeddedDriver

db.url=jdbc:derby:alf_data/derby_data/alfresco;create=true

MySQL Config

Uncomment the DB connection relevant to your DB platform

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

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

Download the db driver and install in $TOMCAT_HOME/lib

custom-hibernate-dialect.properties

Set appropriate for DB platform

hibernate.dialect=org.hibernate.dialect.MySQLInnoDBDialect

External Dependencies # # Sample external executable locations # ooo.exe=/Applications/OpenOffice.org 2.3.app/Contents/MacOS/soffice #ooo.user=${dir.root}/oouser img.root=/srv/alfresco/ImageMagick swf.exe=/srv/alfresco/bin/pdf2swf ooo.exe=/Applications/OpenOffice.org 2.3.app/Contents/MacOS/soffice img.root=/Users/richardim/ImageMagick swf.exe=/Users/richardim/PDF2SWF/bin/pdf2swf

CIFS

file-servers.xml

<config evaluator="string-compare" condition="CIFS Server"> - will need to copy this entire block and make changes.

By default, looks at a file-servers.properties file and settings are picked up from there i.e. ${cifs.enabled}

<serverEnable enabled="${cifs.enabled}"/>

<host name="${cifs.localname}A" domain="${cifs.domain}"/>

<comment>Alfresco CIFS Server</comment>

<broadcast>${cifs.broadcast}</broadcast>

<bindto>${cifs.bindto}</bindto>

CIFS

file-servers-custom.xml.sample renamed to file-servers-custom.xml

Past the entire <config evaluator="string-compare" condition="CIFS Server"> block down to the first </config> element – also add replace=”true” condition.