Watch Me Install Alfresco
Download as PPT, PDF5 likes1,553 views
The document outlines the installation process of Alfresco 3.1, including configurations for Tomcat, database setup, and CIFS configuration. It provides detailed instructions on unpacking files, setting JVM parameters, and customizing repository properties. Additionally, resources such as wikis, forums, and documentation for further support are mentioned.
Watch Me Install Alfresco
- 1. Watch Me Install Alfresco 3.1 Richard Im Solutions Engineering Manager www.alfresco.com
- 2. Agenda Watch me Install from scratch (tomcat bundle) Basic Configurations- How and Where The Repo The DB Externals CIFS Configuration
- 3. 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.
- 4. 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/
- 5. 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
- 6. 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'
- 7. 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:
- 8. 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 <!-- Override basic repository properties --> <value>classpath:alfresco/extension/custom-repository.properties</value> Because of this override mechanism, we can define keys in custom-repository.properties
- 9. 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
- 10. 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
- 11. 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
- 12. 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> <!-- Set to the broadcast mask for the subnet --> <broadcast>${cifs.broadcast}</broadcast> <!-- Set to the IP for the adapter for Java socket --> <bindto>${cifs.bindto}</bindto>
- 13. 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. Some basics to tweak: <host name="${cifs.localname}A" domain="${cifs.domain}"/> <broadcast>192.168.1.0</broadcast> on *nix this: <tcpipSMB ipv6="${cifs.ipv6}" platforms="linux,solaris,macosx"/> <netBIOSSMB bindto="${cifs.bindto}" platforms="linux,solaris,macosx"/> to: <tcpipSMB port="1445" ipv6="${cifs.ipv6}" platforms="linux,solaris,macosx"/> <netBIOSSMB sessionPort="1139" namePort="1137" datagramPort="1138" platforms="linux,solaris,macosx"/>
- 14. More Resources: wiki: Check our wiki often, as pages are added and updated frequently. http://wiki.alfresco.com http://wiki.alfresco.com/wiki/Category:Installation Forums: A great place to pose questions and get advice from others. Search the forum to see if your question has already been asked. http://forums.alfresco.com Documentation: Can find documents on configuring and installing http://www.alfresco.com/products/ecm/enttrial/ Try Alfresco http://www.alfresco.com/try
- 15. Try Alfresco for free. www.alfresco.com/try
- 16. Learn Alfresco. Get more Alfresco webinar recordings www.alfresco.com/about/events/ondemand
Editor's Notes
- #2: 03/09/09