Installing on Linux

Installing YAKINDU Statechart Tools on a Linux machine boils down to the following steps:

  1. Unpack the downloaded archive (just double-click on it)
  2. Start the application with a double-click on the executable SCT.exe or with ./SCT command in your command-line tool.
  3. Upon the first start you will be asked to select a workspace. This is the folder where your project data will be located. Choose a folder as you like. You can still change the workspace later via File → Switch Workspace in the main menu.

Congratulations, you have just installed and started YAKINDU Statechart Tools!

You can proceed now by installing a YAKINDU Statechart Tools license or by creating your first YAKINDU Statecharts Tools project.

Troubleshooting

Depending on your Linux distribution and version, you might need to install additional packages for Webkit GTK from your distribution’s repository (or elsewhere). Below please find the necessary commands for some Linux distributions. To execute them, you have to have system administrator permissions. So please create a root command-line shell or use the sudo command, which is the typical procedure on Linux.

The list of Linux distributions mentioned below is in no way meant to be exhaustive. If your Linux distribution is not yet among them and you manage to find out the proper commands for it, please let us know!

On Linux, Eclipse uses the GTK library for drawing the user interface. Some users experience issues, especially when using the default version GTK3. If your installation of YAKINDU Statechart Tools does not perform as expected, is laggy, has drawing issues or looks weird, refer to Configuring YAKINDU Statechart Tools to use GTK2. If the welcome page looks broken and asks you to configure webkitgtk, refer to Webkit GTK.

Configuring YAKINDU Statechart Tools to use GTK2

GTK+ is one of two major graphics libraries used in the Linux world (the other one being Qt), and it is the one being used by the Eclipse project, on which YAKINDU Statechart Tools are based. There are two different versions of GTK+: The newest one is often referred to as „GTK3”, and the old one is named „GTK2” or just „GTK”.

Eclipse made the switch from GTK2 to GTK3 with the Mars release. While in general it looks and performs somewhat better, some users experience issues with it, especially concerning the performance or just drawing bugs, like wrong colors being used or widgets not displaying properly. If you experience anything like that, you should try to configure YAKINDU Statechart Tools to use GTK2, which is fairly easy to do.

Giving GTK2 a try

You can use GTK2 instead of GTK3 on a case-by-case basis by having the environment variable or shell variable SWT_GTK3 set as shown below when starting YAKINDU Statechart Tools. On the command line, you would usually start the stand-alone YAKINDU Statechart Tools like this:

./SCT

This assumes your current directory is the tool’s installation folder.

To use GTK2, execute this command instead:

SWT_GTK3=0 ./SCT

It defines the SWT_GTK3 shell variable SWT_GTK3 with a value of 0 and passes it to the SCT process.

If you installed YAKINDU Statechart Tools into another Eclipse instance, the corresponding command to start that Eclipse instance is:

SWT_GTK3=0 ./eclipse
Permanently changing to GTK2

If you want to make your switch to GTK2 permanent without having to set the SWT_GTK3 variable each time, you can define that in the tool’s .ini file. In a stand-alone YAKINDU Statechart Tools installation, that’s the file SCT.ini in the yakindu-sct installation folder. If you installed YAKINDU Statechart Tools into an existing Eclipse installation instead, it’s the file eclipse.ini in that Eclipse instance’s installation directory.

Navigate to the yakindu-sct installation folder of your YAKINDU Statechart Tools instance or to the eclipse installation folder of your Eclipse instance, and open the file SCT.ini or eclipse.ini, respectively, with a plain-text editor of your choice.

Look for the „-vmargs” line. Right above this line, paste these two new lines:

--launcher.GTK_version
2

The result looks similar to this:

-startup
plugins/org.eclipse.equinox.launcher_1.4.0.v20161219-1356.jar
--launcher.library
plugins/org.eclipse.equinox.launcher.gtk.linux.x86_64_1.1.550.v20170928-1359
--launcher.GTK_version
2
-vmargs
-Dosgi.requiredJavaVersion=1.8
-Xms256m
-server
-XX:PermSize=256m
-XX:+UseParallelGC
-Xmx3G

Please note: Do not attempt to replace all of the contents of your SCT.ini file with the lines above! The specified version numbers have to match your installation, and if you change them, SCT will not be able to start anymore.

In order to double-check that YAKINDU Statechart Tools now uses GTK2, please proceed as follows:

  • Start YAKINDU Statechart Tools.
  • Navigate to Help → About YAKINDU SCT → Installation Details → Configuration. You will get a bunch of text containing all kinds of internal variables.
  • Somewhat down the lines, you will find the org.eclipse.swt.internal.gtk.version entry. Its major version number should now be 2 instead of 3, for example 2.24.30.

Webkit GTK

On Linux, you might encounter certain user interface problems or display irregularities when working with Eclipse-based software, e.g., when viewing the welcome page. This is a general problem that can also affect YAKINDU Statechart Tools. It is due to Eclipse on Linux needing specific versions of the libwebkitgtk library to function properly. Depending on your Linux distribution and version, you already have a suitable libwebkitgtk library installed or not.

Commands for installing proper libwebkitgtk versions:

Ubuntu Desktop 16.04 LTS:

sudo apt-get install libwebkitgtk-1.0.0
sudo apt-get install libwebkitgtk-3.0.0

Fedora 25 Workstation:

yum install webkitgtk

openSUSE Leap 42.2:

Works out of the box; nothing to be done.

Red Hat Workstation 7.3:

  1. Download the RPM file webkitgtk-2.4.9-1.el7.x86_64.rpm from, e.g., http://rpm.pbone.net/index.php3/stat/4/idpl/31819125/dir/redhat_el_7/com/webkitgtk-2.4.9-1.el7.x86_64.rpm.html.
  2. Install the downloaded RPM file using the following command, assuming you downloaded the file to /opt/software/webkitgtk-2.4.9-1.el7.x86_64.rpm:

rpm -ihv /opt/software/webkitgtk-2.4.9-1.el7.x86_64.rpm