Issue

The Migration/Configuration portion of the ColdFusion MX 6.1 and ColdFusion MX 7 installations, which normally is only run the first time the ColdFusion Administrator is opened, can be run again after the install has been completed. Enabling RDS, re-installing the ODBC services, or migrating settings from a previous version of ColdFusion are reasons why you may want to run it again.

Once the initial step of installing the ColdFusion application files is completed, a second step occurs the first time the ColdFusion Administrator is accessed, as shown below. Note: This is a screenshot from a ColdFusion MX 6.1 installation but the same information applies to a ColdFusion MX 7 installation.

This Configuration and Settings Migration Wizard is the second step of the ColdFusion installation. During the configuration portion of this step, RDS can be enabled, ODBC services are installed (Windows only), and example applications and ColdFusion documentation can be installed. During the settings migration portion, server settings from a previous ColdFusion version can be migrated. If you bypass one of the options but wish to go back later and revisit the option, you can re-run the wizard by modifying the adminconfig.xml file.

Note: The example applications and ColdFusion documentation can only be installed the first time the Configuration Wizard is run; the option is not available when rerunning the Wizard. If the option is not selected the first time the Wizard is run, a full re-install is required in order to choose the option.

Solution

1. Open the adminconfig.xml file for editing. The file is located in either cf_root\CFusionMX\lib (Server configuration 6.1), cf_root\CFusionMX7\lib (Server configuration 7) orjrun_root\servers\cfusion\cfusion-ear\cfusion-war\WEB-INF\cfusion\lib (J2EE configuration).
2. Change the values to true for the steps you wish to re-run.
   To run the Configuration Wizard again, change therunsetupwizard value to true.
   To run the Settings Migration Wizard again, change therunmigrationwizard andrunmxmigrationwizard values both to true.
   
   For example, the following will cause both the Settings Migration Wizard and the Configuration Wizard to run the next time the ColdFusion Administrator is accessed:

    <?xml version="1.0" encoding="UTF-8"?><setupconfig><runsetupwizard>true</runsetupwizard><runmigrationwizard>true</runmigrationwizard><runmxmigrationwizard>true</runmxmigrationwizard></setupconfig> 

   
   Note: The Configuration Wizard (runsetupwizard) can be run on its own but if you choose to rerun the Migration Wizards, the Configuration Wizard is still launched, even when it's set to false. There is no way to prevent this.
3. Save the changes to the file.
4. Navigate to the ColdFusion Administrator in a web browser. You should now be presented with the Configuration and Settings Migration Wizard.
   
   Note: The server does not need to be restarted for this change to take effect.

Additional Information

• Disabling/enabling ColdFusion RDS on production servers
• ColdFusion MX: Manually installing and uninstalling the ColdFusion MX ODBC services

Products affected