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.
- Migrate via Car files
- 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
· Save the file and restart ColdFusion Service.
After restarting the service, you will get the migration wizard. Follow the on-screen instructions to continue.