Step by Step Guide to Installing and Configuring JBoss Developer Studio 8.0

Vijay Chintalapati bio photo By Vijay Chintalapati
Quick Index
Prerequisites
Downloading the binaries
Installing JBoss Developer Studio
Configuring JBoss Developer Studio

Prerequisites

  • Determine if the operating system is 32-bit or 64-bit and install the correct version of JDK 1.7 or 1.8 (JBDS 8.0 works well with either) based on the bitness determined.
  • On the development VM, ensure at least 2 GB of RAM and 1 GB in HDD space is available in addition to the needs of the OS.
  • Ensure that java can be found on the system path. One should be able to run the command java in the terminal from within any folder.

Downloading the binaries

JBoss Developer Studio

####Two options:

  1. From jboss.org here
  2. From Red Hat customer portal here (requires an account)
    • Choose version 8.0.0 from the drop-down
    • Click the download link against the filename Red Hat JBoss Developer Studio 8.0.0 Stand-alone Installer

When done, one should find jboss-devstudio-8.0.0.GA-v20141020-1042-B317-installer-standalone.jar file downloaded.


Installing JBoss Developer Studio

In the folder where the executable was downloaded the following command should be run. If the user account used for the installation does not have write permissions to the installation path, either the command must be run as root or prepended by sudo in front of the command if the user is part of the sudoers list.

java -jar jboss-devstudio-8.0.0.GA-v20141020-1042-B317-installer-standalone.jar 

Follow the images below to complete the installation

Step #s correspond to the # displayed in the installation window

Step 2. Accept the End User License Agreement Step 3. Choose the installation path Step 4. Choose the runtime JVM

It is recommended that JDK is used instead of JRE in this step as shown below Step 5. (Optional) Add a path JDBS needs to scan for platforms or servers

If using an installer that includes a bundled EAP, a choice can be be made to install EAP as part of the current installation and keep it ready for use within JBDS Step 6. Verify the information provided and the disk space requirements and click ‘Next’

Step 7. Watch/Verify the installation progress

Step 8. Create shortcuts to the application where desired

Step 9. Finish the installation

Configuring JBoss Developer Studio

Increase the default memory allocated for JBoss Developer Studio

This is a very important step and not to be skipped especially when the intention is to use plugins in JBDS (example: Data Virtualization) that do some UI heavy lifting. While the application is shut, locate the jbdevstudio.ini file in the installation. Since the path to this file can differ between platforms, on Unix/Linux/MacOSX systems run the following command in the installation folder to track its exact location:

find . -name "jbdevstudio.ini"

Open the file and find entries like the ones shown below OR add them to the file, if they are missing, under -vmargs. Depending on the capacity of the development VM, allocate a high number to the memory, example : 2048m, ideally to both -Xms and -Xmx.

-Xms512m
-Xmx1024m

Follow the images below to complete the configuration

  • Launch the JBoss Developer Studio. Provide the path to the location of workspace.

  • Click on the Workbench icon on top-right corner of the screen

  • Click on the 2nd tab: Software/Update found at the bottom of the JBoss Central frame

  • Choose one or more updates, for example: JBoss Data Virtualization Development, to be applied to current installation and click on Install/Update

  • The rest of the update process should mirror the images shown below and in the sequence shown. To move ahead at each step click OK/Next/Finish as provided. The update should end with a prompt to restart the JBDS.