This file contains information on installing and using the current release of Serena® ChangeMan® DS. This file contains information that may not be included in other Serena documentation. The Fix Log for this release is published in Solution 5002619 on the Serena Support Web site.
To view the Master License Agreement, see MasterLicenseAgreement.
To contact technical support, go to support.serena.com.
Part 1: ChangeMan DS Main Server, Clients, and Communication Agents
Part 2: Copyrights, Trademarks, and Acknowledgements
|
Part 1: ChangeMan DS Main Server, Clients, and Communication Agents |
The Main Server for ChangeMan DS is supported on:
Windows® 2000 Advanced Server (32 bit)
Windows® 2003 Server, Advanced Server (32 bit) or Enterprise Server (64 bit)
HP-UX (PA-RISC) version 11.11 (64 bit) or 11.23 (64 bit)
IBM AIX® version 5.2L (64 bit) or 5.3L (64 bit)
Sun OS (SPARC)/Solaris™ 9 (32 or 64 bit) or 10 (64 bit)
Linux Intel Kernel 2.4.x
In addition to Operating System requirements, the system requirements for a ChangeMan DS Main Server on Windows are:
In addition to Operating System requirements, the systems requirements for the Main Server on UNIX platforms are:
The Windows client for ChangeMan DS is supported on:
Windows® 2000 Professional, Service Pack 4
Windows® 2000 Advanced Server (32 bit)
Windows® XP Professional, Service Pack 2
Note If you enable the built-in firewall feature of Windows XP SP2, all ChangeMan DS executables should be added to the Exceptions list.
The Java client for ChangeMan DS is supported on:
Windows® 2000 Professional, Service Pack 4
Windows® 2000 Advanced Server (32 bit)
Windows® XP Professional, Service Pack 2
Note If you enable the built-in firewall feature of Windows XP SP2, all ChangeMan DS executables should be added to the Exceptions list.
Windows® 2003 Server, Advanced Server (32 bit)
IBM AIX® version 5.2L (64 bit) or 5.3L (64 bit)
Sun OS (SPARC)/Solaris™ 9 (32 or 64 bit) or 10 (64 bit)
Linux Intel Kernel 2.4.x
HP-UX (PA-RISC) version 11.11 (64 bit) or 11.23 (64 bit)
In addition to Operating System requirements, the system requirements for a ChangeMan DS Windows client are:
The following are the systems requirements to use the Web browser client:
Communication Agents for ChangeMan DS are supported on:
Windows® 2000 Advanced Server (32 bit)
Windows® 2003 Server, Advanced Server (32 bit) or Enterprise Server (64 bit)
HP-UX (PA-RISC) version 11.11 (64 bit) or 11.23 (64 bit)
IBM AIX® version 5.2L (64 bit) or 5.3L (64 bit)
Sun OS (SPARC)/Solaris™ 9 (32 or 64 bit) or 10 (64 bit)
Linux Intel Kernel 2.4.x
IBM z/OS 1.6 or 1.7 for use with USS
IBM AS/400 RISC
The following are the systems requirements for the Communication Agent on Windows platforms.
The following are the systems requirements for the Communication Agent on UNIX platforms.
The following are the systems requirements for the Communication Agent on OS/400 platforms.
ChangeMan DS 5.7.2 integrates with TeamTrack versions 6.3 and 6.5.
ChangeMan DS 5.7.2 integrates with JBuilder versions X and 2005
ChangeMan DS 5.7.2 integrates with WebSphere Application Developer 5.1, Rational Application Developer 6.0, and Eclipse versions 3.1 and 3.2.
ChangeMan DS 5.7.2 integrates with Visual Studio .Net versions 2003 and 2005.
ChangeMan DS 5.7.2 integrates with PowerBuilder versions 9 and 10.
The following should be configured before you begin installation:
The host ID and IP address of the machine on which the ChangeMan DS server is to be installed are needed to obtain a license key. See "Licenses" in the Serena® ChangeMan® DS Installation Guide for more information.
For a Microsoft® Windows® installation, you must install from a Windows machine. For a UNIX installation, you can install from either a Windows machine that is running a standard X Window System, or from a UNIX machine.
If you are using a Sun OS/Solaris™ system for your Oracle® database, use a block size of 8K or higher for your tablespace.
If using Microsoft® SQL Server™ 2000, the port you specify for both the SQL Server Network Utility and SQL Client Network Utility must be the same.
In Microsoft SQL Server Enterprise Manager, under the Security tab, ensure SQL Server and Windows NT is selected for authentication.
The following are configuration requirements that apply to all databases:
The following are the system requirements for the metadata database options on Windows platforms:
|
Database Requirements on Windows |
|---|
|
Microsoft® SQL Server™ 2000 or 2005; must be installed CASE SENSITIVE |
|
Oracle® database 9i or 10g |
|
IBM DB2 Universal Database™ 8.1, or 8.2. |
The following are the system requirements for the metadata database options on UNIX or Linux platforms:
|
Database Requirements on UNIX or Linux |
|---|
|
Oracle® database 9i or 10g |
|
IBM DB2 Universal Database™ 8.1, or 8.2. |
Review the following information before you begin:
If you installed any patches to your production version ChangeMan DS, contact Serena Support before upgrading to ChangeMan DS 5.7.2.
If you are upgrading to ChangeMan DS 5.7.2, you must upgrade the server as well as all clients and Communication Agents with which it communicates.
Command line utilities DCM, approve, cancelout, and dcm_ping are no longer supported, and DCM no longer ships with the product. When writing new scripts, use the new cmnxfer, cmnarea, cmnuser, cmnproj, cmnmake, cmnaudit, and cmnping commands instead. The cmnxfer command replaces the former DCM commands.
See the Serena® ChangeMan® DS Command Line Interface Guide for detailed documentation on the command line utilities
Occasionally on Linux, when you execute the setup.sh script, you receive an error message regarding the available space even though there is enough space on the system to install ChangeMan DS. If this happens, run setup.jar instead using the following command:
java -jar setup.jar
If you experience problems with the user interface of the installer using Linux (particularly the RedHat ES and AS distrubutions), these problems can typically be resolved by using Java Runtime Environment version 1.3.1 to run the java-based installer for ChangeMan DS. This is freely available from Sun Microsystems at http://java.sun.com/products/archive/.
You should save your configuration files to a temporary location before running the upgrade.
Upgrades are supported from ChangeMan DS 5.6.1, 5.7.0, and 5.7.1.
To maintain consistency in license administration, Serena recommends that all ChangeMan DS areas on a particular host be configured using either IP address or host name, but not a mixture of both.
Right-click menu options in the Java and Web browser clients may be enabled regardless of whether the option is eligible to be performed.
If you edit or compare a Microsoft Word document in the Java or Web browser client, errors may occur due to the binary nature of the files. For editing or comparing Word documents, use the Windows client.
(DEF74031) If a different version of the Oracle JDBC driver than is supplied with ChangeMan DS is installed on machine hosting your database, the default install time for all packages is 12:00AM.
If you have a Java runtime version earlier than 1.4.1 installed on a Windows Main Server, you may receive the following message during an installation when the installer tries to install Java 1.4.1:
An installation support file 'C:\Program Files\Common Files\Installs\engine\6\Intel32\objectps.dll' could not be installed.
Cancel from the Java installation and continue with the ChangeMan DS installation. After the ChangeMan DS installation is complete, install Java 1.4.1 from the ChangeMan DS Installation CD by running j2re-1_4_1_07-windows-i586.exe.
When you upgrade your ChangeMan DS client, the source control provider setting is not retained. If you are using ChangeMan DS as your source control provider through SCC integration, you must execute IDEReg.exe located in the ChangeMan DS Client subdirectory to set ChangeMan DS as your source control provider.
(DEF90023)If you are using WebSphere Application Developer 6, the ChangeMan DS preferences are not added to the Team node of the wrokbench's Preferences dialog. To enable the Team node in the Preferences dialog:
Return to the Preferences dialog and the "Team" node should now appear.
Documentation for ChangeMan DS 5.7 is provided on your product installation CD and is posted on Serena's Support site.
Note Some documents have not been updated since the 5.7 or 5.7.1 releases of ChangeMan DS. The appropriate versions of the documents shipping with 5.7.2 are:
Updates to the documentation that are not in the published documents for this release are listed in this section. Updates to the published documentation are maintained between product releases in Documentation Solutions in the Serena Knowledgebase.
Offline changes are now supported by the ChangeMan DS integration for Microsoft Visual Studio .NET. When you cannot access the ChangeMan DS server to perform a checkout, you may disable the Read-Only attribute on the file and change it locally on the client. Then, when access to the server becomes available, you may perform an "offline check out" against the server version of the file retroactively, without overwriting your local changes. Check in the modified file as usual to upload your changes to the host and increment the file version number.
(TSK06255)In "Restoring Files Removed from Control," -log is no longer valid for the actions -ala and -alf when restoring files using the command line interface.
The following information should be added to the "Advanced Configurations" chapter under "Other Configurations":
If TeamTrack is setup up to work with NT Challenged Response, enable TTNTChallenge in the vcs_serv.ins file.
See Serena TeamTrack for the TeamTrack versions supported for integration with this release.
The following information should be added to this document:
If TeamTrack is setup up to work with NT Challenged Response, enable TTNTChallenge in the vcs_serv.ins file.
Page 91 under Project Merge Operations states: "This entry is optiona" for the Common Ancestor. This is now required and not optional.
|
Part 2: Copyrights, Trademarks, and Acknowledgements |
Copyright © 1998-2006 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.
Serena, TeamTrack, and ChangeMan are registered trademarks of Serena Software, Inc. The Serena logo is a trademark of Serena Software, Inc.
All other products or company names are used for identification purposes only, and may be trademarks of their respective owners.
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., 2755 Campus Drive, San Mateo, CA 94403.
Portions of this product are redistributed unmodified in binary form from the Eclipse Organization. Source and binary code is available from http://www.eclipse.org/.
Portions of this product are copyrights of other corporations or individuals, as follows:
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
1. Redistributions of source code and documentation must retain the above copyright notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
3. All advertising materials mentioning features or use of this software must display the following acknowledgement:
This product includes software developed or owned by Caldera International, Inc.
4. Neither the name of Caldera International, Inc. nor the names of other contributors may be used to endorse or promote products derived from this software without specific prior written permission.
USE OF THE SOFTWARE PROVIDED FOR UNDER THIS LICENSE BY CALDERA INTERNATIONAL, INC. AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL CALDERA INTERNATIONAL, INC. BE LIABLE FOR ANY DIRECT, INDIRECT INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Permission to use, copy, modify, and distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
Sponsored in part by the Defense Advanced Research Projects Agency (DARPA) and Air Force Research Laboratory, Air Force Materiel Command, USAF, under agreement number F39502-99-1-0512.
The Regents of the University of California. All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
3. Neither the name of the University nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Copyright (c) 1998-2005 The OpenSSL Project. All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
3. All advertising materials mentioning features or use of this software must display the following acknowledgment:
"This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to endorse or promote products derived from this software without prior written permission. For written permission, please contact openssl-core@openssl.org.
5. Products derived from this software may not be called "OpenSSL" nor may "OpenSSL" appear in their names without prior written permission of the OpenSSL Project.
6. Redistributions of any form whatsoever must retain the following acknowledgment:
"This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.openssl.org/)"
THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
This product includes cryptographic software written by Eric Young (eay@cryptsoft.com). This product includes software written by Tim Hudson (tjh@cryptsoft.com).
End Readme
Copyright © 2005 Serena Software, Inc. All rights reserved.