Upgrade Guide v2.6
From ADF Docs
Current Version
Follow the guide below if you are upgrading to ADF v2.6.
IMPORTANT: ADF 2.5 and above require CommonSpot 10.6.1 or 10.5.2 or above.
Before upgrading, please review the v2.6 Release Notes
If you are upgrading from a version earlier than ADF v2.6, then please follow the guides for previous ADF versions:
- 2.5 Upgrade Guide
- 2.4.1 Upgrade Guide
- 2.4 Upgrade Guide
- 2.3.1 Upgrade Guide
- 2.3 Upgrade Guide
- 2.2 Upgrade Guide
- 2.1 Upgrade Guide
- 2.0.1 Upgrade Guide
- 2.0 Upgrade Guide
Upgrade
Follow the steps below to upgrade the ADF directory:
- Download the ADF v2.6 from the Community site project page.
- On your server, rename the "/ADF/" directory to "/ADF-2.5/".
- Create a new "/ADF/" directory. Setup 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.5/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 then created new.
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.6 has been reset successfully!
- Upgrade was successful and you are running the ADF v2.6.
ADF Version Output
- In the browser, add the following URL parameter:
- ?ADFDumpVar=application.ADF.version
- This command with output the ADF version at the top of the page. If you see the following text:
- 2.6.0
- Upgrade was successful and you are running the ADF v2.6.
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"> updated to be <cfproperty name="data" injectedBean="data_2_0" type="dependency">
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 ADF 2.5 thirdParty folder (be careful not to overwrite newer versions)
Note: It is recommended to always 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 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 compatible Apps or without updating all custom ajaxProxy local requests will greatly limit functionality!
