This document contains important information about the 10.1.3.1 release of Serena Dimensions Express that is not included in the manuals or online help. For information about new features and defects fixed in this release, see the accompanying Release Notes.
Release 10.1.3.1 of the Dimensions Express server is targeted for users who are:
Existing users of Dimensions Express 10.1.3 server using Oracle 10g should continue to use their present systems, as this installation will provide no enhancements or fixes.
Existing users of Dimensions Express 10.1.3 server who want to continue using SQL Server 2000 should continue to use their present systems, as there is no support for SQL Server 2000 in Dimensions Express 10.1.3.1.
The Dimensions agents and clients shipped with Dimensions Express 10.1.3.1 are unchanged from those shipped with 10.1.3.
The Dimensions Express software installers (including the server, agent and client components) are available for download from the Serena Support Web site.
A general description of the activities you need to carry out for this release is contained in the Dimensions Express 10.1.3.1 Installation Guide. This guide is available in PDF format (dmexp_installation.pdf) from the Serena Support Web site.
The table below displays a high level matrix of the supported platforms. For full details see the following sections:
| Vendor | Operating System Platform | Hardware | Client | Agent | Server | Database* | Oracle Runtime | Comments |
|---|---|---|---|---|---|---|---|---|
| Microsoft | Windows Vista SP1 (32-bit, x86) | x86 IA-32 |
Y |
Business and Ultimate editions | ||||
| Windows XP Professional (32-bit, x86) | x86 IA-32 |
Y |
||||||
| Windows 2000 Professional (32-bit, x86) | x86 IA-32 |
Y |
||||||
| Windows 2003 Server, 2003 Enterprise Server SP2 (32-bit, x86) | x86 IA-32 |
Y |
Y |
Y |
O, S |
Y |
64-bit supported in 32-bit mode only | |
| Sun | Solaris 10 (64-bit, Sparc) | SPARC | Y |
Y |
* See note below | |||
| HP | HP-UX 11.31 (64-bit, IA-64) Itanium | Itanium | Y |
Y |
* See note below | |||
| HP-UX 11.23 (64-bit, PA-RISC) | PA-RISC | Y |
Y |
* See note below | ||||
| IBM | AIX 5.3L (64-bit, PowerPC) - ML 02 or later | PowerPC | Y |
Y |
* See note below | |||
| Linux | Red Hat 4.0 (64-bit, x86-64) | x86-64 | Y |
Y |
This is a 32-bit application supported on both 32-bit
and 64-bit * See note below |
|||
| SLES 9 (32-bit, x86) | Pentium (x86) | Y |
Y |
* See note below |
Key to
Database Versions |
||
|---|---|---|
| Vendor | Version |
Key |
| Oracle | Oracle 10.2.0.x |
O |
| Microsoft | SQL Server
2005 SP2 |
S |
The server components of this Dimensions Express release are supported on the platform and database combinations listed below.
Note: Dimensions Express is built and tested against Oracle 10.2.0.2 as a supplied runtime. For customers using their own Oracle installations, Serena will support Oracle 10.2.0.x
| Platform | Version | Database |
|---|---|---|
| Microsoft Windows |
|
|
** DBCS is not supported
Note: This release does not support installations where the database is remotely located from the Dimensions Server platform.
Optional: Applies if you want to provide access to the Dimensions Express web client or the Administration Console.
The list of supported Web servers includes:
Supported Web application containers:
Optional: Applies if you want to use LDAP for user authentication.
The list of supported directory servers includes:
The client components of this Dimensions Express release are supported on the platforms listed below. To use the web-based clients, you must also have a supported Web browser and Java virtual machine.
| Platform | Version | Web browser | Java plug-in |
|---|---|---|---|
| Microsoft Windows |
|
|
|
| Sun SPARC Solaris |
|
|
|
| HP-UX |
|
|
|
| IBM AIX |
|
|
|
| Red Hat |
|
|
|
| SuSE |
|
|
|
Notes:
The agent components of this Dimensions Express release are supported on the platforms listed below.
| Platform | Version |
|---|---|
| Microsoft Windows |
|
| Sun SPARC Solaris |
|
| HP-UX |
|
| IBM AIX |
|
| Red Hat |
|
| SuSE |
|
| Vendor |
Application | Integration Method |
|---|---|---|
| Borland |
|
|
| IBM |
|
|
|
|
|
| Microsoft |
|
|
|
|
|
| Sybase |
|
|
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 that customers 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.
For general details on installing this product, see the Dimensions Express 10.1.3.1 Installation Guide (dmexp_installation.pdf) on the Serena Support Web site.
Serena Software strongly recommends that the Serena Common Tomcat should be explicitly shut down before commencing any Dimensions software upgrade. Unfortunately, the upgrade installer is not able to automate this, so the person doing the upgrade must do it manually. If this is not done, then the Web archive (.war) files used by the upgraded Dimensions Express Web tools may not expand correctly, causing missing files in these tools.
On Windows platforms, it is recommended that you make sure that the Microsoft Management Console (i.e. Services, Computer Management, etc.) is closed before starting an installation or upgrade. (This is the option accessed from the Windows Control Panel, or on certain versions of Windows is part of the Control Panel Administrative Tools option.)
When running an Agent installation in console mode on UNIX platforms, you may receive the following java exception messages following the "Dimensions 10.1.3.1 - Installation Location" page:
(Nov 19, 2007 6:36:20 AM), com.installshield.dimensionsunix.event.InstallScript,
err, java.lang.ArrayIndexOutOfBoundsException: 1
java.lang.ArrayIndexOutOfBoundsException: 1
at com.installshield.dimensionsunix.event.InstallScript.onExecutingSetPa
tchVariablesec49d0ef5b1c77db445bea691d08dd70(InstallScript.java:165)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
at java.lang.reflect.Method.invoke(Method.java:324)
at com.installshield.event.ActionSequenceEngine$ActionTask.invokeJavaMethod(Unknown Source)
at com.installshield.event.ActionSequenceEngine$ActionTask.executeAction (Unknown Source)
at com.installshield.event.ActionSequenceEngine$ActionTask.run(Unknown Source)
at com.installshield.event.ThreadPool.run(Unknown Source)
at java.lang.Thread.run(Thread.java:534)
These messages can be ignored, as they will have no effect on the installation.
If during the installation, you receive an error message stating that Dimensions Express is unable to connect to the database, but it does not inform you of the reason, check the following:
For more details, see the section “Pre-Installation Tasks and Considerations” for your platform in the Dimensions Express 10.1.3.1 Installation Guide.
The Dimensions Express Windows installer will fail before loading the first window in the install wizard if there is no C: drive on the machine. To work around this problem use the subst command to create a virtual C: drive.
Some Dimensions Express installation-specific information is retained in the registry for reuse on subsequent installations. If you have removed all Dimensions Express products from your system, you may also wish to remove this registry information. To do so, backup your Windows registry, run regedit, and remove the following key and its contents:
HKEY_LOCAL_MACHINE\SOFTWARE\Serena\Dimensions\10.1
On Windows platforms there is a small possibility that the installation may not in fact have worked even though the installation has appeared to complete successfully. It is recommended that you check that the expected software is listed in the Control Panel | Add or Remove Programs window following the installation. Select the entry (e.g. Serena Dimensions CM Server 10.1.3) and click on the Click here for support information link to check the version number.
After installing Serena® Dimensions® Express 10.1.3.1, please ensure that you visit the Serena support Web site at http://support.serena.com to determine the latest patch updates for Dimensions Express 10.1.3.1, if any. This site requires first time users to register for a user name and password. Once logged into the support site, select Support | My Downloads. Next to the "Please Select Product" drop down list, you will find a link "Click here for patches". Search the list of patches to see if there are any appropriate to Dimensions Express 10.1.3.1. If there are any such patches, it is recommended that you download them together with the associated patch readme and apply them. Each patch download includes the patch binary, an integral patch installer, and the associated patch readme that includes instructions for running the patch installer.
If you have performed an upgrade installation of Dimensions Express, and you will be using the VM Migration, there are some adjustments that are needed to the process model before using the migration tool. There is a script that you can run using the dmpmcli command that will perform the necessary update.
The script is named ExpressVMMigration.js and is located in:
%DM_ROOT%\AdminConsole\examples
where %DM_ROOT% is the location of the Dimensions Express installation.
For example, to run the script for a default installation, log in as Dimensions System Administrator (the default is dmsys) and run the following commands:
cd C:\Program Files\Serena\Dimensions\10.1\CM\AdminConsole\examples
dmpmcli -user dmsys -pass dmsys_test -dsn dim10 -dbname express -host localhost -file ExpressVMMigration.js
Under certain circumstances, it is possible to have an area defined in Dimensions that subsequently ends up with a blank or missing associated network node, thus causing attempts to populate the area to fail.
The dmcli PLCA command (Purge Library Cache Area) does not currently remove sub-directories from the library cache area root directory. The only way to remove sub-directories is to use the "/purge_all" qualifier and then recursively remove the sub-directories from the library cache area root directory.
There is a known issue on Windows such that if you use the SCWS command with the new /USERS parameter to specify a group, the Windows session may terminate with a crash. To avoid this Windows-specific issue, you must specify the individual users in the group rather than the group itself.
When running the dmdba upgrade command specifying a user name containing DBCS characters, the command may fail with an error. The solution is to set the DM_TMP environment variable to a path containing only ASCII characters before running the command.
Dimensions databases require trustworthy mode to be set to on. When you have restored a database from backup using SQL Server 2005, the database will subsequently have trustworthy mode set to off. Before using a restored database you will need to reset trustworthy mode to on.
Before restarting the listener and connecting to the database, do the following:
Start | All Programs | Microsoft SQL Server 2005 | SQL Server Management Studio
alter database dbname set trustworthy on
where dbname is the name of the database (default dim10).
If you have selected the Show User Roles and Privileges option for an object, you may find that when you click on the Privileges tab, the desktop client terminates and the session expires. This is an intermittent problem.
Custom tools in the desktop client now allow you to place an entry for a custom tool anywhere on the pulldown menus by using the Menus/Toolbar tab of the Customize dialog box, instead of having it inserted in the default location in the Tools menu. However, if you use this feature when adding a custom tool, and you subsequently want to delete it, you must first delete all entries for that tool in the pulldown menus by using the Menus/Toolbar tab before deleting the tool using the Tools tab. If you delete the tool on the Tools tab first, blank entries will remain in the Customize Menus/Toolbar dialog box.
If you have used the Windows Explorer integration to both rename a file locally and modify it, and subsequently run the Synchronize wizard, in "upload only" mode, the change will be reported as a conflict in the Synchronize wizard when it is run in "upload only" mode. In this case, the change type is incorrect, as the item has not changed in the repository. This means that you cannot use the Synchronize wizard to synchronize that particular change when in upload mode, forcing you to ignore it. In order for the change to be shown correctly as a non-conflicting local rename and modification, you will need to run the Synchronize wizard in full synchronize mode, and ignore any downloads from the repository that the Synchronize wizard will have selected if you do not want them.
If you are using Internet Explorer on Windows Vista to access Dimensions web client, the enhanced security features of that browser may prevent the web client from reading or writing files to local disks. If this occurs you will probably see a message similar to
java.io.FileNotFoundException:<full pathname>(Access Denied)
This is because Internet Explorer on Windows Vista has Protected Mode enabled by default, and this prevents software running in the web browser from accessing the disk.
Currently, the recommended workaround for this issue is to add the Dimensions Express web server's address to the list of Trusted sites in the Trusted sites security zone. To do this, proceed as follows:
The displaying of the Dimensions custom columns in Windows Explorer is not supported under Windows Vista. To obtain this information for a file:
You can still identify the change type from the decorations added to the file icon.
Dimensions Express cannot fetch items to Windows platforms whose resulting file paths would exceed 260 characters.
If you have changed any item types in Dimensions Express, you may receive errors when checking out items of that type. If this occurs, you need to close and restart Eclipse.
To improve performance, Dimensions Express application servers now cache some privilege and role information. In general, this information is refreshed only when an application server is allocated to a session, i.e. on connection or when an idle session is reactivated. If any privilege assignments are updated in the Administration Console, the changes may not take effect during existing client sessions. In this case, the user will need to restart the client session for the new privilege settings to apply.
This behavior can be changed by setting certain variables in the dm.cfg file. For further details, see the Administrator's Guide.
Copyright © 2008 Serena Software, Inc. All rights reserved.
This document, as well as the software described in it, is furnished under license and may be used or copied only in accordance with the terms of such license. Except as permitted by such license, no part of this publication may be reproduced, photocopied, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording, or otherwise, without the prior written permission of Serena. Any reproduction of such software product user documentation, regardless of whether the documentation is reproduced in whole or in part, must be accompanied by this copyright statement in its entirety, without modification.
This document contains proprietary and confidential information, and no reproduction or dissemination of any information contained herein is allowed without the express permission of Serena Software.
The content of this document is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Serena. Serena assumes no responsibility or liability for any errors or inaccuracies that may appear in this document.
Trademarks
Serena, TeamTrack, StarTool, PVCS, Collage, Comparex, Dimensions, RTM, Change Governance, and ChangeMan are registered trademarks of Serena Software, Inc. The Serena logo, Dimensions, Professional, Version Manager, Builder, Meritage, Command Center, Composer, Reviewer, Mariner, and Mover are trademarks of Serena Software, Inc.
All other products or company names are used for identification purposes only, and may be trademarks of their respective owners.
U.S. Government Rights
Any Software product acquired by Licensee under this Agreement for or on behalf of the U.S. Government, its agencies and instrumentalities is "commercial software" as defined by the FAR. Use, duplication, and disclosure by the U.S. Government is subject to the restrictions set forth in the license under which the Software was acquired. The manufacturer is Serena Software, Inc.,
1900 Seaport Boulevard, 2nd Floor, Redwood City, California 94063-5587.
This product includes software developed by The Apache Software Foundation (http://www.apache.org/).
This product includes software developed by Computing Services at Carnegie Mellon University (http://www.cmu.edu/computing/).
This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.openssl.org/)
CONTAINS IBM(R) 32-bit Runtime Environment for AIX(TM), Java(TM) 2 Technology Edition, Version 1.4 Modules
© Copyright IBM Corporation 1999, 2002. All Rights Reserved
Copyright © 1998, 1999, 2000 Thai Open Source Software Center Ltd and Clark Cooper
Copyright © 2001, 2002, 2003 Expat maintainers.
Copyright 1998-2006 The OpenLDAP Foundation.
Portions of this Software are derived from IBM Corporation Sample Programs. Copyright © IBM Corp., 2002, 2006. All rights reserved.
Optional Oracle components embedded in Dimensions are also subject to the following Copyright Notices:
Copyright © 2003-2006 Oracle Corporation. All rights reserved.
NOTICE OF RESTRICTED RIGHTS
Programs delivered subject to the DOD FAR supplement are 'commercial computer software' and use, duplication, and disclosure of the programs, including documentation, shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement. Otherwise, programs delivered subject to the Federal Acquisition Regulations are 'restricted computer software' and use, duplication, and disclosure of the programs, including documentation, shall be subject to the restrictions in FAR 52.227-19, Commercial Computer Software-Restricted Rights (June 1987). Oracle Corporation, 500 Oracle Parkway, Redwood City, CA 94065.
End of Readme