Adobe
Sign in Privacy My Adobe

Rerunning the ColdFusion MX Configuration and Settings Wizard

Adobe Community Help


Products Affected

Contact support

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

Keywords: tn_19373

This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™ and Facebook posts are not covered under the terms of Creative Commons.

Legal Notices   |   Online Privacy Policy

Products

Download

Support & Learning

Buy

Company

Choose your region

Copyright © 2013 Adobe Systems Incorporated. All rights reserved.

Terms of Use | Privacy | Cookies

Reviewed by TRUSTe: site privacy statement