Building DDS4CCM
DDS4CCM is a Rational Software Architect (RSA) add-in for modeling component based systems
according to the OMG CCM standard.
DDS4CCM has support for the following CCM implementations:
DDS4CCM has support for the following OMG standards:
Build requirements
The build requires:
- a Java 8 or later JRE
- The build will automatically install an appropriate Maven version
Building
- Clone the DDS4CCM git repository.
- Start a shell, and change directory to the repository root.
- To run the build, execute the following commands
# increase Maven memory
export MAVEN_OPTS="-Xmx1024m"
# build
./mvnw -D "dds4ccm.root=`pwd`" clean verify
In Windows environments, you can use the fully qualified path name of the current
directory rather than using the result of the embedded pwd
command, or set the
DDS4CCM_ROOT environment variable before running:
REM increase Maven memory
set MAVEN_OPTS="-Xmx1024m"
REM set build directory variable
set DDS4CMM_ROOT=
mvnw.cmd clean verify
On macOS, it was is necessary to increase the shell's maximum number of open files.
The following was found to be acceptable:
ulimit -Sn 1024
The p2 repositories produced by the build will be found in releng/com.zeligsoft.dds4ccm.update.atcd/target
and releng/com.zeligsoft.dds4ccm.update.axcioma/target
:
- The sub directory
repository
is the created p2 repository.
- The files
com.zeligsoft.dds4cmm.update.atcd-<version>-SNAPSHOT.zip
and com.zeligsoft.dds4cmm.update.axcioma-<version>-SNAPSHOT.zip
are zip archives of these repositories.
- The build also creates a ZIP file with a date, in place of SNAPSHOT. The files are identical.
The later file is useful for distributing regular builds to a file server, allowing you
to distinguish build between results of successive builds.
Installing
DDS4CCM can be installed in Rational Software Architect (RSA), versions 9.5, 9.6 or 9.7.
A default RSA installation should be sufficient. To install:
- Start RSA as a super user. This is important.
- From the Help menu, choose Install New Software to start the Install wizard.
- On the Available Software page, click the Add button, to add a new software site.
- In the Add Repository dialog, click the Archive button, and in the dialog, browse for
the
com.zeligsoft.dds4ccm.update.atcd-*.zip
or com.zeligsoft.dd44ccm.update.axcioma-*.zip
file. Click OK.
- Click OK to close the Add Repository dialog.
- On returning to the Install dialog, check the checkbox beside CX CBDDS.
Optionally, you may check CDT to install the C/C++ development tools.
The CX CBDDS Runtime Dependencies features are always installed if you select
CX CBDDS. They are listed primarily for developers.
- With the your installation features selected, press Next.
- On the Install Details page, you should see additional information on features to
be installed.
If error messages are reported, please contact us. Click Next to continue.
- On the Review Licenses page, click the I accept... radio button, then click Finish.
- During the execution of the wizard, your may be prompted to approve the installation
of unsigned features. This will all have
com.zeligsoft
as a prefix to their names. Approve them.
With RSA 9.6 and RSA 9.7, you may be prompted to approve the signing certificate for Eclipse.org.
Approve it.
- Once the install has completed, you will be prompted to restart RSA. Do this.
- Once restarted, you may exit RSA (which you started as a super user in step 1).
Using CX CBDDS (aka DDS4CCM)
To use CX CBDDS:
- start RSA as a regular user.
- Choose a 'workspace' location, if prompted. This will be the disk location where your
DDS4CCM projects will be stored.
- Ensure the DDS4CCM 'perspective' is open: Choose Window > Open Perspective >
Other, and choose DDS4CCM. Click OK.
- The File menu will then have an option New DDS4CCM Project.
Further tutorial information is not currently stored in this project.