CMS 9.0 Release Notes

Release Summary

Ingeniux CMS 9.0 includes more than 1,000 updates. Learn more about key enhancements and important upgrade information below.

Build Number


Key Enhancements

  • Visual Page Builder
  • Visual Form Builder
  • Standard InSite Search in DSS
  • Global variables
  • Inline/Embedded Components
  • In-Context Edit anywhere
  • Internal user management
  • REST/JSON and SOAP web services APIs
  • .NET 4.5 native API
  • Embeded NoSQL repository

Important Information

Page Builder Requires Responsive Framework CSS/JS Inclusion

Ingeniux Page Builder requires your template (XSLT or MVC) to include the CSS of the responsive framework you have selected (Bootstrap 3.x by default). Existing responsive templates may have these files inlcuded already. To enable Page Builder, nonresponsive sites can add them to create columnar layouts within a fixed-width design; however, the Bootstrap or Foundation framework CSS may affect the how nonresponsive sites render.

Visual Form Builder Does Not Support Visually Defining Conditional Fields

The Visual Form Builder is included with CMS 9.0 by default, but it doesn't include support for conditional fields through the visual editing feature.

Generation Upgrade vs Standard Upgrade Wizard

Ingeniux CMS 9.0 has two different upgrade wizards. The CMS Site Generation Upgrade wizard copies an existing CMS 8.0 site; sets up a new CMS 9.0 instance; and migrates the content and the DSS Preview project from CMS 8.0 to CMS 9.0, leaving the original CMS 8 site untouched. (Learn more about this wizard in the CMS 9.0 Upgrade Guide.) The Site Upgrade Wizard upgrades from a previous CMS 9.0 version to the current version, similar to CMS 8.0.

Pre-Upgrade to CMS 8 Required For Earlier Versions

Customers using Ingeniux CMS 7.5 or earlier must first run the CMS 8.0 upgrade wizard before proceeding with a CMS 9.0 generation upgrade. Learn more in the CMS 9.0 Upgrade Guide.

Software Requirement Changes

ASP.NET 4.5 is now required. Because this framework doesn't support Windows Server 2003 and IIS 6.0, they are no longer supported for CMS 9.0. In addition, Ingeniux CMS 9.0 only supports 64-bit versions of each operating system when more then one configuration is available. Learn more in the Ingeniux CMS hardware and software requirements.

MVC 5 Allowed Syntax Changes

The Microsoft MVC 5 update no longer allows the @ symbol Razor syntax to be used within an existing @{ } braced Razor code block. Essentially, no nested @ statements are allowed. A compiler message may appear in the DSS Preview window indicating there is a syntax error in your view.

Hardware Requirement Changes

Ingeniux CMS now requires a minimum of 4 CPUs and 4 GB of RAM. The new version is multithreaded and will speed up if the recommended 8 CPU cores and 8 GB RAM are provided. Learn more in the Ingeniux CMS hardware and software requirements.

RAM Usage Behavior Change

Similar to Microsoft SQL Server, the embedded NoSQL database used in CMS 9.0 reserves system RAM for potential future use, so the total memory allocated to Ingeniux CMS 9.0 processes is higher than it was in CMS 8.0.

Multiple CMS 9.0 Versions Side by Side Now Supported

Each CMS site instance runs its own version or build of Ingeniux CMS 9.0, so installing a new CMS 9.0 version on the server doesn't affect any previously installed instances. 

Version 8.0 and Version 9.0 Side By Side Supported

All CMS 9.0 instances are unaffected by any existing CMS 8.0–based installations.

Visual Studio 2012 or Higher Required for .NET Developers

Since CMS 9.0 uses ASP.NET 4.5, all .NET development work requires Visual Studio 2012 or higher to edit and compile a DSS Preview or DSS project.

ASP.NET and MVC Automatic Upgrade and Rebuild Process for DSS and DSS Preview

The CMS 9.0 Generation Upgrade wizard now automatically attempts to recompile the DSS Preview Visual Studio project and update it to ASP.NET 4.5 and MVC 5. It returns information on the success or failure of the upgrade and recompilation. Recompiling manually, as was required with CMS 8.0, is stil supported.

The CMS Site Upgrade used for CMS 9.0–to–CMS 9.0 build upgrades also updates and recompiles the DSS projects.

Internet Access Required

All CMS- and DSS-supporting libary updates are delivered using the Microsoft NuGet packaging system, which downloads from the Internet. A DSS or DSS Preview upgrade and/or rebuild will fail without Internet access.

CMS Extensions/Customization Project

All CMS extension customization points—custom hooks, custom tabs, custom workflow actions, etc,—are now managed in a single Visual Studio project that has full debugging support. Learn more in the "How To" article for the CMS 9.0 Dev Harness project.

Custom Hook and Custom Tab Migration

The APIs in CMS 9.0 have been migrated to a .NET 4.5 format using C# instead of the JScript used in CMS 8.0 and earlier. The Custom Hooks file is still in the /Custom folder. It is now a .CS file instead of a .INC file and uses C# instead of JScript. The CMS 9 CSAPI is publicly documented, and the metaphors are very similar to those in CMS 8.0 and earlier, but the syntax is slightly different due to the change in language.

Custom hooks and tabs from CMS 8.0 and earlier won't cause errors in CMS 9.0 because they are disabled during migration until they have been syntatically updated to the CMS 9.0 format.

Devleoper training is available through the Ingeniux 430 API training course. Ingeniux 360 customers can get immediate coding assistance from Ingeniux site implementation engineers. Ingeniux Professional Services is available to assist other clients who don't have internal staff to perform the update. Please contact Ingeniux Support or your account manager if you need training or assistance.

XML Folder and Asset Storage Locations Changed

The XML folder is now located at \CMSPath\App_Data\xml. Individual xID files are, by default, no longer written to disk until publish. Each xID now has a property that allows it to be "serialized" to disk from the database if your CMS or site implementation relies on reading physical files from disk (not recommended).

Publish Folder Location Changed

The publish folder is now located at \CMSPath\App_Data\pub instead of being a child of the XML folder location. The published XML files in CMS 9.0 are identical to those in earlier versions.

Log File Locations Changed

All CMS log files are now located in \CMSPath\App_Data\LogFiles. The history.log file has been replaced with a unified audit trail.

Adobe Flash Required For Mass Upload

Adobe Flash 10+ is required for the mass upload features in CMS 9.0. Users without Adobe Flash have single-file upload capability. Future updates will move to HTML5 upload to match Ingeniux Cartella.

Legacy Publish Deprecated

The only publishing process availalbe in CMS 9.0 is the Dynamic Publish system introduced in CMS 8.0. The legacy publishing capability from CMS 8.0  was removed due to lack of use, performance, and standards compatability. All CMS 8.0 customers use Dynamic Publish.

MSXML 6 Upgrade May Require Minor Template Changes

XSLT templates that call JScript extension functions that internally use MSXML 4.0–specific Prog IDs will need to be updated to use the MSXML 6.0 Prog ID. The XSLT engine in CMS 9.0 is now 64 bit, and there are no 64-bit versions of MSXML 4.0.

Internal User Database

CMS 9.0 has an internal user store in the NoSQL repository for users and instances that do not have Active Directory or LDAP access. During site instance setup, a new administrative login and password are created for configuration purposes.

Who Should Upgrade

All Ingeniux CMS 8.0 customers on any service release can upgrade to CMS 9.0 without an intermediate upgrade. Clients with extensive custom hooks or custom tabs should carefully evaluate the level of effort required to migrate the JScript to C# syntax. Customers on CMS 7.5 and earlier must first temporarily upgrade to CMS 8.0 before continuing to migrate to CMS 9.0.

Ingeniux CMS OnDemand customers will be contacted by Ingeniux Support regarding the schedule for their OnDemand UAT and upgrade.

Upgrade Guidelines

To upgrade to CMS 9, follow these steps:

  1. Review the Ingeniux CMS System Requirements.
  2. Review the Ingeniux CMS 9.0 Installation Guide and/or CMS 9.0 Upgrade Guide .
  3. Contact Ingeniux Support to request a CMS 9.0 product key if you do not have one already.
  4. Configure a test environment with CMS 9.0 using a replica of the CMS 8.0 XML content.
  5. Create a new site in the test environment using the CMS and DSS Site Setup wizards. See the Installation Guide for details on how to do this.
  6. Run the CMS Generation Upgrade Wizard in the test environment to upgrade the site content to the latest version of Ingeniux CMS.
  7. Evaluate the site implementation in CMS 9.0 within the test environment.
  8. Perform a full publish and set up a DSS site in the test environment to evaluate the latest version's DSS features.
    1. In most cases, DSS upgrades are now peformed automatically by the upgrade wizard with CMS 9.0. Customers upgrading their MVC template sites can also continue to manually update the Ingeniux API DLL in their Visual Studio project, build the DSS site, and deploy the new files to the DSS code location. See the MVC knowledge base article describing these steps.
  9. Implement the CMS 9.0 upgrade in the production environment following the same process.

Ingeniux Support is available to work with your organization to determine the optimal plan and time frame to upgrade to the CMS 9.0 release.

License Key

Customers who upgrade must update a new license key specific to CMS 9.0. Please contact Ingeniux Support at 1.877.299.8900 or to request a new product key.

More Questions

Please contact Ingeniux Support at 1.877.299.8900 or with any questions regarding CMS 9.0.