Skip to content
Contribute to GitLab
AF3 Developer Installation
AF3 Developer Installation
Add additional troubleshooting steps
Feb 08, 2021
Hide whitespace changes
0 → 100644
View page @
AF3 Developer Installation with Oomph
Updating an existing installation
Our setup allows updating existing installations almost seamlessly.
Updates are received automatically if you installed AF3 - Developer
installation by using the link
during the oomph setup (see below).
If there are any additional required to update from one version to
another, they will be announced by mail on the AF3 developer list and
also recorded here.
To migrate from a local file-based installation to a URL-based one,
please find the required instructions at the bottom of this page.
Java Compiler Version 11
The AF3 source must be compiled using a Java compiler version 11. We
recommend OpenJDK since we use it for building internally.
: Your distribution probably already packaged OpenJDK, so
you just have to install the openjdk-11 package from you package
Ubuntu 18.04 has a package named
“openjdk-11-jdk” that installs OpenJDK 10. Do not use it! Instead,
search for a PPA that offers the correct package.
OpenJDK can be obtained from
, a buildfarm sponsored by
companies depending on Java.
Alternatively, you can also perform manual installation from the
Windows-only: Please ensure that the HOME variable is set (Keys:
Windows + Pause ->Adjust settings ->Advanced ->Environment
variables) or run
to set the mentioned variable to the user’s directory. It is read by the
git implementation of eclipse. NOTE: If your user folder points to a
network share, you will experience severe performance impacts, so choose
a local folder instead!
of the Eclipse Installer
Start the Eclipse installer
Do not update it, but stay with version 2019-12 (a.k.a. 1.15.0
Build 4434) to workaround an SSL certificate problem
Switch to Advanced Mode (“burger icon” in the upper-right
Eclipse Modeling Tools
Product Version: 2019-12
Java 1.8+ VM:
Select your JDK 11 Installation or leave the
button to go to the Project page
: If you have a stale
entry from a previous
installation, check mark it and remove it using the
icon right of the filter text field
icon right of the filter text field
from the Catalog drop-down box
Copy and paste the following link to the text field:
Note 1: Using this link, instead of installing via a local
file, ensures that your installation will remain up-to-date.
Available updates will be indicated directly after each
startup of eclipse. You are recommended to install them.
Note 2: If you are working with the eclipse platform itself
(AF3 platform updates), you may consider using a file-based
installation from a common (local)
repository. It allows you test modifications to the setup
easily by updating the setup file via git. Please remember
to import this repository in your developer installation
manually to receive remote updates by pulling.
There is now a new folder / category entry called
** and the **
project below it
the project and click
Depending on the state of your installer, you may need to install
the unzip feature for the installer.
The installer is relaunched afterwards and you have to reselect the
**AutoFOCUS 3 (Developer)**
Check “Show all variables” at the bottom of this dialog page to
see all options
Customize the installation locations or accept the default
(sub-folder to your user home)
**Important for contributors:**
Enter your personal REST API key
from the redmine page (this website):
Login to the current web page (top right), or register if
you have not done so yet.
(top right) in a new tab or browser window.
Click “Show” below the “API access key” header in the
rightmost pane of the page.
Copy the key to the corresponding
field in the oomph
installer (initialized with all 0s)
Keep “My Account” page open since you will need the key in a
later setup step again.
You see a list of tasks that will be executed. Just hit
You will be asked to confirm licenses.
**NOTE: Workaround required**
: Do a problem with an Oomph module,
you have to manually unzip the file
It should expand into
You can do this after the installer has launched the new Eclipse
instance and the
We are working on a fix for this issue.
: If an error occurs that warns a certain plugin could not
be downloaded to the p2 cache (checksum), please select a different
p2 pool in the first page of the installer. Alternatively, you can
also delete the contents of the p2 pool , but beware: Old AutoFOCUS
installations cannot be executed any more after doing this.
Wait until the projects are fully built and the IDE has updated the
package explorer icons (you should see gray, red, yellow or green
code rating bullets in the top-left corner of each project icon).
: If there are build errors after the compilation, ...
... clean (ONLY) the plugin “org.fortiss.tooling.kernel” such that the
... clean all plugins in the workspace.
... reload the target platform. Make sure that the target platform
has been resolved before reloading!
... add the require plugins in the OS-specific debug configuration
`Debug Configurations ...`
`Add Required Plug-ins`
... restart AutoFOCUS3.
Next, one typically switches to the Java perspective by typing
“Java” into the Quick Access" box in the top-right corner and
clicking on the “Perspective” item in the list (Not the View!).
that You can clean your installation by deleting the
installation root folder.
However, you might want to keep the bundle pool.
Go to “Run >Run” or “Run >Debug” to start af3. You will be
prompted to select a launch configuration. Select the one which matches
your operating system and click ok.
: Oomph installer cannot find update sites? (Problem
occurred on Windows)
: Deactivate proxy servers.
: I’m experiencing thousands of build errors! Some
are indicating missing eclipse packages.
: In this case, you have to reload the target platform
since eclipse got confused. Therefore, open the plugin
“target-definition” in the package explorer and open
. Then, please wait until the target
platform is resolved. Afterwards, please click “Reload target
platform” in the top-right corner of the editor and a rebuild should
take place, removing any error markers. Maybe you have to re-execute
the last step to trigger the rebuild.
: Launching AF3 causes SIGSEGV on Linux and kills
Java VM within “libgdk-x11-2.0.so”. What now?
: In your launch configuration, on the ‘Environment’
tab, add a new variable called ‘SWT
GTK3’ and set its value to ‘0’.
JVM is linked against GTK2, therefore we need to tell the launcher
not to use GTK3 with this setting.
: Rating files and git interaction seems very slow.
: Please ensure you completed step 1 of the
installation instructions. If the environment variable HOME does not
point to a local directory, heavy network traffic occurs that causes
these performance issues.
: Rating for files is shown, but I cannot change the
rating via the context menu.
: The rating can only be changed in the Package
Explorer view. Make sure, you are not using e.g. the Model Explorer.
Migrating from a file-based installation
Open the file
in a text editor of your choice. In Windows, substitute
; In Linux/MacOS with the home folder
Search for the line mentioning
and replace the line with
Start (or restart) an AutoFOCUS 3 developer installation and check
that the corresponding Oomph file points to the update location:
Open “Window/Edit >Preferences >Oomph >Setup Tasks” and
check the window title.
Ensure that the option “Skip automatic task execution at startup
time” is UNCHECKED to receive updates.