JRebel Reference Manual

©ZeroTurnaround OÜ, Estonia, Tartu


Prev  Home  Next
Preface 2. IDE Configuration

1. Installation

1.1 Installation for Windows
1.2 Platform-neutral Installation
1.2.1 JAR Installer
1.2.2 ZIP Archive
1.3 License Setup
1.4 Uninstallation

Installation Overview

At JRebel download page, you are provided with several options for installation package download. You can choose between Windows-specific installation package, or two platform-independent packages. Note that two latter cases are suitable for installation on Windows PC.

1.1 Installation for Windows

If you select the Windows Installer option for download, you will be provided the installation package for Windows PC. Execute the binary after downloading it, and proceed with the setup as the installation wizard guides you through the process.

At the very final screen of the installation wizard you will have an option to start the configuration wizard which will provide the information about the IDE, application server and application setup with JRebel.

After the installation is complete, if you have selected to create the shortcuts in Start menu, a program group for JRebel will be created as follows:

1.2 Platform-neutral Installation

For platforms other that Windows (but also Windows itself) we have provided the platform-neutral installation packages. There are two options provided for the download, either JAR installer, of a ZIP archive.

1.2.1 JAR Installer

If you select the JAR Installer option for download, you will be provided a ZIP Archive, containing a single jrebel-setup.jar file. To execute the installation process proceed as follows:

    > unzip jrebel-3.1.2a-setup.zip
    > cd jrebel
    > java -jar jrebel-setup.jar

The last command in the snippet above will execute the graphical wizard window which is exactly the same application as in case of Windows platform setup. Proceed with the installation steps by pushing Next button.

1.2.2 ZIP Archive

By selecting ZIP Archive download option you will be provided the archive with the JRebel install directory. Just unpack the archive to the location of your choice. After you have unpacked the archive, it would be wise to setup the environment variables to make use of it later as configure JRebel for you application server and your project.

1.3 License Setup

After the software is installed, the license must be configured. The configuration wizard, bundled with the software provides options for registering your license.

The configuration wizard can be cound in JRebel installation directory under bin/ folder. The application is started using jrebel-config.cmd on Windows, or jrebel-config.sh on Linux machine. To start the registration process, please select one of the options provided:

Already a user

By choosing the very first option, I already have a JRebel license key (skip to Activation page) you will be forwarded to the next page of the wizard for license setup. You can either specify the path to the license file, or alternatively, the license file can be saved to .jrebel directory under your user home folder, e.g. /home/<username>/.jrebel

New evaluation

For the first time users the evaluation license for 30 days is provided for free. By choosing the second option, I'm a new user and need an evaluation license, you will be asked to fill the registration form form. Please provide the correct data and a valid e-mail address. The license file should be delivered to you in a few minutes.

1.4 Uninstallation

If you have installed JRebel using the installation wizard, either via Windows installation package or JAR installer, then JRebel installation will include %JREBEL_HOME%\bin\uninstaller.jar file. It can be used to uninstall JRebel from your computer by executing it as follows:

java -jar uninstaller.jar

The following dialog will appear:


Check the checkbox in order to forcefully delete the JRebel's installation directory and proceed by pushing Uninstall button.

The environment variables aren't deleted by the uninstaller, so you have to clean 'em up manually.

In case if you installed JRebel using ZIP archive, uninstaller.jar utility is not provided, so you can just delete the directory where you have unpacked it.


Prev  Home  Next
Preface 2. IDE Configuration

JRebel Reference Manual, ©ZeroTurnaround OÜ, Estonia, Tartu