Tuesday, July 17, 2007

Installing Liferay Portal 4.3

Update: There are several very handy presentations called Lifecasts on the Liferay website. They make the already simple installation and configuration even easier.

I wrote the following entry while performing the actual installation, which was much simpler than I had anticipated. A few grimaces but no tears.

------

For the past few days I've been researching portals and portlets to replace Microsoft Sharepoint for our corporate intranet. If you'd like to know why I'm replacing Sharepoint, please install and use Sharepoint. If you're still clueless, fire up Sharepoint Designer and get a good book on .Net.

Ok, now that we're all on the same page, the portal that's got me excited today is called Liferay. That's right, your software got me excited. Your feature documents often fill me with great hope, which invariably leads to a much larger-than-necessary crash into the depths of depression and self-hatred. Still, I must press on. Someday I'll deploy the software that will earn me the status of Employee of the Quarter. Someday.

Anyhow, I found out about Liferay when researching Alfresco, a document management system.

"Huh? I thought you were researching portals?"

Cork it. I'm also researching document management systems, and content management systems, and customer relation management systems and all variations of the above, "enterprise" or otherwise. Really I don't understand why there's so much distinction here. If you want a system to store records then surely you might want to collaborate about the records; maybe schedule a meeting about said records or leave a comment? Perhaps the records in question relate to a particular customer? That wouldn't be terribly strange now would it? I guess it would.

So anyhow, Liferay portal is some kind of Java thing that has all sorts of portlets which are some other kinds of Java things that plug in to the portal to provide the actual features that a person might want. The default portlets supported by Liferay look very promising and best of all, there's some kind of Alfresco portlet. This combination could be the Sharepoint killer that I've been looking for. (Yes, I really did just say "Sharepoint killer" with the full knowledge of the power of that phrase in search engines. There, I just said it again.)

Both Liferay and Alfresco are open source, or at least have public open source versions. I haven't looked into licensing much yet, but it looks like I can freely use and develop for both and I like that. However, being community-driven open source projects, it also means that your community forgot to write proper documentation and probably forgot to implement some show-stopper of a feature. Ouch, burn.

Enough with the preface, let's get on with the install.

I'm installing Liferay on my garbage machine just to see it in action. The garbage machine in question is running Windows XP Pro.

"Oh well then you're just asking for problems...."

Stuff it. If I decide on Liferay it will have to run on a Windows 2003 Server because we're almost 100% Windows here. Not my choice, just the way it is. Get over it. Anyhow, installing on XP Pro should be just fine as I just want to see how it works.

Here we go...

1) I'm visiting http://www.liferay.com/web/guest/downloads and there's a nice "Recommended Download" link entitled "Liferay Enterprise Portal 4.3.0 (Bundled with Tomcat 6.0)". I like recommended download links, especially considering the schizophrenic list of alternative downloads you typically offer me.

It's a zip file, praise Blod (the um, God of Blogs). There are some quick installation instructions underneath the link:

"Quick installation instructions: Install Java Runtime, Unzip, Run startup.bat or startup.sh. Read "Liferay Portal 4 - Installation Guide" for instructions on how to change to a production-ready database instead of HSQLDB."

Sounds easy!

2) Checking the system for Java runtime -- check. Actually: check, check, check, check. I have four Javas, three versions of version 5, and one version of version 6. Whatever. Your Java makes me confused.

3) Download complete. Unzipping.

Ok, what I've got here is a bunch of files and folders. There's a RUNNING.txt file with instructions for installing and running Tomcat. Do I need to follow these instructions? Hmm, according to the LICENSE document, this IS Tomcat. Alright, so my guess is that you basically just installed your software on/in Tomcat and zipped it all up. I guess we can work with that.

4) Running startup.bat. Which is in "bin/". (would it have been so hard to note that even though we all know that bin is short for binary, a convenience that saves us a mere 30 seconds assuming we can only type one word per minute?).

*Blip* Ah, the black blip of a batch file that terminates without pausing. Fine. Shell it is.

"Neither the JAVA_HOME nor the JRE_HOME environment variable is defined. At least one of these environment variable is needed to run this program."

I hate your Java.

5) Reading Quick Installation guide for Liferay. Step 1 says that I need to download and install JavaSE 5.0 and define the JAVA_HOME environment variable.

Have I mentioned that I hate your Java? So I have to actually download and install the JDK because all I've got on this machine is four versions of the JRE. I'm about to have five versions of the JRE because it's included in the JDK. I'm not sure what "Java SE" means, and there's also a "Java EE". What's wrong with you?

On the Java SE Downloads page there's a picture of a girl sitting in a tree while using a laptop. You should take that down because it fills me with rage. There are also about sixty five downloads to choose from. The first download is "JDK 6 Update 2". Is that an update for JDK 6, or JDK with an update? Why would I want an un-updated JDK? The second link is "JDK Update 1 with Java EE SDK Update 3 Preview 2". You bastard.

And wait, aren't I supposed to be downloading J2SE (another acronym!) version 5? Damnit. Ok, thanks to Google I've located the page to download JDK 5, and that same chick is still sitting in a tree.

Ok, the first link is "JDK 5.0 Update 12 with NetBeans IDE 5.5.1". That sounds good, I'll try it. Ok, the download button took me to a page with four thousand, seven hundred and eighty six links. I see another download button; I'm going for it.

Son of a crap, another download page. You are a bad, bad person. Ok, I have to click that I accept a license agreement that I'm not going to read, and then....ahh, ok, I just have to choose the "J2SE(TM) and NetBeans(TM) IDE Cobundle (J2SE 1.5.0 U12 / NB 5.5.1), Multi-language" link under "Windows Platform - J2SE(TM) and NetBeans(TM) IDE Cobundle (J2SE 1.5.0 U12 / NB 5.5.1". Sounds both high-tech and enterprise at the same time. Yay, downloading.

Hey wait a minute, didn't you tell me to "Download an install JavaSE 5.0" in your installation instructions? Aren't I downloading JavaSE 1.5.0? Does JavaSE == J2SE? Nevermind. It's cake day and I'm going to get some cake and eat it. (for real, it's not some silly metaphor)

Damnit there's no cake left. The rest of this install had better go smoothly.

6) Installing J2SE 1.5.0 or JavaSE 5.0 or JDK 5 or something like that.

Man it takes a long time to unpack jars. Done!

7) Ok, re-running startup.bat.

Dang it. If you're going to use Installsheild to install your product, then you have the power to set environment variables for me. Or maybe find a less 1990's way of storing your path? But then we wouldn't have this blog, would we.

8) Setting JAVA_HOME *or* JRE_HOME. I'll pick JAVA_HOME, it sounds nice.

Ok, that worked not at all.

I'll set JRE_HOME. But which JRE to point to now that I have five of them? The largest one that starts with 5 I guess. Oh no, I mean 1.5. I think. 1.5 = 5 and 1.6 = 6. You won't outfox me!

Oh yeah, setting variables via System Properties doesn't update them. What year is this? Google or restart...Google or restart... I'll just restart and take a little walk.

9) Running startup.bat.

It worked! I've got me a nice Tomcat shell that popped up. It's setting "useContextClassloader" to false...that's good. Some more stuff is happening. Good, good. Setting "useContextClassloader" to false again just in case. Good. Ok server startup in 70 thousand milliseconds. Awesome.

10) Browsing to localhost:8080. Hot dog, it worked! Signing in as default user. Success!

Ok, it's working but it's slow. Like sixty seconds to load a page slow. The Tomcat console is reporting java.lang.OutOfMemoryError. Interesting, considering that I'm only using 430MB of 1GB of RAM. The CPU is pegged.

I click on Add Content and about a minute later I get a blank popup. You like doing this to me, don't you. Ok, back to the instructions.

11) Re-reading installation instructions. Hm. Ok so the default database is probably the reason that the system runs so poorly, and that's not a big deal. But now I'm wondering how I use this thing. Let's check the website for some documentation. Ah, Portal Administrator's Guide, perfect.

"Coming Soon!"

Damn you.

Ok, so the documentation for version 4.3 isn't quite complete. That's ok, it's open source and I can write my own documentation. Snicker. But seriously, it looks like there's some documentation for 4.2 and I'm betting that some of it will apply. I'm glad that there is at least some documentation, and it looks pretty good overall.

According to the Portal Administrator's Guide for version 4.2, I click on Add Content to add portlets to the page. Unfortunately this is the same Add Content page that comes up blank on my installation.

Do I have to log in as a different user? I've seen no indication that I have to.

Do I have to download portlets manually? I know there are many bearded men out there who can't stand any extra bits bundled into their software, but I would expect at least one portlet to be available.

Something is wrong.

Looking back at the Tomcat console I'm noticing an error that I missed: "Unable to load repository ... plugins.liferay.com ..."

Ok, that's interesting. Let's ping it: "could not find host plugins.liferay.com".

Awesome. You've almost got me upset, but the strange calmness of 4PM has washed over me.

12) Let me check your forums.

Ok, I found this thread: http://www.liferay.com/web/guest/devzone/forums/message_boards/message/36461 which leads me to believe that everything should be working regardless of the fact that plugins.liferay.com doesn't exist.

Not finding anything about a blank Add Content window.

13) Let me try IE instead of Firefox, just for giggles.

14) That was dumb. This thing is too slow to be messing around like this. Let me figure out why it's running so slow. Searching forums for out of memory errors.

I'm going to try adding the memory options to my catalina.bat file from the following wiki page:

http://wiki.liferay.com/index.php/Setting_up_the_Alfresco_Portlet

Ok, that just doesn't work at all. Restoring catalina.bat.

Server is back up and running. Let me try it again just to see....

It works?!

Ok, apparently all that I needed to do was stop and restart the server.

Conclusion

Your software failed to make me cry today, and for that I am thankful. I do feel like a bit of a fool, however, since the purpose of this blog is to rant about how much I hate your software, but that's what I get for writing while I'm working. Your Java did upset me for a little while there, but not enough to bring tears. Nice try.

So far Liferay looks like it might do much of what I need in order to dump Sharepoint.

19 comments:

AEA said...

loooool. been there. done that. same problems. wait till you get deep into portlet administration and configuration. if that wont make you cry, i dont know what will.

Anonymous said...

Hi,
I had some problems with anything user related, but once I connected Liferay (5 RC) up to an external database it worked fine (the docs didn't take into account the new version of geronimo though so I was doomed until I tried it with a separate container).
Java heap settings and pointing JAVA_HOME to the right place isn't a show stopper, but the only performance problem I have is after every restart, the delays feel like it's recompiling JSPs or something. After hitting an action for the first time it's pretty quick...until I restart the server again.
My main experience is with WebSphere Portal, but I'm finding Liferay pretty good (maybe the 5 vresion is better than previous versions).

SM2K said...

It sounds like the app server is being shy about loading up Liferay until a request comes in. I've similar problems with IIS + Sharepoint where workers would be recycled after X minutes, thus the first person to hit the site in the morning would have to wait a long time for it to come up. I'd start by looking for something in your app server.

I'm looking forward to version 5. I'm actually going to wait for it before I roll this thing out.

Anonymous said...

[url=http://www.pinskerdream.com/bloghoster/?u=videosealene4]ImTOO DVD Subtitle Ripper 1.1.14.0201[/url] [url=http://www.drawingboard.org/blogs/?u=videosealoysius6]Xilisoft Video to Audio Converter 3.1.5.0430b[/url]
FLV Editor Pro Apex Video Converter Super 6.26
http://www.pinskerdream.com/bloghoster/?u=videosealice8 Ideal DVD Copy 3.1.1 Beta
[url=http://www.blogportalen.no/blog/?u=videosealaina5]IM MP4 Thumbnail[/url] [url=http://www.blogportalen.no/blog/?u=videoseadriana3]Xilisoft DVD Ripper Ultimate 5.0.32.0314[/url]
Super Video Joiner 2.7 All to iPhone Converter
http://www.drawingboard.org/blogs/?u=videoseamos4 Alldj DVD to Mpeg Converter 3.2
Aurora MPEG to DVD Burner 5.1.12
my icq:858499940385

Filo said...

I enjoyed your post. Very frank! I'm currently evaluating both Liferay and GateIn. Have you any thoughts on GateIn( the new combined portal from JBoss & Exo)?

Anonymous said...

Il semble que vous soyez un expert dans ce domaine, vos remarques sont tres interessantes, merci.

- Daniel

Anonymous said...

I love sadsoftware.blogspot.com! Here I always find a lot of helpful information for myself. Thanks you for your work.
Webmaster of http://loveepicentre.com and http://movieszone.eu
Best regards

Anonymous said...

Hey, I am checking this blog using the phone and this appears to be kind of odd. Thought you'd wish to know. This is a great write-up nevertheless, did not mess that up.

- David

Anonymous said...

absolute free dating sites http://loveepicentre.com/faq.php uranium 235 dating

Anonymous said...

[url=http://loveepicentre.com/testimonials.php][img]http://loveepicentre.com/uploades/photos/1.jpg[/img][/url]
free kingston ontario dating sites [url=http://loveepicentre.com/advice.php]rules to online dating[/url] christian dating single thacker
basque dating sites [url=http://loveepicentre.com/testimonials.php]chat program dating internet service[/url] free online adult dating site
100 free online dating site scranton [url=http://loveepicentre.com/advice.php]gratis dating advertenties[/url] time dating techniques

Anonymous said...

sony touch edition ebook skins http://audiobookscollection.co.uk/it/Advanced-robust-and-nonparametric-methods-in-efficiency-analysis/p102164/ flowers in the attic ebook [url=http://audiobookscollection.co.uk/de/Together-Forever/p167531/]dead in the family ebook torrent[/url] free starwars guide ebook

Anonymous said...

bursa-buku miliki 3 ebook terbaru gratis http://audiobookscollection.co.uk/de/Safari-Origami/p214386/ free download word 2003 ebook [url=http://audiobookscollection.co.uk/es/Product-Focused-Software-Process-Improvement-6th-International-Conference-PROFES-2005-Oulu-Finland-June-13-18-2005-Proceedings-Lecture-Notes-Programming-and-Software-Engineering/p209640/]physics for scientists and engineers ebook[/url] ebook nederland

Anonymous said...

windows voice recognition software http://buysoftwareonline.co.uk/es/product-31616/ITubeX-Ultimate-6-0-MAC garmin 750 gps software [url=http://buysoftwareonline.co.uk/account/history]metodologias de desarrollo del software[/url] computer software hollywood
[url=http://buysoftwareonline.co.uk/it/contact]Contattaci - Cheap Legal OEM Software, Software Sale, Download OEM[/url] best project accounting software
[url=http://buysoftwareonline.co.uk/category-200-203/Graphics-and-Publishing?page=1][img]http://buyoem.co.uk/image/2.gif[/img][/url]

Anonymous said...

[url=http://onlinemedistore.com/categories/stop-smoking.htm][img]http://onlinemedistore.com/12.jpg[/img][/url]
safeway pharmacy wages http://onlinemedistore.com/ ryk spoor albany pharmacy [url=http://onlinemedistore.com/products/risperdal.htm]xavier college of pharmacy[/url]
european pharmacy online http://onlinemedistore.com/products/prevacid.htm pharmacognocy in pharmacy [url=http://onlinemedistore.com/products/levitra-professional.htm]levitra professional[/url]
online pharmacy adderl http://onlinemedistore.com/products/mentax.htm uriel pharmacy [url=http://onlinemedistore.com/catalogue/c.htm]td qd pharmacy terminology[/url]
gehring pharmacy cincinnati ohio http://onlinemedistore.com/products/intagra.htm how is communication related to pharmacy [url=http://onlinemedistore.com/products/digoxin.htm]digoxin[/url]

Anonymous said...

[url=http://redbrickstore.co.uk/products/finpecia.htm][img]http://onlinemedistore.com/3.jpg[/img][/url]
pharmacy algebra http://redbrickstore.co.uk/products/gift-kamagra-jelly.htm pharmacy approval letters [url=http://redbrickstore.co.uk/products/atarax.htm]pharmacy gold[/url]
pharmacy business process http://redbrickstore.co.uk/products/tadalis.htm problems in the pharmacy field [url=http://redbrickstore.co.uk/categories/women-s-health.htm]women s health[/url]
target pharmacy mn http://redbrickstore.co.uk/products/crestor.htm glovers pharmacy [url=http://redbrickstore.co.uk/products/menosan.htm]pharmacy and sale of customer prescription records and law[/url]
palmyra nj pharmacy http://redbrickstore.co.uk/products/tentex-royal.htm how do i become a pharmacy technician trainee in phx az [url=http://redbrickstore.co.uk/products/diamox.htm]diamox[/url]

Anonymous said...

[url=http://englandpharmacy.co.uk/products/lisinopril.htm][img]http://onlinemedistore.com/11.jpg[/img][/url]
lenox pharmacy massachusetts http://englandpharmacy.co.uk/products/actos.htm good skin pharmacy tri aktiline instant deep wrinkle filler [url=http://englandpharmacy.co.uk/products/paxil.htm]pharmacy hse ireland[/url]
gc pharmacy http://englandpharmacy.co.uk/products/xenical.htm winslow drug pharmacy [url=http://englandpharmacy.co.uk/products/prandin.htm]prandin[/url]
dillons pharmacy in derby kansas http://englandpharmacy.co.uk/products/motrin.htm passport photos cvs pharmacy oak ridge [url=http://englandpharmacy.co.uk/products/vasotec.htm]online pharmacy schooling[/url]
pharmacy health http://englandpharmacy.co.uk/products/lexapro.htm pharmacy refusal of plan b [url=http://englandpharmacy.co.uk/products/indinavir.htm]indinavir[/url]

Anonymous said...

john kelvin dating nigeria http://loveepicentre.com/success_stories/ interracial dating syracuse married but looking
free dating web site online [url=http://loveepicentre.com/advice/]rules for speed dating[/url] cheap sex dating
herpies dating [url=http://loveepicentre.com/articles/]uk dating magazine[/url] torrent dating sims parfait [url=http://loveepicentre.com/user/arnleybiatch/]arnleybiatch[/url] free to use adult dating

Anonymous said...

top rated online dating service 2007 http://loveepicentre.com/taketour/ personality tests software for dating
dating service franchise [url=http://loveepicentre.com/articles/]single dating free site[/url] teen dating biological
dating psychotherapist [url=http://loveepicentre.com/success_stories/]astral dating[/url] we are dating kdrama [url=http://loveepicentre.com/user/marlyandcec/]marlyandcec[/url] dating sites in new jersey

Anonymous said...

keith harkin dating ruth o'leary http://loveepicentre.com/taketour/ 34 scorpio dating detroit
who is advertisement dating [url=http://loveepicentre.com]tampa dating service[/url] is taylor swift dating taylor lautner
100.3 the beat online dating [url=http://loveepicentre.com/faq/]secret dating[/url] girls who squirt dating [url=http://loveepicentre.com/user/charity/]charity[/url] sisters and brothers dating