Visual Studio Code¶
The JRebel plugin for Visual Studio Code (VS Code) can be installed using a VSIX file. The installation includes the JRebel agent that automatically generates the JRebel configuration. It enables JRebel for applications and servers with a single click and improves the debugging support in the IDE.
Installing the plugin from the VSIX file¶
The JRebel plugin is bundled with the VSIX file and automatically installs the plugin for VS Code.
To install the plugin from a VSIX file:
Install the VSIX file from the Extensions: Install from VSIX… command in the Command Palette… or the Extensions sidebar, from the Views and More Actions… menu, select Install from VSIX…. A file explorer window opens.
Navigate to the downloaded VSIX file for the JRebel plugin and click Install.
Restart the IDE if prompted to complete the plugin installation.
To verify the successful installation of a plugin, in the sidebar, click the JRebel icon . The JRebel plugin pane opens.
Uninstalling the JRebel plugin¶
Go to Manage (Extensions) or View > Extensions. Open the INSTALLED tab and locate the JRebel plugin.
Right-click the plugin and select Uninstall.
Reload the VS Code for the changes to take effect.
Following the installation, you do not have a license yet. Once your IDE restarts, the JRebel plugin notifies you about JRebel Activation. On the sidebar, select the JRebel icon and navigate to User Settings > Dashboard and then click Add License.
The Activate JRebel window opens. The JRebel Activation window contains two tabs: Commerical License and Individual Trial.
Open this tab if you already have a JRebel license. You can select one of three activation options:
Team URL (connect to online licensing service) – Select this option if your network administrator provides you with a Team URL. The Team URL is a unique URL consisting of the License Server address and a unique key. Specify the Team URL link in the first field and enter your email address into the second field. Click OK to activate JRebel.
License file from the hard drive (jrebel.lic) – Select this option if you bought a license. We will email you a
jrebel.liclicense file. Click Choose File and locate the
jrebel.licfile on the hard drive and then click OK to activate JRebel using the license file.
Activation code – Select this option and enter the trial activation code in the text field. Click OK to activate using the activation code.
Click to select the checkbox I agree to the terms and conditions of the License Agreement to have a fully functional JRebel.
JRebel requires just one configuration file rebel.xml, which is generated automatically and used to map the running application to the workspace. To open JRebel, navigate to View > Open View… > JRebel or the View: Show JRebel command in the Command Palette.
Installing the JRebel extension for VS Code does not enable JRebel for projects automatically. To enable JRebel for a project, navigate to JRebel > Workspace Settings > Home > Project Panel or JRebel > Quick Access > Go to Projects and click to select the checkbox for a project to automatically generate the
rebel.xmlfile that resides under the source tree of a project.
A dedicated configuration file is generated for every module in the project. Once you have generated
rebel.xml, you need to redeploy your application to the server for the configuration to take effect. To make modifications to the configuration file, see the Reference for rebel.xml file format.
The JRebel plugin for VS Code includes the dedicated launch buttons JRebel Run and JRebel Debug. JRebel Run launches the application with JRebel, and JRebel Debug launches the application with JRebel in debug mode. Launching the process using JRebel Run or JRebel Debug, the JRebel plugin automatically adds the appropriate command line parameters.
The configuration of application servers to work with JRebel is done using JRebel > Workspace Settings > Startup - Guide. You can select one of the options from the Startup - Guide view to run your application server.
Run via IDE¶
Navigate to JRebel > Workspace Settings > Startup - Guide > Run via IDE to display all application servers configured for the IDE. Select the checkbox next to any server to add the required JVM arguments to the server startup configuration. The automatic publishing will be disabled in the server configuration to prevent unintended automatic redeploys.
You can quickly get in touch with the JRebel Support team. Navigate to JRebel > User Settings > Dashboard > Request Support.
Describe the issue for JRebel support and provide more information on what went wrong by sending the JRebel log file
(jrebel.log) to the support team at email@example.com.
IDE log level configuration¶
You can configure the JRebel IDE plugin log level using a command-line parameter. Add the following parameter to
The default value for this property is
info. The JRebel IDE plugin log file is stored in