Telelogic® Focal Point version 6.3.0.3 readme

IBM Corporation
13 March, 2009

 

 

This file contains last-minute product information and updates to Telelogic® Focal Point 6.3.0.3.

It is divided into the following sections:

For the latest news and information on Telelogic Focal Point, visit the web site at http://www.ibm.com/software/rational/support/.


System requirements

Focal Point is a Web server application. Users access the application by using a standard Web browser.

Server - To run Telelogic Focal Point 6.3 you need:

  • One of the following operating systems installed on the server:
    • Windows 2000 (service pack 4), on x86
    • Windows XP (any version/service pack), on x86
    • Windows 2003 Server (any version/service pack) 32bit, on x86
      Note: Windows 2003 Server is not a preferred solution.
    • RedHat Enterprise Linux 4 or 5, on x86
    • Solaris 9 or 10, on SPARC
  • One of the following databases installed on the server:
    • PostgreSQL 8.1 and 8.2 (8.0 is also supported but it is significantly slower)
    • Oracle 10g
  • Web servers:
    The Tomcat servlet and JSP engine can be downloaded from http://tomcat.apache.org/. For installation on Linux or Solaris, Tomcat 5.5 is required. In a standard installation Tomcat serves both static and dynamic content. Optionally, it is possible to use Apache for serving static content and forwarding dynamic content from Tomcat. Tomcat 5.5 is designed to run on J2SE 5.0 and later.

Focal Point cannot be installed on Windows 95/98/ME/NT/Vista. Focal Point supports Windows 2003 Server, but it this not an optimal solution, because of slow performance.

Do not use file system compression on the installation server. This may slow down the database access, and a Microsoft hot fix has been reported to make data corrupt.

Server Hardware recommendations

1-10 concurrent users (x86 platform)
Pentium IV running at 3.0 GHz
10 GB HD free space
1 GB RAM

10-50 concurrent users (x86 platform)
Pentium IV running at 3.0 GHz
20 GB HD free space
2 GB RAM

50-150 concurrent users (x86 platform)
Application Server:
Pentium IV running at 3.0 GHz
20 GB HD free space
4 GB RAM

Database Server:
2x Xeon running at 2.4 GHz
80 GB HD free space
4 GB RAM

10-50 concurrent users (SPARC platform)
Fujitsu-Siemens 1 SPARC64 1.1 GHz
20 GB HD free space
2 GB RAM

or

Sun UltraSPARC IIi 1.28 GHz
20 GB HD free space
2 GB RAM

50-150 concurrent users (SPARC platform)
Application Server:
Fujitsu-Siemens 1 SPARC64 1.1 GHz
20 GB HD free space
4 GB RAM

Database Server:
Fujitsu-Siemens 1 SPARC64 2 x 1.1 GHz
80 GB HD free space
4 GB RAM

or

Application Server:
Sun UltraSPARC IIi 1.28 GHz
20 GB HD free space
4 GB RAM

Database Server:
Sun UltraSPARC IIi 2 x 1.28 GHz
80 GB HD free space
4 GB RAM

It is not optimal to use Windows for large installations. In those cases we recommend Solaris (SPARC) or Linux (x86). Please contact Support for information about larger installations.

Client - To run Telelogic Focal Point 6.3 you need:

  • One of the following Web browsers:
    • Internet Explorer 6 or 7 with Microsoft Java or Sun Java 1.4.2_05 to 1.6.X
    • Firefox 2.0+ on Windows or Linux with Java 1.4.2_05 to 1.6.x support and live connect.
      Some features may be unavailable when running MS Java and/or Mozilla derived browsers.
  • A minimum of 1024x768 pixels screen resolution.

For additional information on system requirements, including recommended configurations, visit the Rational Software Support site.


Operating system locales supported by Telelogic Focal Point 6.3

Focal Point supports use in any locale using the UTF-8 character set (on Unix) or CP 1252 (on Windows). Use in locales using other character sets is not supported. Focal Point provides configurable date formats that are independent of locale; it does not adapt messages, numeric formats, or sorting orders according to the locale.


Installing Telelogic Focal Point 6.3

To download the Telelogic Focal Point Installation Guide 6.3.0.3, follow the links at Fix Central, select Product Group Rational and Product Telelogic Focal Point.

Upgrading Telelogic Focal Point 5.4 to 6.3

There is a major difference between Telelogic Focal Point version 5.4 and 6.3. It is therefore recommended to test your configuration in a 6.3 pre-production environment before you decide to upgrade your production environment to 6.3.

Upgrading Telelogic Focal Point 6.x to 6.3

Upgrading from Focal Point 6.x to 6.3 is done by removing the 6.x installation and installing the new version. On Unix, a backup of the configuration files is required before installing the new version of Focal Point. Note: For installations running on Oracle, you must download the latest version of focalpoint_grant.sql and run it according to the instructions in Focal Point Installation Guide before the upgrade.


Obtaining a license for Telelogic Focal Point

To obtain a license for Telelogic Focal Point, you need to provide Customer Support with the hostname and hostid of the computer on which the license server is to be run. How to proceed is described in detail in the Installation Guide.


What's new in version 6.3.0.3

Telelogic Focal Point 6.3.0.3 includes no new functionality.

 



Known problems

ID

Description

Work around

Category

1

Importing very large workspaces may trigger an out of memory error.

For example keep files on a separate server and link to the files from Focal Point.

Export/Import

2

Exporting a workspace (or a module) logs out all other users in the workspace. This is not a bug, but necessary to protect information integrity

None

Export/Import

3

The access control is too strict in rare cases, which results in an error message: Access denied. (Since this is extremely difficult to replicate, we appreciate any information that may help tracing this problem)

None

General

4

Large relational graphs or Gantt views may cause client-side out of memory error in the applet

Use smaller views

Performance

5

The Web browser navigation (Back/Forward) in the application may not work.

None

Web Browser

6

PostgreSQL 8.0 on Windows has performance issues. Focal Point occasionally gets long response times.

Upgrade to PostgreSQL 8.1.

Performance

7

PostgreSQL do not support the so-called supplementary characters. That is the characters whose codepoints are greater that U+FFFF. Oracle do support them.

Change to Oracle

Database

8

Several fields in Focal Point are now truncated to 3800 characters when using the Oracle database. Affected areas are choice item names and descriptions, filter names, metadata names and values, module names and descriptions, pairwise comparisons comments, report names and descriptions, report template names and descriptions, attribute setup values, and workspace names and descriptions.

This is usually not a problem

Database

9

The Web Services API is not fully tested for performance and scalability. General performance benchmarks are not provided.

We strongly recommend testing the Web Services API in a test environment before using it in a production environment.

Web Services

10

When starting Focal Point on a Windows server, Tomcat may start before PostgreSQL has been started. An error message is displayed when trying to login and Focal Point is not available. (This problem may occur only when Focal Point has been set up to start automatically.)

Start Tomcat manually when PostgreSQL is running. This is set in Start Menu > Control Panel > Administrative Tools > Services. Right-click Apache Tomcat, select Properties > General tab and select Startup type: Manual.

Installation

11

The Excel 2007 file format is not supported when importing to Focal Point.

Save the file in Excel 2003 format and import again.

Export/Import

12

Installing Dashboard 3.0 Portal on a machine with Focal Point and PostgreSQL generates a conflict. PostgreSQL stops working.

Dashboard 3.0 Portal and PostgreSQL use the same dll file - but not the same version. Replace the file LIBEAY32.dll (which has been changed by Dashboard) with the same file from a working Focal Point installation.

Database

13

Notification mail format issue: When Application Settings > Mail Format is set to Mixed or Text and you use the notification feature, the e-mails will contain first Id: Title and then Id: Title as a link (i.e. double information) for each element.

None

Notification

14

On a normal size workspace, a notification can take tens of seconds. With a large workspace with a lot of history, a notification can take up to a minute. When there are many notifications, the server doesn't have time to finish all of them before the next run starts, further impeding performance.

Avoid using lots of notifications and simultaneous execution.

Notification

15

In Review > Action List, attribute values don't get saved when an element is edited.

None

Review

16

Danish date format is not supported when running Java 1.6 on the server. More information: http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=4842276

Use Portuguese date and number format.

General

17

Expressions and Business Rules are not fully tested. For example all customer specific business rules might not work properly. There are several misbehaviours and error messages might not always appear or display correct information.

Contact support

Expressions

18

Errors when reviewing elements: If consequence estimation is used and several attributes are included for the reviewed elements.

 Filter too a small amount of attributes before consequence estimations.

Review

19

Baseline migration fails because of a MultiChoice attribute. Baseline migration is a FP6.1 feature that enables users to do separate migrations of old baselines.

Avoid using MultiChoice attributes

Baseline

21

The MS Word integration performance: Import of elements takes longer time than expected.

None

Integration

22

A Single Sign-On user is able to login when Web Single Sign-On is disabled in the database. The Login page is not displayed and instead the SSO user is logged into the application directly

None

Web SSO

23

Doors URL generated after sync in FP URL attribute does not link to the Doors object.

None

Integration

24

Stricter parenthesis evaluation implemented in 6.2 03 can affect expressions currently in operation in Focal Point. The interpretation of expressions containing boolean expressions, such as (1>2)?3:4+5 has been corrected.

Update expressions with parenthesis as needed if the previous, incorrect evaluation gave the intended result.

Expressions

27

Stricter expression validation implemented in 6.2 03 can affect expressions currently in operations in Focal Point. Expressions that previously were run and displayed as successfully completed although some subtasks could not be completed, must now be corrected before they can be started.

Correct each expression according to the displayed message

Expressions

28

When decreasing the maximum file size restriction in the File attribute it is possible to exceed the file size restriction if there already is a file larger than the new value.

None

Files

29

Select All and Deselect All item is not working in the MultiChoice attribute.

Select all manually.

General

38

Importing a Workspace containing Link attributes within a Module as well as some Mirror attributes may result in broken links and no link values.

None

Export/Import

39

A Business Rule (in this case LinkbyText) does not work after importing the Workspace. This problem occurs when importing to another server.

Always verify Business Rules after importing the Workspace containing the Business Rule.

Export/Import

42

Old business rules, from 5.X, can be uploaded to Focal Point 6.X - but they should not, because they do not work properly.

1) Identify old business rules on the file system. 2) Remove all old business rules. 3) If Focal Point has been started after the upgrade, make the SQL query ""delete from expressions"". 4) Restart Focal Point.

Business rules

43

A filter cannot be defined on the basis of Inherit From for a Members view as the option Inherit From is removed in the filter configuration.

Filter on Inherit From in Display > Attribute Statistics by using the choices in the bottom frame.

Filter

44

Apache Tomcat version 5.5.27 is not compatible with Focal Point 6.3.0.3.

Use Apache Tomcat version 5.5 25.

Installation


Fixed problems

ID

Fix

Category

10575

Resource links are now updated when assigning requirements to resources in plan views.

Link

11508

Case-sensitivity in view rules and filters is now optional.

Filters

116115

The handling of filters when creating and migrating baselines has been improved.

Baselines

11673

Failed scheduled expressions are now run at the next opportunity.

Expressions

11763

Now, incoming link attributes based on views do not apply  filters.

Filters

11825

Changes made in views based on the rule “Owner is Current user” are now displayed in What's new.

Views

11826

Now, members who are logged in in a workspace that is being deleted are directed to the navigation bar with no workspace opened.

Users

11859

The message is now only displayed to users with permission to delete members.

Users

11901

All users can now be added as members to a workspace regardless of the number of folders.

Users

11958

LDAP updating of user data now works as intended.

Users

11959

Attribute identification during export and import has been improved.

Expressions

11987

Attributes with expressions as default allues are now evaluated when creating elements in Add views.

Expressions

12039

The user lookup displayed when there are more than 50 users in an imported workspace is now described in the online help.

Import

12051

The attribute access in the workflow definition can now be set to “As view” after setting workflow attribute access to “Read-only” or “Hidden”.

Workflow

12053

State transitions can now be assigned in the workflow configuration.

Workflow

12060

When importing a workspace with more than 50 users, the lookup option (magnifying glass) can now be activated in Internet Explorer.

Import

12092

Templates can now be uploaded in both Internet Explorer and Firefox browsers.

Reports

12095

Element comparisons are now displayed.

Attributes

12099

Column names are automatically assigned when imporing a workspace with matrix attributes.

Import

12100

The view definition logic has been corrected.

Views

12110

The history graph now displays the overall number of elements as well as the different values of the choice attribute.

Display

12125

Missing user names are now handled gracefully when displaying choice attribute history.

Database

12171

The table view no longer displays a blank screen if a filter that causes brokens links is applied.

Display

 

Contact Support

Support and information for Telelogic products is currently being transitioned from the Telelogic Support site to the IBM Rational Software Support site. During this transition phase, your product support location depends on your customer history.

·         If you are a heritage customer, meaning you were a Telelogic customer prior to November 1, 2008, please visit the Telelogic Focal Point Support site.

Telelogic customers will be redirected automatically to the IBM Rational Software Support site after the product information has been migrated.

·         If you are a new Rational customer, meaning you did not have Telelogic-licensed products prior to November 1, 2008, please visit the IBM Rational Software Support site.


 

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, ibm.com, Telelogic, and Telelogic Focal Point are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. These and other IBM trademarked terms are marked on their first occurrence in this information with the appropriate symbol (® or ™), indicating US registered or common law trademarks owned by IBM at the time this information was published. Such trademarks may also be registered or common law trademarks in other countries. A current list of IBM trademarks is available on the Web at www.ibm.com/legal/copytrade.html.

Linux is a registered trademark of Linus Torvalds.

Macrovision and FLEXnet are registered trademarks or trademarks of Macrovision Corporation.

Microsoft, Windows, Windows 2003, Windows XP, Windows Vista, and/or other Microsoft products referenced herein are either trademarks or registered trademarks of Microsoft Corporation.

Mozilla and Firefox are trademarks of the Mozilla Foundation.

Oracle is a registered trademark of Oracle Corporation.

Red Hat is a registered trademark of RedHat, Inc.

Sun, Sun Microsystems, Solaris, and Java are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries.

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