Serena Dimensions CM - Important Information About this Release

This readme contains important information about the release of Serena Dimensions CM. Last updated 4th March 2016.

New FeaturesFixed IssuesSoftware CompatibilityInstalling and UpgradingKnown IssuesLimitations


New Features

All the new features described below are detailed in the Dimensions CM documentation. You can download a searchable PDF portfolio of all the documents from the Serena documentation center.

The CM Documentation Roadmap, a complete overview of the CM documentation to help you find the information you are looking for, is available online here.

What's New in


VRS data caching

Personal streams


Cherrypicking requests

Dimensions CM Pulse enhancements

Stream and project selection enhancements

Security enhancements

Desktop client user interface improvements

New dmcli commands

Updates to dmcli commands

Serena Deployment Automation

Dimensions CM Bridge enhancements

SVN migration with changesets

Agent auto update

IDE performance enhancements

RESTful API web services

Viewing execution logs


Replicator is now supported, for details see the Dimensions CM System Administration Guide.

VRS Data Caching

This release introduces a major new performance optimization feature, the Versioned Repository Schema (VRS) data cache. The Dimensions CM server pre-caches VRS data into a directory on disk. Pre-caching is automatic when a project, stream, or baseline is accessed for the first time. The main benefits of data caching are improved performance when:

The Dimensions CM administrator can manually pre-cache specific projects, streams, and baselines. For more information, and details of where data cache files are stored, see KB article S141604.

Personal Streams

Personal streams are private development branches in a repository that are only visible to the originator. Personal streams enable you to:

For more details see the Dimensions CM User's Guide.


Shelving enables you to store local changes in a personal stream and optionally remove the changes from a work area.

Shelve changes and reset a work area

You can remove changes from a work area that you do not want to deliver to the associated stream. For example, the changes are not complete but you need to interrupt your current work, set aside the changes, and switch to a different task using the same work area. After the shelving operation is complete you reset the work area so that it is identical to the latest repository content.

Backup changes

When you are sharing a stream with other developers but are not ready to deliver your local changes, you can backup your work by committing it to a personal stream. This creates a snapshot of the work area at that point in time. When creating backups you keep the local changes and do not reset the work area. When you are ready to resume work on the shelved changes you can restore them by merging the personal stream back into the work area.

For more details see the Dimensions CM User's Guide.

Cherrypicking Requests

When you merge changes between streams you can select changes that are related to specific requests. This is commonly known as cherrypicking or backporting. For example, you have delivered multiple sets of changes to a stream but only want to merge one specific set of changes into a different stream.

For more details see the Dimensions CM User's Guide.

Dimensions CM Pulse Enhancements

The following enhancements have been made to Dimensions CM Pulse:

Suites and Products

Administrators can organize development work into a hierarchy of suites and products.


There is a sidebar on the left that includes the following links:

The links displayed below the divider change based on your current location in the Pulse hierarchy.


When you select a suite, product, or stream its latest activity is displayed in the main window, including information about:


Experts are tools that perform actions on streams, such as examining health and quality, and report back measurements and findings. Experts are triggered when a delivery is made to a stream and a changeset is created. You can inspect an expert's results in an activity feed or on a review page. You can configure experts to run in a sequence, called an expert chain, and create multiple independent expert chains to run on a stream. For example, the first chain runs on every delivery and performs brief static analysis. A second chain is scheduled to run at midnight every day and performs more thorough analysis and deployment.

The following experts are included with Pulse:


Report views display measurements generated by review and expert activity in your stream as charts or tables. Reports are scoped to the suite, product, or stream from where you run them.


You can select the review notifications to which you are subscribed. Notifications are sent when an event takes place on a review, for example:

The list of review notifications is managed by your Pulse administrator.

Watch a Review

You can optionally watch a review. When changes are made to the review you are notified by email.


To refine a search you can now select multiple filters.

Review Page

Review pages include the following improvements:

Stream and Project Selection Enhancements

In the desktop client, and the Visual Studio and Windows Explorer integrations, it is now easier to find and select streams and projects. You can:

You can add streams and projects to, and remove them from, your Favorites list. Recently used streams and projects are automatically added to your Recents list.

Security Enhancements

The following security enhancements have been introduced:

Desktop Client User Interface Improvements

The desktop client user interface has had a major refresh including:

New dmcli Commands

The following commands have been added to dmcli, the Dimensions CM command-line interface:

For details see the Dimensions CM Command-Line Reference.

Updates to dmcli Commands

The following dmcli commands have been updated:

For details see the Dimensions CM Command-Line Reference.

Serena Deployment Automation

You can optionally install Serena Deployment Automation (SDA) with Dimensions CM. SDA automates software deployment, which is the process of moving software through various pre-production stages to final production. Typically, each stage represents a step of higher criticality, such as quality assurance to production. SDA helps you meet the deployment challenge by providing tools that improve deployment speeds while simultaneously improving their reliability. For more details see the Serena documentation center.

Dimensions CM Bridge Enhancements

The following enhancements have been made to Dimensions CM Bridge:

For details see the Dimensions CM Bridge Getting Started Guide.

When CM Bridge is running on Windows Server 2008, you can improve performance by adjusting the Tomcat configuration. For details see this Serena KB article:

SVN Migration with Changesets

By default Dimensions CM changesets are created from Subversion revisions. The changesets are for historical use only and cannot be used with stream versions. For example, you cannot fetch a stream version that is older than the date of a migration. Files deleted from Subversion are included in changeset history but are not migrated as Dimensions CM items. For details see the Migrating to Dimensions CM guide.

Agent Auto Update

Auto update is the process of managing the automatic update of Dimensions CM agents. Auto update has the following benefits for administrators:

For details see Configuring and Using Auto Update in the Dimensions CM System Administration Guide.

IDE Performance Enhancements

The Visual Studio integration now gets items statuses and loads data into views more quickly.

RESTful API Web Services

Dimensions CM now supports RESTful API web services. For details see the Dimensions CM Developer's Reference.

Viewing Execution Logs

To aid the traceability of deployment areas you can view the results of REXEC, deployment, and build script executions by examining the log files that are preserved in CM. For details see Executing Operations on Remote Nodes in the Dimensions CM System Administration Guide.

Fixed Issues

Software Compatibility

Installing and Upgrading

Known Issues