This readme contains important information about Serena Dimensions CM 14.3.2.
Last updated 20th October 2016.
Dimensions CM 14.3.2 is the version that immediately follows 14.3.1 All of the features, changes, and fixes that were made in 14.3 and 14.3.1 are included in 14.3.2.
Dimensions CM 14.3.2 supports new installations—you do not need to install a previous version of CM before installing this version.
All the new features are described in detail 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, helps you find the information you are looking for and is available online.
The following documents have been extensively rewritten and simplified:
You can watch videos of Dimensions CM features online.
Contact Serena Support at the following web site: http://www.serena.com/support
Detailed information about supported platforms and software configurations is available on the Supported Platform Matrix.
Information regarding third-party software copyrights and license information is available from Serena Support.
Serena recognizes that virtualization technology provides significant utility and value to our customers. As such, Serena conducts functional testing and certifies our products using virtualization technology in addition to native environments. While Serena expects that our products will function properly when running on supported platforms in a virtualized environment as well as a native environment, there may be functional and performance limitations. Serena will not require customers to recreate and troubleshoot every issue in a non-virtualized environment, however there may be circumstances in which such action may be required. Serena will only make this request when there is reason to believe that the virtualized environment is a contributing factor to the issue. If the issue cannot be reproduced in a supported non-virtualized environment, customers will need to refer their issues to their virtualization vendor.
Note This release contains important performance improvements.
The following features have been added in this release.
The Dimensions CM Git Connector brings central control and security to teams using Git, allowing them to store code in a CM stream. Streams can be shared by developers using Git or Dimensions CM. For details see the Dimensions CM Git Connector User's Guide.
Multiple improvements including:
Multiple improvements including:
The following features and enhancements were added in the 14.3.1 release (August 2016).
Archive, Retrieval, and Transfer (ART) Facilities, including TBO/TBI, are now supported, for details see the Dimensions CM System Administration Guide.
Note Only supported on Oracle.
If you use Dimensions Build, update your scheduler passwords as the method used to encrypt them has changed.
The following features and enhancements were added in the 14.3 release (June 2016).
Integration with Serena Deployment Automation
Eclipse IDE Integration with Apache Maven
You can now manage your team's requests, using Agile views, in Dimensions CM Pulse. Request planning enables you to:
Request planning can include:
For more information see the Pulse Help.
You can optionally install Serena Deployment Automation (SDA) and use it, instead of Dimensions Deployment, to promote or demote baselines. The benefits of using SDA include:
For details see the Dimensions CM Deployment Guide.
The following commands have been updated to support SDA:
For details see the Dimensions CM Command-Line Reference.
Dimensions CM web services have also been updated to support SDA. For details see the Dimensions CM Developer's Reference.
The integration with Docker provides a Docker Private Registry and enables you to:
For details about using the Docker integration see the Dimensions CM Docker Registry Guide.
The integration with Docker is installed and licensed separately from Dimensions CM. For details contact Serena Software.
In addition to request planning many enhancements have been made to Dimensions CM Pulse, including:
You can delegate a personal stream to another user and change ownership of the stream. For example, you are switching to a different task and want to delegate the changes in a personal stream to another user. See the Dimensions CM User's Guide.
Note
The following new command have been added to dmcli, the Dimensions CM command-line interface:
For details see the Dimensions CM Command-Line Reference.
When you authenticate against an LDAP server you can now optionally synchronize Dimensions CM groups and LDAP groups. Synchronizing groups has these advantages:
For details see Appendix A in the Dimensions CM System Administration Guide.
The CM Eclipse IDE now supports M2Eclipse providing a tight integration for Apache Maven.
HP ALM Quality Center versions 11 and 12 are now supported.
The Versioned Repository Schema (VRS) data cache is a major new performance optimization feature, first introduced in Dimensions CM 14.2.0.2. 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.
Replicator is now supported, for details see the Dimensions CM System Administration Guide.
If you are not using SSO, ALF event authentication user credentials are contained in this XML node:
\EventNotice\EventNotice\Base\User\ALFSecurity\UsernameToken
For details see Application Lifecycle Framework Events in the Dimensions CM Developer's Reference.
For details about hardware requirements see the General Scalability and Performance Guidelines in the Dimensions CM Scaling and Optimization Guide.
For full details about installing this release see these documents:
To upgrade from Dimensions CM 2009 R2 or 12.x:
To prevent issues with data that was created with a pre-14.1.x release of Dimensions CM, do the following:
The VRS upgrade retains all the existing project structure, project history, and baseline data. This avoids the need to upgrade all projects and baselines at once and ensures that an error during upgrade does not result in a loss of data. However, database size may increase dramatically as it contains both the old and new data. Before performing the upgrade Serena recommends that you increase the space allocated for PCMS_DATA by at least 50% and the space allocated for PCMS_IDX by at least 100%.
To prevent poor performance you must recompute database statistics after an upgrade. If you choose to perform a series of partial upgrades you must recompute statistics after each partial upgrade.
After all projects and baselines have been upgraded you can drop the tables containing the pre-upgrade data. Serena strongly recommends that you backup and create an export of these tables (or the entire database) before dropping them:
XII_WS_FILES
XII_WS_DIRS
XII_PSH_REQ_RELS
XII_PSH_PSH_RELS
XII_PSH XII_PREV_CHANGES
XII_PART_PART_RELS
XII_PART_ITEM_RELS
XII_MIGRATED_CHANGES
XII_ITEM_SETS
XII_DP_ITEMS_SETS
XII_BASELINE_ITEM_FILES
XII_BASELINE_ITEM_DIRS
To upgrade from previous versions of Dimensions CM 14.x, run the Dimensions CM 14.3.2 installers.
If you are upgrading a Dimensions CM installation that is already configured to use the CM Single Sign On Server (SSO), do the following.
Note The steps below are not required if the installation is configured to use Serena Business Manager as the SSO Server.
You must install Dimensions Connect for SBM when you upgrade the Dimensions CM server to a new version. For example, if you upgrade the Dimensions CM server to 14.3.2 you must also install the 14.3.2 version of Dimensions Connect for SBM. If not the integration may not work as expected. See the Dimensions CM Connect for Serena Business Manager User's Guide.
Shut down the Serena Common Tomcat before starting any Dimensions CM software upgrade. The upgrade installer is not able to perform this step so you must do it manually. If you do not shut down Tomcat, the Web archive (.war) files used by the upgraded Dimensions CM Web tools may not expand correctly, causing files to be missing from these tools.
When you stop the Dimensions Service on Windows the dmschedule and dmemail processes may continue to run for a period after the other processes have exited. Check that these processes have terminated before upgrading.
(Windows only) Check that the Microsoft Management Console is closed before starting an installation or upgrade.
If an error message is displayed during installation stating that Dimensions CM is unable to connect to the database, do the following:
If you installed and uninstalled a trial version of Araxis Merge the Dimensions CM instance of Araxis Merge can appear as not registered. Remove the expired license in the Windows registry by deleting the "SerialNumber" value under: HKEY_CURRENT_USER\Software\Araxis. The registration information provided by Dimensions CM will be used instead.
If you cannot install on Windows Server 2012R2 with Oracle 12 check that:
The installer displays incorrect messages when you upgrade from Dimensions CM 12.1 with SSO to 14.3.2 without SSO. You can ignore these messages as they do not have any impact on the installation and all files are installed correctly.
During installation and upgrade a new version of the ALF events configuration file ($DM_ROOT/dfs/alf_events_config.xml) is installed for Pulse and your customizations are overridden. Your original file is backed up and you can merge your customizations into the new version.
In Dimensions CM 14.3.2 the dmappsrv process writes directly to the local item libraries. This revised access mechanism provides performance enhancements, improved security, and server scalability. Check that the Dimensions CM Pool User has permissions to read and write to all local item library directories. To find out who is the Pool User check the value of the parameter -user in dfs/listener.dat.
To disable this behavior, in the Dimensions CM server dm.cfg file set the variable DM_DISALLOW_DIRECT_LOCAL_LIBRARY_CHECKIN to Y and restart the Dimensions listener.
Before installing on AIX, run this command to avoid hitting a memory limit:
export LDR_CNTRL=MAXDATA=0XB0000000@DSA
For dmwebservices2 web applications the connectioncache library has been replaced with the Apache Commons Pool2 library. To change the setting for the pool:
The following configuration file is no longer used: webapps\dmwebservices2\WEB-INF\classes\connectioncache.properties
Serena recommends that you backup Dimensions CM REST services before upgrading.
After the upgrade is complete:
If you are installing a CM server into a remote SQL Server, you must use an existing and pre-configured ODBC. Creating a new ODBC as part of the installation will not work.
The following features and functionality are not supported in Dimensions CM 14.3.2:
Serena Runtime RDBMS 12.1.0.2 may only be used on servers that have a maximum capacity of 2 sockets. When used with Oracle Real Application Clusters, Serena Runtime RDBMS 12.1.0.2 may only be used on a maximum of 2 one socket servers. Each Serena Runtime RDBMS 12.1.0.2 may use a maximum of 16 CPU threads at any time. When used with Oracle Real Application Clusters, each Serena Runtime RDBMS 12.1.0.2 may use a maximum of 8 CPU threads per instance at any time. The new 16 CPU thread cap is a technical limitation in the database program, not merely a contractual license limitation. Serena Runtime RDBMS 12.1.0.2 cannot utilize more than 16 threads at any time. On a typical Intel processor, each core contains 2 threads. For example, a 2- socket Intel-based server may contain two processors each having 10 cores, so the server has 20 threads in total (if hyper threading is enabled). Serena Runtime RDBMS 12.1.0.2 can utilize a maximum of 16 threads at any time.
Note This release contains important performance improvements.
For a list of all the fixes in Dimensions CM 14.3.2 see this Serena Support web page.
For a complete list of fixes in previous releases of Dimensions CM see the Serena Support Knowledgebase and select a CM version.
Microsoft Edge
Common Access Card (CAC) login is not supported with Microsoft Edge, see this KB article.
Wind River Workbench 3.3.x
Wind River Workbench version 3.3.x. does not work with this release of CM.
Solution: Use the 14.1 version of the CM plug-in instead, however it does not support the new post 14.1 CM features.
Serena Deployment Automation (SDA)
Eclipse and Maven Integration Installers
The Eclipse and Maven integration installers on Windows Server 2012 R2 may fail with the following error: Installer User Interface Mode Not Supported
Solution: run the installers in compatibility mode.
On Windows Server 2012 R2 and Windows 8.x the installers may still fail when run in compatibility mode and display this message: ZeroGu6: Windows DLL failed to load. This is caused by an incompatibility between the Java runtime embedded in the integration installers and recent versions of Windows. To resolve this problem install a 32-bit Java 7 or 8 runtime.
Dimensions CM REST Services
Dimensions CM REST services do not work correctly after upgrading. To fix this problem do the following: