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 😉

4 Replies to “Installing ColdBox Platform Utilities extensions on CFBuilder for Mac OSX”

  1. Thanks for this walkthrough!

    It seems to work and gives me an “Installation successful” but does not any of the Utility context menus when right clicking on my project folders.

    My setup is a bit different than yours but your walkthrough seems to match everything I’m seeing.

    My setup: Windows 7, CF9 Remote, CF Builder 1 Build 274293, Flash Builder 4 Premium Plugin build 272416, ColdBox Utilities 2.5

    Just hoping someone else has run into this issue and has already done the legwork on fixing it. Or I’m missing something simple 🙂

    TIA

  2. Whups… first sentence should read ‘It seems to work, and gives me an “Installation successful” but does not show any of the ColdBox Utility context menus when right clicking on my project folders.’

  3. Hi Tom,
    Thanks for stopping by. If I had to take a guess and make a real leap of faith, I’d say that in order to get this extension to work you have to have ColdFusion installed locally. I say this because when I install this extension it creates a folder called “Coldbox Platform Utilities” in my Coldfusion web root locally. I’m guessing that is what makes this extension really work. In adition to also having coldbox locally as well. I would imagine that without CF locally, you would get what you’re experiencing – no context menus.

    Any thoughts to installing CF 9 Developer Edition locally on your Windows 7 box? I think you’d find having it locally will help you greatly in development if it’s an option for you.

Leave a Reply