Install Renew 4.1

Using Renew requires a Java 11 (or higher) runtime environment (JRE) or development kit (JDK). You can get it from Oracle or from Adoptium. For the installation of Java we refer you to the instructions there.

Quick start

The quickest way to using Renew is to download the base package, unzip it and move to the resulting directory renew4.1. If you are using Linux as operating system just issue the following command line:

java -p .:libs -m de.renew.loader gui
However, when you are using Windows as operating system you have to type the following into the command line interface:
java -p ".\;libs" -m de.renew.loader gui

Install the base package

After you downloaded the base package you will first need to unzip it somewhere on your machine. A directory renew4.1 will be created in the current directory. Documentation files are placed in the subdirectory renew4.1/doc. The subdirectory renew4.1/samples contains example nets. The functionality of Renew has been decomposed into several plugins which reside as jar files in the subdirectory renew4.1/plugins. This is also the place where you can add extra plugins.

The base package contains install scripts for Unix, Win and Mac systems. These are located under renew4.1/bin/YOUR_OS depending on your operating system. They generate a start script for Renew which sets the modulepath and the netpath (see the user guide for more on this).

  • Download the base package
  • Unzip it, navigate to the created renew4.1 folder
  • Navigate to renew4.1/bin/YOUR_OS/ and run the install script installrenew for your operating system
  • To start renew now run the script renew4.1/bin/YOUR_OS/renew

Mac Package

The disk image (DMG) offers several advantages over the zip archive. The AppleUI Plugin is already installed and the Application will automatically register Renew file types for convenient handling, adapted icons and more. If you want to use the provided scripts (i.e. to make and compile stubs) you can still run the installrenew script, which is located in the folder Reference Net Workshop/Contents/Java/bin/unix. Just follow the instructions above.

Install the Source package

Building Renew from source requires a Java compiler (javac, part of the JDK). We use Gradle as our build tool, which will automatically take care of all dependencies. You do not even have to have Gradle installed, as the source package comes with its own Gradle wrapper. See the file renew4.1/src/README for information on Gradle and the libraries that are used.

The build process is specified in the file build.gradle and managed by Gradle. You can run ./gradlew dist (Unix) or gradlew dist (Win) in the source folder. If the build is successful this will generate the folders dist and dist/plugins. The de.renew.loader.jar is located in the dist folder, plugins contains the plugins in jar format.

Now you can start Renew like described in the quick start section. However, you will now either have to navigate into the dist folder, or change the module paths to your dist and dist/libs folders.

If you want to setup Renew in an IDE, we recommend using JetBrains' IntelliJ IDEA. It natively supports a multi-project build, which Renew is. You can easily load the project by importing the root build.gradle file. This action requires Java 11 (or higher) but we recommend using Java 17.

UHH, Inf

Back to the Renew homepage

Last modified: Tuesday, 14 February 2023 at 14:19 UTC by