© Copyright IBM Corporation 1992, 2009
U.S. Government Users Restricted Rights - Use, duplication, or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

This file contains last-minute product information and updates to IBM Rational Synergy 7.1

It is divided into the following sections:

• System requirements
  
  
• Operating system locales
  
  
• Compatible products
  
  
• Installing Rational Synergy 7.1
  
  
• Obtaining a license
  
  
• What's new in version 7.1
  
  
• Known problems
  
  
• Fixed problems
  
  
• Contacting Support
  
  
• Notices
  
  
  

For the latest news and information on Rational Synergy 7.1, visit the Web site at http://www.ibm.com/software/rational/support/.

System requirements

To run the Rational Synergy 7.1 server with the IBM Informix database:

• One of the following operating systems must be installed on your computer:
  
  • IBM AIX® 6.1
  • Red Hat® Enterprise Linux 5 (32-bit or 64-bit)
  • Sparc Solaris® 10
  • SUSE® Linux Enterprise Server 10 SP2
  • Windows® Server 2003 R2 Standard or Enterprise Edition (32-bit or 64-bit)
  • Windows XP Professional SP3 (for evaluation purposes only)
  • VMWare® ESX Server™ 3.5 running Windows Server 2003 R2 Standard or Enterprise Edition (32-bit or 64-bit)
  
  
• The minimum hardware requirements are:
  
  • A multi-processor or multi-core processor server class machine
  • 4 GB RAM for the Rational Synergy server
  • 900 MB free disk space
  
  
• IBM Rational Directory Server 5.0, 5.1, or 5.x must be installed and operational
• IBM Rational License Server TL 2.0 or Telelogic License Server 1.5 must be installed and operational

To run the Rational Synergy 7.1 server with an Oracle® database:

• One of the following operating systems must be installed on your computer:
  
  • IBM AIX 6.1
  • Red Hat Enterprise Linux 5 (32-bit or 64-bit)
  • Solaris 10
  
  
• The minimum hardware requirements are:
  
  • A multi-processor or multi-core processor server class machine
  • 8 GB RAM for the Rational Synergy server
  • 900 MB free disk space
  
  
• IBM Rational Directory Server 5.0, 5.1, or 5x must be installed and operational
• IBM Rational License Server TL 2.0 or Telelogic License Server 1.5 must be installed and operational
• Oracle Database 10g Release 2 (64 bit) must be installed and operational

To run the Rational Synergy 7.1 client:

• One of the following operating systems must be installed on your computer:
  
  • IBM AIX 6.1
  • Red Hat Enterprise 5 (32-bit or 64-bit)
  • Solaris 10
  • SUSE® Linux Enterprise Server 10 SP2
  • Windows XP Professional SP3
  • Windows Vista Enterprise Edition SP1
  • Windows Server 2003 R2 Standard or Enterprise Edition (32-bit or 64-bit)
  • Citrix XenApp 5 on Windows Server 2003 Enterprise R2 (32-bit or 64-bit)
  
  
• One of the following browsers must be installed on your computer:
  
  • Internet Explorer 6 SP2 or 7.0 or Firefox 3 for Windows XP and Windows 2003 clients
  • Internet Explorer 7.0 for Windows Vista clients
  • Firefox 2.0 for IBM AIX clients
  • Firefox 3.0 for Red Hat Enterprise Linux, Solaris, and SUSE Enterprise Linux clients
  
  
• The minimum hardware requirements are:
  
  • A Windows computer with a Pentium II 500 MHz single processor (recommended: Pentium III 733+ MHz) OR a UNIX computer with a 200 MHz single processor (recommended: 400+ MHz)
  • 512 MB memory (recommended: 2 GB)
  • 500 MB free disk space

For additional information on system requirements, including recommended configurations, visit the Rational Support Web site at: http://www.ibm.com/software/awdtools/synergy/sysreqs

Operating system locales supported by Rational Synergy 7.1

Rational Synergy 7.1 is certified only in the C locale. IBM supports use in any locale using the Latin-1 character set or the Windows extension CP 1252; however, such locales have not been tested. Use in locales using non-Latin-1 character sets is not supported. Rational Synergy displays dates and times in locale-appropriate formats, but some Synergy interfaces accept dates and times as input only in US formats. Rational Synergy does not adapt messages, numeric formats, or sorting orders according to the locale.

Compatible products

Rational Synergy 7.1 is compatible with the following products:

• IBM Rational Change 5.2
• IBM Rational Directory Server 5.0, 5.1, or 5.x
• IBM Rational License Server TL 2.0 or Telelogic License Server 1.5

Rational Synergy 7.1 is DCM-compatible with the following versions:

• Telelogic Synergy 7.0
• Telelogic Synergy 6.5 SP2
• Telelogic Synergy 6.4 SP1
• Telelogic Synergy 6.6a

Previous releases of Synergy require patches to support DCM compatibility with Rational Synergy 7.1. See the Rational Support Web site for more information.

Installing Rational Synergy 7.1

Login to IBM Passport Advantage to download platform-specific installation images for Rational Synergy or to request a physical media kit.

See the IBM Rational Synergy Installation Guide for detailed directions about installation. The documentation can be found online at the Rational Information Center.

Obtaining a license for Rational Synergy 7.1

Synergy 7.1 uses the IBM Rational License Server TL, which is a FLEXlm-based license server that manages licenses for heritage Telelogic products.

If you have a Telelogic Synergy 7.0 installation, you can reuse the Telelogic License Server and you will not need a new license. If you have a Telelogic Synergy installation previous to 7.0, you must install the latest Rational License Server TL and request a new license.

What's new in version 7.1

Changes to Rational Synergy 7.1 from the previous release are summarized below.

• Branding
• Improved support for Component-Based Development
• Usability improvements
• Support for link-based work areas in Web Mode
• Updates to the Rational Synergy CLI for Web Mode
• Improved administration for Web Mode
• Deployment of Windows clients
• Large file support
• New archiver

Branding

The product name was changed from Telelogic Synergy to IBM Rational Synergy. The splash screen and About dialog were updated. On Windows, the installation path, Start menu entry, and desktop icons were updated.

Improved support for Component-Based Development

The following improvements were made to support component-based development in Rational Synergy:

• It is easier to switch to a new version of a subcomponent. When a user uses a new version of a subcomponent project or product, it is now added to the current task. This ensures that when the user checks in his changes, the changes are propagated through the normal development and test lifecycle to other team members.
  
  
• It is easier to use new subcomponents, and to set up rules for using new components.
  
  When a build manager creates a baseline, Rational Synergy automatically creates two component tasks, one for projects and one for products. These component tasks are a "handle" for using those components in other releases.
  
  In keeping, the Process Rules dialog provides a new dialog to easily find and add component tasks to the process rules for a given release. It is now easy to set up rules such as:
  • Include subcomponent projects from a specific release and baseline
  • Include the latest published products from a specific release
  • Include the newest released projects and products of a subcomponent (from any release)
  • Include the latest published projects from a specific release, any component (for example, a team who has many subcomponents with 2-week release cycles can set up rules to include all subcomponents for release */week42, where * can be any component)
  
  The creation of component tasks can be turned off per release if it is not needed, for example, if a specific component release is not meant to be reusable by other teams.
  
  Upgrade does not automatically create component tasks for baselines that were created prior to the upgrade. A new command is provided to create component tasks for pre-existing baselines as needed. See the "ccm baseline" command for details.
  
  DCM supports the transfer of component tasks. They are included automatically when a baseline is transferred, or you can add a component task directly to a transfer set in order to transfer that component. Patches must be applied to previous releases for DCM compatibility.
  
  
• Rational Synergy 7.1 provides full support for baselines containing mixed releases. By default, when you create a baseline for a project hierarchy that contains mixed releases, the baseline includes all projects and releases in the hierarchy.
  
  Starting in Rational Synergy 7.1, the subcomponents with different releases can use the top-level baseline; update the process rules to refer to the hierarchy baseline. A new command option is provided for copying the baseline rules from the parent process rules to the other process rules; see "ccm process_rule -copy -baseline_rules_only".
  
  
• In previous releases, when you created a baseline, if Telelogic Synergy detected that some of the tasks in the project grouping properties may not actually be included in all of the projects, those tasks were marked as "untrusted" and continued to be shown in the "tasks on top of the baseline" in the project grouping properties. These tasks are still included by update, but they are no longer shown in tasks on top of the baseline, nor used in baseline compare, giving a more accurate view of what was introduced between the baselines.
  
  The Rational Synergy CLI provides the ability to view the additional untrusted tasks.
  
  
• When updating a project, if there are no candidates for the root directory, the update operation will give an error and stop. This avoids having the root directory and all members "disappear", for example, when there is no baseline, and should save time and prevent frustration for users. This change applies to all interfaces.

Usability improvements

The History dialog was updated to make it easier to manage a complex history containing many versions. A new macro view provides context and easy navigation. A new list view provides easy sorting and filtering to enable users to quickly find a specific version and navigate to it. Show only the selected version, predecessors and successors with one click to easily traverse complex histories. Increase or decrease the font size and number of versions shown with one click.

Selecting release values has been improved. By default, Rational Synergy saves the most recently-used release values at the top of the release drop-down list so that the user does not need to expand the release tree. These release values are referred to as favorites. The user can set preferences for how many release favorites will appear and which values should be permanently displayed in the release drop-down list.

Support for link-based work areas in Web Mode

Link-based work areas are now supported for UNIX clients running in Web Mode. Link-based work areas in Web Mode behave the same as link-based work areas in Traditional Mode, and are fully supported in the Rational Synergy graphical and command line interfaces.

Note: Rational Synergy Web Mode clients running over a Wide Area Network (WAN) require NFS visibility from the client system to the Rational Synergy server system in order to use link-based work areas.

Updates to the Rational Synergy CLI for Web Mode

The Rational Synergy CLI no longer requires the user to type the password as an option to the "ccm start" command on Windows. A user can use the new command "ccm set_password" to save an encrypted copy of his or her password to a file. The new option "ccm start -fpw <file>" reads and uses the password from the specified file. This provides a more secure option for Windows-based scripts.

The Rational Synergy CLI has the following improvements in version 7.1:

• The "ccm attr -copy" subcommand was implemented.
• The "ccm baseline" command was extended to support creating and displaying component tasks:
  • A new "ccm baseline -create_component_tasks" subcommand can be used to create component tasks for a baseline.
  • "ccm baseline -show" now shows component tasks if they exist.
• The "ccm copy_project", "ccm create -t project", and "ccm wa" commands were updated with options to support link-based work areas on UNIX.
• The "ccm dcm" subcommands and options were completed, and several new commands were added, including:
  • ccm dcm -delete -packages
  • ccm dcm -modify -settings
  • ccm dcm -show -el
  • ccm dcm -show -packages
  • ccm dcm -show -receive_lock
  • ccm dcm -show -settings
• The "ccm delimiter" command was extended to show the version delimiter.
• The "ccm finduse" command was completed and extended to support the following subcommands:
  • ccm finduse -folder
  • ccm finduse -folder_template
  • ccm finduse -change_request
  • A new scope for finding process rules using an object was added.
• The "ccm folder -finduse" command option was completed.
• The "ccm folder", "ccm folder_template", and "ccm task -query" subcommands were extended to support convenient querying for component tasks.
• A new "ccm process" command is available to enable creating and maintaining processes from the command line:
  • ccm process -copy
  • ccm process -create
  • ccm process -delete
  • ccm process -list
  • ccm process -modify
  • ccm process -show
• A new "ccm process_rule -copy_baseline_rules_only" command was implemented.
• The "ccm project_grouping" command was completed and extended:
  • New "ccm pg -refresh_baseline_and_tasks" subcommand
  • New "ccm pg -compare" subcommands
  • New "ccm pg -set_custom_baseline" subcommand
  • The "ccm pg -show" subcommand supports showing tasks on top of the baseline.
• The "ccm project_purpose -delete" and "ccm project_purpose -modify" subcommands were implemented.
• The "ccm release" command has been extended to support component tasks:
  • ccm release -create
  • ccm release -modify
  • ccm release -show
• A new "ccm show_servers" command shows CCM servers.
• The "ccm soad" and "ccm soad_scope" subcommands were completed, including:
  • ccm soad -preview
  • ccm soad -delete
  • ccm soad_scope -create
  • ccm soad_scope -delete
  • ccm soad_scope -list
  • ccm soad_scope -modify
• The information formats for various objects has been extended to show:
  • Directory entries for directories and projects in verbose mode
  • Component tasks for baselines in verbose mode
  • Baseline project for projects
  • Component tasks for release definitions

For a detailed list of improvements to the Rational Synergy CLI in release 7.1, and information about upgrading to the Rational Synergy CLI, visit the Rational Support Web site.

Improved administration for Web Mode

By default, a single CCM server serves all Rational Synergy databases. For improved scalability when supporting large numbers of users, you can create additional CCM servers on different physical servers to serve different Rational Synergy databases. All back-end Rational Synergy sessions will run on the physical server that hosts the CCM server.

Rational Synergy 7.1 improves the ability to manage which CCM servers serve which Rational Synergy databases with the following features:

• When creating a new Rational Synergy database using the unpack, load, or upgrade commands, specify the CCM server to serve the database using the new -url CCMServerAddress option.
  
  
• Reassign Rational Synergy databases to different servers using the new web administration interface. To use the web administration interface, navigate to the URL CCMServerAddress/admin. The page shows all databases and their assigned servers. If a database is actively being served by a server, you must login to the admin interface for that server in order to change it.

A Rational Synergy end user can now change his or her RDS password via the Rational Synergy CCM server by navigating to the URL CCMServerAddress/user.

Deployment of Windows clients

Rational Synergy Windows client users can now install and patch their Rational Synergy client installations using the Rational Synergy deployment feature without having Administrator privilege on the Windows desktop.

If the user installing Rational Synergy has Administrator privilege, the Rational Synergy client is installed for all users of the local machine, and requires the end user to have Administrator privilege to update the client installation in the future. This is how the client behaved in previous releases.

If the user installing Rational Synergy does not have Administrator privilege, the Rational Synergy client is installed for the current user only. The registry entry is stored under HKEY_CURRENT_USER rather than HKEY_LOCAL_MACHINE. This enables the user to automatically update/patch his or her own client from the server using the Rational Synergy deployment feature.

Note: Windows Vista has additional security restrictions that may prevent automatic deployment.

Large file support

Rational Synergy now supports files larger than 2 GB on all platforms and in all user interfaces.

New archiver

Rational Synergy 7.1 includes a new underlying archiver used to archive source files. The new archiver is scalable, reliable, and fast, and is used for both ascii and binary data types. This change is transparent to all users except the administrator.

Starting in Rational Synergy 7.1, archiving is asynchronous for fast file check in. Upon check in, source files are synchronized from the work area to the Rational Synergy server, but the check in operation does not wait until the file is archived before completing. This improves the performance of check in, especially for large files.

All related tools and commands such as "ccm clean_cache" and "ccm archive_check" were updated to behave appropriately to work with the new archiver and asynchronous archiving behavior.

Each database has one back-end session dedicated to archiving checked-in files for all users of that database. Administrators may want to configure the CCM server to increase the number of back-end sessions for a given database to account for this dedicated session. See the IBM Rational Synergy Administration Guide for more information about configuring the server.

Known problems

Visit the IBM Support site for an updated list of known problems.

Fixed problems

Visit the IBM Support site for a list of problems fixed in Rational Synergy 7.1.

Contacting Support

Please visit our Telelogic support overview site at: http://www.ibm.com/software/rational/support/telelogic/
You will find a one-sheet reference guide about how to best contact support in your geography.

Notices

This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send written license inquiries to:

IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

For license inquiries regarding double-byte character set (DBCS) information, contact the IBM Intellectual Property Department in your country or send written inquiries to:

IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106-0032, Japan

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law:
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions. Therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

Intellectual Property Dept. for Rational Software
IBM Corporation
1 Rogers Street
Cambridge, Massachusetts 02142
U.S.A.

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.

Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.

If you are viewing this information softcopy, the photographs and color illustrations may not appear.

Trademarks

IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at Copy and Trademark information at www.ibm.com/legal/copytrade.html.

Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, and/or other countries.

IT Infrastructure Library is a registered trademark of the Central Computer and Telecommunications Agency which is now part of the Office of Government Commerce

Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.

Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.

ITIL is a registered trademark, and a registered community trademark of the Office of Government Commerce, and is registered in the U.S. Patent and Trademark Office

UNIX is a registered trademark of The Open Group in the United States and other countries.

Cell Broadband Engine is a trademark of Sony Computer Entertainment, Inc. in the United States, other countries, or both and is used under license therefrom.

Java and all Java-based trademarks and logos are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

Other company, product or service names may be trademarks or service marks of others.