Rational Software Corp.

TOC PREV



Rational Suite DevelopmentStudio Release Notes

These release notes provide information on the following topics:

Note: In some cases, you may note discrepancies between the printed documentation and the online documentation. In these cases, the online documentation is the most up-to-date and should be followed.

If you encounter any problems while installing or running Rational Suite DevelopmentStudio, check here first to see if you encountered a known problem. Also, refer to the product-specific Release Notes. For a list a product-specific Release Notes, see Product Release Notes.

If you find a problem that is not documented, contact Rational Technical Support so that we can investigate it, provide you with a workaround, and track the problem for future action. For more information, see Contacting Rational Technical Support.

See the Rational Suite Web site for the latest Release Notes, patches, and additional information: www.rational.com/products/rs


Please Read First

You Must Install License Keys to Run this Product!

With your software media kit, you received an envelope containing your Startup License Key Certificates for this product. You need these keys to run your software. The startup license keys will expire a few weeks after shipment. Be sure to request your permanent license keys as soon as they are available. The availability date for your permanent keys is indicated in the top section of your Startup License Key Certificate.

Please check the Installing Rational Suite DevelopmentStudio manual for detailed instructions on how to install your startup license keys and how to request your permanent license keys.

Version 2001A.04.00 software will run with version 2000.02.10 license keys. If you are an existing customer and are using version 2000.02.10 of Rational Suite DevelopmentStudio, you do not need to obtain new license keys to run version 2001A.04.00 of the same product.

If you are an existing customer and are using a version of Rational Suite DevelopmentStudio prior to version 2000.02.10, you need to return your old license keys and request new ones. For more information, see "Requesting License Keys" in the Installing Rational Suite DevelopmentStudio manual.


Notice To Upgrade and Beta Customers

Beta Customers

You must uninstall the beta version of Rational Suite DevelopmentStudio, Version 2001A.04.00 before installing the final release of this product.

Upgrade Customers

Crystal Reports, Version 8.0 (Windows)

Upgrade customers who wish to continue to use Rational ClearQuest on Windows can order the Crystal Reports Pro Edition, Version 8.0 CD from the following web site:

http://www.rational.com/support/downloadcenter/upgrades/clearquest.jsp

Installing Windows Components

If you plan to install the Windows components of Rational Suite DevelopmentStudio, you will need the Rational Solutions for Windows CD to install the latest versions of the Windows software and the Rational Solutions for Windows Online Documentation CD to obtain the latest copies of Installing Rational ClearQuest and Installing Rational Requisite Pro.

Important: Back up any user files before starting this procedure. Backing up your data prior to installing any new software should be a regular practice.

You also need to uninstall any previous versions of Rational Suite DevelopmentStudio from the target system.

To uninstall a Rational product, click Settings > Control Panel. Double-click Add/Remove Programs. Click the Rational product you want to remove and click Add/Remove. Do not attempt to remove a product by just deleting program directories - there are many registry entries that need to be modified as well.

Note: If you have uninstalled a Rational Suite product and plan to reinstall the product or install a new version, we recommend that you reboot your system after you have removed the software, before proceeding with the installation.

The Rational Software setup program may install Microsoft Shared components into the Windows 9x System, and Windows NT System32 directories. These Microsoft components are not removed when you uninstall Rational Suite. Other programs may use these files; therefore, following Microsoft guidelines, we do not remove them from your system.

In addition, a minimal number of files will remain under the folder <drive>:\Program Files\Rational\. This is because our uninstall deliberately does not delete files that you have created while using the products. You may manually delete these files if you wish to remove them from your system. Do not delete the entire \Program Files\Rational folder itself unless you are certain that you have uninstalled all products installed from the Rational Solutions for Windows CD (or other Rational product CDs).


General Information About this Release

This section covers general information about this release.

What's Included with the Suite?

In addition to this document, the Rational Suite DevelopmentStudio media kit contains the following items:

Suite Products

The following products are included in Rational Suite DevelopmentStudio:

* This product is installed and run on a Windows server. RequisiteWeb provides a web interface that allows UNIX users to access Rational RequisitePro on Windows through their web browser.

Note: This version of Rational Suite DevelopmentStudio includes a new version of the licensing server software (FLEXlm 7.0f). It is highly recommended that you take advantage of the new features provided in this release to help optimize your license server's performance.

Previous versions of Rational Suite DevelopmentStudio included the Windows version of ClearQuest Web. Rational Suite DevelopmentStudio includes Rational ClearQuest for UNIX. Note that for those customers who wish to use the Windows version of ClearQuest, it can still be installed from the Rational Solutions for Windows CD. The license provided for Rational Suite DevelopmentStudio (Windows components) will also work for the Windows version of ClearQuest.

See the "Installing Rational Suite DevelopmentStudio" manual for more details about supported configurations.


What's New in This Release

New Platforms supported

The following platforms are supported in Rational Suite DevelopmentStudio, version 2001A.04.00:

Note: Rational Unified Process is not supported on HP-UX 10.20. Supported HP-UX platforms for this product include HP-UX 11.00 and 11.11.

Rational ClearCase LT

Rational ClearCase LT is included with this release of Rational Suite DevelopmentStudio on a separate CD as an optional product for you to install. Your Suite license key can be used to install ClearCase LT.

Rational ClearCase LT provides software configuration management and a built-in process to track changes to all software project assets, including requirements, visual models, and code. Rational ClearCase LT supports Unified Change Management, Rational's best practices process for managing change and controlling workflow.

To install this product, see the Rational ClearCase LT Installation Notes and Release Notes.

Node-locked licenses

In previous releases of Rational Suite DevelopmentStudio, permanent or TLA node-locked licenses started a license server process. In this release, the license server process is not required because these types of licenses are uncounted.

Rational Rose

New Rational Rose Features and Enhancements

This release of Rational Rose includes these new features and enhancements:

New Rose J Add-In Features and Enhancements

The Rose J add-in supports true round-trip engineering and provides support for large frameworks. This release of the Rose J add-in provides the following new capabilities:

Rose ANSI C++ Features and Enhancements

Rose ANSI C++ is the new Rational Rose language add-in in support of the C++ programming language.

Because of its many benefits, users are encouraged to convert their models from Rose C++ to Rose ANSI C++. Rose ANSI C++ is designed to be powerful enough to handle large projects, with particular emphasis on scalability and completeness of language support. The user interface has been completely overhauled to make it easy to understand and use.

A model converter is included as an add-in, and the ANSI C++ online help provides instructions for this easy conversion.

Rose ANSI C++ provides:

Batch File Load

Progress Bar/Cancel

Macros

AutoSync

ClearQuest

Improved Security Model

The latest release of ClearQuest significantly improves the security model. This is achieved on two levels. First, Super User privileges are no longer required to perform certain administrative tasks. Second, specific defects and other change requests in ClearQuest can be hidden based on group membership. This enables users to grant their customers controlled access to user databases for submission and modification of change requests, as well as creation and execution of queries. Several new features have been added to ClearQuest to improve the security model, as described below.

Ability to Hide Change Records

Enables certain defects and other types of change request records to be hidden from specific users based on what group they belong to. By allowing any reference field to be a security context field, ClearQuest UNIX will hide certain change requests from specified groups of users.

Ability to Administer Dynamic Choice Lists

A new privilege, called Dynamic Choice List Administrator, enables creation and modification of dynamic choice lists. This includes the ability to add, delete, and modify entries in dynamic choice lists without having Super User privileges.

Ability to Administer Public Queries Folder

A new privilege, called Public Folder Administrator, enables specific users to manage the public folder. This enables certain users to move queries, charts, report formats and reports to the public folder without Super User privileges.

New User Privilege to View and Edit SQL

This privilege allows users to edit the SQL code that is generated for queries. Users without this privilege can view but cannot modify the SQL code. It is important that users not have this privilege when record hiding has been enabled. Modifying the SQL code directly can allow users access to all defects.

Ability to Administer Security at a Site

This privilege is related to the ability to hide change request records based on user group membership. Users with the Security Administrator privilege can view all data in a database since the security checks are not enabled for users with this privilege. This enables the administrator to grant one or more users in a specific group access to all data in the system, even if other members of that group are restricted from viewing certain records in the database. However, this user is not allowed to add new users or update the schema.

Downward Compatibility

Rational ClearQuest UNIX now supports downward compatibility between different feature levels of the ClearQuest databases. This allows users to upgrade to a newer version of the product in a staged manner by first upgrading all the client machines to the new version and then upgrading the ClearQuest databases.

Rational Purify, Quantify and PureCoverage

A new HTML-based online help system has been added in this release for all three products: Rational Purify, Rational Quantify, and Rational PureCoverage.

Solaris

This release supports Solaris 8. Also, this release provides support for the following compilers: Forte 6 Update 1 compiler; (compiler version 5.2) and gcc 2.95.2 compiler.

HP-UX

HPUX 10.01 and 10.10 are no longer supported. HP-UX 10.20, 11.00, and 11.11 are supported.

This release supports objdebug style debug information generated by cc and aCC compilers. With the +objdebug option to the compiler, extra debug information is placed into each object file to help the debugger locate the object file and to quickly find global types and constants.

Rational Unified Process

Rational Suite DevelopmentStudio, version 2001A.04.00 provides three variants of Rational Unified Process (RUP):

Since many companies today have heterogeneous environments, that is., they have a mixture of operating systems, technologies (IBM and Microsoft), and a mixture of Rational Suite products (UNIX and Windows), this version of Rational Suite DevelopmentStudio allows you to install any or all three variants of RUP.

The default variant, RUP (Generic) is for UNIX. You can define any one of the three variants as the primary. For more information see Installing Rational Suite DevelopmentStudio.

Note: Rational Unified Process is not supported on HP-UX 10.20. Supported HP-UX platforms for this product include HP-UX 11.00 and 11.11.

SoDA

The following section describes the changes made to SoDA between the SoDA 3.1.0b and SoDA 2001A.04.00 releases.

FrameMaker + SGML

FrameMaker + SGML is no longer shipped with SoDA. It must now be licensed and installed independently. Rational SoDA 2001A.04.00 supports FrameMaker+SGML 5.5 and 6.0. FrameMaker (without SGML) cannot be used in place of FrameMaker + SGML.

If you have previously installed version 3.0.1, 3.0.3, or 3.1.0 of Rational SoDA, you may choose to use the installation of FrameMaker+SGML bundled with that release. To do this, copy the entire SoDA directory to a new location and uninstall the previous version of Rational Suite DevelopmentStudio. This way, you do not accidentally remove the previous version of Rational SoDA when you uninstall the Suite.

Note: To optimize disk space by removing the SoDA components and keeping only the FrameMaker+SGML components, refer to Technical Application Note 17972 at the following location: www.rational.com/support/.

Rose Domain

The Rose 2001 domain now operates as a client-server application, if you have Rose already running on your system, the Rose domain will connect to that instance of Rose for retrieving model information. This has the advantage of improved performance and reduced memory consumption if Rose is already running on the system, however note that if you are viewing a different model than the one required by the SoDA domain, the required model will automatically be loaded in your Rose session.

The Rose 2001 domain no longer uses encapsulated postscript as the format for graphics imported into a SoDA template, instead JPG is used. See the note under the Rose RealTime domain below for additional information regarding graphics.

If you are using Rose for the first time, it is recommended that you run Rose at least once before attempting to generate a Rose template. This ensures that Rose properly sets up your Windows emulation environment.

Rose/SoDA Integration on HP-UX

At the time of publication, there was an outstanding issue relating to the use of SoDA's Rose integration on HP-UX. In some situations, the Rose application may terminate or issue Ole exception errors while SoDA is generating a template. This is usually caused by registry entries that are incompatible with SoDA's Rose client application.

The SoDA-Rose integration is sensitive to the default registry settings and certain personalized settings that you may have in the <user>.reg file in your home directory. You may use either of the following methods to generate SoDA templates on HP-UX:

1 Before generating a Rose template on HP-UX, ensure that Rose is not running on your desktop. SoDA will automatically start Rose as a background task when you generate a template. If you allow SoDA to start Rose, template generation should proceed normally with no errors.

2 Modify the <user>.reg file in your home directory. In the section [HKEY_CURRENT_USER\Software\Rational Software\Rose\Rose], add the following key: "AutoConstructMainDiagrams"="Yes". This key may already exist in your personal registry file. If so, ensure that the value for this key is "Yes". If you do not have a <user>.reg file in your home directory, you may create one based on the default file provided in your Rose installation. See the Rose product documentation for further information.

These restrictions for using SoDA on HP-UX will be removed in a future patch release.

Rose Templates

Users of Rational Rose who are upgrading from SoDA 3.0.1C or earlier should note that the schema for the Rose 98i, 2000 and 2001 domains is different from that of the Rose 98 domain shipped with previous versions of SoDA. The Rose templates shipped with SoDA have been updated to the new schema, however your existing Rose templates cannot be edited or generated using the new Rose 98i, 2000 or 2001 domains. An upgrade utility is provided with SoDA for upgrading older Rose templates for compatibility with Rose 98i, 2000 and 2001. The utility is accessible through the SoDA>Utilities>Upgrade Document menu. See the Upgrading SoDA section of the online help for more information. There is no template change between Rose 2000 and Rose 2001.

Ghostscript Support

SoDA is shipped with Ghostscript 2.6.1, which is used during generation of Rose templates to improve the appearance of diagrams. Ghostscript may be optionally installed while installing SoDA. Note that the use of Ghostscript is only beneficial if you are running Rose 2000e. The Rose 2001 integration no longer generates encapsulated postscript files.

Note: Ghostscript is public domain software provided without warranty. Its use is subject to the GNU General Public License.

Rose RealTime Domain

SoDA includes a domain compatible with Rose RealTime for UNIX.

Note: To install the Rose RealTime domain, Rose RealTime must already be installed on your system.

Exporting Graphic Files (Rose and Rose RealTime)

The environment variable SODA _GRAPHIC_FORMAT is used to specify the type of graphics files exported from the Rose or Rose RealTime domain. By default, this is set to JPG. In this case, when a document is generated from a Rose or RoseRT model, the domain will create a directory named <document name prefix>.dia and will fill it with a JPG file for each diagram requested from the model. On Solaris, the environment variable SODA_GRAPHIC_FORMAT can be changed to TIFF, which causes TIFF files to be generated rather than JPG.

Apex Domain

The Apex domain supports Apex 3.2, and Apex 4.0 in this release. The Apex domain for version 3.0 is no longer included on the distribution media. Contact Rational Technical Support if you still require this combination.

The Apex domain for Apex 4.0 introduces the Apex/ClearCase integration. Apex/ClearCase provides the Apex development environment while enabling the use of ClearCase for configuration management and version control. If you are using the Apex/ClearCase integrations, there are a few limitations to be noted:

TestMate Domain

The TestMate domain supports TestMate 3.0 and TestMate 3.2 in this release.

ClearCase Domain

The SoDA integration domain for ClearCase 3.0 and later is included in this release. This version of the ClearCase domain contains an updated schema for better compatibility with the ClearCase domain available on Windows. Clear-Case 4.0 or later is required to use the UCM features of the ClearCase domain.

ClearQuest Domain

This release of SoDA includes support for ClearQuest 2001A.04.00 on UNIX. If you have Rational ClearQuest for Solaris or HP-UX, you may use SoDA to document your ClearQuest database.

The ClearQuest domain utilizes a feature of SoDA/Frame called dynamic schema generation. This feature allows SoDA to determine the schema corresponding to a particular ClearQuest database at runtime. Since different ClearQuest databases will have different schemas, the properties and relationships available within a ClearQuest template depend on the database being documented. SoDA communicates with ClearQuest to determine the schema for a particular database as needed. This may happen during template customization, or during generation. SoDA will prompt you for a login name and password for your ClearQuest database. There will be a short delay while SoDA communicates with ClearQuest to obtain the database schema.

For further information on how to use the ClearQuest integration, please see the on-line help.


Documentation

Rational Suite DevelopmentStudio and point-product documentation is provided in this release. Suite-specific documentation is provided online in HTML and PDF format and can be accessed before installing the Suite. Table 1 lists the location of the Suite-specific documents on the Rational Suite DevelopmentStudio CD.

Table 1 Suite-Specific Documents
Document

Locations

Installation manual

/docs/pdf/suite_install
/docs/html/suite_install


Release Notes (this document)

/docs/pdf/suite_relnote
/docs/html/suite_relnote


Introducing Rational Suite

/docs/html/suite_intro
/docs/pdf/suite_intro


Viewing Documentation Online

Rational Suite DevelopmentStudio includes a documentation browser that you can use to browse all of the documentation both directly from the CD and from the installed product area. To view documents directly from the CD, run the command rs_help from the CD's root directory. To view documents from the installed product area, run the command rsdsu_help (this assumes that you have set up your Suite environment for the shell that you are using by running rs_setup.csh, or rs_setup.ksh).

Point-product manuals are also available in the /docs area. Generally speaking, these documents are available as PDF (under /docs/pdf). The README.html file in the /docs directory provides a listing of these documents and direct links to each of them. A text version of this file (README) is also available in the /docs directory. Text README files are provided in each PDF document directory with instructions for accessing the files in that directory.

A browser is required to view the HTML files. Adobe Acrobat is required to view the PDF files. Copies of Netscape Navigator and Adobe Acrobat are provided on the Rational Suite DevelopmentStudio CD in the /extras directory. Both these products are installed by default unless you choose otherwise. After you have installed the product, Netscape Navigator and Adobe Acrobat are installed in the rational_dir/base/cots directory, where rational_dir is the installation path for the Suite. The rs_help command starts Netscape and opens the page to a list of documents in this release. Point your browser to rational_dir/releases/DevelopmentStudioUNIX.2001a.04.00/docs/index.html for a framed HTML page with a table of contents containing links to all HTML and PDF documents.

Netscape Navigator 4.7 is supplied with this release and is configured so that when you click on a link to a PDF file, Acrobat is automatically launched. If you are using an installation of Netscape Navigator that is not configured for the same functionality, you can access the PDF files with the Adobe Acrobat acroread executable.

The complete Rational Suite product documentation set can be ordered separately. For a complete printed documentation set, contact your Rational Sales office.

Product Release Notes

Each product included in the Rational Suite DevelopmentStudio provides its own set of release notes dealing only with issues related to that product. All of these release notes are provided online in PDF or HTML format. The following release notes are provided:

These release notes can be found online in the /docs area.

Windows components Documentation

Documentation for the following Rational Suite DevelopmentStudio (Windows components) can be found on the Rational Solutions for Windows Online Documentation CD:

Rational ClearCase LT Documentation

Documentation for Rational ClearCase LT can be found on the Rational ClearCase LT CD.


Known Problems

The following section contains the known problems associated with this release. Further information about point product issues can be found in the product-specific release notes.

Table 2 lists known problems with the Suite.

Table 2 Known Problems with DevelopmentStudio for UNIX  
Case Number

Description

41413

Remote installation of Solaris point products from an HP-UX system is not supported.
Workaround: Run the Solaris installation either locally or from a remote Solaris system.

41849

If you experience frequent problems such as internal errors or vendor daemon errors, it could be because you have not upgraded your FLEXlm license server software from FLEXlm 6.0. It is highly recommended that you upgrade the license server software from FLEXlm 6.0 to FLEXlm 7.0 if you have not already done so. This will allow you to take advantage of the new features and help optimize your license server's performance.
Workaround: If you experience frequent problems, you should upgrade the license server software as a first step to address these issues.

42520

Cannot uninstall a single architecture. If both HP and Solaris editions of the Suite are installed in the same rational_dir, there is no selection to uninstall just one.
Workaround: It is not recommended that different editions of the Suite be installed in the same directory. The uninstall command cannot uninstall multiple editions of the Suite. It only gives you the ability to uninstall individual point products.

44800

The viewrup command does not work on HP-UX 10.20.
Note: Rational Unified Process is not supported on HP-UX 10.20. Supported HP-UX platforms include: 11.00 and 11.11
Workaround: Currently, no known workaround.

45790

When starting Rose after doing a new installation, you may encounter errors if you removed the directory where your previous version of Rose was located. This is because some of the startup files (for example, roseddl.pty, DefaultStereotypes.ini, stereocorba.ini, and so on) are looking for these files in the previous location where Rose was installed.
Workaround: To stop the errors from occurring, run rose_cleanup.

48996

RSU_LICENSE_MAP variable not reset to new installation directory.
This occurs if you have run rs_setup.csh or rs_setup.ksh, uninstall the product, reinstall a new version of the product, and run rs_setup.csh or rs_setup.ksh again. The RSU_LICENSE_MAP is still set to the original installation directory.
Workaround: You have two ways to avoid this situation:

1 You can log out and log on again. Rerun rs_setup.csh or rs_setup.ksh.

2 You can unset the environment variable RSU_LICENSE_MAP and rerun rs_setup.csh or rs_setup.ksh.

To unset the environment variable in csh, type:

unsetenv RSU_LICENSE_MAP

To unset the environment variable in ksh, type:

unset RSU_LICENSE_MAP


49055

You are prompted for a port number when you are setting up a node-locked license. Node-locked licenses are uncounted and do not require that a license server process be started; therefore, the port@host information is not required.
Workaround: Ignore this prompt and press the Enter key.

49093

Receive the message "Cannot find license file" when trying to use the Rational CaseCase/ClearQuest integration.
On Solaris 2.6, 2.7 (Solaris 7), and 2.8 (Solaris 8) there is a problem with the select() system call if the file descriptor limit is set above 1024. This manifests itself as a license checkout failure when applications are run or when the license server is started. Ensure that the file descriptor limit is set to 1024. A user can set this limit using the limit or ulimit command as summarized below.
For sh, ksh, bash users:

49391

Rose/SoDA Integration on HP-UX
At the time of publication, there was an outstanding issue relating to the use of SoDA's Rose integration on HP-UX. In some situations, the Rose application may terminate or issue Ole exception errors while SoDA is generating a template. This is usually caused by registry entries that are incompatible with SoDA's Rose client application.
The SoDA-Rose integration is sensitive to the default registry settings and certain personalized settings that you may have in the <user>.reg file in your home directory. You may use either of the following methods to generate SoDA templates on HP-UX:

1 Before generating a Rose template on HP-UX, ensure that Rose is not running on your desktop. SoDA will automatically start Rose as a background task when you generate a template. If you allow SoDA to start Rose, template generation should proceed normally with no errors.

2 Modify the <user>.reg file in your home directory. In the section [HKEY_CURRENT_USER\Software\Rational Software\Rose\Rose], add the following key: "AutoConstructMainDiagrams"="Yes". This key may already exist in your personal registry file. If so, ensure that the value for this key is "Yes". If you do not have a <user>.reg file in your home directory, you may create one based on the default file provided in your Rose installation. See the Rose product documentation for further information.

These restrictions for using SoDA on HP-UX will be removed in a future patch release.

49445

Cannot serve both a UNIX node-locked license and a Windows floating license on a UNIX license server.
Workaround: The node-locked license must be served from a UNIX license server and the Windows license must be served from a Windows license server.

49454

Frame *.lck files are not always removed on HP-UX 11.00
When you close a document using FrameMaker+SGML 5.5.6, the Frame *.lck files are not always removed. This is a known issue with FrameMaker+SGML. When the document is re-opened, the Document in Use dialog is displayed.
Workaround: Click Reset Lock and Open to continue editing the document.
Also, if you specify a filename in the Generate Into box on HP-UX, you may see a generation report containing the message "The specified name is invalid." This can occur if you previously generated another (or the same) template as the same target file. If a *.lck file exists for the target file from the previous generation, SoDA will not be able to write the document after generation.
Workaround: Manually remove the *.lck file prior to generation.

49624

You have installed both the 32- and 64-bit versions of Purify and Quantify as part of the Suite installation on HP-UX 11.00 or 11.11. Later, you decide to remove the 32-bit version by running uninstall. You will find that the 64-bit version no longer works.
Workaround: Uninstall the 64-bit version. Reinstall the 64-bit version without the 32-bit version. The product will now run correctly.

49724

A mixed license file (one with both Suite and Developer Tools named user licenses) can be requested from AccountLink. When you attempt to set up the named user licenses for Developer Tools, you should be prompted for authorized user names. This does not occur if there is a Floating license for another Rational product in the license file, for example, a Rational Suite DevelopmentStudio license. (Reference Tech Note ID: 17853)
Workaround: Make a copy of the license file (filename.upd). Remove all but the Named User licenses and save the license file. Rerun the license_setup and import the new license file. You will be prompted for the user names to be served.

49595

60-byte Memory leak
Workaround: No known workaround

49974

Get an error message when you define a new cache directory location that is not owned by the installer.
Workaround: Ignore the error message and proceed with the installation. If the cache directory is writable by everyone, no action is necessary. If not, change the directory permissions to be writable by everyone.
Alternatively, rerun post_install and set the default cache location to a new directory so that the permissions on the directory can be set properly.

50033

An error may occur during SoDA post_install when SoDA tries to remove a link when the file is a directory. This can happen if files were copied using the cp -r command on Solaris. Links are not copied but full copies of the files are. When you get this error, the link for FrameMaker+SGML will not be performed/created? so SoDA will not work.
Workaround:

1 Use the following command to copy the files.

find . -depth -print | cpio -pdmu /destination

This command requires that you are in the source directory and that the destination directory exists.

2 Run post_install for SoDA and point to the properly copied directory.



Contacting Rational Technical Support

If you have questions about installing, using, or maintaining this product, contact Rational Technical Support as follows:

Your Location

Telephone

Facsimile

E-mail

North America

(800) 433-5444
(toll free)

(408) 863-4000
Cupertino, CA


(781) 676-2460
Lexington, MA


support@rational.com

Europe, Middle East, Africa

+31 (0) 20-4546-200
Netherlands


+31 (0) 20-4545-201
Netherlands


support@europe.rational.com

Asia Pacific

+61-2-9419-0111
Australia


+61-2-9419-0123
Australia


support@apac.rational.com

Note: When you contact Rational Technical Support, please be prepared to supply the following information:


Contacting Rational Licensing Technical Support

If you have questions about acquiring license keys for your Rational Software products, contact Rational Licensing Support as follows:

Your Location

Telephone

Facsimile

E-mail

Asia Pacific

+61-2-9419-0111

+61-2-9419-0123

license@apac.rational.com

Asia Pacific (Japan)

+61-2-9419-0111


+61-2-9419-0123

license@japan.rational.com

Asia Pacific (Korea)

+82-2-556-9420

+82-2-556-9426

license@apac.rational.com

Asia Pacific (Mainland China, Hong Kong, and Taiwan)

+61-2-9419-0111

+61-2-9419-0123

license@china.rational.com

Europe
Middle East
Africa


+31 20 4546 200


+31 20 4546 202

license@europe.rational.com

North American (East Coast) South America

800-433-5444
(toll free)


781-676-2460

license@rational.com

North America (West Coast) Central America

800-433-5444
(toll free)


408-863-4001

license@rational.com

Online Support on the World Wide Web

Online support can be found on the World Wide Web at the following location: www.rational.com/support/

This location includes any updates not available at the printing of this manual in relation to such documents as:

This website also includes such information as:


Rational Software Corporation  http://www.rational.com
support@rational.com
techpubs@rational.com
Copyright © 1993-2001, Rational Software Corporation. All rights reserved.
TOC PREV