Accessibility

ColdFusion Release Notes

ColdFusion MX 7 Updater

Release Notes Part 2 - Installing the ColdFusion MX 7 Updater

September 12, 2005

This document is the second part of the Macromedia ColdFusion MX 7 Updater Release Notes. It provides information about how to install the ColdFusion MX 7 Updater. Part 1 contains information about ColdFusion MX 7 Updater.

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

Contents of Part 2

Installing a New ColdFusion MX 7 Configuration with the Updater

The Updater includes two types of installation:

  • ColdFusion 7.0.1 - Full ColdFusion MX 7 installation kit, including all updates. To download the full installation kits, go to the the Macromedia site.
  • ColdFusion 7.0 Updater - ColdFusion MX 7 Updater kit, includes updates only. You can download the Updater from Updaters page of the ColdFusion Support Center. These release notes describe how to use the Updater installation.

Note: Because of the size of the file you download to install ColdFusion MX 7.0.1 ,you should confirm that the download was successful. One indication of an unsuccessful download is the message that tells you to select a different location to install ColdFusion. To verify the download, obtain the checksum values from the Macromedia site, and then run an MD5 checksum utility. If you are installing on a UNIX system, there is an MD5 checksum untility called md5sum included with the operating system. If you are installing on a Windows system, there are a number of MD5 checksum utilities available for downlaod. To find an MD5 checksum utility, use Google to search for "md5 checksum utility windows."

Back to Contents

Updating an Existing ColdFusion MX 7 Installation

When you update an existing ColdFusion MX 7 installation, you update one of the following:

Updating a ColdFusion MX 7 server configuration on Windows

This section explains how to install the ColdFusion MX 7 Updater on a server configuration on a Windows platform. Read the Installation Notes before you install the update.

To install the ColdFusion MX 7 Updater on Windows:

  1. Close any applications that are currently running on your computer.
  2. If you are running the server configuration, stop the following services:
    • ColdFusion MX 7 Application Server
    • ColdFusion MX 7 Search Server
    • On Windows Server 2003 systems only: Windows Management Instrumentation
    • If you use IIS as your web server for ColdFusion MX: World Wide Web Publishing Service
    • If you use a web server other than IIS or the ColdFusion MX built-in web server:
      the web server
  3. Run CFMX_70_Updater_windows.exe. The Install Wizard starts.
  4. Follow the instructions in the wizard. Select the Server Configuration option on the Configure Installer page. Respond as appropriate to all other options; for example, specify the location of the ColdFusion MX 7 installation that you are updating and the location of the CFIDE directory. Let the installer run to completion.

    Note: If you use IIS as your web server and do not shut it down in step 3, ColdFusion attempts to shut down each site individually and restart it after installing the Updater. If you have large numbers of sites, this might take a long time.

  5. After the Pre-Installation Summary page of the wizard, the Updater copies updated files to your computer and upgrades any configured web server connectors.
  6. After the installation is complete, ensure that any services that you stopped in step 2 are running; restart them if they are not running.

Back to Contents

Updating a ColdFusion MX 7 server configuration on UNIX

This section explains how to install a ColdFusion MX Updater on a Server Configuration on UNIX. Read the Installation Notes before you install the update.

Note: These instructions use the general term cfmx_updater_file to refer to the Updater file. The specific Updater filename depends on the operating system, as follows:

Linux CFMX_70_Updater_linux.bin
Solaris CFMX_70_Updater_solaris.bin

To install the ColdFusion MX 7 Updater on UNIX:

  1. Log in as root.
  2. Stop ColdFusion MX by using the following command:

    /cf_root/bin/coldfusion stop

  3. Stop the ColdFusion Search service by using the following command:

    cf_root/bin/cfmxsearch stop

  4. Stop your web server.
  5. Using the cd command, go to the directory with the Cold Fusion MX7 Updater file.
  6. Ensure that the Updater file owner has full permissions and all others have read and execute permissions.
  7. Start the installation by using the following command:

    ./cfmx_updater_file

    The installation program starts.

  8. Follow the instructions in the Install Wizard. Select the Server Configuration option on the Configure Installer page. Respond as appropriate to all other options; for example, specify the location of the ColdFusion MX 7 installation that you are updating.
  9. After the Updater program finishes, ensure that your web server has restarted; if not, restart it manually.
  10. Start ColdFusion MX 7 by using the following command:

    /cf_root/bin/coldfusion start

  11. Start the ColdFusion Search service by using the following command:

    /cf_root/bin/cfmxsearch start

Back to Contents

ColdFusion MX 7 server configuration installation notes

In the following notes, cf_webroot refers to the directory that contains the ColdFusion MX 7 CFIDE directory. This directory is typically the active web server's root document directory. For example, for the ColdFusion MX 7 internal web server, this directory is cf_root/wwwroot. If ColdFusion MX 7 uses another web server, such as Microsoft IIS or Apache, the directory might have a different path. You specify the location of this directory in one of the Updater installation program steps.

  • The Updater writes the following information files to the cf_root directory:
Macromedia_ColdFusion_MX _7_Updater_InstallLog.log
Log file that provides installation details, including the files that installed.
cfmx_updater_installer_debug.txt Detailed debugging information, which can be useful for Macromedia Technical Support.
  • The Updater checks for the existence of the following files before installing the Updater. If any of these files is missing, the Updater reports an error and does not install the update.
On Windows cf_root\bin\cfstart.bat
cf_root\lib\cfusion.jar
cf_root\lib\bcel.jar
cf_webroot\CFIDE\administrator\Application.cfm
On UNIX cf_root/bin/coldfusion
cf_root/lib/cfusion.jar
cf_root/lib/bcel.jar
cf_webroot
/CFIDE/administrator/Application.cfm
  • The Updater puts copies of the original versions of all files that it updates in the cf_root/updater_backup directory tree. Each file's location in this directory tree reflects the original file's location relative to the cf_root directory.

    Caution: If you reinstall an update that has already created backup files, the installation overwrites the original backup files, and you lose the original release versions of the files. If you must reinstall the update, copy the backup files to a place outside the updater_backup directory before you reinstall.

  • The Updater automatically upgrades all configured web connectors. In some cases, you might have to upgrade all configured connectors independently of the Updater; for example, following installation of a security patch. To upgrade the connectors on Windows, run cf_root\bin\connectors\Upgrade_all_connectors.bat. On UNIX or Linux run cf_root/bin/connectors/upgrade_all_connectors.sh. The script takes no arguments.

Back to Contents

Updating a ColdFusion MX 7 multiserver configuration on Windows

This section explains how to install the ColdFusion MX 7 Updater on a multiserver configuration on a Windows platform. Read the Installation Notes before you install the update.

Notes:

  • Updating the multiserver configuration updates the cfusion JRun server and all JRun servers that contain ColdFusion MX.
  • Updating the multiserver configuration includes JRun 4 updater 5 plus selected hot fixes. For more information on updating JRun 4, see the Macromedia JRun Hot Fix Main Page.
  • If you are updating ColdFusion MX 7 on Windows XP with SP2 installed, read Technote 19518 for information on using ColdFusion MX7 with Windows Firewall enabled.
  • The ColdFusion MX 7 Updater tries to update ColdFusion server instances in the jrun_root/servers directory. However, if the ColdFusion server instances are outside the jrun_root/servers directory, the ColdFusion MX 7 Updater does not update them.

To install the ColdFusion MX 7 update on Windows:

  1. Close any applications that are currently running on your computer.
  2. If you run any of the following as a Windows service, stop them:
    • The cfusion JRun server and all instances of JRun that run the ColdFusion MX 7 application
    • ColdFusion MX 7 Search Server
    • On Windows Server 2003 systems only: Windows Management Instrumentation
    If the JRun server on which ColdFusion MX 7 is deployed does not run as a Windows service, use the JRun Launcher, JRun Management Console (JMC), or command line to stop the JRun server on which ColdFusion MX 7 runs.
  3. Run CFMX_70_Updater_windows.exe. The Install Wizard starts.
  4. Follow the instructions in the wizard.
    1. On the Configure Installer page, select the Multiserver Configuration option.
    2. On the Configure ColdFusion MX 7 page, specify the location of JRun.
    3. On the next page, specify the location of the CFIDE directory.
    4. Let the installer run to completion.
  5. After the Pre-Installation Summary page of the wizard, the Updater copies updated files to your computer.
  6. After the installation is complete, restart the services or JRun servers that you stopped in step 2.

Back to Contents

Updating a ColdFusion MX 7 multiserver configuration on UNIX

This section explains how to install the ColdFusion MX 7 Updater on a multiserver configuration running on UNIX. Read the Installation Notes before you install the update.

Notes:

  • Updating the multiserver configuration updates the cfusion JRun server and all JRun servers that contain ColdFusion.
  • Updating the multiserver configuration includes JRun 4 updater 5 plus selected hot fixes. For more information on updating JRun 4, see the Macromedia JRun Hot Fix Main Page.

These instructions use the general term cfmx_updater_file to refer to the Updater file. The specific filename depends on the operating system, as follows:

Linux CFMX_70_Updater_linux.bin
Solaris CFMX_70_Updater_solaris.bin

To install the ColdFusion MX 7 update on UNIX:

  1. Log in as root.
  2. Use the JRun Management Console, the JRun Launcher, or the command line to stop the instance of JRun that runs the ColdFusion MX 7 application that you are updating.
  3. Stop the ColdFusion MX 7 Search Server.
  4. Using the cd command, go to the directory with the Cold Fusion MX Updater file.
  5. Ensure that the Updater file owner has full permissions and all others have read and execute permissions.
  6. Start the installation by using the following command:

    ./cfmx_updater_file

    The installation program starts.

  7. Follow the instructions in the wizard.
    1. On the Configure Installer page, select the Multiserver Configuration option.
    2. On the Configure ColdFusion MX 7 page, specify the location of the JRun 4 directory that you are updating. The wizard default value is the default location that the ColdFusion MX 7 installer uses (/opt/jrun4).
    3. Specify the location of the CFIDE directory.
    4. Let the installer run to completion.
  8. After the Pre-Installation Summary page of the wizard, the Updater copies updated files to your computer.
  9. Use the JRun Management Console, the JRun Launcher, or the command line to start the JRun servers that have been updated.

Back to Contents

ColdFusion MX 7 multiserver configuration installation notes

These notes use the following pathnames:

The directory name cf_root refers to the directory that contains your ColdFusion MX 7 WEB-INF directory. This directory is typically jrun_root\servers\server_name\cfusion-ear\cfusion-war, where server_name is normally cfusion.

The directory name cf_webroot refers to the directory that contains the ColdFusion MX 7 CFIDE directory. This directory is typically the active web server's root document directory. For example, for the default multiserver configuration using the ColdFusion MX 7 internal web server, this directory is the same as jrun_root\servers\server_name\cfusion-ear\cfusion-war. If ColdFusion MX 7 uses another web server, such as Microsoft IIS or Apache, the directory has a different path. You specify the location of this directory in one of the Updater Install Wizard steps.

The Updater writes the following information files:

Macromedia_ColdFusion_MX _7_Updater_InstallLog.log Log file that provides installation details, including the files installed. Saved in the jrun_root directory.
cfmx_updater_installer_debug.txt Detailed debugging information, which can be useful for Macromedia Technical Support. Saved in the jrun_root directory.

The Updater checks for the existence of the following files before installing the update. If any of these files are missing, the Updater reports an error and does not install the update.

On Windows cf_root\WEB-INF\cfusion\lib\cfusion.jar
cf_root\WEB-INF\cfusion\lib\im.jar
cf_webroot\CFIDE\administrator\Application.cfm
cf_webrootCFIDE\adminapi\Application.cfm
On UNIX cf_root\WEB-INF\cfusion\lib\cfusion.jar
cf_root\WEB-INF\cfusion\lib\im.jar
cf_webroot\CFIDE\administrator\Application.cfm
cf_webrootCFIDE\adminapi\Application.cfm

The Updater puts copies of the original versions of all files that it updates in the cf_root\WEB-INF\cfusion\updater_backup directory tree. 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.

Caution: If you reinstall an update that has already created backup files, the installation overwrites the original backup files and you will lose the ColdFusion MX 7 release versions of the files. If you must reinstall the update, copy the backup files to a place outside the updater_backup directory before you reinstall.

Back to Contents

Updating a ColdFusion MX 7 J2EE configuration

This section explains how to install the ColdFusion MX 7 Updater on a system that is running the ColdFusion MX 7 J2EE configuration. It applies to all operating systems and all application servers.

Important: You must perform the full 7.0.1 installation to create the updated EAR or WAR file. If you perform an update installation on your existing EAR or WAR file, the update installer overwrites your web.xml file.

When updating the J2EE configuration, you completely redeploy an updated ColdFusion application. For the Updater, you must save your settings, run the full installer, deploy the EAR or WAR file, and reapply your settings.

Note: These instructions refer to the ColdFusion MX 7 J2EE deployment instructions for your application server. For more information, see Deploying ColdFusion MX 7 on J2EE Application Servers. The "Supported J2EE application servers" section includes links to the appropriate installation instructions for supported J2EE servers. The "Unsupported application servers for the archive install" section includes links to installation instructions for additional servers.

To install the update on ColdFusion MX 7 J2EE configurations, you perform the following tasks:

  1. Save your ColdFusion MX 7 application and configuration files.
  2. Undeploy your ColdFusion MX 7 application from your J2EE server.
  3. Install an updated ColdFusion MX 7 7 EAR or WAR file.
  4. Redeploy the new ColdFusion MX 7 EAR or WAR file on your J2EE server.
  5. Update the Verity Search Server.
  6. Restore your ColdFusion MX 7 configuration using the files you saved in task 1.

The following sections provide detailed descriptions of each of these tasks.

Task 1: Save your ColdFusion MX 7 application and configuration files

To save your ColdFusion MX 7 information, create a ColdFusion Archive (CAR file) by performing the following steps:

  1. Save your ColdFusion license number.
  2. Open the ColdFusion MX Administrator and go to Packaging and Deployment > ColdFusion Archives.
  3. Create a new archive and run the Archive Wizard.

Alternatively, you can back up files manually:

  • If your web root is under the cf_root directory, back up the files or directories that you have put in your web root. Do not back up the cfdocs, CFIDE, META-INF, or WEB-INF directory.
  • If you added custom tags, CFX files, CFC files, applets, or any other custom files in directories under the cf_root directory, save copies of these files. Review the ColdFusion MX Administrator Mappings, Java Applets, CFX Tags, and Custom Tag Paths pages to check for files that need to be backed up. For example, the directories such as the following might contain files that require backing up:

    cfusion\cfusion.ear\cfusion.war\WEB-INF\jsp
    cfusion\cfusion.ear\cfusion.war\WEB-INF\cfusion\cfx
    cfusion\cfusion.ear\cfusion.war\WEB-INF\cfusion\CustomTags

  • Back up the following ColdFusion MX 7 configuration files in the cf_root\WEB-INF\cfusion\lib\ directory:

    All neo-*.xml files
    license.properties

  • Back up anything you added to the cf_root\WEB-INF\cfusion\gateway\ directory.

Task 2: Undeploy your ColdFusion MX 7 application

Undeploy your ColdFusion MX 7 application using your J2EE server's application or server undeployment procedure.

  1. Stop the Verity Search Server.
  2. As appropriate for your application server, either stop the ColdFusion application and RDS application (if it is running), or stop the application server.
  3. Undeploy your ColdFusion MX 7 J2EE enterprise application, or the ColdFusion MX 7 web application and the RDS application (if it is installed) from your application server, by using the standard undeployment procedure for your J2EE server. For server-specific ColdFusion MX 7 deployment instructions, see the links on the lower part of the page of Deploying ColdFusion MX 7 on J2EE Application Servers.

Task 3: Install an updated ColdFusion MX 7 EAR or WAR file

For the Updater only: When updating the J2EE configuration, you must install a completely updated EAR or WAR file using the version 7.0.1 full installation kit.

To perform the 7.0.1 full installation:

  1. Start the 7.0.1 full installation and follow the instructions in the wizard.
  2. On the Configure Installation page, select the J2EE configuration (EAR/WAR file) option.
  3. On the summary page, click the Install button.
    The installer creates an EAR or WAR file that contains ColdFusion MX 7 with all updates.

Task 4: Redeploy an updated ColdFusion MX 7 application

Follow the normal deployment procedure for your J2EE server. Server-specific instructions for deploying ColdFusion MX 7 are available in Deploying ColdFusion MX 7 on J2EE Application Servers.

Note: The server-specific instructions assume that you are deploying ColdFusion MX for the first time. Undeploying the ColdFusion application does not remove JVM settings, so you do not have to do the JVM configuration steps described in these instructions.

Task 5: Update the Verity Search Server

See Updating a Stand-alone Verity Search Server later in these Release Notes.

Task 6: Restore your configuration

Use the following procedure to restore your ColdFusion MX 7 configuration after you deploy the updated EAR or WAR file.

  • If you created a CAR file:
    1. Open the ColdFusion MX Administrator and click System Information.
    2. Enter your ColdFusion MX 7 serial number and click Submit Changes.
    3. Select Packaging and Deployment > ColdFusion Archives.
    4. Under Deploy an Existing Archive, specify the location of the CAR file that you saved in task 1, and click Deploy.
  • If you backed up files manually:
    1. Ensure that your ColdFusion MX 7 web application is not running. Depending on your J2EE server, stop either the J2EE server or the ColdFusion web application.
    2. Copy the files that you saved in task 1 back to their original locations.
    3. Restart your J2EE server or ColdFusion application.

Installing ColdFusion MX 7 Updater on Mac OS X

This section describes how to install the server configuration, the multiserver configuration, and J2EE configuration on Mac OS X.

Note: To install ColdFusion MX 7 Updater on Mac OS X, you must have full machine “administrative” privileges; otherwise, permission errors occur during installation, and the installation does not complete successfully.

Installing the server configuration on Mac OS X

To install the ColdFusion MX 7 Updater server configuration on Mac OS X:

  1. Close any applications that are currently running on your computer.
  2. Stop your web server.
  3. Go to the location where you downloaded the ColdFusion MX 7 Updater installer.
  4. Unpack the ZIP file to get the cf_install.app file.
  5. Ensure that you have read access to the cf_install.app file.
  6. Double-click cf_install.
  7. Follow the instructions in the installation wizard.
    Note: In addition to the required information listed in Installing and Using ColdFusion MX 7, you must enter the current user password for the computer on which you are installing the Updater.

Note: If you try to open the ColdFusion MX Administrator just after installing ColdFusion MX 7 Updater, and see an Error 500, you should wait a few seconds, and then refresh the page.

Installing the multiserver configuration on Mac OS X

To install the ColdFusion MX 7 Updater multiserver configuration on Mac OS X:

  1. Close any applications that are currently running on your computer.
  2. Stop your web server.
  3. Go to the location where you downloaded the ColdFusion MX 7 Updater installer.
  4. Ensure that you have read access to the cf_install.app file.
  5. Double-click cf_install.
  6. Follow the instructions in the installation wizard.
    Note: In addition to the required information listed in Installing and Using ColdFusion MX 7, you must enter the current user password for the computer on which you are installing the Updater.

Note: If you try to open the ColdFusion MX Administrator just after installing ColdFusion MX 7 Updater, and see an Error 500, you should wait a few seconds, and then refresh the page.

Installing the J2EE configuration on Mac OS X

To install the ColdFusion MX 7 Updater J2EE configuration on Mac OS X:

  1. Close any applications that are currently running on your computer.
  2. Stop your web server.
  3. Go to the location where you downloaded the ColdFusion MX 7 Updater installer.
  4. Ensure that you have read access to the cf_install.app file.
  5. Double-click cf_install.
  6. Follow the instructions in the installation wizard.
    Note: In addition to the required information listed in Installing and Using ColdFusion MX 7, you must enter the current user password for the computer on which you are installing the Updater.
  7. Ensure that you select J2EE configuration and select EAR file or WAR file, depending on how you want to deploy ColdFusion.
  8. Ensure that the Start ColdFusion on system init option is not selected.
  9. After the installation wizard completes, you deploy ColdFusion MX 7 to your application server. For more information, see Deploying ColdFusion MX 7 on J2EE Application Servers.
  10. Log in to the Configuration wizard by browsing to http://machinename/CONTEXT_ROOT/CFIDE/administrator/index.cfm.
    Note: If you try to open the ColdFusion Administrator just after installing ColdFusion MX 7 Updater, and see an Error 500, you should wait a few seconds, and then refresh the page.

Note: When using ColdFusion MX 7 in J2EE Configuration on Mac OSX 10.3.x, some server environments may encounter the following error:
Apple AWT Java was loaded on first thread -- can't start AWT. Unable to initialize graphing service: java.lang.InternalError: Can't start the AWT because the Java was started on the first thread. Make sure StartOnFirstThread is not specified in your applications Info.plist or on the command line.
To resolve this problem with the graphing service, add the following JVM argument to the end of the JVM argument list in the JVM configuration file:
-Djava.awt.headless=true
When using JRun 4, the JVM configuration file is located in the $JRUN_HOME/bin directory as jvm.config. The line to configure begins with java.args=. When finished, the jvm.config file entry for java.args ends in -Djava.awt.headless=true, and look similar to the following example:
# Arguments to VM
java.args=-server -Xmx512m -Dsun.io.useCanonCaches=false
-XX:MaxPermSize=128m -XX:+UseParallelGC
-DJINTEGRA_NATIVE_MODE -DJINTEGRA_PREFETCH_ENUMS
-Dcoldfusion.rootDir={application.home}/../
-Dcoldfusion.classPath={application.home}/../lib/updates,
{application.home}/../lib,{application.home}/../gateway/lib/,
{application.home}/../wwwroot/WEB-INF/cfform/jars
-Dcoldfusion.libPath={application.home}/../lib
-Djava.awt.headless=true

Updating a Stand-alone Verity Search Server

This section explains how to update a stand-alone Verity Search Server. You typically use a stand-alone Verity Search Server when running the J2EE configuration, however, you might also use a stand-alone Verity Search Server in the server and multiserver configurations to run it on a separate computer.

To update a stand-alone Verity Search Server:

  1. Download the stand-alone Verity installer from the Verity Search Packs section of the Macromedia site.
  2. Run the stand-alone Verity installer, specifying the location of your existing Verity Search Server directory.
If you created any collections using ColdFusion MX 7, Macromedia recommends that you do one of the following:
  • Recreate the collections
  • Edit the collectionname/style/style.dft files by commenting out the filter line, so it appears as follows:

            zone-begin: PrimaryDoc
      field: DOC
      # /filter="universal"
      field: CF_BODY
      # VDK will attempt to autorecognize BODY content if we use this
      #   /filter="universal"
      zone-end: PrimaryDoc

Note: You change the collection style files to improve performance when indexing custom data. Any collections that you create after you install ColdFusion MX 7 Updater use the updated style files and exhibit the associated performance improvement.

Back to Contents

Uninstalling the Updater

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

Note: If you use ColdFusion MX 7 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.

You uninstall the Updater from one of the following configurations:

Resetting web server connectors

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

To reset the web server connectors:

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

    On 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, stop 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 7 in the cf_root/bin/connectors directory, or see the latest ColdFusion MX 7 Release Notes.

Back to Contents

Uninstalling the Updater from a ColdFusion MX 7 server configuration on Windows

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

To uninstall the ColdFusion MX 7 update from Windows:

  1. Stop the following services, if they are running:
    • ColdFusion MX 7 Application Server
    • ColdFusion MX 7 Search Server
    • Windows Management Instrumentation
  2. Move all of the files in the backup folder for the update, cf_root/updater_backup, 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 7 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 Updater from a ColdFusion MX 7 server configuration on UNIX

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

To uninstall the ColdFusion MX 7 update from UNIX:

  1. Stop ColdFusion MX 7 by using the following command:

    /cf_root/bin/coldfusion stop

  2. Stop ColdFusion Search service by using the following command:

    /cf_root/bin/cfmxsearch stop

  3. Move all of the files in the backup folder for the update, cf_root/updater_backup, 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.
  4. Delete the ColdFusion MX 7 generated class files from the cf_root/wwwroot/WEB-INF/cfclasses directory.
  5. Restart ColdFusion MX 7 by using the following command:

    /cf_root/bin/coldfusion start

  6. Restart ColdFusion Search server by using the following command:

    /cf_root/bin/cfmxsearch start

  7. You might also have to restart your web server.

Back to Contents

Uninstalling the Updater from a ColdFusion MX 7 multiserver configuration on Windows

This section explains how to uninstall the update from ColdFusion MX 7 installed on the multiserver configuration on Windows.

To uninstall the ColdFusion MX 7 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 7 instance that you are updating runs. If you selected the Multiserver Configuration option when you installed ColdFusion MX 7, and you have not deployed ColdFusion MX 7 on additional instances of the JRun server, this is the cfusion server.
    • ColdFusion MX 7 Search Server.

    If the JRun server on which ColdFusion MX 7 is deployed does not run as a Windows service, use the JRun Launcher, the JRun Management Console, or the command line to stop the JRun server on which ColdFusion MX 7 runs.
  2. Move all of the files in the backup folder for the update, cf_root\WEB-INF\cfusion\updater_backup 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 7 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 Updater from a ColdFusion MX 7 multiserver configuration on UNIX

This section explains how to uninstall the update from ColdFusion MX 7 running on the multiserver configuration on a UNIX platform.

To uninstall the ColdFusion MX 7 update from UNIX:

  1. Use the JRun Management Console, the JRun Launcher, or the command line to stop the JRun server (typically, the cfusion server) on which ColdFusion MX 7 runs.
  2. Move all of the files in the backup folder for the update, cf_root/WEB-INF/cfusion/updater_backup 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 7 generated class files from the cf_root/WEB-INF/cfclasses directory.
  4. Restart the JRun server for ColdFusion MX 7.

Uninstalling the Updater on the J2EE configuration

To uninstall the ColdFusion MX 7 update from a ColdFusion MX 7 J2EE configuration and revert to your original installation of ColdFusion MX 7, follow steps 1, 2, 5, and 6 of the Updating a ColdFusion MX 7 J2EE configuration procedure. In step 5, use the original cfusion-ear or cfusion-war file that you first used to deploy ColdFusion MX 7 on your J2EE server.

If you did not keep a copy of the original ColdFusion MX 7 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

Uninstalling the Updater on Mac OS X

To uninstall the ColdFusion MX 7 Updater from a server configuration or a multiserver configuration on the Mac OS X platform:

  1. Stop the ColdFusion server.
  2. Run the cf_root\uninstall\uninstall.app application.

Top Support Topics

 

More ColdFusion Topics

Choose a category to see more topics.

Request Support

 

Additional ColdFusion Resources

 

ColdFusion Downloads

 

Outside Resources

 

Feedback

 

Community