Skip to content

Instructions to run the Open Roberta Lab Server natively on ubuntu ‐ not recommended

Reinhard Budde edited this page May 22, 2024 · 1 revision

We STRONGLY recommend to run a local lab in a docker container.

Many people, teachers and students, around the world have no good internet connection or other good reasons not to use our online server at https://lab.open-roberta.org. This tutorial explains how to setup the server in a lokal system, either as standalone version (not recommended), or as a local network installation, e.g. in classrooms or maybe in a school or intranet network (sorry, no real experience in this).

1. Get the Open Roberta Lab Server Binaries

  • Download the binaries from the latest release here. Please choose the latest version openrobertalab_binaries.zip
  • Extract the zip file and copy the content of the the openrobertalab_binaries folder to your desired location, e.g. into a new folder "OpenRobertaLab".

License information is available here. Please read the file LICENCE and NOTICE carefully. If you have questions please contact us.


2. Get Java for your System

  • Make sure that Java Runtime Environment (JRE) is available. Open a command prompt and type java -version, if it is already available then the output is something with java version "1.8.a_b" or a higher version number.
  • If you do not have the JRE already installed, please search in the internet for it and install it. Make sure that the above point is met.

Start the Open Roberta Lab server

  • start a terminal
  • navigate to the folder where you have extracted the binaries in step 1
  • type ./admin.sh start-embedded-server, you should see the output of the starting process in the terminal.
  • check now if the server is available in the browser: type localhost:1999 in the adress field and the Open Roberta Lab site will appear

With the admin.sh script you can configure the start of the server with a couple of parameters Here is an overview what is possible and the default values:

  • determine the port: -d server.port=1999
  • determine the available robot systems and their order in the menu: -d robot.whitelist=ev3lejos,ev3dev,calliope2017,calliope2016,microbit,microbitv2
  • determine the directory server internal temporary files: -d plugin.tempdir=/tmp/
  • determine the location of the admin folder: -d server.admin.dir=./admin

If you want to run the server in the background: wrap the start command with nohup and &. Example server start: nohup ./admin.sh start-embedded-server -d robot.whitelist=sim,ev3lejos,ev3dev -d server.port=1234 &

Note:

If you try to use functionality around cross compilation of code generated for ''real'' robots, the server will probably react with a "Server Error", because crosscompiler are not installed locally (this is one reason why running the lab in a docker container is much better). This might be confusing, so it is highly recommended to follow the instructions how to set up the cross compiler and their resources" in the readme of the repo https://github.com/OpenRoberta/openroberta-lab**

Clone this wiki locally