Installation guide

How to launch labAlive Apps

Experiment environment
Webstart application. Each of the communications technology experiments provided on this site comes along with a specific program that implements the experimental setup.

The experiments on this site are Web Start based applications, i.e. Java applications launched via Web Start. All is free for use by anyone. You only have to ensure that Java and Webstart are running on your system.

Click the Launch button of any experiment.

Regardless of the operating system, Web Start is not implemented in OpenJDK and Oracle Java above version 8. So either you can choose to add Web Start during the installation process or you can install it separately afterwards using IcedTea-Web.

Do you need help getting OpenJDK running on your system? Just follow our step by step guides for Windows or Linux.

OpenJDK 11 on Windows

This installation guide is based on Windows 10 and should work for other Windows versions as well.

Depending on your Windows installation Oracle Java 8 could be preinstalled. If you have no Java installed you can follow this guide to get OpenJDK 11 running on your system.

You can download an OpenJDK installer from https://adoptopenjdk.net/. Your operating system is chosen automatically. You have to select which software versions you would like to use. HotSpot JVM will work just fine.

Download dialogue
Download and run the installer.

AdoptOpenJDK 8 installer
AdoptOpenJDK 11 installer. Click on "Weiter" (terms may vary with different system languages).

License agreement
Confirm the license agreement and proceed.

Important settings
Important setting: Select the JAVA_HOME variable to be configured and continue.

Starting the installation
Start the installation.

Finished installation
Complete the installation.

Now you can run Java programs on your system. To make it more comfortable and start labAlive java applications by the Launch button you need to go one step further...

IcedTea-Web

To launch labAlive experiments from the web browser install IcedTea-Web. It enables Webstart.

Download IcedTea-Web from this site:

http://icedtea.wildebeest.org/download/icedtea-web-binaries/1.8/windows/itw-installer.msi
Start of the IcedTea-Web installer
Start the IcedTea-Web installer and continue.

License Agreement
>Accept the license agreement.

Installation path
Installation path - there's no need to change it. So go ahead and click "Next".

Start installation
Click on "Install".

Finished installation
Finish the installation

Associate .jnlp files with IcedTea-Web

One last thing to do is associate .jnlp files with IcedTea-Web. Click on this (or any experiment's) launch button and download a .jnlp file.

Try to run this file, e.g. click on it. Your system will ask you which App to use to open .jnlp files.

Open with-dialogue
"Open with"-dialogue. Click on "Further (Weitere) Apps" to get more options.

Recommended programs by Windows
Recommended programs by Windows. Scroll down and click on "Andere App auf diesem PC suchen". Confirm the checkbox to remember your file association.

Location of javaws
Location of "javaws". Go to the IcedTea-Web installation folder - in our case "C:\Program Files\IcedTeaWeb\". Proceed to "WebStart\bin" and double-click the "javaws"-application.

Conformation dialogue
Security approval
Let the labAlive App start. Confirm that you trust all my applications.

Personally, I assure that the labAlive apps on this site do only the stuff that is propagated on this site. I.e. implement the signal processing for the simulation / demonstration purposes. Signals are visualized, files can be saved and loaded for signal samples, measure screenshots and simulation settings. Specific settings might lead to a high processing load.

When clicking the checkbox, IcedTea-Web adds the certificate to its exceptions site list and you'll not be asked again.

Another notification appears.

Security approval
Allow the app to use the shown code base. Better select to save this decision.

Finally the labAlive app starts!

Now you are able to explore the whole labAlive content. Start all apps by downloading and starting a specific .jnlp file.

OpenJDK 17 on Windows 11

This installation guide is based on Windows 10 and should work for other Windows versions as well.

Depending on your Windows installation Oracle Java 8 could be preinstalled. If you have no Java installed you can follow this guide to get OpenJDK 11 running on your system.

You can download an OpenJDK installer from https://adoptium.net/. Your operating system is chosen automatically.

Download dialogue
Download and run the installer.

AdoptOpenJDK 17 installer
OpenJDK 17 installer. Click on "Weiter" (terms may vary with different system languages).

Important setting
Important setting: Select the JAVA_HOME variable to be configured and continue.

Starting the installation
Start the installation.

Finished installation
Finish the installation.

Now you can run Java programs on your system. To make it more comfortable and start labAlive java applications by the Launch button you need to go one step further...

IcedTea-Web

To launch labAlive experiments from the web browser install IcedTea-Web. It enables Webstart.

Download IcedTea-Web from this site:

https://adoptopenjdk.net/icedtea-web.html

Version 1.8.8 works fine for OpenJDK 17.

Start of the IcedTea-Web installer
Download and run installer.

Continue the installation
Continue the installation with "Next".

License Agreement
Accept the license agreement.

Installation path
Installation path - there's no need to change it. So go ahead and click "Next".

Start installation
Click on "Install".

Finished installation
Finish the installation

Associate .jnlp files with IcedTea-Web

One last thing to do is associate .jnlp files with IcedTea-Web. Click on this (or any experiment's) launch button and download a .jnlp file.

Try to run this file, e.g. click on it. Your system will ask you which App to use to open .jnlp files.

Open with-dialogue
"Open with"-dialogue. Click on "Further (Weitere) Apps" to get more options.

Recommended programs by Windows
Recommended programs by Windows. Scroll down and click on "Andere App auf diesem PC suchen". Confirm the checkbox to remember your file association.

Location of javaws
Location of "javaws". Go to the IcedTea-Web installation folder - in our case "C:\Program Files\IcedTeaWeb\". Proceed to "WebStart\bin" and double-click the "javaws"-application.

Conformation dialogue
Security approval
Let the labAlive App start. Confirm that you trust all my applications.

Personally, I assure that the labAlive apps on this site do only the stuff that is propagated on this site. I.e. implement the signal processing for the simulation / demonstration purposes. Signals are visualized, files can be saved and loaded for signal samples, measure screenshots and simulation settings. Specific settings might lead to a high processing load.

When clicking the checkbox, IcedTea-Web adds the certificate to its exceptions site list and you'll not be asked again.

Another notification appears.

Security approval
Allow the app to use the shown code base. Better select to save this decision.

Finally the labAlive app starts!

Now you are able to explore the whole labAlive content. Start all apps by downloading and starting a specific .jnlp file.

OpenJDK (8 or 11) on Ubuntu

This installation guide is based on Ubuntu 18.04 lts and should work for related operating systems as well.

You can check if Java is already installed by opening a terminal and typing "java -version".

No Java installed jet
No Java installed jet

As you can see, Java is not installed yet. The system suggests to install Java via "apt". The installation will not differ from OpenJDK 8 to OpenJDK 11, so it is your choice which version you would like to install. "default-jre" means the standard version for your operating system and should be fine.

Type "sudo apt install default-jre". The system asks for your root password and begins the installation. It is possible that you have to confirm the installation by typing "j" (or "y" for English system language).

After some time you should get to the prompt without any errors. By typing "java -version" again your installed Java version is displayed.

After successful installation
After successful installation

In our case the installed system default-jre is OpenJDK 11.0.5. Now you should be able to run Java programs by downloading the application and opening it with Java.

To make it a bit more comfortable you should install IcedTea-Web. This will enable Java Web Start.

In your terminal type "sudo apt install icedtea-8-plugin". After typing your root password and conforming the installation you should get to the prompt without any errors. To pay it safe, you should restart your web-browser (in Ubuntu the standard browser is Firefox).

Now you should be able to open any app in labAlive via the green "Launch"-button. Doing this for the first time, Firefox asks for a program to open the file with. Thereby Firefox suggests "IcedTea Web Start" by itself.

Open-dialogue
Open-dialogue

Confirm with "OK".A new window with the IcedTea start screen should appear. In the following you are asked to confirm some security approval.

Security approval
Security approval

By clicking the checkbox, IcedTea-Web adds our certificate to its exceptions site list and you will not be asked again.

Another security window pops up.

Security approval
Security approval

Confirm by clicking "Ja" (or "Yes" for English system language). Remembering your decision by clicking the checkbox makes starting your apps easier and faster in the future.

Congratulations. You have installed OpenJDK and Webstart successfully. Now you are able to explore the whole labAlive content.

OpenJDK on macOS

JDK installation

You can check if Java is already installed by opening a terminal and typing "java -version".

Java is ready
Java is ready

In this case, you can continue with the installation of OpenWebStart.

If the "java" command is not found, a JDK (e.g. Amazon Corretto) must be installed: https://docs.aws.amazon.com/corretto/latest/corretto-11-ug/downloads-list.html

Amazon corretto
Amazon corretto

Install the JDK by double-clicking on the .pkg file using the wizard that opens.


OpenWebStart installation

Download the .pkg file from: https://openwebstart.com/download/

OpenWebStart download
OpenWebStart download

Install OpenWebStart by double-clicking on the .pkg file.

Since OpenWebStart is not set as the default for opening .jnlp files, they can be opened with OpenwebStart by right-clicking:

Start with OpenWebStart
Start with OpenWebStart

Using Windows .bat to launch labAlive Apps

If you face problems starting labAlive Apps via jnlp files and IcedTea-Web there's a simple alternative using Windows .bat files: