Installation

Using Renew requires a Java 1.6 (or higher) runtime environment (JRE). You can get it from Oracle. 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 renew2.4base.zip, unzip it and move to the resulting directory renew2.4. 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 renew2.4base.zip you will first need to unzip it somewhere on your machine. A directory renew2.4 will be created in the current directory. Documentation files are placed in the subdirectory renew2.4/doc. The subdirectory renew2.4/samples contains example nets. The functionality of Renew has been decomposed into several plugins which reside as jar files in the subdirectory renew2.4/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.4/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 renew2.4base.zip
Unzip it, navigate to the created renew2.4 folder
Navigate to renew2.4/bin/YOUR_OS/ and run the install script installrenew for your operating system
To start renew now run the script renew2.4/bin/YOUR_OS/renew

Ubuntu /Debian Packages

We provide deb packages for Debian-based systems. Just add the following lines to your /etc/apt/sources.list:

## The Renew Repository
deb http://www.informatik.uni-hamburg.de/TGI/renew/debian renew stable

and run the following as super user:

# wget http://www.informatik.uni-hamburg.de/TGI/renew/renew.gpg
# apt-key add renew.gpg 
# apt-get update
# apt-get install renew

or in order to install renew and optional plugins

# apt-get install renew renew-guiprompt renew-fs renew-tablet renew-imagenetdiff

Mac Package

The disk image (DMG) offers several atvantages over the zip archive. The ApplleUI Plugin is already installed and the Application will automatically register Renew file types for convenient handling, adapted icon, etc. 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 folder Reference Net Workshop/Contents/Resources/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 renew.properties in the config folder (or in your home directory in .renew.properties) and double-click on the loader.jar:

de.renew.gui.autostart=true

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 code beautifier Jalopy (optional), and
the rest reporting package Cobertura (optional)

See the file renew2.4/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/local.properties which you need to adapt to your needs. Set the properties dir.javacc, dir.cobertura and dir.jalopy.lib 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 manual start section.

Impressum

Back to the Renew homepage

Last modified: Tue May 7 17:41:07 CEST 2013 by webmaster@renew.de