LOADING


labAlive - Installation guide

How to launch labAlive simulations

Each of the communications technology experiments provided on this site comes along with a specific program that implements the experimental setup. It's a Java application that is launched via Java Web Start. All is free for use by anyone.

Click the Launch button of any experiment to start the specific simulation.

You can download and install Oracle Java from their website www.oracle.com. Version 8 is required. Please note that newer versions don`t support Java Web Start anymore what is needed to launch labAlive applications via the web launch button.

We suggest to install the free OpenJDK. For Windows users there are a few installation packages available. We recommend the software from adoptopenjdk.net. Version 8 or 11 are long term supported and will do just fine.

If you are using common Linux distributions like Ubuntu, you can install Java very easy from its software sources.

Java Web Start is not implemented in OpenJDK and Oracle Java above version 8. Depending on your installer you can choose to add Web Start during the installation process. If not, you can install it separately with a small browser plug-in called IcedTea.

If you need help to get OpenJDK running on your system, just follow our step by step guides for Windows or Linux.

OpenJDK 8 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 should be preinstalled. If you have no Java installed, you can follow these guide to get OpenJDK 8 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 dialogue

Run the installer after the download has finished.

AdoptOpenJDK 8 installer
AdoptOpenJDK 8 installer

Click on "Weiter" (terms may vary with different system languages).

License agreement
License agreement

Confirm the license agreement by clicking the checkbox and proceed with "Weiter".

Important settings
Important settings

In this dialogue you have to make a few changes. We want the setup program to configure the system JAVA_HOME variable. We also want to use IcedTea-Web for Java Webstart and associate it with *.jnlp files. Continue the installation with "Weiter".

Starting the installation
Starting the installation

Now you can start the installation with "Installieren".

Finished installation
Finished installation

After the setup has finished the installation end the dialogue with "Fertig stellen".

To pay it safe you should restart your system.

Now you should be able to open any app in labAlive via the green "Launch"-button.*

Before the app starts you are asked to confirm some security notifications.

Conformation dialogue
Conformation dialogue

Security approval
Security approval

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

Another notification appears.

Security approval
Security approval

Here you can although select, if your decisions should be saved. You can choose to save only for this app or for the whole website. Click "Ja" to finish.

Finally the app starts and you are able to explore the whole labAlive content.

*Due to changes in Firefox it is not possible to open *.jnlp files directly via Java-Webstart anymore. Alternatively the files can be downloaded and executed afterwards.

Download dialogue
Download dialogue

Now click on your downloaded file to start the app.

Downloaded file
Downloaded file

The app starts and you can continue with the security notifications.

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 should be preinstalled. If you have no Java installed, you can follow these 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 dialogue

Run the installer after the download has finished.

AdoptOpenJDK 8 installer
AdoptOpenJDK 8 installer

Click on "Weiter" (terms may vary with different system languages).

License agreement
License agreement

Confirm the license agreement by clicking the checkbox and proceed with "Weiter".

Important settings
Important settings

In this dialogue you have to make a change. We want the setup program to configure the system JAVA_HOME variable. Continue the installation with "Weiter".

Starting the installation
Starting the installation

Now you can start the installation with "Installieren".

Finished installation
Finished installation

After the setup has finished the installation end the dialogue with "Fertig stellen".

To pay it safe you should restart your system.

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 can install the IcedTea-Web browser plug-in. This will enable Java Webstart.

To do so download IcedTea-Web form this site:

http://icedtea.wildebeest.org/download/icedtea-web-binaries/1.8/windows/itw-installer.msi

After starting the installer you have to confirm some notifications.

Start of the IcedTea-Web installer
Start of the IcedTea-Web installer

Click on "Next" to get to the following screen.

License Agreement
License Agreement

Accept the license agreement and click on "Next" to go further.

Installation path
Installation path

There is no need to change the installation path. So go ahead and click "Next".

Start installation
Start installation

Finally click on "Install" to start the installation.

Finished installation
Finished installation

Once the setup has completed click "Finish" to end the installation.

One last thing to do is to associate *.jnlp files with IcedTea-Web. Download any *.jnlp file you want and right-click on it. Choose properties and click on the "change"-button right to the field "open with".

File properties
File properties
Open with-dialogue
"Open with"-dialogue

Click on "Weitere Apps" to get more options. Scroll down and click on "Andere App auf diesem PC suchen". Confirm the Checkbox to remember your file association.

Recommended programs by Windows
Recommended programs by Windows

In the following a file explorer window opens. Go to the IcedTea-Web installation folder (in our case "C:\Program Files\IcedTeaWeb\". From here change to "WebStart\bin" and double-click the "javaws"-application.

Location of javaws
Location of "javaws"

To check your changes right-click on your *.jnlp file again and select "file properties". Now "javaws" should be the preferred program to open *.jnlp files.

File properties dialogue
File properties dialogue

Now you should be able to open any app in labAlive via the green "Launch"-button.*

Before the app starts you are asked to confirm some security notifications.

Conformation dialogue
Conformation dialogue
Security approval
Security approval

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

Another notification appears.

Security approval
Security approval

Here you can although select, if your decisions should be saved. You can choose to save only for this app or for the whole website. Click "Ja" to finish.

Finally the app starts and you are able to explore the whole labAlive content.

*Due to changes in Firefox it is not possible to open *.jnlp files directly via Java-Webstart anymore. Alternatively the files can be downloaded and executed afterwards.

Download dialogue
Download dialogue

Now click on your downloaded file to start the app.

Downloaded file
Downloaded file

The app starts and you can continue with the security notifications.

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 the IcedTea browser plug-in. This will enable Java Webstart.

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 with Java Webstart successfully. Now you are able to explore the whole labAlive content.