I wish everyone a very happy and prosperous new year. Here comes the first blog post for the year 2015, on ColdFusion Buider 3. A user came across our Mobile Application Development Contest blog and was trying to develop his application using ColdFusion Builder 3, but he wasn’t able to setup a connection between ColdFusion 11 and ColdFusion Builder 3.  He was trying to create a “Remote Server” connection between ColdFusion Builder 3 and ColdFusion 11, installed on separate servers (distributed setup). 

Here are the steps that will help you setup a remote host with ColdFusion Builder:-

1.     Launch ColdFusion Builder 3 and choose your workspace.

2.     Right-click on the “CF Servers” view and select Add Server

3.    Select “New server configuration” and click “OK”. You can choose “Import configurations from RDS server”, in case you have RDS server setup already and want to use existing server information.

CF Server

4.     If you can’t locate the CF Servers, then, follow the screenshot below, to enable it.

CF Server alternate

Refer to Add a remote server and fill in the details for your server.

5.     General Settings

a)     Server Name: ColdFusion server name.

b)     Description: (optional) Description of the server.

c)     Application Server: Select the drop-down list and select CF+ Tomcat Bundle (for CF10/CF11)

d)     Host Name: Name of the remote server host.

e)     Select: Is Remote.

Note: When you enter a Host Name other than localhost or, Is Remote is automatically selected.

f)     Webserver Port: Specify the port number of the remote ColdFusion server instance you are configuring. You can refer server.xml for the same at \ColdFusion11\cfusion\runtime\conf\.

g)     RDS User Name: (optional) if you are using RDS, specify the RDS user name.

h)      RDS Password: (optional) Specify the RDS password.

General Settings

Click Next to move to the next screen.

6.     Remote Server Settings

a)     User Name: Specify the CF Admin username.

b)     Password: Specify the CF Admin password.

Remote Server Settings

Click Next to move to the next screen.

7.     Install Extensions

Select Install Extensions to install the extensions that are packaged with ColdFusion Builder.

a)     Browse and select the ColdFusion web root location.

b)     Browse and select the ColdFusion web root location on the remote ColdFusion server.

c)     Browse to a location within the web root to install the extensions. The extensions are installed in the Extensions directory within the selected location.

Install Extensions

8.    Click Finish to add the remote ColdFusion server instance. You can right-click on the remote server and access the ColdFusion Administrator of the remote server.

Launch CF Admin

This blog post talks about, the minimal settings required to setup a remote server for CF Builder. You can skip the Install Extensions section as well.

Note: - While configuring the remote server in CF Builder, ensure that, you are able to access/ping the remote ColdFusion server outside builder. You can probably, access the remote CF Admin in the browser, for e.g. http://ip:port/CFIDE/Administrator/index.cfm and ensure connectivity.



33 Comments to “Setting up ColdFusion Builder 3 with a remote server”

  1. Steve W
    You might want to fix the typo in the note...index.cfm NOT index.com
  2. Anit Kumar Panda
    @Steve, Corrected. Thank You.
  3. David Belanger
    Happy 2015 to you too Anit!

    Just to let you know, from August 23rd to the 25th, 2014 I spoke with Rohit Negi to log this bug:

    When you restart CFB3, you lose your saved Remote Servers. Not the local ones, just the remote ones. He verified the bug.

    Unfortunately, this bug has not been fixed and so all users will have to repeat your instructions above every time they want to use the remote server.

    Most of us use remote servers and so I think you can see that this bug needs immediate attention. Please feel free to contact me (or Rohit) to show you in person.
  4. Anit Kumar Panda
    @David,This issue is fixed in the latest installer available at www.adobe.com. Can you check the build number (Help>>Product Details), in your CFB3. If it is not 292483, then, you need the latest installer on your server. Please let me know, if it's not working with the latest setup.
  5. David Belanger
    Thanks Anit, you were correct, I didn't have the latest build. I wasn't told I needed to re-install. I was waiting for the update to be released. It's working now!
  6. Raymond Camden
    Is it worth mentioning that - generally - RDS isn't recommended for production servers? You mentioned remote, not production, so it is entirely possible a user wants to hit a remote dev server, but I'd probably remind folks anyway. ;)

    Also - step 7 - can CFB *really* do the extension install to a remote machine?
  7. Anit Kumar Panda
    @Ray, RDS is not recommended on Production server, that is why, I mentioned Remote (and not Production, as you said).

    Regarding Step 7, yes, you can install "extensions" on remote machine. The location would change from C:\ColdFusion11\cfusion\wwwroot to \\server-name\c$\ColdFusion11\cfusion\wwwroot. You can use the IP instead, as well.
  8. Raymond Camden
    Can I recommend updating the screen shot in 7 to show that? Also, are the files placed via RDS, or must you have a network share for that to work? They look like network shares to me and while a user may have RDS and FTP access, they may not have that.
  9. Anit Kumar Panda
    I will replace the screenshot to show that. That's a good point indeed. The files are definitely placed via RDS. You don't need a N/w share. The only requirement, as mentioned as last NOTE is that, you should able to access/ping the remote ColdFusion server outside builder.
  10. Raymond Camden
    Interesting, so the same syntax used for network shares works for RDS in this context? Is that documented anywhere? Would a user know they could even do this? That's why I started asking about it because I had assumed it would be an issue. Does this work elsewhere in CFB or just here?
  11. Colin
    I'm having trouble getting this to work in CFB3 and a remote server. I suspect that it is due to the fact that I cannot access the built-in tomcat server directly, but must go to http://myhostname.dev/CFIDE/administrator/index.cfm (port 80). I'm using IIS 7.0. Any suggestions as to how I can put in the proper hostname and port to get RDS working?
  12. Anit Kumar Panda
    @Colin, as you have disabled the built-in server, you can still access CF remotely via the port on which the site is running. In your case, the Webserver Port would be 80. Let me know, in case you face any issue
  13. Anit Kumar Panda
    @Sana, Can you provide us more info around your issue? Are you not able to setup the "remote server"? In that case, are you able to connect to CF admin of the remote server outside CF builder.
  14. Ken Bench
    Your article explains everything very well. Lately I'm having trouble find the right post that explains the very important parts of <a href="http://www.lionleaf.com/blog/coldfusion-a-faster-development-platform/">ColdFusion</a>;. Thank you for sharing it here. By the way, how can I put properly the hostname to the port and get it working with RDS? Appreciate it!
  15. Anit Kumar Panda
    @Ken, Can you contact cfinstal<AT>adobe<DOT>com with your query and detailed environment description and we will assist you further.
  16. Web Application Development India
    Awesome This is great Screen shot Tutorial.. useful information Thanks for sharing..
  17. John Nessim
    Thank you for this post. I reached here while looking for a solution for my local CF11 on CF Builder 3 and found it on 5c.
  18. Ray
    Can you talk about the best way to configure the local and remote path mappings? (Used for preview and debugging). I don't necessarily want to manually map a drive to the IIS web root.
  19. Ted Daniels
    I am trying to get PhoneGap going and cannot figure out how to set up defaultLocal on my laptop - can you do a similar writeup for defaultLocal? I have plenty of remote servers running but defaultLocal eludes me!
  20. Anit Kumar Panda
    @Ted, our team is already in touch with you and assisting you.
  21. David
    I was trying to get a remote cf11 instance installed but ran into issues with the RDS service reporting 404 errors. Turns out I had disabled RDS during the initial CF install. Simply enabling RDS in the Cfadmin does not fix the problem. I had to reference this very old article https://helpx.adobe.com/coldfusion/kb/disabling-enabling-coldfusion-rds-production.html instructing to uncomment the RDS servlet code in web.xml. After doing so and restarting CF I was able to see all RDS databases and files. Others may need to know this. The blog should probably be updated with this tip as well. FYI, I am running in a win2008/IIS/Cf11 environment. Also, editing live files via mapped drive was incredibly slow. Editing files via RDS much faster.
  22. Anit Kumar Panda
    David, Someone from our team will reach out to you.
  23. Cynth
    I had the same issue as David where I had to uncomment out the RDS servlet code in the web.xml file after enabling RDS. Mine is still not working, however. I am using a remote server and if I go directly to the rds ide.cdm url, I get a 405. Help?
  24. David Belanger
    This may not be your issue but if you're running on Linux with Apache, you'll need to create a folder called "main" within your CFIDE directory as well as create a dummy file (can be empty) in that directory called "ide.cfm". Without it, Apache trumps CF and immediately returns a not found error.

    On most default installations, that will be found in

  25. Cynth
    Thank you, David. I tried your idea but no dice. If I try to navigate to ip/cfide/main/ide.cfm, I get a 405 error (page cannot be displayed). I've updated my CFBuilder software to the latest build. I am on CF11 and using cfbuilder 3. Any other ideas?
  26. David Belanger
    Case sensitivity comes to mind (especially with CFIDE in caps then /main/ide.cfm in lowercase.

    Another idea, If you're using a local virtual machine (like Oracle's Virtual Box), make sure all CF ports are properly mapped like (for example): 5005, 5500, 8500, 8575, 8789, 8983, 8985
  27. Cynth
    All lowercase. How would I map those/check that they are mapped properly?
  28. David Belanger
    If you're testing with the browser, CFIDE should be in uppercase, not lowercase.

    As for the ports, I use vagrant to create my development server and I've set up my "vagrantfile" to map my local ports to my VM. Here's the link https://www.vagrantup.com/docs/networking/forwarded_ports.html

    Also, and I probably should have asked this first, did you log into the CFAdmin > Security > RDS and ensure that "Enable RDS Service" was checked and that you're Using the correct username and password as specified in that section? If it's a "Single password only", your username is "admin"
  29. Cynth
    Thank you. I've checked and rechecked. RDS is enabled. I may set it to no pw and see if that helps. My feeling is that I have the port(s) wrong someplace.
  30. Cynth
    And yes, I have tried http://ip:port/CFIDE/main/ide.cfm with the proper case :) I put a test html file in the main folder and I was able to access that via the browser without issue (http://ip:port/CFIDE/main/test.html). My port..is port 80.

    Note that I am getting a 405 (can't display) error for ide.cfm, not a 404 (not found). I really appreciate you helping me with this.
  31. David Belanger
    Another shot in dark and then I'm afraid I'm out of ideas on this one; Are your main/ide.cfm permissions the same as the rest of the CFIDE folders and files?
  32. Charlie Arehart
    Cynth, I think you're closer to your solution than you think. You're SUPPOSED To get a 405 if you browse that URL in a browser. It's not meant to be browsed (which does a GET). It's designed to reject GET requests.

    The RDS feature within editors like CF Builder, Dreamweaver, and the old ColdFusion Studio don't send GETs.

    So in your #23, when you say you did the uncomment and thinks were "not working", do you mean you couldn't get to your server from within CFBuilder?

    Just know that there can be MANY reasons that you may find you can't connect to a server (local or remote) from CFBuilder, via RDS, from issues with CF (which you seem to have resolved since you get the 405), to issues with any firewall on the CF server (which the 405 indicates you're not having), to issues within CFBuilder, such as needing to create a project, then a server, and define the RDS within that server correctly.

    It's all too much to communicate in a blog comment (indeed, all this discussion might have better taken place as a forum thread), but I will note that I have addressed this in more detail in various resources, including ones about challenges setting up the CFBuilder debugger, which in fact requires RDS as well, so I cover common challenges with that and THEN go on to discuss debugger-specific challenges. Hope you may find answers among these:

    http://www.carehart.org/articles/#2010_2 (chapter from book)

    (See especially page 84, addressing common challenges)

    http://www.carehart.org/presentations/#cfb_debugger_setup (video, and PDF of notes)

    See especially pages 3-5 of the notes for RDS config and troubleshooting info.

    I should cull out the RDS-specific elements from that, and will try to do that this weekend.

    Let us know if this gets you going Cynth (or David, or others).
  33. Charlie Arehart
    Cynth, David, any thoughts in reply to my last comment? Did it help, or any problems remaining?

Leave a Comment

Leave this field empty: