Alfreso is a fantastic ECM solution that has some amazing features and some great momentum. It has been more than a year since I've used Alfresco and man have they gotten some cool stuff done.

I spent the last couple of days getting certified to teach a couple of Aflresco's classes. I used my mac (running leopard) and I figured I'd post a bit about what I did to get all the features up and running. Alfresco is able to use OpenOffice and Image Magick to do some cool stuff like transform any word doc to PDF or and GIF to PNG etc. Problem is the Alfresco site is short on detail about how to make all that goodness work on the mac.

Being the stubborn guy that I am I would not leave well enough alone and run it on some other OS. It took me a couple of hours but I got everything working. Here are the details...

Grab Open Office from here. I got the aqua interface cause I don't really care about the UI anyway. Install by copying it to your Applications folder. I renamed the app to OpenOffice.app (got rid of spaces) although I'm not sure that is necessary it ended up that way after all the experimentation and I've not had a chance to go back and check if it would work with a space (seemed at the time like something that Alfresco was using was not properly escaping spaces).

Now that you have the OO install done its time to teach Alfresco about it. In your alfresco install (the one that includes tomcat) there is an extensions folder (tomcat/shared/classes/alfresco/extension). Go there and add a folder called 'bootstrap'. Then in there create an XML file called openoffice-startup-context.xml. I've included mine here so you don't have to set it up from scratch. Basically this file tells Alfresco how to startup openoffice in headless mode so that it can be used to do doc transforms.

Install Image Magick with mac ports via a command line that looks basically like this sudo port install ImageMagick. If you are stubborn and you don't want to use Mac Ports the Image Magick community has a binary distro for you here. I used the mac ports build instead of the binary distro so your millage might vary if you use the binary.

That is it, now when you restart Alfresco it will be able to do the document conversion and image conversion. If you are looking for an ECM take a look, its really cool stuff.