SmartMDSD Toolchain Installation

The official website of the SmartMDSD Toolchain is https://projects.eclipse.org/projects/modeling.smartmdsd and the source code of the SmartMDSD Toolchain is available via the github repository at https://github.com/eclipse/smartmdsd.

The following table lists the current recommendations for the operating system, the Eclipse Modeling Tools, the SmartMDSD Toolchain and the Java Runtime Environment (JRE):

On Ubuntu 20.04, you can get the Java Runtime Environment (JRE) by installing OpenJDK as follows:

sudo apt install openjdk-11-jre

At the technology level, the SmartMDSD Toolchain IDE is a combination of the Eclipse Modeling Tools and the SmartMDSD plugin.

If you are a toolchain user, you can get the SmartMDSD Toolchain either by downloading the ready-to-use binary version (Option 1) or by installing the binary SmartMDSD plugin in the Eclipse Modeling Tools (Option 2).

If you are a Toolchain developer, you can build your own toolchain plugin from the available SmartMDSD Toolchain sources (Option 3).

The following sections describe different ways to get the SmartMDSD Toolchain.

This option is recommended for the users of the SmartMDSD Toolchain (i.e Component Developer, Behavior Developer, System Builder or Domain-Expert). Ready-to-use, preinstalled binaries along with sources are available at https://github.com/eclipse/smartmdsd/releases.

Technically, these binaries contain the Eclipse Modeling Tools and they have the SmartMDSD plugin already installed. The sources are packaqged as jar files. One can import these source jar files and can have a look at these sources used for building the plugin. In case you want to build from sources, see Option 3.

Download the latest version i.e eclipse-smartmdsd-v3.19-2021-12.tar.gz, extract and run it.

The name of the “.tar.gz” indicate that the toolchain version is 3.19 and that the version of the Eclipse Modeling Tools IDE is 2020-09.

cd ~/SOFTWARE
 
#Download the ".tar.gz" of v3.19 Toolchain
wget http://ftp.fau.de/eclipse/smartmdsd/updates/releases/v3.19/2021-12/eclipse-smartmdsd-v3.19-2021-12.tar.gz
 
#Untar the downloaded file
tar -xzf eclipse-smartmdsd-v3.19-2021-12.tar.gz
 
cd eclipse-smartmdsd-v3.19-2021-12/
 
#Run the Toolchain
./eclipse

This option is also for the users of the SmartMDSD Toolchain. Here we download the Eclipse Modeling Tools IDE directly from the Eclipse website and install the prebuilt SmartMDSD plugin into the Eclipse Modeling Tools IDE through the update site.

The sources are packaged as jar files. One can import these source jar files and can have a look at these sources used for building the plugin. In case you want to build from sources, see Option 3.

The currently recommended versions of the Eclipse Modeling Tools and the SmartMDSD plugin along with the required links are listed below.

#code snippet to download Eclipse Modeling Tools and installing ​SmartMDSD Toolchain plugin
 
cd ~/SOFTWARE
 
#Temporary variables
ECLIPSE_BASE_VERSION=2021-12
TOOLCHAIN_VERSION=v3.19
SMARTMDSD_REPO_URL="https://download.eclipse.org/smartmdsd/updates/releases/${TOOLCHAIN_VERSION}/${ECLIPSE_BASE_VERSION}"
SMARTMDSD_FEATURE_NAME="org.eclipse.smartmdsd.toolchain.source.feature.group"
TOOLCHAIN_NAME=SmartMDSD-Toolchain-${TOOLCHAIN_VERSION}
 
#Download the Eclipse Modeling Tools version
#This link is slower and will take longtime to download
wget https://archive.eclipse.org/technology/epp/downloads/release/${ECLIPSE_BASE_VERSION}/R/eclipse-modeling-${ECLIPSE_BASE_VERSION}-R-linux-gtk-x86_64.tar.gz
 
#Untar the downloaded file
tar -xzf eclipse-modeling-${ECLIPSE_BASE_VERSION}-R-linux-gtk-x86_64.tar.gz
 
#Rename the extracted file
mv eclipse ${TOOLCHAIN_NAME}
 
#Optional remove the downloaded tar file
rm eclipse-modeling-${ECLIPSE_BASE_VERSION}-R-linux-gtk-x86_64.tar.gz
 
#Install SmartMDSD Plugins
#Alternatively, you can also install the plugin through Eclipse GUI using update site : https://download.eclipse.org/smartmdsd/updates/releases/${TOOLCHAIN_VERSION}/${ECLIPSE_BASE_VERSION}
cd ${TOOLCHAIN_NAME}
./eclipse -noSplash -application org.eclipse.equinox.p2.director -repository https://download.eclipse.org/releases/${ECLIPSE_BASE_VERSION} -repository ${SMARTMDSD_REPO_URL} -installIU ${SMARTMDSD_FEATURE_NAME}

This option is recommended for toolchain developers who want to contribute to the Eclipse SmartMDSD toolchain. This option is similar to option 2 except that instead of installing the released SmartMDSD plugin binaries, one will compile the binaries from the SmartMDSD Toolchain sources. The SmartMDSD Toolchain uses Maven and Tycho to build.

cd ~/SOFTWARE
 
#Temporary variables
ECLIPSE_BASE_VERSION=2021-12
TOOLCHAIN_VERSION=v3.19
SMARTMDSD_REPO_URL="https://download.eclipse.org/smartmdsd/updates/releases/${TOOLCHAIN_VERSION}/${ECLIPSE_BASE_VERSION}"
SMARTMDSD_FEATURE_NAME="org.eclipse.smartmdsd.toolchain.source.feature.group"
TOOLCHAIN_NAME=SmartMDSD-Toolchain-${TOOLCHAIN_VERSION}
 
#Download the Eclipse Modeling Tools version 
wget https://archive.eclipse.org/technology/epp/downloads/release/${ECLIPSE_BASE_VERSION}/R/eclipse-cpp-${ECLIPSE_BASE_VERSION}-R-linux-gtk-x86_64.tar.gz
 
#Untar the downloaded file
tar -xzf eclipse-modeling-${ECLIPSE_BASE_VERSION}-R-linux-gtk-x86_64.tar.gz
 
#Rename the extracted file
mv eclipse ${TOOLCHAIN_NAME}
 
#Optional remove the downloaded tar file
rm eclipse-modeling-${ECLIPSE_BASE_VERSION}-R-linux-gtk-x86_64.tar.gz

• Download Eclipse IDE for Java Developers
• Install Plug-in Developers Environment (PDE) in Eclipse IDE
• Clone the SmartMDSD source
• Import project into workspace as Maven project
• Select releng –> pom.xml
• Right click on pom.xml and Select “Run As” and choose “2 Maven build…”
• Enter “clean compile install” in “Goals:” editor and click on “Run”
• After the build, you will have binaries generated in org.eclipse.smartmdsd.toolchain.repository/target folder

Finally, install the compiled tool chain binary in Eclipse Modelling Tools via GUI.

Once you installed the SmartMDSD Toolchain, you can create a launcher which is handy to launch the SmartMDSD Toolchain via an application launcher. The below code snippet creates a launcher for the SmartMDSD Toolchain.

cd ~/SOFTWARE
 
#create a file named "SmartMDSD-Toolchain.desktop"
touch SmartMDSD-Toolchain.desktop
 
#add Desktop entry details to the file
#make sure paths of Exec, Icon entries are correct
echo "[Desktop Entry]
Name=SmartMDSD-Toolchain-v3.19
Version=v3.19
Comment=SmartMDSD Toolchain
Exec=$HOME/SOFTWARE/eclipse-smartmdsd-v3.19-2021-12/eclipse
Icon=$HOME/SOFTWARE/eclipse-smartmdsd-v3.19-2021-12/icon.xpm
Terminal=false
Type=Application
Categories=Development;" > SmartMDSD-Toolchain.desktop
 
#make the file executable
chmod +x SmartMDSD-Toolchain.desktop
 
#move the file to $HOME/.local/share/applications/
mv SmartMDSD-Toolchain.desktop $HOME/.local/share/applications/

Go back to the overall installation process.

Nayabrasul Shaik