Migrating CF Admin settings from ColdFusion 9 or 10 to ColdFusion 11

Since we have been getting lot of calls/queries around migration these days, I thought it would make sense to make a blog post on it. Now, since Migration is a very broad subject we need to keep in mind the Technology, Hardware, Operating System, Settings, Application Server, Web Server, Code compatibility.

In this article we will discuss 2 ways on how to migrate CF Admin settings from ColdFusion 9 or 10 to ColdFusion 11.

  1. Migrate via Car files
  2.      Migrate via migration wizard

Migrate via Car files:

ColdFusion archive files (.car) files can be generated and deployed only if both the version of ColdFusion are in enterprise edition. Out of all the differences between standard and enterprise edition, one of them is that you cannot create a .car file in standard edition (but note that generation of car files IS now available in ColdFusion 11 standard edition).

So, if you have ColdFusion 9 (or 10) Enterprise edition and ColdFusion 11 Standard or Enterprise edition you can migrate via these method. If you need to migrate from Coldfusion 9 Standard, see the final section, "Migrate via migration wizard".

To export your CF9 Admin settings (in ColdFusion 9 Enterprise), in the ColdFusion 9 admin page please go to packaging and deployment >> ColdFusion Archives. In the ColdFusion archives page you will find two options

         ·         Deploy an Existing Archive

         ·         Create an Archive

Now, since we are creating the archive file we will select create an archive option. On the Archive name option let us give a name say “test” and click on create. Once the archive is created it will be listed under Current Archive Definition List. In the actions bar please click on the pen icon (refer to the image below):


When you click on the icon, a pop up page will open up where you can select all the settings that you want to migrate (refer to the image below)

After you select all the required settings you can click on close window button. After closing the pop up window, let us click on the build archive button (refer to the image below)


When we click on that button, a pop up page opens up where it gives you a summary of the selected settings (refer to the image below)

Please select next after you have reviewed the settings. In the next page, we will be asked to select the .car file. Now, let us create a folder in say “C” drive and name it test. Now, inside the folder let us create a file with extension .car . Let us name it migrate.car. Now, in the page let us browse to the that folder and click on okay and add the file name, the path should look like C:/test/migrate.car (refer to the image below)

Now, let us click on next and we should get a popup message saying “Build Successful” (refer to the image below). 

Click on okay and close the window. Now, let us go to ColdFusion 11 admin page and go to the same place that is  packaging and deployment >> ColdFusion Archives. Let us remember that we have already created the .car file and now we need to deploy it. So we will work on the first option that is deploy an existing archive. Click on the bowser server option and browse to the migrate.car file which we have created earlier. (Refer to the image below)

After entering the path click on deploy button and a pop up window will appear. Click on next and the next page will give you the option to deploy and it will specify the Deploy Locations as well (Refer to the image below)

Once you click on the button deploy, you will get a pop up message saying Deploy successful (Refer to the image below)


When you get the above message you have deployed the .car file successfully and with it migration from ColdFusion 9 to ColdFusion 11.


Migrate via migration wizard

In case you have a ColdFusion 9 (or 10) Standard installation and are moving to ColdFusion 11 on the same server, then you need to modify the adminconfig.xml within ColdFusion. The location for adminconfig.xml is ColdFusion11cfusionlib

Now, if we are trying to migrate from ColdFusion 9 to ColdFusion 11, please follow the below mentioned steps:-

        ·         Navigate to adminconfig.xml for ColdFusion 11 and open it with text editor.

        ·         Change the value from “false” to “true” at


                          <Runmigrationwizard>false</runmigrationwizard> and


        ·         Save the file and restart ColdFusion Service.

After restarting the service, you will get the migration wizard. Follow the on-screen instructions to continue.



11 Responses

  1. This is a bit limp. The hard part of migrating CFML apps between versions isn’t using the UI to migrate the settings, it’s dealing with the code incompatibilities that one hits between versions. Especially when moving from JRun to Tomcat, and possibly Java version differences too (config tweaks etc)

    What would be a *useful* blog article would be to do a case study of migrating an actual application’s code.

    What you’ve written here is basically just CFAdmin documentation.


  2. It’s not “inconvenience” Sandip, it’s just despair. Every time one of your team demonstrates how sloppy you lot are, it just paints ColdFusion as just that wee bit more of a circus act. Each occurrence in itself is not so significant, but taken as a whole, your team is a bit farcical when it comes to your professionalism.

    You guys really seriously need to get your collective acts together and go out of your way to just do a thorough and professional job of everything you do.

    Every time you do some work, you need to actively ask yourself “is this a thorough professional job? Or is this just our typical sloppiness?” And answer the question *honestly*, and then follow through accordingly.

    Speaking for this current exercise here: how did you decide that the way you presented that article originally was sufficiently polished to publish on the official ColdFusion Blog? That’s a serious question. How? And how did the editor of the blog decide it was OK too? How was it perceived to be good enough?


  3. It’s harsh, but he’s right. We always take a step back and make sure everything we churn out is top notch, you all should do the same.

    Just a prespective .net has an entire website of everything on their language. ColdFusion has a blog with an interface that looks like it was scrapped together in 2 seconds. Whoever made your CF admin panel UI, should have been consulted on this blog.

Leave a reply