Difference between revisions of "Upgrading ColdFusion"

From Hostek.com Wiki
Jump to: navigation, search
(Upgrading ColdFusion 10 to the latest available HotFix)
m (Step 2 - Ensure Java Bin Folder is in System Path)
 
(18 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
__FORCETOC__
 
__FORCETOC__
==Upgrading ColdFusion 10==
+
==Upgrading ColdFusion 10+==
===Upgrading ColdFusion 10 to the latest available HotFix===
+
===Upgrading ColdFusion 10+ to the latest version===
#Log into ColdFusion Administrator
+
In our experience it is most reliable to download the latest cumulative update through ColdFusion Administrator, then manually execute the update from the command line. Follow these steps to apply ColdFusion updates from the command line on your server:
#Navigate to Security-->Sandbox Security. Uncheck 'Enable ColdFusion Sandbox Security' and click 'Submit Changes'.
+
====Step 1 - Install Java if not already installed====
#Restart ColdFusion in the Services section of your VPS.
+
Your VPS may be using the built-in Java JRE bundled with ColdFusion, but it is a good idea to use a separate version of Java for installing ColdFusion updates. You may download the latest version of Java from Oracle: [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java SE Development Kit 8 Downloads]
#Log back into ColdFusion Administrator
+
#Click the Server Updates link, then click "Check for updates"
+
#When you see and available update, click Download and install. CF will notify you that CF will be restarted. At this point click OK, then open the task manager. If you see the ColdFusion.exe process stop but not start back up, manually restart the service in the Windows Services utility.
+
#Once complete, log back into ColdFusion Administrator, go to Security-->Sandbox Security - check 'Enable ColdFusion Sandbox Security' then click Submit Changes.
+
#Restart ColdFusion
+
  
===If you have not previously applied ColdFusion 10 Update 1===
+
At the download page accept the license agreement, then download the appropriate version for your operating system. Most likely, you'll want the 64-bit version for your OS. During installation, it is a good idea to only install the development tools; the source code and public JRE are not needed.<br />[[File:Jdk-options.png]]
The ColdFusion to IIS connector must be removed and re-added after applying ColdFusion 10 Update 1 (or any Cumulative Hotfix that includes Update 1. After applying HotFix 1 for ColdFusion 10, perform the following steps:
+
====Step 2 - Ensure Java Bin Folder is in System Path====
#Navigate to C:\ColdFusion10\cfusion\runtime\bin and open 'wsconfig.exe'.
+
#To check your path first open your system properties by right-clicking your VPS's '''Computer''' icon in '''Windows Explorer''', then clicking '''Propteries'''.<br />[[File:Cf10updates-01.png]]
#Remove the existing connector within the 'wsconfig' tool.
+
#In the window that opens, click the '''Advanced System Settings''' link off to the left.<br />[[File:Cf10updates-02.png]]
#Now click the 'Add' button in the 'wsconfig' tool.
+
#In the popup that appears, click the '''Environment Variables''' button toward the bottom right.<br />[[File:Cf10updates-03.png]]
#Make sure 'All' is selected as the 'IIS Web Site' then click OK. The tool will restart IIS, then you'll be able to continue using ColdFusion.
+
#In the next popup, select the '''Path''' variable under '''System Variables''', then click '''Edit'''.<br />[[File:Cf10updates-04.png]]
 +
#In the next popup, check the '''Variable value''' textbox to see if the path to a Java bin folder exists. If not, add a semicolon to the end of the line, followed by the path to your Java bin folder. For example, if you just installed Java as described above, you'd add a path like this: <pre>C:\Program Files\Java\jdk1.8.0_45\bin\</pre>[[File:Winpath.png]]<br /><br />
 +
 
 +
Once you've updated your system's PATH variable, you can click OK on all the popup windows to save your changes.
 +
 
 +
====Step 3 - Download the ColdFusion Update====
 +
#Log into ColdFusion Administrator for your server
 +
#Navigate to the '''Server Update'''-->'''Updates''' section
 +
##If you do not see an available update, click the '''Check for Updates''' button
 +
##If you see an available update, click the '''Download''' button<br />[[File:Cf10-update14.png]]
 +
#ColdFusion will download the file to '''''<cf_home>''/hf-updates/''' (eg. C:\ColdFusion10\cfusion\hf-updates)
 +
====Step 4 - Run the Update Installer====
 +
#Stop ColdFusion. This will help ensure the update will install properly.
 +
#Open a command prompt window on your server as ''Administrator''. You can do this by right-clicking on the ''CMD'' icon in the Start Menu, then choosing ''Run As Administrator''
 +
#Navigate to the location where ColdFusion downloaded your update. <br />''CF 10 Example:'' <pre>cd c:\ColdFusion10\cfusion\hf-updates</pre><br />''CF 11 Example:'' <pre>cd c:\ColdFusion11\cfusion\hf-updates</pre>
 +
#Launch your update via the following command: <pre>javaw -jar hotfix_0XX.jar</pre> (replace '''0XX''' with the actual update number)
 +
#Your CF update will be launched in a GUI. Just follow the prompts to install the update, and it will take care of the rest. If you are running a multi-instance ColdFusion server, ensure the boxes for all your instances are checked, and the updater will patch each instance automatically for you.
 +
 
 +
Once the update has completed, just log into ColdFusion Administrator and go back to the Server Updates section. If it shows the update you applied in the '''Installed Updates''' tab, your ColdFusion installation has been updated successfully.
 +
 
 +
===Post-Upgrade: Upgrade the IIS connector===
 +
The ColdFusion to IIS connector must be upgraded after applying most ColdFusion 10+ updates. After applying the latest update for ColdFusion 10 or 11, perform the following steps:
 +
#Open a command prompt as ''Administrator''
 +
#Navigate to ''<cf_home>''\cfusion\runtime\bin:<br />''CF 10 Example:''<pre>cd C:\ColdFusion10\cfusion\runtime\bin</pre><br />''CF 11 Example:''<pre>cd C:\ColdFusion11\cfusion\runtime\bin</pre>
 +
#Open 'wsconfig.exe', issuing it the upgrade parameter: <br /><pre>.\wsconfig.exe -ws iis -site 0 -upgrade -v</pre>
 +
 
 +
The tool will restart IIS, then you'll be able to continue using ColdFusion.
 +
 
 +
===ColdFusion 10 Mandatory Update===
 +
If you happen to have a server on Coldfusion 10 version 282462 or earlier, you will first need to apply the ColdFusion 10 Mandatory Update first. Follow these steps to complete the installation:
 +
#[http://download.macromedia.com/pub/coldfusion/10/cf10_mdt_updt.jar Download the JAR file] for the update from Adobe.  
 +
#On your server, open a command prompt as '''Administrator''' then navigate to the folder containing the update's JAR file.  
 +
#Launch the JAR with this command: <pre>java -jar cf10_mdt_updt.jar</pre>
 +
#Follow the installer's instructions, and the update will complete in a couple minutes.
 +
 
 +
Once the mandatory update has been installed, you'll be able to proceed through the update instructions above.
 +
[[Category:ColdFusion]]
 +
[[Category:ColdFusion-VPS]]

Latest revision as of 16:45, 3 July 2015

Upgrading ColdFusion 10+

Upgrading ColdFusion 10+ to the latest version

In our experience it is most reliable to download the latest cumulative update through ColdFusion Administrator, then manually execute the update from the command line. Follow these steps to apply ColdFusion updates from the command line on your server:

Step 1 - Install Java if not already installed

Your VPS may be using the built-in Java JRE bundled with ColdFusion, but it is a good idea to use a separate version of Java for installing ColdFusion updates. You may download the latest version of Java from Oracle: Java SE Development Kit 8 Downloads

At the download page accept the license agreement, then download the appropriate version for your operating system. Most likely, you'll want the 64-bit version for your OS. During installation, it is a good idea to only install the development tools; the source code and public JRE are not needed.
Jdk-options.png

Step 2 - Ensure Java Bin Folder is in System Path

  1. To check your path first open your system properties by right-clicking your VPS's Computer icon in Windows Explorer, then clicking Propteries.
    Cf10updates-01.png
  2. In the window that opens, click the Advanced System Settings link off to the left.
    Cf10updates-02.png
  3. In the popup that appears, click the Environment Variables button toward the bottom right.
    Cf10updates-03.png
  4. In the next popup, select the Path variable under System Variables, then click Edit.
    Cf10updates-04.png
  5. In the next popup, check the Variable value textbox to see if the path to a Java bin folder exists. If not, add a semicolon to the end of the line, followed by the path to your Java bin folder. For example, if you just installed Java as described above, you'd add a path like this:
    C:\Program Files\Java\jdk1.8.0_45\bin\
    Winpath.png

Once you've updated your system's PATH variable, you can click OK on all the popup windows to save your changes.

Step 3 - Download the ColdFusion Update

  1. Log into ColdFusion Administrator for your server
  2. Navigate to the Server Update-->Updates section
    1. If you do not see an available update, click the Check for Updates button
    2. If you see an available update, click the Download button
      Cf10-update14.png
  3. ColdFusion will download the file to <cf_home>/hf-updates/ (eg. C:\ColdFusion10\cfusion\hf-updates)

Step 4 - Run the Update Installer

  1. Stop ColdFusion. This will help ensure the update will install properly.
  2. Open a command prompt window on your server as Administrator. You can do this by right-clicking on the CMD icon in the Start Menu, then choosing Run As Administrator
  3. Navigate to the location where ColdFusion downloaded your update.
    CF 10 Example:
    cd c:\ColdFusion10\cfusion\hf-updates

    CF 11 Example:
    cd c:\ColdFusion11\cfusion\hf-updates
  4. Launch your update via the following command:
    javaw -jar hotfix_0XX.jar
    (replace 0XX with the actual update number)
  5. Your CF update will be launched in a GUI. Just follow the prompts to install the update, and it will take care of the rest. If you are running a multi-instance ColdFusion server, ensure the boxes for all your instances are checked, and the updater will patch each instance automatically for you.

Once the update has completed, just log into ColdFusion Administrator and go back to the Server Updates section. If it shows the update you applied in the Installed Updates tab, your ColdFusion installation has been updated successfully.

Post-Upgrade: Upgrade the IIS connector

The ColdFusion to IIS connector must be upgraded after applying most ColdFusion 10+ updates. After applying the latest update for ColdFusion 10 or 11, perform the following steps:

  1. Open a command prompt as Administrator
  2. Navigate to <cf_home>\cfusion\runtime\bin:
    CF 10 Example:
    cd C:\ColdFusion10\cfusion\runtime\bin

    CF 11 Example:
    cd C:\ColdFusion11\cfusion\runtime\bin
  3. Open 'wsconfig.exe', issuing it the upgrade parameter:
    .\wsconfig.exe -ws iis -site 0 -upgrade -v

The tool will restart IIS, then you'll be able to continue using ColdFusion.

ColdFusion 10 Mandatory Update

If you happen to have a server on Coldfusion 10 version 282462 or earlier, you will first need to apply the ColdFusion 10 Mandatory Update first. Follow these steps to complete the installation:

  1. Download the JAR file for the update from Adobe.
  2. On your server, open a command prompt as Administrator then navigate to the folder containing the update's JAR file.
  3. Launch the JAR with this command:
    java -jar cf10_mdt_updt.jar
  4. Follow the installer's instructions, and the update will complete in a couple minutes.

Once the mandatory update has been installed, you'll be able to proceed through the update instructions above.