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:
- Download the ColdBox Platform Utilities zip file from ColdBox website.
- Make sure you have ColdFusion installed – in my case I have it installed as a Multiserver.
- Open up CF Builder (currently version 1.x)
- 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.
- 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.
- Click the Server icon (first one on left) to Add a Server
- Some helpful suggestions:
Server Name: Localhost (your choice)
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.)
- Click Next and make changes to Local Server Settings
Server Home: /Applications/JRun4
Document Root: /Library/WebServer/Documents (my default, yours may vary)
- Click Finish
- Your Console window should show something like this:
[localhost]:(02/26 at 10:38:17) Server is available. Getting server settings.
- Open up your Extensions tab (also at the bottom – if not visible use the menus Window > Show View > Other… > Extensions)
- Click the + (plus) icon, first one on left to add new extensions from archive files (a .zip)
- Navigate to where you downloaded the ColdFusionPlatformUtilities.zip file, select it and click Open.
- The installation wizard should kick and present you with the Extension Installation Wizard dialog box.
- Click Next
- Accept the terms, and click Next
- Select your newly or already added server from Select Server drop-down
- Your ColdFusion web root and install location should already be pre-entered which is your default web location for that CF server. Click Next.
- It should tell you the extensions are ready to be installed with Install Summary, Click Finish.
- You should get an Installation Successful message.
- You should now see the Coldbox Platform Extensions in the extensions panel for Localhost.
- 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.
- Begin coding 😉