Workarounds: Rational Software Architect Client Extension problems in Design Management 4.0
Authors: Chad Beery, Patti Hiscock, and Catherine Radatus
Last Updated: October 16, 2012
Build Basis: Design Management 4.0
Important: Ensure you install the Design Management 4.0 iFix001 to fix a model corruption problem in the client extension. After you connect to a server repository, when you edit a local UML models, the model may become corrupt and unusable when not connected to the Design Management Server.
The table of contents below lists all of release notes related to the Rational Software Architect Client Extension functionality in the Design Management 4.0 release.
- You cannot create a UML model for Integrated Architecture (UPIA), RealTime (RT), or Service-Oriented Architecture (SOA) models when a project area is associated with the correct corresponding domains
- You might not be able to move shapes on topology diagrams
- If an alias URI was used to configure a Collaborative Lifecycle Management (CLM) server as a friend of the Design Management Server, you might have to log in twice to the Rational Software Architect Design Manager Client Extension to access that server
- You might not be able to create or delete links to artifacts in Rational DOORS by using the Rational Software Architect Design Manager Client Extension
- In Rational Software Architect versions 8.0.4.1 and 8.5, the UML-to-SCA and UML-to-WSDL transformations do not run successfully if a source model exists in a Design Management repository
- Topic diagrams created in the Rational Software Architect Design Manager Client Extension cannot be imported to Design Management Server
- In the Design Management web client, clicking on references to visualized elements does not return relevant information
- You cannot import topologies and deployment artifacts that are stored in the Design Management repository into other topologies, and you cannot drag and drop deployment artifacts from the Design Management repository to topology diagrams
- A Design Management link is missing if the corresponding asset is published using the Rational Software Architect Design Manager Client Extension version v8.0.4.x
- Transformations that target UML models that are located on a Design Management server do not run
- The labels on shapes, connectors, or border items are displayed correctly in the Rational Software Architect Design Manager Client Extension, but are missing when the diagram is displayed in a web browser
- You cannot install the Rational Software Architect Design Manager Client Extension into an existing Rational Software Architect installation
Workaround Summary
If you plan on using the Rational Software Architect Design Managment client extension, you must install a mandatory iFix.
After you connect to a server repository, when you edit a local UML model, it may become corrupt and unusable when connected to the server. The problem happens in both Rational Software Architect version 8.5 and Rational Software Architect verion 8.0.4.1.
Problem
After connecting to server repository, editing local UML model may cause pathmap references such as:
pathmap://UML_LIBRARIES/UMLPrimitiveTypes.library.uml#String
to be converted to server references such as:
https://server:port/dm/models/RSA_UML_LIBRARIES_UMLPrimitiveTypes_library_uml#String.
This is model corruption. The local UML model will not be usable without server connection.
Workaround
Complete the following steps:
- Download the iFix from this All Downloads tab.
- Read and follow the instructions on the Design Managment 4.0 iFix001 Release Notes tab on Jazz.net.
Workaround Summary
You cannot create a UML model for Integrated Architecture (UPIA), RealTime (RT), or Service-Oriented Architecture (SOA) models when a project area is associated with the correct corresponding domains; new model templates for UPIA and other UML extensions do not appear in the new model wizard.
Problem
This problem occurs because the extensions do not have new model templates registered with the Design Management Rational Software Architect client extension; therefore, no new model templates are displayed in the new model wizard.
Workaround
Complete the following steps:
- Assign the proper domains (RT, UPIA, SOA, for example) to the project area.
- In the client extension, right-click a project area; then click New > UML Model.
- In the New Model wizard, select General category; then click the Blank Package template.
- Select the root package, and then display the properties view. On the Profiles tab, click Add Profile.
- Select the UPIA, SOA or RT profile and save the changes.
- Share the change set with others if the Share with others check box is not selected.
- Close the main diagram, then open it. Verify that the profile palette entries are displayed.
- Verify that at least one of the Explorer Node Content Definition exists for any class of each of the domains that the viewpoint should be used with.
- Save your changes in the viewpoint and refresh the page.
Workaround Summary
You might not be able to move shapes on topology diagrams.
Problem
In an actively managed project area, you might not be permitted to move shapes on topology diagrams. This is a refresh issue. This problem occurs only with topology diagrams; it does not occur with BPMN and UML diagrams.
Workaround
Complete the following steps:
- Move a shape on a topology diagram. Although the shape remains in the same location on the diagram, it has been moved.
- Click Save.
- Open the diagram. The shape is now in the new location.
Workaround Summary
If an alias URI was used to configure a Collaborative Lifecycle Management (CLM) server as a friend of the Design Management Server, within Rational Software Architect Design Manager Client Extension, you might have to log in twice to CLM friend servers.
Problem
If you or an administrator specifies an alias to configure a CLM server as a friend of the Design Management Server, within the Rational Software Architect Design Manager Client Extension, you might have to log in twice to CLM friend servers. This problem occurs because the client extension’s cookie manipulation logic does not work as expected in this scenario. After you log in, the client extension operates as expected.
Workaround
Avoid using an alias URI when you configure a CLM server as friend of the Design Management Server.
Workaround Summary
You might not be able to create or delete links to artifacts in Rational DOORS by using the Rational Software Architect Design Manager Client Extension.
Problem
In the Rational Software Architect Design Manager Client Extension, you can only view existing links to artifacts in Rational DOORS. You might not be able to create or delete those links.
Workaround
You can use the Rational Software Architect Design Manager web client to create or delete links to artifacts in Rational DOORS. You can view the links by using the Rational Software Architect Design Manager Client Extension.
Workaround Summary
In Rational Software Architect versions 8.0.4.1 and 8.5, the UML-to-SCA and UML-to-WSDL transformations do not run successfully if a corresponding source model exists in a Design Management repository.
Problem
Due to a transformation configuration (TC) validation failure, the UML-to-SCA and UML-to-WSDL transformations do not run in Rational Software Architect versions 8.0.4.1 or 8.5 when Rational Software Architect has a source model in a Design Management repository.
Workaround
Expand the elements of the source model in the transformation configuration window: Double-click a .tc file, and in the transformation configuration editor, on the Source and Target page, expand the source model so that at least one component element, which is composite, is expanded fully.
Workaround Summary
You can use topic diagrams locally on the Rational Software Architect Design Manager Client Extension; they cannot be imported into Design Management Server.
Problem
Topic diagrams created in the Rational Software Architect Design Manager Client Extension cannot be imported into Design Management Server. The Design Management Server does not support importing, creating or rendering Rational Software Architect topic diagrams.
Workaround
You can use topic diagrams locally on the Rational Software Architect Design Manager Client Extension.
Workaround Summary
In the Design Management web client, clicking on references to visualized elements does not return relevant information.
Problem
References to visualized elements, such as Java classes or XSD elements, do not have proper editors or compact renderers defined on the Design Management web client. If you click on such a reference in a web browser, information does not load, and preview windows or tool tips for links to these elements do not display relevant information.
Workaround
There is no workaround for this problem.
Workaround Summary
You cannot import topologies and deployment artifacts that are stored in the Design Management repository into other topologies, and you cannot drag and drop deployment artifacts from the Design Management repository to topology diagrams.
Problem
You cannot import topologies and deployment artifacts that are stored in the Design Management repository into other topologies. You also cannot drag and drop deployment artifacts from the Design Management repository to topology diagrams that are stored in either a file in the local Eclipse workspace or in the Design Management repository.
Workaround
There is no workaround for this issue. This feature is not supported in the Design Management 4.0 release.
Workaround Summary
A Design Management link is missing if the corresponding asset is published using the Rational Software Architect Design Manager Client Extension version v8.0.4.1.
Problem
When you publish a Design Management model to Rational Asset Manager, the Rational Asset Manager asset should have a link pointing back to model element in Design Management. If you publish the asset by using Rational Software Architect Design Manager with Rational Software Architect version 8.0.4.1, the link is missing. The problem only happens when you are using Rational Software Architect version 8.0.4.1; it does not happen when you use Rational Software Architect version 8.5.
Workaround
The feature works with Rational Software Architect version 8.5. The workaround is to upgrade from version 8.0.4.1 to version 8.5.
Workaround Summary
Transformations that target UML models that are located on a Design Management server do not run.
Problem
An exception is thrown for any Rational Software Architect transformation that has a target that is a UML model if the model is stored on a Rational Software Architect Design Management server. This occurs for reverse transformations if the source of the transformation is a UML model and the transformation is configured to support a reconcile protocol.
Workaround
The transformation must target a local UML model. The local model can then be imported to a design management server.
Workaround Summary
The labels on shapes, connectors, or border items are displayed correctly in the Rational Software Architect Design Manager Client Extension, but are missing when the diagram is displayed in a web browser.
Problem
If the font that you use for labels is not available on the system, the operating system substitutes the missing font with an existing one. This issue is platform specific and is handled by SWT string painting. AWT uses tables JRE to default to specific fonts, which are different from the fonts that the operating system defaults to, and are different from SWT. Therefore, the same string with a very specific font that is not available on the operating system might be painted differently in SWT and AWT.
Workaround
Complete the following steps:
- Shut down the server.
- In a text editor, open the Design Management installation folderserverserver.startup file.
- Add the following line to the file: “-Dibm.dm.rsa.imageFormat=jpg”.
- Save the file.
- Start the server.
- Open the diagram and verify that the labels are displayed correctly.
Workaround Summary
You cannot install the Rational Software Architect Design Manager Client Extension into an existing Rational Software Architect installation.
Problem
The Rational Software Architect Design Manager Client Extension requires that the UML modeling feature be installed.
Workaround
Complete the following steps:
- Start IBM Installation Manager.
- On the Start page, click “Modify”.
- In the Modify Packages wizard, select the “IBM Software Delivery Platform” product package group and click “Next”.
- On the Translations page, click “Next”.
- On the Features page, expand the navigation tree to “IBM Rational Software Architect 8.5” > “Rational Software Architect” > “Solution Architecture and Model-Driven Development”.
- Select the “UML Modeling” check box.
- On the Summary information page, click “Modify”. The UML modeling feature is added to the RSA installation.
- Install the RSA DM client extension into the modified RSA installation.
Copyright © 2012 IBM Corporation