Installing ColdBox Platform Utilities extensions on CFBuilder for Mac OSX

I had some experience before working with ColdBox very lightly on Windows platform some time ago but a lot has changed in the last few years.  I recently converted to Mac last year and have been working hard to re-establish my development platform.  There is a lot to learn in the process.  Today however, I was disappointed with the Wiki I found on ColdBox to install the ColdBox Platform Utilities extensions on CFBuilder so I decided to write this down here if it helps anyone else out.

Here were my steps, your mileage may vary:

  1. Download the ColdBox Platform Utilities zip file from ColdBox website.
  2. Make sure you have ColdFusion installed – in my case I have it installed as a Multiserver.
  3. Open up CF Builder (currently version 1.x)
  4. If this is the first time you are running CF Builder and haven’t yet added a Server, then follow the next few steps to create a server for your localhost.  If you already have a server, skip to step # 11.
  5. At the bottom of CF Builder, click the “Servers” tab (Servers,Console,Problems,Tailview,Services Browser,Extension) should be visible at the bottom.  If it’s not visible, use the menues Window > Show View > Servers to make it visible.
  6. Click the Server icon (first one on left) to Add a Server
  7. Some helpful suggestions:
    Server Name:  Localhost (your choice)
    Description:  (optional)
    Application Server:  Jrun
    Host Name: localhost
    Is Local:  checked
    WebServer Port: 8300 (you can gleen this from the ColdFusion Launcher app in /Applications/JRun4/)
    Context Root:    (leave blank by default unless you deploy as a J2EE app with a specific context root)
    Application Server Name:  cfusion  (the same name as the server folder or instance in ColdFusion Launcher app)
    RDS User Name:    (leave blank if your security is a single password)
    RDS Password:  *****  (your RDS password)
    Auto Start:  Checked
    Auto Stop:  Checked  (These two start/stop allow CF to be started and stopped when you open/close CF builder.)
  8. Click Next and make changes to Local Server Settings
    Server Home:  /Applications/JRun4
    Document Root:  /Library/WebServer/Documents  (my default, yours may vary)
  9. Click Finish
  10. Your Console window should show something like this:
    [localhost]:(02/26 at 10:38:17) Server is available.  Getting server settings.
  11. Open up your Extensions tab (also at the bottom – if not visible use the menus  Window > Show View > Other… > Extensions)
  12. Click the + (plus) icon, first one on left to add new extensions from archive files (a .zip)
  13. Navigate to where you downloaded the ColdFusionPlatformUtilities.zip file, select it and click Open.
  14. The installation wizard should kick and present you with the Extension Installation Wizard dialog box.
  15. Click Next
  16. Accept the terms, and click Next
  17. Select your newly or already added server from Select Server drop-down
  18. Your ColdFusion web root and install location should already be pre-entered which is your default web location for that CF server.  Click Next.
  19. It should tell you the extensions are ready to be installed with Install Summary, Click Finish.
  20. You should get an Installation Successful message.
  21. You should now see the Coldbox Platform Extensions in the extensions panel for Localhost.
  22. To verify it’s working you can right click on the project main folder or any other folder to view two new context menu items ColdBox Platform and ColdBox Forgebox.
  23. Begin coding 😉