Watch Me Install Alfresco


Published on

Watch Richard Im, our prodigy Solutions Engineer, install Alfresco from scratch.

First, doing a custom install, and then, using the Windows installer.

The process will include:

Using the tomcat bundle:
The pros and cons of using the bundle

Custom start up options

Configuring open office connection

Ensuring imagemagick binaries on path

Ensure pdf2swf

Why we have these 3 binaries part of Alfresco.

Configure Alfresco Web Content Management

Configure your database

Configuring CIFS

how linux you configure ports

How to configure Alfresco Share remotely

Starting your evaluation of alfresco Explorer:
- Configuring your own document management scenarios using content models, aspects, rules and actions.

Starting your evaluation of Alfresco Share:
- Creating your own team site so you can start your collaboratin'

And now, doing it all over again!
Except this time with the Windows installer.

This will be a very hands-on webinar. So come prepared to take notes, and do some work yourself.

Published in: Technology
1 Comment
No Downloads
Total views
On SlideShare
From Embeds
Number of Embeds
Embeds 0
No embeds

No notes for slide
  • 03/09/09
  • Watch Me Install Alfresco

    1. 1. Watch Me Install Alfresco 3.1 Richard Im Solutions Engineering Manager
    2. 2. Agenda Watch me Install <ul><li>from scratch (tomcat bundle)‏ </li></ul><ul><li>Basic Configurations- How and Where </li></ul><ul><ul><li>The Repo </li></ul></ul><ul><ul><li>The DB </li></ul></ul><ul><ul><li>Externals </li></ul></ul><ul><li>CIFS Configuration </li></ul>
    3. 3. Choices... <ul><li>Tomcat Bundle </li></ul><ul><ul><li>Easy...pretty much works OOTB. Just start up! </li></ul></ul><ul><li>WAR file + Extensions </li></ul><ul><ul><li>Download the war and sample extensions for your configurations </li></ul></ul><ul><li>EAR Distribution </li></ul><ul><ul><li>For AS deployment </li></ul></ul><ul><li>Installers </li></ul><ul><ul><li>Good for evaluation. Developers + Administrators: Use the bundle or WAR distro. </li></ul></ul>
    4. 4. First and Foremost <ul><li>Unpack the zip/tar.gz </li></ul><ul><ul><li>Pretty standard Tomcat installation with some root level folders and scripts </li></ul></ul><ul><ul><li>/amps – place alfresco extension amps here and use the supplied to add to your alfresco.war </li></ul></ul><ul><ul><li> – the main script file to start and stop alfresco (see next slide). </li></ul></ul><ul><li>WCM – Unpack </li></ul><ul><ul><li>Contains additional files and virtual tomcat to install on a DM alfresco instance. </li></ul></ul><ul><ul><li> & /virtual-tomcat can be dropped at the same root for your alfresco tomcat </li></ul></ul><ul><ul><li>Copy wcm-bootstrap-context.xml to /$TOMCAT_HOME/shared/classes/alfresco/extension/ </li></ul></ul>
    5. 5. Startup Scripts <ul><li>Default & (.bat for windows)‏ </li></ul><ul><ul><li>Depending on your environment set up: </li></ul></ul><ul><ul><ul><li>export JAVA_HOME=/usr </li></ul></ul></ul><ul><li> </li></ul><ul><ul><li>Issue in, references Incorrect! </li></ul></ul><ul><ul><li>Fix this so its the right file and 'start'/'stop' argument appropriately </li></ul></ul>
    6. 6. JVM Parameters <ul><li>Default (.bat for windows)‏ </li></ul><ul><ul><li>export JAVA_OPTS='-Xms128m -Xmx512m -XX:MaxPermSize=128m -server' </li></ul></ul><ul><ul><li>export JAVA_OPTS=&quot;${JAVA_OPTS} -Dalfresco.home=${ALF_HOME}; </li></ul></ul><ul><li>JAVA_OPTS Additions </li></ul><ul><ul><li>-Xdebug -Xrunjdwp:transport=dt_socket,address=5001,server=y,suspend=n </li></ul></ul><ul><ul><li>-Didentifier=alfrepo -uniquely identify </li></ul></ul><ul><li>Virt Server – Add in or in </li></ul><ul><ul><li>export VIRT_JAVA_OPTS=' -Xms128m -Xmx512m -XX:MaxPermSize=128m -server' </li></ul></ul><ul><ul><li>export VIRT_JMX_OPTS=' -Duser.language=en -Didentifier=alfvirtual' </li></ul></ul>
    7. 7. One off config tip <ul><li>WCM – Web projects dependent on path based resource files </li></ul><ul><ul><li>Due to spring requiring resource files being on disk location </li></ul></ul><ul><ul><li>Can't use standard RMI based classloading of your webproject to the virtual server </li></ul></ul><ul><ul><li>i.e. getRealPath() to work properly </li></ul></ul><ul><ul><li>Around this: you can use CIFS to your advantage here: </li></ul></ul>
    8. 8. Configure the Repo <ul><li>Alfresco Configurations </li></ul><ul><ul><li>Use $TOMCAT_HOME/shared/classes/alfresco/extensions </li></ul></ul><ul><ul><li>Safe for restarts/upgrades </li></ul></ul><ul><ul><li>Again, Tomcat bundle wins! </li></ul></ul><ul><li>custom-repository-context.xml </li></ul><ul><ul><li>This spring file loads existing properties and adds additional </li></ul></ul><ul><ul><li><!-- Override basic repository properties --> </li></ul></ul><ul><ul><li><value>classpath:alfresco/extension/</value> </li></ul></ul><ul><ul><li>Because of this override mechanism, we can define keys in </li></ul></ul>
    9. 9. Configure the Repo...cont. <ul><li> </li></ul><ul><ul><li>dir.root=./alf_data </li></ul></ul><ul><ul><ul><li>relative path – BAD! set to a real path </li></ul></ul></ul><ul><ul><li>dir.root is also a var used through out the file to define: index dirs, oouser dirs, etc. </li></ul></ul><ul><ul><ul><li>Indexes on another volume? Yes, just get the keys from </li></ul></ul></ul>
    10. 10. Configure the DB <ul><li>Alfresco Default DB Driver/URL </li></ul><ul><ul><li>Comment out the default: </li></ul></ul><ul><ul><li>db.driver=org.apache.derby.jdbc.EmbeddedDriver </li></ul></ul><ul><ul><li>db.url=jdbc:derby:alf_data/derby_data/alfresco;create=true </li></ul></ul><ul><li>MySQL Config </li></ul><ul><ul><li>Uncomment the DB connection relevant to your DB platform </li></ul></ul><ul><ul><li> </li></ul></ul><ul><ul><li>db.url=jdbc:mysql://localhost/alfresco31e </li></ul></ul><ul><ul><li>Download the db driver and install in $TOMCAT_HOME/lib </li></ul></ul><ul><li> </li></ul><ul><ul><li>Set appropriate for DB platform </li></ul></ul><ul><ul><li>hibernate.dialect=org.hibernate.dialect.MySQLInnoDBDialect </li></ul></ul>
    11. 11. External Dependencies # # Sample external executable locations # ooo.exe=/Applications/ #ooo.user=${dir.root}/oouser img.root=/srv/alfresco/ImageMagick swf.exe=/srv/alfresco/bin/pdf2swf ooo.exe=/Applications/ img.root=/Users/richardim/ImageMagick swf.exe=/Users/richardim/PDF2SWF/bin/pdf2swf
    12. 12. CIFS <ul><li>file-servers.xml </li></ul><ul><ul><li><config evaluator=&quot;string-compare&quot; condition=&quot;CIFS Server&quot;> - will need to copy this entire block and make changes. </li></ul></ul><ul><ul><li>By default, looks at a file and settings are picked up from there i.e. ${cifs.enabled} </li></ul></ul><ul><ul><li><serverEnable enabled=&quot;${cifs.enabled}&quot;/> </li></ul></ul><ul><ul><li><host name=&quot;${cifs.localname}A&quot; domain=&quot;${cifs.domain}&quot;/> </li></ul></ul><ul><ul><li><comment>Alfresco CIFS Server</comment> </li></ul></ul><ul><ul><li><!-- Set to the broadcast mask for the subnet --> </li></ul></ul><ul><ul><li><broadcast>${cifs.broadcast}</broadcast> </li></ul></ul><ul><ul><li><!-- Set to the IP for the adapter for Java socket --> </li></ul></ul><ul><ul><li><bindto>${cifs.bindto}</bindto> </li></ul></ul>
    13. 13. CIFS <ul><li>file-servers-custom.xml.sample renamed to file-servers-custom.xml </li></ul><ul><ul><li>Past the entire <config evaluator=&quot;string-compare&quot; condition=&quot;CIFS Server&quot;> block down to the first </config> element – also add replace=”true” condition. </li></ul></ul><ul><ul><li>Some basics to tweak: </li></ul></ul><ul><ul><li><host name=&quot;${cifs.localname}A&quot; domain=&quot;${cifs.domain}&quot;/> </li></ul></ul><ul><ul><li><broadcast></broadcast> </li></ul></ul><ul><ul><li>on *nix this: </li></ul></ul><ul><ul><li><tcpipSMB ipv6=&quot;${cifs.ipv6}&quot; platforms=&quot;linux,solaris,macosx&quot;/> </li></ul></ul><ul><ul><li><netBIOSSMB bindto=&quot;${cifs.bindto}&quot; platforms=&quot;linux,solaris,macosx&quot;/> </li></ul></ul><ul><ul><li>to: </li></ul></ul><ul><ul><li><tcpipSMB port=&quot;1445&quot; ipv6=&quot;${cifs.ipv6}&quot; platforms=&quot;linux,solaris,macosx&quot;/> </li></ul></ul><ul><ul><li><netBIOSSMB sessionPort=&quot;1139&quot; namePort=&quot;1137&quot; datagramPort=&quot;1138&quot; platforms=&quot;linux,solaris,macosx&quot;/> </li></ul></ul>
    14. 14. More Resources: <ul><ul><li>wiki: Check our wiki often, as pages are added and updated frequently. </li></ul></ul><ul><ul><li> </li></ul></ul><ul><ul><li> </li></ul></ul><ul><ul><li>Forums: A great place to pose questions and get advice from others. Search the forum to see if your question has already been asked. </li></ul></ul><ul><ul><li> </li></ul></ul><ul><ul><li>Documentation: Can find documents on configuring and installing </li></ul></ul><ul><ul><li> </li></ul></ul><ul><ul><li>Try Alfresco </li></ul></ul><ul><ul><li> </li></ul></ul>
    15. 15. Try Alfresco for free. <ul><ul><li> </li></ul></ul>
    16. 16. Learn Alfresco. <ul><ul><li>Get more Alfresco webinar recordings </li></ul></ul><ul><ul><li> </li></ul></ul>