SRRC Wiki

Service Robotics Research Center
at Ulm University of Applied Sciences

User Tools

Site Tools


smartmdsd-toolchain:installation

SmartMDSD Toolchain Installation

The virtual appliance is the recommended standard way of using everything. See Ready-To-Go Virtual Appliances for download and installation and also the Getting Started Guide for guidance on different entry points.

These installation instructions are part of the overall installation process. This part here just describes the installation of the SmartMDSD Toolchain as part of the overall installation process.

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.

Software URL
Toolchain Official website https://projects.eclipse.org/projects/modeling.smartmdsd
Toolchain Source code https://github.com/eclipse/smartmdsd

System Requirements

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

Software Version
Ubuntu 20.04
Eclipse Modeling Tools 2020-09
SmartMDSD Toolchain 3.17
Java Runtime Environment (JRE) 11
Hardware Version
Architecture x86(-64)
Memory > 8 GB (sufficient to run systems)
Disk Space > 1 GB (considers only ACE and the SmartSoft Kernel)
+500 MB SmartMDSD Toolchain

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

sudo apt install openjdk-11-jre

Installation Instructions

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.

Option 1: Get the Ready-to-Use SmartMDSD Toolchain as Binary Package

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.17-2020-09.tar.gz, extract and run it.

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

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

Option 2: Prepare the SmartMDSD Toolchain from Binary Packages

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 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.

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

Software Version Info
Eclipse Modeling Tools 2020-09 Download link
SmartMDSD 3.17 Update Site
#code snippet to download Eclipse Modeling Tools and installing ​SmartMDSD Toolchain plugin
 
cd ~/SOFTWARE
 
#Temporary variables
ECLIPSE_BASE_VERSION=2020-09
TOOLCHAIN_VERSION=v3.17
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}

Option 3: Build the SmartMDSD Toolchain Plugin and Install it on Eclipse Modeling Tools IDE

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=2020-09
TOOLCHAIN_VERSION=v3.17
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

Compiling the SmartMDSD Plugin from Sources

  • 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.

Creating Launcher

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.17
Version=v3.17
Comment=SmartMDSD Toolchain
Exec=$HOME/SOFTWARE/SmartMDSD-Toolchain-v3.17/eclipse
Icon=$HOME/SOFTWARE/SmartMDSD-Toolchain-v3.17/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/

Next Steps

Acknowledgements

Nayabrasul Shaik

smartmdsd-toolchain/installation.txt · Last modified: 2021/11/19 09:02 by Christian Schlegel