Install Red Hat JBoss Developer Studio 10.0

Updated -

Developer Studio Installation Options

Red Hat JBoss Developer Studio is provided in two variants depending on your circumstance: stand-alone and Bring-Your-Own-Eclipse (BYOE). JBoss Developer Studio stand-alone packages the JBoss Developer Studio plug-ins with Eclipse and dependent third-party plug-ins in an installer for all operating systems. JBoss Developer Studio BYOE packages the JBoss Developer Studio plug-ins for installing in your existing Eclipse instance.
There are a variety of ways of installing each JBoss Developer Studio variant and instructions are given here for completing the following tasks:

Note: You can also install Devstudio as part of Red Hat Development Suite. The Red Hat Development Suite Installer installs the following components:

  • OpenJDK 1.8.0.91
  • Red Hat JBoss Developer Studio 10.0.0
  • Cygwin 2.5.1
  • Red Hat Container Development Kit 2.1
  • Vagrant 1.7.4
  • VirtualBox 5.0.8
    Note that currently only 64-bit versions of Windows 7, 8, and 10 are supported. For instructions on installing Red Hat Development Suite, refer to https://access.redhat.com/articles/2360571.

Hardware and Software Requirements

JBoss Developer Studio 10 requires Java 8 to run. Before commencing the installation of devstudio, make sure that Java 8 is installed on your system.

JBoss Developer Studio 10 is supported for use with a range of operating system, architecture, and Java developer kit combinations; for a complete list, see https://access.redhat.com/articles/427493 on the Red Hat Customer Portal.

To install and run Devstudio 10, the following is recommended:

  • 4 GB RAM (minimum 2 GB RAM)
  • 2 GB of hard disk space

Install OpenJDK 8

Unless you already have Java 8 installed on your system, use the OpenJDK distribution provided by Red Hat. This section describes how to install OpenJDK by Red Hat on Microsoft Windows and Red Hat Enterprise Linux.

Install OpenJDK on Microsoft Windows

Note: Currently only 64-bit versions of Windows 7, 8, and 10 are supported.

To install OpenJDK 8 on Windows using the MSI-based installer:

  1. Download the MSI-based installer from: http://developers.redhat.com/products/openjdk/overview/.

  2. Run the installer and follow the on-screen instructions to install.

  3. To configure Developer Studio to use OpenJDK, follow the instructions at http://help.eclipse.org/mars/index.jsp?topic=%2Forg.eclipse.jdt.doc.user%2Ftasks%2Ftasks-JREs.htm&cp=1_3_5.

Install OpenJDK on Red Hat Enterprise Linux

To install OpenJDK 8 on Red Hat Enterprise Linux:

Note: All the commands in the following procedure must be run as the root user.

  1. Register and subscribe the system by running the following command:

    # subscription-manager register
    
  2. When prompted, enter your Red Hat Customer Portal user name and password.

  3. To find a suitable subscription, such as Developer Subscription, run the following command:

    # subscription-manager list --available
    

    This command lists the available subscriptions and details of the subscriptions. Note down the pool ID of the appropriate subscription.

  4. To attach a subscription to your system, run the following command:

    # subscription-manager attach --pool=<pool id from previous command>
    
  5. To install OpenJDK RPMs:

    # yum install java-1.8.0-openjdk-devel
    

    Note: Install the java-1.8.0-openjdk-demo package for examples of Java applications and the java-1.8.0-openjdk-src package to debug your applications. Both packages are available from the Optional repository. Use the following command to enable that repository on your system:

    # subscription-manager repos --enable=rhel-7-server-optional-rpms
    

    Substitute the version number in the above command with 6 if you use Red Hat Enterprise Linux 6.
    Use the following command to install the packages:

    # yum install java-1.8.0-openjdk-src java-1.8.0-openjdk-demo
    

Install JBoss Developer Studio BYOE when Online

JBoss Developer Studio BYOE is available to install from Eclipse Marketplace when you are online.

To install JBoss Developer Studio BYOE from Eclipse Marketplace:

  1. Ensure that Java 8 is installed on your system.

  2. Start Eclipse Neon.

  3. Click HelpEclipse Marketplace, locate Red Hat JBoss Developer Studio 10.0 GA and click Install.

  4. Follow the on-screen instructions to complete the installation process.

During the installation process, if you receive warnings about installing unsigned content, review the details of the content and if satisfied, click OK to continue with the installation.
Once installation is complete, you are prompted to restart Eclipse. Click Yes to restart immediately and No if you need to save any unsaved changes to open projects. Note that IDE changes do not take effect until Eclipse is restarted.

Install JBoss Developer Studio BYOE when Offline

You need the Update Site Zip to install JBoss Developer Studio BYOE in offline mode. Alternatively, you can also use an installer downloaded on your system instead of the Update Site Zip to install JBoss Developer Studio BYOE when Offline.

Important: You must first be online to download the .zip file before proceeding to install JBoss Developer Studio BYOE in offline mode.

To install JBoss Developer Studio BYOE in offline mode:

  1. Ensure that Java 8 is installed on your system.

  2. Download the Red Hat JBoss Developer Studio {version} Update Site Zip from https://devstudio.redhat.com/10.0/development/updates.

  3. Start Eclipse Neon.

  4. Click HelpInstall New Software.

  5. In the Work with field, enter the path of the Update Site Zip file. Alternatively, click Add and click Archive to locate the file.

  6. From the table of components, select JBoss Developer Studio {version} - Bring Your Own Eclipse and click Next.

  7. Follow the on-screen instructions to complete the installation process.

During the installation process, you may receive warnings about installing unsigned content. If this is the case, review the details of the content and if satisfied, click OK to continue with the installation.
Once the installation is complete, you are prompted to restart Eclipse. Click Yes to restart immediately and No to save any unsaved changes to open projects. Note that the IDE changes do not take effect until Eclipse is restarted.

Install JBoss Developer Studio Stand-alone

The installer provided to install JBoss Developer Studio stand-alone is available from a variety of sources, including the Red Hat Customer Portal.

To install JBoss Developer Studio stand-alone:

  1. Ensure that Java 8 is installed on your system.

  2. Download Red Hat JBoss Developer Studio {version} Stand-alone Installer from https://access.redhat.com/jbossnetwork/restricted/listSoftware.html?product=jbossdeveloperstudio&downloadType=distributions.

  3. Start the installer:

    $ cd /path/to/.jar
    $ java -jar devstudio-{version}-installer-standalone.jar
    

    Alternatively, you can start the installer by double-clicking the .jar file. On OS X systems, hold control and click the .jar file, click Open, review the .jar file details and if satisfied, click Open.

  4. Follow the on-screen instructions to complete the installation process.

Install JBoss Developer Studio Stand-alone and Red Hat JBoss EAP

A single installer is provided for both JBoss Developer Studio stand-alone and Red Hat JBoss Enterprise Application Platform. A specific JBoss EAP version is packaged in the installer; for details of the JBoss EAP version, see https://access.redhat.com/articles/427493. This installer is available from a variety of sources, including the Red Hat Customer Portal.

To install JBoss Developer Studio stand-alone and JBoss EAP:

  1. Ensure that Java 8 is installed on your system.

  2. Download Red Hat JBoss Developer Studio {version} Installer with EAP from
    https://access.redhat.com/jbossnetwork/restricted/listSoftware.html?product=jbossdeveloperstudio&downloadType=distributions.

  3. Start the installer:

    $ cd /path/to/.jar
    $ java -jar devstudio-{version}-installer-eap.jar
    

    Alternatively, you can start the installer by double-clicking the .jar file. On OS X systems, hold control and click the .jar file, click Open, review the .jar file details and if satisfied, click Open.

  4. Follow the on-screen instructions to continue the installation process.

  5. At installer step 5, when asked if you want to install JBoss EAP, click Yes.

  6. Continue to follow the on-screen instructions to complete the installation process.

This additional installer option installs JBoss EAP in a subdirectory of the JBoss Developer Studio installation and generates a complete default server definition within the IDE with which to manage the JBoss EAP instance and deployed applications.

Advanced Installation Tasks

Install JBoss Developer Studio via a Script

Use the scripted method to install JBoss Developer Studio stand-alone using the GUI once and then a generated script for subsequent installations. This installation method enables simplified repeat installations or installations in bulk without stepping through the installer GUI for every installation.

The JBoss Developer Studio stand-alone installer is available from a variety of sources, including the Red Hat Customer Portal.

To install JBoss Developer Studio by script, complete the following steps:

  1. Download Red Hat JBoss Developer Studio {version} Stand-alone Installer from https://access.redhat.com/jbossnetwork/restricted/listSoftware.html?product=jbossdeveloperstudio&downloadType=distributions.

  2. Start the installer as follows:

    $ cd /path/to/.jar 
    $ java -jar devstudio-{version}-installer-standalone.jar
    
  3. Follow the on-screen instructions to complete the installation process.
    After the installation is complete, a InstallConfigRecord.xml file is generated in the /path/to/devstudio/ directory.

  4. In the terminal window, enter the following command:

    $ java -jar devstudio-{version}-installer-standalone.jar /path/to/devstudio/InstallConfigRecord.xml
    

Note: The generated InstallConfigRecord.xml file is machine-specific and uses the Java Developer Kit and installation paths of your system. To use the InstallConfigRecord.xml file for systems with different operating systems, Java Developer Kits, or paths, you must manually modify the file.

Build the JBoss Developer Studio Stand-alone Installer from Source

A .zip file is provided from which you can build the JBoss Developer Studio stand-alone installer. The source code archive is available from a variety of sources, including the Red Hat Customer Portal.

Note: It is easier to build the installer from the github source instead of the source ZIP file.

Important: Maven must be installed to build the installer from the source code. Also, ensure that you are using Maven 3.2 or later, with Java 8 or later. To obtain and configure Maven, see http://maven.apache.org/.

To build the JBoss Developer Studio stand-alone installer from source:

  1. Download the Red Hat JBoss Developer Studio 10.0.0 Stand-alone Installer from: https://access.redhat.com/jbossnetwork/restricted/listSoftware.html?product=jbossdeveloperstudio&downloadType=distributions.

  2. Extract the contents of the downloaded file by running the following commands:

    $ cd path/to/.zip
    $ unzip devstudio-{version}-src.zip 
    
  3. Build the installer by following the instructions in the README.how-to-build-from-sources-zip.txt file.

Note: The README.how-to-build-from-sources-zip.txt file is located in the extracted current folder at the highest level.

Building takes some time to complete, after which the installer .jar file will be located in the /path/to/devstudio-{version}-src/jbdevstudio-product-{SHA_checksum}/installer/target directory.

Report Issues from within the IDE

Red Hat JBoss Developer Studio and JBoss Tools allow users to report issues from within the IDE as they are encountered. It is recommended that users report issues frequently and include as much detail as possible to help the development and testing teams replicate and fix the issue. The Report Problem wizard creates a zip file containing the relevant IDE log files. This zip file can be attached to the JIRAs submitted against each problem to provide context for the issue.

  1. Click Help and then click Report Problem.

  2. The Log file name field contains the zipped log files as a default. Click Browse to select a different log file to attach to the JIRA.

  3. In the Problem Description field, outline details about the problem, such as:

    • What you wanted to do with JBoss Developer Studio.

    • What steps you followed to arrive at the problem or error message.

    • Any other noteworthy information about the environment or any unsupported add-ons or plug-ins in use.

  4. Optionally, in the E-Mail field, add your e-mail address to be potentially contacted in the future about the issue.

  5. Click OK to submit the problem report.

You can also enable error reporting from: Preferences > General > Error Reporting. If enabled, when you encounter a plugin related error, a pop-up notification describing the error will appear. The user can either dismiss or send the error directly, or provide more details about the error. You can optionally provide your e-mail ID to be contacted for more details on the error.

2 Comments

Not mentioned here is that you can also build devstudio from github sources, rather than fetching a zip.

Sources are here: https://github.com/jbdevstudio/jbdevstudio-product

~nboldt@redhat.com

Hi Nick,

This should be mentioned at the moment in a note under the "Build the JBoss Developer Studio Stand-alone Installer from Source" heading. Let me know if you think it should be more prominent or something and I'll adjust it. Thanks!