Upgrade notes for 10.8 -> 10.9

General notes

The 10.9 release has a small number of changes that require special consideration for upgrade:

• Lucee restart
• Coldbox 4
• Admin interfaces that have been built with the "crudadmin" tool

Lucee restart

If you are upgrading to Preside 10.9 from previous versions, you should restart Lucee after upgrading your code to avoid various issues.

Coldbox 4

Preside 10.9 upgrades to Coldbox 4 which has some backward compatibility issues. We have provided backward compatible workarounds/polyfills for as much as possible but a single compatibility issue remains to do with Async log appenders in logbox. These appenders were removed from the coldbox codebase in favour of configuring the non-async appenders with an async=true flag and we cannot reasonably produce a workaround for this. If your applications and extensions are using any Async log appenders, they will need changing. For example:

old Config.cfc

config.logbox.appenders.syncAppender = {  class = 'coldbox.system.logging.appenders.AsyncRollingFileAppender'  , properties = { filePath=logsMapping, filename="sync.log" } } 

upgraded Config.cfc

var coldboxMajorVersion = Val( ListFirst( settings.coldboxVersion ?: "", "." ) );
if ( coldboxMajorVersion < 4 ) {  config.logbox.appenders.syncAppender = {  class = 'coldbox.system.logging.appenders.AsyncRollingFileAppender'  , properties = { filePath=logsMapping, filename="sync.log" }  } } else {  config.logbox.appenders.syncAppender = {  class = 'coldbox.system.logging.appenders.RollingFileAppender'  , properties = { filePath=logsMapping, filename="sync.log", async=true }  } } 

Admin interfaces that have been built with the "crudadmin" tool

10.9.0 Comes with a whole new system for customizing the data manager that makes the crudadmin tool redundant. If you have built admin sections with the crudadmin tool, you should add the following attribute to your object definitions to ensure no problems:

@datamanagerEnabled true