Accessibility

ColdFusion Release Notes

ColdFusion MX 6.1 Updater

Release Notes Part 3 - Installing ColdFusion MX for the First Time and Uninstalling the Update

August 23, 2004

This document is the third part of the ColdFusion MX 6.1 Updater Release Notes. It describes how to install ColdFusion MX 6.1 and immediately apply the update, and how to uninstall the update and revert to ColdFusion MX 6.1

Contents of Part 3

Installing a New ColdFusion MX Configuration with the Update

Uninstalling the Update

Other Parts of the Release Notes

Part 1 -- Known Issues, Changes, and Installation Instructions

Part 2 -- ColdFusion MX 6.1 Issues Fixed in this Release

Note: In these Release Notes, cf_root refers to the directory where ColdFusion MX is installed or deployed. By default, you install the ColdFusion MX server configuration in C:\CFusionMX on Windows and /opt/coldfusionmx on UNIX. You deploy the ColdFusion MX J2EE configuration in a directory that depends on the application server.

Installing a New ColdFusion MX Configuration with the Update

The ColdFusion MX 6.1 installer does not include the update; therefore, Macromedia recommends that when you install ColdFusion MX 6.1, you immediately install the update. Use the following procedures to install a new copy of the ColdFusion MX 6.1 with the update.

Installing a New Server or JRun 4 Configuration with the Update

Use the following procedure to install ColdFusion MX 6.1 and the update if you are using the server configuration or if you are installing ColdFusion MX with JRun 4. Do not use this procedure if you already installed JRun 4.

To install a ColdFusion MX server configuration or ColdFusion MX with JRun 4 and the update:

  1. Install ColdFusion MX 6.1, as described in Installing and Using ColdFusion MX. On the Install Configuration page, select the ColdFusion Server option or the J2EE Configuration (ColdFusion MX with JRun 4) option.

    Note: Ensure that you complete the installation and configuration process, including running the Configuration and Migration wizard.

  2. If you installed ColdFusion MX 6.1 using the J2EE Configuration (ColdFusion MX with JRun 4) option, install the JRun 4 update as described in the Macromedia JRun Hot Fix Main Page.
  3. Install the ColdFusion MX 6.1 update as described for your configuration in Part 1 -- Known Issues, Changes, and Installation Instructions of these Release Notes.

Installing a New Non-JRun 4 J2EE Configuration with the Update

Use the following procedure to install ColdFusion MX 6.1 and the update on a non-JRun J2EE server.

To install ColdFusion MX with the Update as a J2EE Application:

  1. Follow the initial instructions in the Installing an EAR file or WAR files section of Installing and Using ColdFusion MX to create an EAR file or WAR file containing the ColdFusion MX J2EE application. Do not deploy the EAR file or WAR files.
  2. Install the update as described in Part 1 -- Known Issues, Changes, and Installation Instructions of these Release Notes. This step updates the cfusion.ear or cfusion.war file that you created in step 1.
  3. Follow the instructions in the Installing an EAR file or WAR files section of Installing and Using ColdFusion MX to deploy your EAR file or WAR files on your J2EE server and configure ColdFusion MX 6.1.

Back to Contents

Uninstalling the Update

Use the following procedures to uninstall the ColdFusion MX 6.1 update and revert to the original ColdFusion MX 6.1 installation.

Note: If you use ColdFusion MX 6.1 server configuration with any web server except the built-in web server that comes with ColdFusion MX, you must follow the steps in the Resetting Web Server Connectors section before uninstalling the update.

Resetting Web Server Connectors

If you are using ColdFusion MX 6.1 server configuration with any web server other than the built-in web server that comes with ColdFusion MX, you must reset the web server connectors before you uninstall the ColdFusion MX update.

To reset the web server connectors:

  1. Use the updated wsconfig.jar to uninstall the current connectors, as follows:

    In Windows:

    cf_root\runtime\jre\bin\java -jar cf_root/runtime/lib/wsconfig.jar -v -uninstall

    On UNIX:

    cf_root/jre/bin/java -jar cf_root/runtime/lib/wsconfig.jar -v -uninstall
  2. Replace the updated wsconfig.jar with the original JAR file in the backup folder (cf_root\cumulative_hotfix_bkup\runtime\lib\wsconfig.jar).
  3. If you use the connector with Microsoft IIS web server, shut down IIS and delete the cf_root\runtime\lib\wsconfig\jrunwin32.dll file.
  4. To reinstall the original connectors, use one of the scripts supplied with ColdFusion MX in the cf_root/bin/connectors directory, or see the latest ColdFusion MX Release Notes.

Back to Contents

Uninstalling the Update from a ColdFusion MX Server Configuration in Windows

This section explains how to uninstall the update from a ColdFusion MX server configuration in Windows.

To uninstall the ColdFusion MX update from Windows:

  1. Stop the following services, if they are running:

    ColdFusion MX Application Server

    ColdFusion MX ODBC Agent

    ColdFusion MX ODBC Server

    Windows Management Instrumentation

  2. Move all of the files in the backup folder for the update, cf_root/cumulative_hotfix_bkup, to their original locations, replacing the updated files. The file locations in the backup folder directory tree correspond to their locations relative to the cf_root directory.
  3. Delete the ColdFusion MX generated class files from the cf_root\wwwroot\WEB-INF\cfclasses directory.
  4. Restart the services that you stopped in step 1. You might also have to restart your web server.

Uninstalling the Update from a ColdFusion MX Server Configuration on UNIX

This section explains how to uninstall the update from a ColdFusion MX server configuration from a UNIX platform.

To uninstall the ColdFusion MX update from UNIX:

  1. Stop ColdFusion MX with the following command:
    /cf_root/bin/coldfusion stop
  2. Move all of the files in the backup folder for the update, cf_root/cumulative_hotfix_bkup, to their original locations, replacing the updated files. The file locations in the backup folder directory tree correspond to their locations relative to the cf_root directory.
  3. Delete the ColdFusion MX generated class files from the cf_root/wwwroot/WEB-INF/cfclasses directory.
  4. Restart ColdFusion MX with the following command:
    /cf_root/bin/coldfusion start

    You might also have to restart your web server.

Back to Contents

Uninstalling the Update from ColdFusion MX on JRun 4 in Windows

This section explains how to uninstall the update from ColdFusion MX 6.1 installed on JRun 4 in Windows.

To uninstall the ColdFusion MX update from Windows:

  1. If you run any of the following run as a Windows service, stop them:
    • The JRun server on which the ColdFusion MX instance you are updating runs. If you selected the J2EE Configuration (ColdFusion MX with JRun 4) option when you installed ColdFusion MX 6.1, and have not deployed ColdFusion MX on additional instances of the JRun server, this is the cfusion server.
    • ColdFusion MX ODBC Agent.
    • ColdFusion MX ODBC Server.
    If the JRun server on which ColdFusion MX 6.1 is deployed does not run as a Windows service, use the JRun Launcher or JRun Management Console to stop the JRun server on which ColdFusion MX runs.
  2. Move all of the files in the backup folder for the update, cf_root\WEB-INF\cfusion\cumulative_hotfix_bkup directory tree to their original locations, replacing the updated files. Each file's location in this directory tree reflects the original file's location relative to the cf_root\WEB-INF\cfusion directory, with the exception of the wwwroot subdirectory, which contains files in their location relative to the cf_webroot directory.
  3. Delete the ColdFusion MX generated class files from the cf_root\WEB-INF\cfclasses directory.
  4. Restart the services and JRun servers that you stopped in step 1.

Uninstalling the Update from ColdFusion MX on JRun 4 on UNIX

This section explains how to uninstall the update from ColdFusion MX running on a JRun 4 J2EE server on a UNIX platform.

To uninstall the ColdFusion MX update from UNIX:

  1. Use the JRun Management Console or JRun Launcher to stop the JRun server (typically, the cfusion server) on which ColdFusion MX runs.
  2. Move all of the files in the backup folder for the update, cf_root/WEB-INF/cfusion/cumulative_hotfix_bkup directory tree to their original locations, replacing the updated files. Each file's location in this directory tree reflects the original file's location relative to the cf_root/WEB-INF/cfusion directory, with the exception of the wwwroot subdirectory, which contains files in their location relative to the cf_webroot directory.
  3. Delete the ColdFusion MX generated class files from the cf_root/WEB-INF/cfclasses directory.
  4. Restart the JRun server for ColdFusion MX.

Uninstalling the Update on a Non-JRun ColdFusion MX J2EE Configuration

To uninstall the ColdFusion MX update from a ColdFusion MX 6.1 J2EE configuration other than JRun 4 and revert to your original installation of ColdFusion MX 6.1, follow steps 1, 2, 5, and 6 of the Installing the ColdFusion MX 6.1 Update on J2EE configurations procedure. In step 5, use the original cfusion-ear or cfusion-war file that you first used to deploy ColdFusion MX 6.1 on your J2EE server. If you did not keep a copy of the original ColdFusion MX 6.1 cfusion.ear or cfusion.war file, (the updater saves them as cfusion.ear_original or cfusion.war_original) use step 3 of the procedure before you do step 5, and use the resulting cfusion.ear or cfusion.war file in step 5.

Back to Contents

Part 1 -- Known Issues, Changes, and Installation Instructions

Part 2 -- ColdFusion MX 6.1 Issues Fixed in this Release

Top Support Topics

 

More ColdFusion Topics

Choose a category to see more topics.

Request Support

 

Additional ColdFusion Resources

 

ColdFusion Downloads

 

Outside Resources

 

Feedback

 

Community