An Architect's View

CFML, Clojure, Software Design, Frameworks and more...

An Architect's View

Railo for Dummies Part II

March 24, 2009 ·

I said I'd look at Railo on Tomcat next but I figured I'd just sneak in a quick Express for Windows post before that so folks don't think I'm forgetting all those PC users.Download Go to the download page and under "Railo Express", pick the "Windows" zip file: This puts a 58MB ZIP file on your system (I saved it to Downloads). Right-click the ZIP file and Extract to... your Desktop (I used WinZip because Windows 7's built-in unzip can't extract things correctly!). Starting Railo In the folder created from the ZIP file, simply double-click the start file (start.bat). Accept the various Windows security alerts. It will start a cmd window and run a command to start Railo. After six or seven seconds, the cmd window will show Started SelectChannelConnector @ to indicate that Railo is running. Do not close that window (because that will stop the server). That's it - Railo is running. Yes, after just six or seven seconds! Testing Browse to http://localhost:8888/. You'll see the Railo test page! A real application Last time we installed ColdBox from the ColdBox website. This time we'll install ColdBox directly from within the Railo Web Administrator! Click on the admin link on that page and choose the Web Administrator. It will ask you to provide a new password and confirm it. Then choose Applications under Extension (experimental) and click Activate the extension manager. Select ColdBox and click install. Change the Path for the install so it ends in just coldbox, not coldbox-2.6.1-1 (component paths cannot have '-' in them so you'll have problems running the samples if you don't do this). Uncheck the Mapping creation (we don't need it with ColdBox directly in the webroot with the coldbox folder name). Click install on that second screen. Click OK on the next screen when it confirms where it has installed the framework. Then browse to http://localhost:8888/coldbox/samples/. It should show the ColdBox Samples Gallery page and you can try out the examples. Congratulations! You've installed Railo on Windows and started it. You've installed ColdBox and tried out some sample applications and it all works! Stopping Railo In the folder created from the ZIP file, simply double-click the stop file (stop.bat). Accept the various Windows security alerts. Then it will open a new cmd window and run a command to stop Railo. Both the original cmd window and this new one should close. Railo is stopped. Next time I really will look at a basic installation of Railo on Tomcat!

Tags: coldbox · coldfusion · microsoft · railo

4 responses

  • 1 Todd Rafferty // Mar 25, 2009 at 1:52 AM

    Just a note to new users to Railo regarding the "Express" version: It's meant to be quickly downloaded so that you can run and play. Please don't use the express setup in a production environment. Actually take the time and learn to setup Railo with Resin/Tomcat/JBOSS, etc.

    Oh, and if you're looking for the correct pronunciation of Railo. It is RAI-LO. Not RAIL-LO.
  • 2 Sean Corfield // Mar 25, 2009 at 7:49 AM

    @Todd, yup, as I said in Part I "I'm going to start with the very simplest development scenario and build up to a variety of production options."

    On pronunciation, specifically it's Rhy-Lo not Ray-Lo (I think that's what you were trying to convey?).
  • 3 Aaron West // Apr 5, 2009 at 9:23 AM

    @Sean - I've been reading through this series and have something to suggest. Screenshots. I'm a super visual person and while I can read to learn something, screenshots are really helpful. It does take extra time to add media to blog posts but it's worth it in my opinion.
  • 4 Sean Corfield // Apr 5, 2009 at 10:07 AM

    @Aaron, screenshots of... the command line?

    There's no dialog boxes involved so I'm not sure how screenshots of files in editors or commands in Terminal would add much... could you elaborate?