Overview

Cascade Server version 6.10 is a major Cascade release that contains new features, bug fixes, and improvements.

The new features include:

• Facebook Connector
• New Velocity tools for developers and a Velocity Engine upgrade
• Cross-configuration linking to different Destination URL
• Users, Groups, and Roles Filtering
• PDF engine upgrade
• Tomcat 6 support
• File editor upgrade

Facebook Connector

Velocity Improvements

The Velocity Templating Engine has been upgraded and a number of new tools have been added to the Velocity context for use when writing Script Formats within Cascade. These tools include:

• Escape Tool - Provides methods to escape characters that are reserved in XML and other languages.
• Math Tool - Allows simple conversion from String objects to integers.
• Display Tool - Contains a wide array of utility methods related to "pretty-printing" data structures like Lists and Arrays; includes methods to aid with truncating content and also null value replacement for collections.
• Number Tool - Provides a variety of convenient formatting methods for numeric values.

See the Script Formats documentation for examples demonstrating these new tools.

Cross-configuration Linking

A new field has been added to Destinations (within Sites) that makes it possible to link to a particular configuration of a Page that lives at a different URL than the Page linking to it.  This field is called the Web URL and is applicable when the Page Configurations of a Content Type have been configured to publish to specific Destinations.  

Web URL field on Destination

Content Type Configuration to Destination Mapping where Destination has Web URL specified

The most common use case for this feature is linking to a mobile version of a Page that resides at a different domain than the full html version of that page.  Before Cascade 6.10, it was required that the mobile output for a page use a different extension than the full html version which is not an ideal solution.  In 6.10, a mobile Destination can now be given a Web URL so that links to mobile configurations will be prepended with an appropriate mobile URL.  See Link rewriting using Destination URLs for more information.

Users, Groups and Roles Filtering

The Users, Groups, and Roles tables now includes a filter box to allow you to quickly filter the Users, Groups, and Roles that appear in the table by name, email or full name.

PDF Engine Upgrade

Tomcat 6 Support

File editor upgrade

The syntax-highlighting file editor has been improved to address issues with blurriness while editing identified in Firefox, Safari, and Chrome browsers.

The editor handles larger files better though there are still some outstanding issues with loading really long files.

Issues Resolved

• [CSI-2] - EditArea is blurry in WebKit browsers (Safari 5, Chrome)
• [CSI-143] - EditArea - desynchronization problems in Firefox
• [CSI-158] - Search and Replace throws java.lang.Integer error but still updates content
• [CSI-224] - Sort log files in Administration->Logs
• [CSI-234] - Add filter box to Users, Groups, Roles interface
• [CSI-225] - Tomcat 6 Support
• [CSI-230] - Upgrade FOP to the latest version
• [CSI-229] - Linking - Allow cross-configuration links to work correctly when configs are published to different Destinations via Content Type
• [CSI-228] - Velocity - Add MathTool, NumberTool, Display Tool to the Velocity context
• [CSI-231] - Velocity - Add Escape Tool for XML escaping
• [CSI-232] - Velocity - Upgrade to 1.7
• [CSI-233] - Facebook Connector
• [CSI-166] - Last CSS style in drop down outputs extraneous comma

Web Services API

Tomcat 6 and the Installers

Tomcat 6 comes bundled with Cascade 6.10 installer packages. Upgrades using the ROOT.war file will not take advantage of the new Tomcat version. Please consider installing Cascade to a new location using one of the OS-specific packages or the ZIP package.

Due to the changes required for Tomcat 6, the "Upgrade" options was removed from the installer. When upgrading, please install Cascade to a new location and configure it to point to the existing database.

You'll need to manually apply any further customization you've made to Cascade including:

• customizations to the tomcat/conf/context.xml file not including the database configuration which is set by the installer
• customizations to the tomcat/conf/server.xml file not including the HTTP port which is set by the installer
• customizations to the tomcat/conf/web.xml file
• copying custom Asset Factory plugins, Publish Triggers, custom authentication modules from the tomcat/webapps/ROOT/WEB-INF/lib directory to the new installation folder's tomcat/webapps/ROOT/WEB-INF/lib directory

**IMPORTANT: Be sure to keep copies of the following files from existing installations on hand:

• tomcat/conf/context.xml
• tomcat/conf/server.xml
• tomcat/conf/web.xml

This will allow you to reference any modifications that may have been made for previous installs.

Running Tomcat 6 as 64-bit Service

With the addition of Tomcat 6 support, it is now possible to run Tomcat as a service in a 64-bit Windows environment.  Please see the installation guide for instructions on how to configure Tomcat in this way.

All Upgrades

Please follow every available release Upgrade Guide for every version you skipped during the upgrade.

Then, follow the standard upgrade guide.