Installation using the RXFActivator
The
installation of an RXF by Willert Software Tools requires you to already
have the modeling tool Rhapsody installed.
A release of an RXF is delivered as ZIP-Archive. It contains all
framework files and the related tools, samples and documentation. You
should select a destination folder to unzip it where your user account
has read and write access.
We recommend to unzip it relative to your
IDE projects to be able to use it together with your configuration
management.
Once
the ZIP has been extracted, the framework is ready to be used.
But in most cases Rhapdody needs to be prepared to work together with the RXF. The RXF comes with
a small tool called RXFActivator, that performs the Rhapsody RXF integration for you.
From
the extracted RXF folder execute RXFActivator.exe, it will ask for
administrator rights that are needed e.g. to write to the registry. It
is a console application that will list all Rhapsody installations
found on your machine. All those Rhapsody versions can afterwards be
used with the RXF. The program can be exited by pressing any key after it has
finished.
Moving the RXF Folder and Installing new Rhapsody Versions
You can move the RXF folder to any other location with read and write access, there is no need to re-execute the RXFActivator.
But you need to re-execute it after a new Rhapsody version has been installed.
Possible Problems During Setup
If you experience any problems, please first check the following possible solutions:
- Make sure you have the necessary read/write access privileges in the RXF and Rhapsody directories.
- Make sure you have enough disk space available.
- Only Windows 10 is the supported operating system.
- If
you want to place the RXF on a "subst" mapped drive or on a network
drive, please make sure that the administrator account, executing the
RXFActivator sees the path to the RXF the same way your user sees it.
- Sometimes long path
names may cause problems. If RXFActivator failed, you may retry it after
moving all RXF files to a directory on
your local drive with shorter paths (e.g. "C:\Willert\") and
launching RXFActivator.exe from there again.
- If
the RXFActivator experiences problems, it shall print warning or error
messages. If you need further help, please include the console output
of the RXFActivator and send an e-mail to support@willert.de
Uninstalling the RXF
Basically all you need to do to uninstall the RXF is to delete its folder.
There is no new entry added to the Windows registry during installation.
Regarding the Rhapsody modifications the RXFActivator also performs,
usually there is no need to undo it. However if you completely removed
all RXFs
from your computer you can follow the following steps to make sure the
RXF does not leave modifications in the Rhapsody installation:
- In your Rhapsody "Share\Settings" or "UserShare\Settings" folder you shall find the subfolders "CodeCentric_Original" and
"SoftwareArchitect_Original". If that is the case, you may:
- delete the subfolders "CodeCentric" and "SoftwareArchitect" and
- rename subfolder "CodeCentric_Original" to "CodeCentric" and
- rename subfolder "SoftwareArchitect_Original" to "SoftwareArchitect"
- In your Rhapsody "Share\Properties" or "UserShare\Properties" folder edit the file SiteC++.prp
- If it contains an environment enumeration literal "RXF" you may remove it, including the following comma (",").
Putting the RXF under Configuration Management
See
Software Configuration Management page.