Upgrade Guide v2.7.1 - Revision history

Gcronkright at 21:49, 23 September 2025

2025-09-23T21:49:50Z

Gcronkright at 18:36, 3 June 2025

2025-06-03T18:36:07Z

Gcronkright at 18:27, 3 June 2025

2025-06-03T18:27:21Z

Gcronkright: v2.7.1 Upgrade Guide

2025-06-03T18:27:00Z

v2.7.1 Upgrade Guide

New page

== Current Version ==
Follow the guide below if you are upgrading to ADF v2.7.1.

'''IMPORTANT:''' ADF 2.7.x and above requires CommonSpot 11.0.0, 10.9.1 or 10.8.3 or greater.

Before upgrading, please review the [http://community.paperthin.com/projects/ADF/docs/release-notes/Release-Notes-v2-7-1.cfm v2.7.1 Release Notes]

If you are upgrading from a version earlier than ADF v2.7.1, then please follow the guides for previous ADF versions:
* [[Upgrade_Guide_v2.7.0|2.7.0 Upgrade Guide]]
* [[Upgrade_Guide_v2.6.3|2.6.3 Upgrade Guide]]
* [[Upgrade_Guide_v2.6.2|2.6.2 Upgrade Guide]]
* [[Upgrade_Guide_v2.6.1|2.6.1 Upgrade Guide]]
* [[Upgrade_Guide_v2.6|2.6 Upgrade Guide]]
* [[Upgrade_Guide_v2.5|2.5 Upgrade Guide]]
* [[Upgrade_Guide_v2.4.1|2.4.1 Upgrade Guide]]
* [[Upgrade_Guide_v2.4|2.4 Upgrade Guide]]
* [[Upgrade_Guide_v2.3.1|2.3.1 Upgrade Guide]]
* [[Upgrade_Guide_v2.3|2.3 Upgrade Guide]]
* [[Upgrade_Guide_v2.2|2.2 Upgrade Guide]]
* [[Upgrade_Guide_v2.1|2.1 Upgrade Guide]]
* [[Upgrade_Guide_v2.0.1|2.0.1 Upgrade Guide]]
* [[Upgrade_Guide_v2.0|2.0 Upgrade Guide]]

[[Upgrade|Previous ADF Upgrade Guides]]

== Upgrade ==
Follow the steps below to upgrade the ADF directory:
# Download the ADF v2.7.0 from the [http://community.paperthin.com/projects/ADF/ Community site project page].
# On your server, rename the "/ADF/" directory to "/ADF-2.6.3/".
# Create a new "/ADF/" directory. Set up any necessary security or permissions for the new "/ADF/" directory.
# Export the download ADF zip folder into the "/ADF/" directory.
# Copy the contents of the "/ADF-2.6.3/apps/" directory into the "/ADF/apps/" directory.
# Reset the ADF through the web browser with the following URL parameter:
## ?resetADF=1

Note: If you have security permissions on the "/ADF/" directory make sure to set them up because the folder was renamed and a new "/ADF/" folder was created.

== Upgrade Cleanup ==
If you have any HF[#].cfm files from previously installed ADF HotFixes that are still in your ADF root directory (eg. "/ADF/hf4.cfm") be sure to remove them from your upgraded "/ADF/" folder.

# Reset the ADF through the web browser with the following URL parameter:
## ?resetADF=1

== Validate Upgrade ==
There are 2 methods to validate the ADF upgrade.
=== ADF Reset ===
# Reset the ADF through the web browser with the following URL parameter:
## ?resetADF=1
# The reset command will add text to the top line of the page. If you see the following text with the date/time stamp:
## ADF v2.7.0 has been reset successfully!
# Upgrade was successful and you are running the ADF v2.7.0.

=== ADF Version Output ===
# In the browser, add the following URL parameter:
## ?ADFDumpVar=application.ADF.version
# This command will output the ADF version at the top of the page. If you see the following text:
## 2.7.0
# Upgrade was successful and you are running the ADF v2.7.0.

== Post-Upgrade Steps ==

=== Update Site Level Override Components ===

* Any site level override ADF Lib components located in the "_cs_apps/lib/" folder will need to be renamed and the component "extends" updated to point to the latest version of the matching ADF Lib components.

Example: "'''_cs_apps/lib/scripts_1_1.cfc'''" needs to become "'''scripts_2_0.cfc'''" and the extends value in the component tag will need to point to "'''ADF.lib.scripts.scripts_2_0'''"

* Also make sure all CFPROPERTY "injectedBean" type="dependency" tags at the top of any other site level override ADF Lib components files are also updated to the latest versions of the ADF Lib components.

Example: <cfproperty name="data" injectedBean="'''data_1_2'''" type="dependency"> should be updated to be <cfproperty name="data" injectedBean="'''data_2_0'''" type="dependency">

=== Update Custom App Lib Component References ===
* Update any ADF Lib component references in your custom ADF Apps to the latest versions of the matching ADF 2.0 Lib components in the App's appBeanConfig.cfm file (in the root of the App directory).

Example: "addConstructorDependency(appBeanName, "'''scripts_1_2'''", "scripts"); " needs to become "addConstructorDependency(appBeanName, "'''scripts_2_0'''", "scripts");"

=== ADF Removed Resources ===
Options for resolving missing resources:
# Update the Registered Resource (or your site's code) to use the latest available version*
# Update the Registered Resource (or your site's code) to use the required version from a CDN*
# Download the required resource files and install them locally in your site and update the Register Resource or your site's code
# Copy in the missing resource files using the previous ADF version's5 thirdParty folder (be careful not to overwrite newer versions)

'''Note:''' It is recommended to use the latest available version of any third-party/external resources

=== Register ADF Scripts as CommonSpot Resources ===

* Register the ADF Script Resources with CommonSpot (for ADF 2.0 and above only!)
** Run the [[Register All Scripts|Register ALL Scripts]] tool.

'''IMPORTANT:''' The ADF thirdParty scripts libraries will not function when using ADF.scripts_2_0 loadScripts calls unless they are registered as Resources in CommonSpot 10.x.


=== Enable the CSRF Safe Mode for local ajaxProxy requests ===

* Once your site is ready Enable [[ADF AjaxProxy CSRF Safe Mode]] (for ADF 2.5 and above only!)

'''WARNING''': Enabling the "ADF CSRF Safe Mode" without installing ADF 2.5 and above compatible Apps or without updating all custom ajaxProxy local requests will greatly limit functionality!

== Related Guides ==
=== CommonSpot Registered Resources ===
* [[ADF Scripts and CommonSpot Registered Resources]]
* [[Register All Scripts|Register ALL ADF Scripts as CommonSpot Resources]]

=== ADF 2.7 and above! ===
* [[ceRecordAPI Reference|ceRecordAPI Reference]] - ADF v2.7 and CommonSpot 11 and above
* [[Privileged Module Configuration|Privileged Module Configuration]] for ceRecordAPI

[[Category: Upgrading the ADF]][[Category: How-to Guide]]

← Older revision		Revision as of 18:36, 3 June 2025
Line 1:		Line 1:
		+	Back to [[Upgrade\|ADF Upgrade]]
		+
	== Current Version ==		== Current Version ==
	Follow the guide below if you are upgrading to ADF v2.7.1.		Follow the guide below if you are upgrading to ADF v2.7.1.

@@ Line 8: / Line 8: @@
 Before upgrading, please review the [http://community.paperthin.com/projects/ADF/docs/release-notes/Release-Notes-v2-7-1.cfm v2.7.1 Release Notes]
-If you are upgrading from a version earlier than ADF v2.7.0, then please follow the guides for previous ADF versions:
+If you are upgrading from a version earlier than ADF v2.7.1, then please follow the guides for previous ADF versions:
 * [[Upgrade_Guide_v2.7.0|2.7.0 Upgrade Guide]]
 * [[Upgrade_Guide_v2.6.3|2.6.3 Upgrade Guide]]
@@ Line 28: / Line 28: @@
 == Upgrade ==
 Follow the steps below to upgrade the ADF directory:
-# Download the ADF v2.7.0 from the [http://community.paperthin.com/projects/ADF/ Community site project page].
+# Download the ADF v2.7.1 from the [http://community.paperthin.com/projects/ADF/ Community site project page].
-# On your server, rename the "/ADF/" directory to "/ADF-2.6.3/".
+# On your server, rename the "/ADF/" directory to "/ADF-2.7.0/".
 # Create a new "/ADF/" directory.  Set up any necessary security or permissions for the new "/ADF/" directory.
 # Export the download ADF zip folder into the "/ADF/" directory.
-# Copy the contents of the "/ADF-2.6.3/apps/" directory into the "/ADF/apps/" directory.
+# Copy the contents of the "/ADF-2.7.0/apps/" directory into the "/ADF/apps/" directory.
 # Reset the ADF through the web browser with the following URL parameter:
 ## ?resetADF=1
@@ Line 50: / Line 50: @@
 ## ?resetADF=1
 # The reset command will add text to the top line of the page.  If you see the following text with the date/time stamp:
-## ADF v2.7.0 has been reset successfully!
+## ADF v2.7.1 has been reset successfully!
-# Upgrade was successful and you are running the ADF v2.7.0.
+# Upgrade was successful, and you are running the ADF v2.7.1.
 === ADF Version Output ===
@@ Line 57: / Line 57: @@
 ## ?ADFDumpVar=application.ADF.version
 # This command will output the ADF version at the top of the page.  If you see the following text:
-## 2.7.0
+## 2.7.1
-# Upgrade was successful and you are running the ADF v2.7.0.
+# Upgrade was successful, and you are running the ADF v2.7.1.
 == Post-Upgrade Steps ==