Install Renew 2.6

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 renew2.6. Here, you just have to issue the following command line:

java -jar loader.jar gui

Install the base package

After you downloaded the base package you will first need to unzip it somewhere on your machine. A directory renew2.6 will be created in the current directory. Documentation files are placed in the subdirectory renew2.6/doc. The subdirectory renew2.6/samples contains example nets. The functionality of Renew has been decomposed into several plugins which reside as jar files in the subdirectory renew2.6/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 renew2.6/bin/YOUR_OS depending on your operating system. They generate a start script for Renew which sets the classpath and the netpath (see the user guide for more on this).

  • Download the base package
  • Unzip it, navigate to the created renew2.6 folder
  • Navigate to renew2.6/bin/YOUR_OS/ and run the install script installrenew for your operating system
  • To start renew now run the script renew2.6/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.

Click start

If you prefer to run Renew by clicking on an executable this is also possible. Just add the following line to the file in the config folder (or in your home directory in and double-click on the loader.jar:


Install the Source package

Building Renew from source requires a Java compiler (javac, part of the JDK) and additional libraries which are not included in the distribution.

  • the Apache Ant build tool,
  • the unit testing package JUnit (optional),
  • the parser generator JavaCC,
  • the rest reporting package Cobertura (optional)
  • Eclipse is used as code formatter (optional)

See the file renew2.6/src/README for information on the used version of the above libraries.

The build process is specified in the file build.xml and managed by ant. You will first need to tell ant where the required libraries are located. In the source folder run ant init. This generates the configuration file ant/ which you need to adapt to your needs. Set the properties dir.javacc and dir.cobertura to point to the locations, where you installed them.

After configuring your local properties you can run ant dist in the source folder. If the build is successful this will generate the folders dist and dist/plugins. The 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.

UHH, Inf

Back to the Renew homepage

Last modified: Fri Jan 5 11:42:51 2024 +0100 by