8
Chapter 1: Migrating Applications from ColdFusion 5
5.
Install ColdFusion MX on the test computer. The Install Wizard detects the previous version
of ColdFusion and prompts you for the following:
■
Location of previous ColdFusion directory.
■
Location of CFIDE directory.
■
Whether to switch your web server from the previous ColdFusion version to
ColdFusion MX. When using this migration strategy, it’s best to switch your web server to
ColdFusion MX.
6.
Open the ColdFusion MX Administrator. When starting the ColdFusion MX Administrator
for the first time, the Configuration and Settings Migration Wizard runs.
7.
Answer the Configuration and Settings Migration Wizard questions, selecting all migration
options.
8.
Test the code in your application using the ColdFusion Code Compatibility Analyzer.
Ensure that you specify the location of any custom tags or other code outside of the
ColdFusion MX web root directory. For more information, see
“Using the ColdFusion Code
Compatibility Analyzer” on page 10
.
9.
Based on the results of the Code Compatibility Analyzer report and the incompatibilities listed
in this guide, make a migration plan. For example, you might plan to immediately fix code that
causes errors, such as
dbtype="dynamic"
in query tags, and to schedule and prioritize other
fixes, such as replacing deprecated tags and using new functionality.
10.
Make the necessary changes to your ColdFusion application and run the application on your
test computer. Ensure that you test all application features under load, not just with a few users.
If possible, use a source control system to manage these changes.
Tip:
Remove the
web_root
/cfdocs directory before moving to production.
Your application is now ready for production on ColdFusion MX.
Note:
A number of testing applications are available for download from the web. For more
information, see the Support section of the Macromedia website (
www.macromedia.com/support
).
Migration strategy using built-in web server
If your environment does not multiple computers for development, testing, and staging. You can
install ColdFusion MX directly on a staging or production computer and use the built-in web
server to test your application in co-exist mode. Adapt the following suggested steps to fit your
needs:
1.
Study the ColdFusion MX Migration section of the Macromedia website
(
www.macromedia.com/go/cfmxmigration
) and this migration guide to anticipate the
compatibility issues that might affect your system.
2.
Install ColdFusion MX on your staging or production computer. Do not configure an external
web server; select the built-in web server instead.
3.
Run the Configuration and Settings Migration Wizard to complete the installation. If
ColdFusion 5 is already installed on the computer, the wizard will migrate your settings to
ColdFusion MX.
