Frequently Asked Questions (FAQ)

Troubleshooting

• I have an Out Of Memory Error running Publisher for Rhapsody™.
• I have a Memory Error opening my model in MagicDraw.
• I try to run the Publisher and I get an invalid Rhapsody version issue.
• Publisher remains blocked and I don’t know what to do.
• I have an Exception "The Semantic Model is invalid - It must contain a UML Model". What should I do?

Tools/Installation

• I want to publish to MagicDraw 19.0.
• I have an older Rhapsody version than 8.3.1.
• How to obtain the license information needed?

Transformation

• Text boxes, class markings, and text are not converted.
• Why do I have a "_TAGS" Profile in my model?
• How about the links back to DOORS? Are they migrated to DataHub?
• How will the export impact if we have custom stereotypes used in the Rhapsody model?
• Can you expand upon the SysML limitations or mappings between Cameo and Rhapsody?
• Is there a limitation on model structure between the Rhapsody and Cameo? i.e. is model structure maintained?
• After the migration can you continue to develop the Cameo model?
• Why my Actors are migrated over as blocks?
• Why do I have a synchronisation warning on Action or Message?
• Why do I have an error on GraphEdge?

Troubleshooting

• I have an Out Of Memory Error running Publisher for Rhapsody™.

  You can increase the VM arguments, on %PUBLISHER_INSTALL_DIR%\publisher.ini, like:
  -startup
plugins/org.eclipse.equinox.launcher_1.5.700.v20200207-2156.jar
--launcher.library
plugins/org.eclipse.equinox.launcher.win32.win32.x86_64_1.1.1200.v20200508-1552
-clean
-vmargs
-Dosgi.requiredJavaVersion=11
-Dosgi.instance.area.default=@user.home/rhp2md-workspace
-Xms256m
-Xmx10g
-Drhapsody.omroot=S:
-Drhp2md.graphical.properties.path=C:\ProgramData\Publisher4Rhapsody\3.3.1\display.properties
-Drhp2md.publisher.properties.path=C:\ProgramData\Publisher4Rhapsody\3.3.1\publisher.properties
  
  Note 1: The values to set depend on the specifications of the system you are working on. If this is not enough, you could try to increase again the Xmx value.
  Note 2: Values can be managed when installing Publisher for Rhapsody.

• I have a Memory Error opening my model in MagicDraw.

  If during your work the out of memory error dialog box appears, change the Java Heap size and the MaxPermSize directly in this dialog box.
  In the Xmx field change the number of heap size to bigger heap size in megabytes. In the XX:MaxPermSize field you can increase the MaxPermSize.
  You can also change the java heap size or MaxPermSize in the magicdraw.properties file.

• I try to run Publisher for Rhapsody™ and I get an invalid Rhapsody version issue.

  If you have this kind of error, it means that there is a compatibility issue between Java, Rhapsody and the Publisher.

• Publisher remains blocked and I don’t know what to do.

  If Publisher for Rhapsody seems to have been running in a vacuum for a long time, a problem may have arisen.
  We have developed a problem management process which you will find in the section Troubleshooting Publisher for Rhapsody.

• I have an Exception "The Semantic Model is invalid - It must contain a UML Model". What should I do?

  This message appears when an issue occurs running Transformation from Rhapsody to UML2.
  However, it can also occur if the installation of the Publisher for Rhapsody is not correctly done.
  We have developed a problem management process which you will find in the section Troubleshooting Publisher for Rhapsody.

Tools/Installation

• I want to publish to MagicDraw 19.0.

  To publish to MagicDraw 19.0, set the option magicdraw.profile.version to "19.0" in the publisher.properties file, such as:
  magicdraw.profile.version=19.0.

• I have an older Rhapsody version than 8.3.1.

  Publisher for Rhapsody has been validated with Rhapsody 8.3.1, 8.4, 9.0.2 and 10.0.1.
  Older versions of Rhapsody are not supported.

• How to obtain the license information needed?

  To obtain the license information needed, run FlexNet LMTools GUI.
  Select System Settings tabulation, then Save HOSTID info to a File by clicking the corresponding button.
  Provide the generated file to the support team.

Transformation

• Text boxes, class markings, and text are not converted.

  Because of Rhapsody API Limitations, Free Shapes can only be transformed from Rhapsody 9.0.2 and running Publisher for Rhapsody 2.5.0.

  The Publisher has limitations when publishing free shapes because of MagicDraw limitations. The available Free Shapes in MagicDraw are:
  

  • Rectangular shapes
  • Horizontal and vertical lines
  • Image shapes
  Other shapes (Polylines, Polygons, Curved lines, ...) won't be transformed. In addition, line style is not supported due to Rhapsody API limitations.

• Why do I have a "_TAGS" Profile in my model?

  In Rhapsody, it is possible to have Tagged Values on Elements, even if the Element is not Stereotyped, while this is not possible in MagicDraw.
  In Rhapsody, this is what we call "Local Tags".
  For example, "block_2" is not Stereotyped, while it has a "local tag" called "block_2_localTag1".
  
  To handle correctly Tagged Values in MagicDraw, Block "block_2" has to be stereotyped. And this is the stereotype that carries the Tagged Value:
  
  In this example, "block_2" is stereotyped <<LocalTags.block_2_Class_TAGS>> (<package_name>.<element_name>_<element_type>_TAGS).
  The Stereotype is owned by a Profile called "LocalTags_TAGS" (<package_name>_TAGS).
  In MagicDraw, "block_2" is stereotyped <<LocalTags.block_2_Class_TAGS>>, Tagged Values are set correctly:
  
  

• How about the links back to DOORS? Are they migrated to DataHub?

  Publisher for Rhapsody can publish OSLC Links between Rhapsody elements and IBM Rational Doors Next Generation (DNG) artifacts via an extra license. See the option Publish OSLC Links for more information.

• How will the export impact if we have custom stereotypes used in the Rhapsody model?

  Custom Stereotypes are transformed.

• Can you expand upon the SysML limitations or mappings between Cameo and Rhapsody?

  Some constructions are allowed in Rhapsody, while this is not allowed in UML2/Cameo. In this case, we use the concept of Profile/Stereotype to extend UML2 and enable the transformation of all data.

• Is there a limitation on model structure between the Rhapsody and Cameo? i.e. is model structure maintained?

  Structure of Elements between Rhapsody and Cameo is kept. For some special case (see previous comment) we have extended the UML2 metamodel so as not to lose the data.

• After the migration can you continue to develop the Cameo model?

  Yes.

• Why my Actors are migrated over as blocks?

  It is possible with Rhapsody to create Actor with features in it (Attributes, Operations) while this is not possible in UML/MagicDraw.
  With the Publisher for Rhapsody, we’ve made the choice to transform such Actors to Class (stereotyped <<RhpActor>>), otherwise, features are lost.

• Why do I have a synchronisation warning on Action or Message?

  The warning can occur for several reasons. Here is a list of what can be wrong:

  • There are more parameters in the declared Operation than the number of pins on the Action/Message implementing the Operation. Even if the Publisher creates missing pins, if two parameters at least have the same name, the creation of the pins will fail
  • There are less parameters in the declared Operation than the number of pins on the Action/Message implementing the Operation
  • The parameter and the corresponding pin do not have the same type

• Why do I have an error on GraphEdge?

  The error can occur for several reasons. Here is a list of what can be wrong:

  • Two ports, which does not have the same type, are linked by a GraphEdge