
p. 

==<div style="counter-reset: h1 1">==

h1(#inst_installing_yakindu_statechart_tools). Installing YAKINDU Statechart Tools

In order to start working with YAKINDU Statechart Tools, you have to install the software on your computer. We are assuming you have downloaded the software package and stored it somewhere on your machine.

The installation process boils down to
# checking the "system requirements":#inst_system-requirements,
# unpacking the downloaded ZIP file containing YAKINDU Statechart Tools, and
# executing the _SCT_ application.

This is explained in more detail in section "&quot;Platform overview&quot;":#inst_platform-overview and the following sections.

Java developers might want to read section "JRE not found":#inst_jre-not-found, in case they encounter a certain problem.



h2(#inst_system-requirements). System requirements

h3(#inst_java). Java

YAKINDU Statechart Tools is based on the Java programming language and requires *Java 8* or higher. A Java Runtime Environment (JRE) must be installed on your computer.

Installation of Java is beyond the scope of this document. You can find more information on Java and download it for free from Oracle Corporation at "https://www.java.com/":https://www.java.com/. Before downloading Java, make sure you are picking the variant with the correct bit size, i.&nbsp;e. either 32 or 64 bit, whichever is appropriate for your computer.


h3(#inst_eclipse). Eclipse

Internally, YAKINDU Statechart Tools are based on *"Eclipse":http://www.eclipse.org/*, an integrated development environment (IDE). YAKINDU Statechart Tools are running inside the Eclipse environment. When you are installing YAKINDU Statechart Tools, a full-fledged Eclipse instance will be put on your computer. Currently it is the *Oxygen* release.

###. CHECK: Is Oxygen still the current Eclipse release?

If you are new to Eclipse, you might find the "Eclipse Help":http://help.eclipse.org/ useful, especially the "Workbench User Guide".

If you are an experienced Eclipse user, you can install YAKINDU Statechart Tools into a existing Eclipse instance from an update site.



h2(#inst_platform-overview). Platform overview

You can install YAKINDU Statechart Tools as a stand-alone software package under the following operating systems:

* "Installing YAKINDU Statechart Tools on Windows":#inst_installing_on_windows
* "Installing YAKINDU Statechart Tools on macOS":#inst_installing_on_macosx
* "Installing YAKINDU Statechart Tools on Linux":#inst_installing_on_linux

Alternatively, you can install YAKINDU Statechart Tools into an existing Eclipse instance.

* "Installing YAKINDU Statechart Tools to an existing Eclipse instance":#inst_installing_to_an_existing_eclipse_instance




h2(#inst_installing_on_windows). Installing on Windows

This chapter describes how to install YAKINDU Statechart Tools on a Windows 7 machine.


h3(#inst_installing_on_windows_unpacking-the-downloaded-file). Unpacking the downloaded file

Unpack the software distribution file. Use the file explorer to open the directory you downloaded the software distribution file to, right-click on the latter, and select _Extract All..._ in the context menu.

p(#inst_fig_installing_on_windows_unpacking_the_downloaded_file_on_Windows_1). 

!images/inst_windows7_010_eclipse_extract_1.png(Unpacking the downloaded file on Windows [1])!

p=. Unpacking the downloaded file on Windows &#91;1]

Choose a directory for YAKINDU Statechart Tools (YAKINDU SCT). The example below assumes you want to install the software in the _C:\Program Files\YAKINDU_ directory.

Depending on your permissions, you might not be able to create a directory and install software under _C:\Program Files_. In this case, please choose another installation directory at a location you are allowed to write to.

p(#inst_fig_installing_on_windows_unpacking_the_downloaded_file_on_Windows_2). 

!images/inst_windows7_020_eclipse_extract_2.png(Unpacking the downloaded file on Windows [2])!

p=. Unpacking the downloaded file on Windows &#91;2]

Click on _Extract_ to start the extraction process. With Window's built-in unpacker, this will take a surprisingly long period of time. Alternatively, you can use a 3rd-party unpacker like "7-Zip":http://www.7-zip.org/. Saves you a lot of time!

After unpacking, you will find a folder _yakindu-sct_ in your installation directory, i.e., _C:\Program Files\YAKINDU\yakindu-sct_ in our example, as shown in figure "&quot;The extracted _yakindu-sct_ folder&quot;":#inst_fig_installing_on_windows_the_extracted_yakindu_sct_folder.

p(#inst_fig_installing_on_windows_the_extracted_yakindu_sct_folder). 

!(standard-image)images/inst_windows7_030_eclipse_folder.png(The extracted "yakindu-sct" folder)!

p=. The extracted _yakindu-sct_ folder

The contents of the _yakindu-sct_ folder looks like this:

p(#inst_fig_installing_on_windows_contents_of_the_extracted_yakindu-sct_folder). 

!images/inst_windows7_040_eclipse_contents.png(Contents of the extracted "yakindu-sct" folder)!

p=. Contents of the extracted _yakindu-sct_ folder

There you are: You have installed YAKINDU Statechart Tools. Now you should start it.



h3(#inst_installing_on_windows_starting-yakindu-statechart-tools). Starting YAKINDU Statechart Tools

Start YAKINDU Statechart Tools by running the _SCT.exe_ executable.

To do so, please double-click (or single-click, depending on your Windows settings) on the _YAKINDU_ symbol shown in figure "&quot;Contents of the extracted _yakindu-sct_ folder&quot;":#inst_fig_installing_on_windows_contents_of_the_extracted_yakindu-sct_folder.

Depending on the Windows settings and your permissions, you might get the following security warning, indicating that you downloaded the application from a potentially unsecure source:

p(#inst_fig_installing_on_windows_windows_security_warning). 

!(standard-image)images/inst_windows7_045_security_warning.png(Windows security warning)!

p=. Windows security warning

Uncheck the _Always ask before opening this file_ option. Click _Run_ to continue starting the application. Subsequently starting YAKINDU Statechart Tools will not show this security warning again.

While YAKINDU Statechart Tools is starting up, it is showing a splash screen:

p(#inst_fig_installing_on_windows_yakindu_sct_starting_up_and_showing_a_splash_screen). 

!images/inst_windows7_050_eclipse_splash.png(YAKINDU Statechart Tools starting up and showing a splash screen)!

p=. YAKINDU Statechart Tools starting up and showing a splash screen

The software needs a _workspace_ directory where it stores its so-called projects along with other data. During the first startup, the _Workspace Launcher_ dialog asks you to specify the workspace directory in the _Workspace_ field. Please select a new and empty one.

In the example below, we chose the _C:\Users\joedoe\workspace_ directory as our workspace. We also checked the _"Use this as the default and do not ask again"_ option. This is sensible, because on subsequent startups, YAKINDU Statechart Tools won't ask for a workspace directory again. Instead it will always use the one we chose once and forever. (You can still change the workspace later via _File → Switch Workspace_ in the main menu.)

!(standard-image)images/inst_windows7_060_eclipse_workspace_dialog.png(Selecting a workspace)!

p=. Selecting a workspace

Click on the _OK_ button to proceed.

On the first start, YAKINDU Statechart Tools presents a _Welcome_ window:

p(#inst_fig_installing_on_windows_yakindu_statechart_tools_presenting_the_welcome_window). 

!images/inst_windows7_070_eclipse_welcome.png(YAKINDU Statechart Tools presenting the "Welcome" window)!

p=. YAKINDU Statechart Tools presenting the _Welcome_ window

You can browse the material shown here, if you want. When you are done, please close the _Welcome_ tab or click on _Workbench_ at the upper right. Both actions are leading to the workbench:

!images/inst_windows7_080_eclipse_workbench.png(The YAKINDU Statechart Tools workbench)!

p(#inst_fig_installing_on_windows_yakindu_statechart_tools_workbench). 

p=. The YAKINDU Statechart Tools workbench

This is your working environment now. Congratulations, you have just installed and started YAKINDU Statechart Tools!

You can proceed now by "installing a YAKINDU Statechart Tools license":#inst_installing_a_yakindu_statechart_tools_license or by "creating your first YAKINDU Statecharts Tools project":../tutorials/tutorials.html.




h2(#inst_installing_on_macosx). Installing on macOS

This chapter describes how to install YAKINDU Statechart Tools on a Mac computer under Mac OS X.



h3(#inst_installing_on_macosx_unpacking-the-downloaded-file). Unpacking the downloaded file

When downloading the ZIP file containing the software distribution in a browser to your local disk, the _Archive Utility_ automatically unpacks it by default. Upon success, the ZIP file is removed. Alternatively, you can unpack the ZIP file manually by double-clicking it.

Unpacking will provide you with the _YAKINDU SCT_ application bundle.

Move the unpacked application bundle to your _Applications_ folder. Alternatively, you can also move it somewhere else as you see fit. The screenshot below shows the _YAKINDU SCT_ application bundle having been moved to _Applications_.

p(#inst_fig_installing_on_macos_the_yakindu_statechart_tools_application_in_the_applications_directory). 

!(shadowless)images/inst_macosx_010_applications.png(The YAKINDU Statecharts Tools application in the "Applications" directory)!

p=. The YAKINDU Statecharts Tools application in the _Applications_ directory

There you are: You have installed YAKINDU Statechart Tools. Now you should start it.



h3(#inst_installing_on_macosx_starting-yakindu-statechart-tools). Starting YAKINDU Statechart Tools

Start YAKINDU Statechart Tools by running the _YAKINDU SCT_ application.

To do so, please double-click on the _YAKINDU_ symbol shown in the sample screenshot above.

Upon the first start, Mac OS X will verify the application and show you the following security warning, indicating that you did not download the application from Apple's App Store, but from a potentially unsecure source instead:

!(shadowless)images/inst_macosx_020_security_warning.png(macOS security warning)!

p=. macOS security warning

Click _Open_ to continue starting the application. Subsequently starting YAKINDU Statechart Tools will not show that security warning again.

While YAKINDU Statechart Tools is starting up, it is showing a splash screen:

!(small shadowless)images/inst_macosx_050_eclipse_splash.png(YAKINDU Statechart Tools starting up and showing a splash screen)!

p=. YAKINDU Statechart Tools starting up and showing a splash screen

The software needs a _workspace_ directory where it stores its so-called projects along with other data. During the first startup, the _Workspace Launcher_ dialog asks you to specify the workspace directory in the _Workspace_ field. Please select a new and empty one.

In the example below, we chose the _/Users/joedoe/workspace_ directory as our workspace. We also checked the _"Use this as the default and do not ask again"_ option. This is sensible, because on subsequent startups, YAKINDU Statechart Tools won't ask for a workspace directory again. Instead it will always use the one we chose once and forever. (You can still change the workspace later via _File → Switch Workspace_ in the main menu.)

!(shadowless)images/inst_macosx_060_eclipse_workspace_dialog.png(Selecting a workspace)!

p=. Selecting a workspace

Click on the _OK_ button to proceed.

On the first start, YAKINDU Statechart Tools presents a _Welcome_ window:

!(shadowless)images/inst_macosx_070_eclipse_welcome.png(YAKINDU Statechart Tools presenting the "Welcome" window)!

p=. YAKINDU Statechart Tools presenting the _Welcome_ window

You can browse the material shown here, if you want. When you are done, please close the _Welcome_ tab or click on _Workbench_ at the upper right. Both actions are leading to the workbench:

!(shadowless)images/inst_macosx_080_eclipse_workbench.png(The YAKINDU Statechart Tools workbench)!

p=. The YAKINDU Statechart Tools workbench

This is your working environment now. Congratulations, you have just installed and started YAKINDU Statechart Tools!

You can proceed now by "installing a YAKINDU Statechart Tools license":#inst_installing_a_yakindu_statechart_tools_license or by "creating your first YAKINDU Statecharts Tools project":../tutorials/tutorials.html.




h2(#inst_installing_on_linux). Installing on Linux

This chapter describes how to install YAKINDU Statechart Tools on a Linux machine using a command-line tool.


h3(#inst_installing_on_linux_installing_required_packages). Installing required packages

Depending on your Linux distribution and version, you might need to install additional packages for *Webkit GTK* and *Java* 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":#inst_linux_gtk2. If the welcome page looks broken and asks you to configure _webkitgtk_, refer to "Webkit GTK":#inst_installing_on_linux_webkit_gtk.


h4(#inst_linux_gtk2). 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.

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

bc. ./SCT

This assumes your current directory is the tool's installation folder. Please also see section "&quot;Starting YAKINDU Statechart Tools&quot;":#inst_installing_on_linux_starting_yakindu_statechart_tools.

To use GTK2, execute this command instead:

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

bc. SWT_GTK3=0 ./eclipse

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

bc. 
--launcher.GTK_version
2

The result looks similar to this:

bc. 
-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
-XX:MaxPermSize=256m

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


h4(#inst_installing_on_linux_webkit_gtk). 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:*

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


*Fedora 25 Workstation:*

bc. yum install webkitgtk


*openSUSE Leap 42.2:*

_Works out of the box; nothing to be done._


*Red Hat Workstation 7.3:*

# 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":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.
# 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_:

==<div style="margin-left: 4em">==

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

==</div>==

h4(#inst_installing_on_linux_java). Java

*Ubuntu Desktop 16.04 LTS:*

bc. 
sudo apt-get install default-jre



h3(#inst_installing_on_linux_unpacking-the-downloaded-file). Unpacking the downloaded file

Choose a directory for YAKINDU Statechart Tools. The commands below assume you want to install the software in the _/my/software_ directory. Please modify the commands appropriately to install somewhere else!

Go to the installation directory:

bc. cd /my/software/

Unpack the software distribution file. If the downloaded file is located in _/download/sct-linux.gtk.x86&#95;64.zip_, use the following command to unpack in the installation directory:

bc. unzip /download/sct-linux.gtk.x86_64.zip

This will create a folder _yakindu-sct_ in your installation directory, i.e., _/my/software/yakindu-sct_ in our example, as shown in the image below:

p(#inst_fig_installing_on_linux_unpacking_the_downloaded_file). 

!images/inst_linux_010_eclipse_folder.png(The extracted "yakindu-sct" folder)!

p=. The extracted _yakindu-sct_ folder

The contents of the _yakindu-sct_ folder looks like this:

p(#inst_fig_installing_on_linux_contents_of_the_extracted_yakindu-sct_folder). 

!images/inst_linux_020_eclipse_contents.png(Contents of the extracted "yakindu-sct" folder)!

p=. Contents of the extracted _yakindu-sct_ folder

There you are: You have installed YAKINDU Statechart Tools. Now you should start it.



h3(#inst_installing_on_linux_starting_yakindu_statechart_tools). Starting YAKINDU Statechart Tools

Start YAKINDU Statechart Tools by running the _SCT_ executable.

To do so, please _cd_ to the _yakindu-sct_ folder and enter this command:

bc. ./SCT

If your command shell is in some other working directory, issue this command:

bc. /my/software/yakindu-sct/SCT

From a graphical file browser, you can start YAKINDU Statechart Tools by clicking on the _SCT_ symbol.

While YAKINDU Statechart Tools is starting up, it is showing a splash screen:

p(#inst_fig_installing_on_linux_yakindu_statechart_tools_starting_up_and_showing_a_splash_screen). 

!images/inst_linux_030_eclipse_splash.png(YAKINDU Statechart Tools starting up and showing a splash screen)!

p=. YAKINDU Statechart Tools starting up and showing a splash screen

The software needs a _workspace_ directory where it stores its so-called projects along with other data. During the first startup, the _Workspace Launcher_ dialog asks you to specify the workspace directory in the _Workspace_ field. Please select a new and empty one.

In the example below, we chose the _/my/workspace_ directory as our workspace. We also checked the _"Use this as the default and do not ask again"_ option. This is sensible, because on subsequent startups, YAKINDU Statechart Tools won't ask for a workspace directory again. Instead it will always use the one we chose once and forever. (You can still change the workspace later via _File → Switch Workspace_ in the main menu.)

!images/inst_linux_040_eclipse_workspace_dialog.png(Selecting a workspace)!

p=. Selecting a workspace

Click on the _OK_ button to proceed.

On the first start, YAKINDU Statechart Tools presents a _Welcome_ window:

!images/inst_linux_050_eclipse_welcome.png(YAKINDU Statechart Tools presenting the "Welcome" window)!

p=. YAKINDU Statechart Tools presenting the _Welcome_ window

You can browse the material shown here, if you want. When you are done, please close the _Welcome_ tab or click on _Workbench_ at the upper right. Both actions are leading to the workbench:

p(#inst_fig_installing_on_windows_yakindu_statechart_tools_workbench). 

!images/inst_linux_060_eclipse_workbench.png(The YAKINDU Statechart Tools workbench)!

p=. The YAKINDU Statechart Tools workbench

This is your working environment now. Congratulations, you have just installed and started YAKINDU Statechart Tools!

You can proceed now by "installing a YAKINDU Statechart Tools license":#inst_installing_a_yakindu_statechart_tools_license or by "creating your first YAKINDU Statecharts Tools project":../tutorials/tutorials.html.




h2(#inst_installing_to_an_existing_eclipse_instance). Installing to an existing Eclipse instance

This chapter describes the steps that are needed to install YAKINDU Statechart Tools to an existing Eclipse instance. Let's assume you already have Eclipse up and running and now you want to install YAKINDU Statechart Tools as an additional software item (plugin).

bq. *Please note:* On macOS, this only works if your _.app_ file is located in your _app_ folder.

In the the _Help_ menu, select the _Install New Software_ menu item:

!images/inst_eclipse_010_eclipse_menu_install_new_software.png(Selecting "Help → Install New Software" in the main menu)!

p=. Selecting _Help → Install New Software_ in the main menu

The _Install_ wizard opens:

!images/inst_eclipse_020_eclipse_install_wizard.png(The "Install" wizard)!

p=. The _Install_ wizard

Click on the _Add..._ button near the upper right corner of the wizard.

A dialog opens, asking you to specify the update repository you want to install the new software from. The appropriate update repository depends on your Eclipse version. Please enter the URL of the respective update repository into the _Location_ field.

bq. *Please note:* Update site URLs are available online via the "YAKINDU Statechart Tools download page":https://info.itemis.com/state-machine/download-yakindu-statechart-tools.

Enter some text into the _Name_ field. This text is abitrary in principle, but you should choose something that makes it easier for you to identify this particular update repository among other update repositories. In the example below, the repository's name is @YAKINDU Statechart Tools (Luna)@. It describes which piece of software the repository provides (YAKINDU Statechart Tools) and which Eclipse release that software is compatible with (Luna, i.e., Eclipse 4.4).

!images/inst_eclipse_030_eclipse_add_repository.png(Adding a software repository)!

p=. Adding a software repository

After entering name and location of the update repository, click _OK_.

Eclipse establishes a network connection to the update repository, asks it for available software items and shows them in the install wizard:

!images/inst_eclipse_040_eclipse_software_items.png(Selecting YAKINDU Statechart Tools software items)!

p=. Selecting YAKINDU Statechart Tools software items

Please check at least _Xtext Integration Utilities_ and – no surprise – _YAKINDU SCT_. (You can also install the respective source code items. However, unless you want to have a look at that source code or even want to modify it, you don't need them.)

Click _Next &gt;_.

Eclipse tries to integrate the new software with the software that is already installed. If it detects any mismatches between requirements and provisions, Eclipse will try to find a solution in order to mitigate this problem. The screenshot below shows such a case:

!images/inst_eclipse_050_eclipse_trouble.png(Install remediation page)!

p=. Install remediation page

Select the most appropriate solution, then click _Next &gt;_.

The wizard shows the software to be installed and gives you the opportunity to review the changes:

!images/inst_eclipse_060_eclipse_review.png(Reviewing the items to be installed)!

p=. Reviewing the items to be installed

Click _Next &gt;_.

The wizard asks you to review and accept the terms of the new software's license agreements.

!images/inst_eclipse_070_eclipse_licenses.png(Accepting the new software's license agreements)!

p=. Accepting the new software's license agreements

Select the radio button labelled _I accept the terms of the license agreements_ (if you do), then click _Finish_.

Eclipse starts to download the software and installs it on your computer. This may take some time.

!images/inst_eclipse_080_eclipse_installation.png(Installing software in progress ...)!

p=. Installing software in progress ...

If the installation was completed successfully, Eclipse needs a restart in order to have the changes take effect. A dialog asks whether you want to restart Eclipse right now or later:

!images/inst_eclipse_090_eclipse_restart.png(Restarting Eclipse after software installation)!

p=. Restarting Eclipse after software installation

After the restart, Eclipse displays its _Welcome_ window, now also featuring YAKINDU Statechart Tools:

!images/inst_eclipse_100_eclipse_sct_help.png(Eclipse presenting the "Welcome" window)!

p=. Eclipse presenting the _Welcome_ window



h2(#inst_updating-yakindu-statechart-tools). Updating YAKINDU Statechart Tools

To check whether a new YAKINDU Statechart Tools release is available and to install it, please select the _Help → Check for Updates_ menu item.

!images/inst_eclipse_update_010_eclipse_menu_check_for_updates.png(Selecting "Help → Check for Updates" in the main menu)!

p=. Selecting _Help → Check for Updates_ in the main menu

If Eclipse finds any software items to be updated – not just YAKINDU Statechart Tools –, it will guide you through the process of updating them. Generally Eclipse has to be restarted afterwards to have any changes take effect.

You can configure Eclipse as follows to automatically check for updates:

Select the _Window → Preferences_ menu item. The _Preferences_ dialog opens.

Go to the _Install/Update → Automatic Updates_ section. Here you can configure whether and when Eclipse should check for updates and what to do when it finds any.

!images/inst_eclipse_update_020_eclipse_automatic_updates.png(Configuring automatic update)!

p=. Configuring automatic update




h2(#inst_installing_a_yakindu_statechart_tools_license). Installing a YAKINDU Statechart Tools license

The YAKINDU Statechart Tools Standard Edition for non-commercial use does not require any license to be installed.

The YAKINDU Statechart Tools Professional Edition trial version comes with an evaluation license that is valid for 30 days. If you want to continue working with YAKINDU Statechart Tools Professional Edition beyond that period of time or if you want to work with YAKINDU Statechart Tools Standard Edition for commercial purposes you have to "acquire a license":https://www.itemis.com/en/yakindu/statechart-tools/licences/.

The license manager documentation describes how you can install a license file or configure a license server for floating licenses. To access that documentation, select _Help → Help Contents_ from YAKINDU Statechart Tools' main menu, then open the _YAKINDU License Management_ documentation.




h2(#inst_jre-not-found). JRE not found

If you want to develop Java source code, you need a Java Runtime Environment (JRE) or Java Development Kit (JDK) in your workspace.

Usually Eclipse's Java Development Toolkit (JDT), which is bundled with YAKINDU Statechart Tools, automatically finds one or more JREs on your machine. However, under certain circumstances this won't work and even the JRE that is used to run Eclipse cannot be found. In this case, you will have to add a JRE definition to your workspace by hand.

In order to check whether you are affected, proceed as follows:

# In the main menu, select _Window → Preferences_. The _Preferences_ window opens.
# In the _Preferences_ window, select _Java → Installed JREs_.

If the list of installed JREs is empty, you are affected by the problem and will have to manually add a JRE definition. Click on the _Add…_ button and follow the _Add JRE_ wizard. The Eclipse documentation explains in more detail how to "add a new JRE definition":http://help.eclipse.org/oxygen/index.jsp?topic=%2Forg.eclipse.jdt.doc.user%2Ftasks%2Ftask-add_new_jre.htm to your workspace.

###. CHECK Does the link http://help.eclipse.org/oxygen/index.jsp?topic=%2Forg.eclipse.jdt.doc.user%2Ftasks%2Ftask-add_new_jre.htm still point to how to add a JRE?

!images/inst_installed_jres_010.png(Installed JREs)!

p=. Installed JREs

==</div>==