Red Hat Training

A Red Hat training course is available for Red Hat Development Suite

Chapter 4. Installing Red Hat Development Suite

4.1. Installation Options

Red Hat Development Suite 1.4 includes the following installation options:

  • Windows-only Installers

    • An Installer that has an initial download of approximately 1 GB and includes all Red Hat products, OpenJDK, and Cygwin for installation. VirtualBox and Kompose are not included in the installer and have to be downloaded during the installation time.
    • An Online Installer that is a 60 MB download and downloads the required components during the installation process.

  • macOS-only Installers

    • An Installer that has an initial download of approximately 1 GB and includes all Red Hat products, OpenJDK and Cygwin for installation. VirtualBox and Kompose are not included in the installer and have to be downloaded during the installation time.
    • An Online Installer that is a 60 MB download and downloads the required components during the installation process.

  • Red Hat Enterprise Linux (Technology Preview)

    • Red Hat Enterprise Linux uses RPM packages to install Red Hat Container Development Kit and Red Hat JBoss Developer Studio.

4.2. Installation Prerequisites

4.2.1. General Prerequisites

The following are general prerequisites for Windows and macOS. Ensure that you refer to the Microsoft Windows or macOS specific prerequisites after ensuring the general requirements are met.

  • Sign Up for the Red Hat Developer Program: Join the program here: Red Hat Developer Program. After signing up, you must wait approximately fifteen minutes to allow the new account information to propagate to the Red Hat Subscription Management system.
  • (Optional) Install Docker individually to use Docker for Windows: Red Hat Development Suite includes the Docker tooling, but to use the full version of Docker for Windows (Docker Machine or Boot2Docker), you must install Docker and test it before installing any Eclipse Docker tools. This is only applicable to using Docker out of JBoss Developer Studio, such as Docker for Windows or Docker for macOS.

4.2.2. Microsoft Windows Prerequisites

Ensure that the following prerequisites are met when installing Development Suite on Microsoft Windows (supported):

  • Ensure that Virtualization is enabled in your machine’s BIOS settings. If Red Hat Development Suite is run on a new system, ensure that Virtualization is enabled in the BIOS settings. This is required to run VirtualBox. For further information, consult your system’s documentation for instructions to change BIOS settings.
  • Ensure that you are logged in using an Administrator account. Red Hat Development Suite adds drivers and changes environment variables and therefore requires Administrator permissions. Do not run Red Hat Development Suite using a non-Administrator account with the Run as Administrator option because this not supply the required permissions.

4.2.3. macOS Prerequisites

Ensure that the following prerequisites are met when installing Development Suite on macOS :

  • Ensure that you are logged in as a user that has permission to administer the computer . Red Hat Development Suite adds drivers and changes environment variables and therefore requires administrator permissions.
  • Ensure that Java SE 1.8.0 is installed: Download and install Java SE 1.8.0 Build 111 from the Oracle website: Java Download.

  • Ensure that Virtualization is enabled for your machine. In a terminal, run the sysctl -a | grep machdep.cpu.features command. The result will be a string of features, for example: 

    machdep.cpu.features: FPU VME DE PSE TSC MSR PAE MCE CX8 APIC SEP MTRR PGE MCA CMOV PAT PSE36 CLFSH DS ACPI MMX FXSR SSE SSE2 SS HTT TM PBE SSE3 PCLMULQDQ DTES64 MON DSCPL *VMX* EST TM2 SSSE3 CX16 TPR PDCM SSE4.1 SSE4.2 x2APIC POPCNT AES PCID XSAVE OSXSAVE TSCTMR AVX1.0 RDRAND F16C

    If the output includes VMX, as highlighted in the example, the machine has Virtualization enabled.

4.2.4. Red Hat Enterprise Linux Prerequisites

Ensure that the following prerequisites are met on Red Hat Enterprise Linux:

  • Enable the rhel-server-rhscl-7-rpms repository on Red Hat Enterprise Linux Server and rhel-workstation-rhscl-7-rpms repository on Red Hat Enterprise Linux workstation. Run the following command in order to enable the repository on Red Hat Enterprise Linux Server: 

    subscription-manager repos --enable rhel-server-rhscl-7-rpms

    Run the following command in order to enable the repository on Red Hat Enterprise Linux Workstation: 

    subscription-manager repos --enable rhel-workstation-rhscl-7-rpms

    For more information on enabling the repository, see Getting Access to Red Hat Software Collections.

4.3. Installing Red Hat Development Suite

4.3.1. Installing Red Hat Development Suite on Microsoft Windows and macOS

To install Red Hat Development Suite:

  1. Log in and download Red Hat Development Suite from the Red Hat Developers Portal product download page at Red Hat Developers Download. Please note that macOS installers need to be unzipped before the next step. If using the Safari browser to download, the macOS installer is automatically unzipped.
  2. Run the downloaded file installation file (Online or Bundled).

  3. At the Log In screen, enter your existing Red Hat Developer login credentials to log in.

    Figure 4.1. Enter Your Login Credentials

    Enter Your Login Credentials

  4. At the Target Folder screen, add a path to the target directory for the Red Hat Development Suite installation. The default path for Windows is c:\DevelopmentSuite, and the default path for macOS is /Applications/DevelopmentSuite.

    Figure 4.2. Set the Target Directory

    Set the Target Directory

    If your Windows user has a space in the username, for example, Example User, the installer displays an error. See Section 6.1, “Terms and Conditions Error” for troubleshooting information for this error.

  5. The Confirmation screen lists the components that Red Hat Development Suite downloads and installs. Red Hat Development Suite detects components based on the PATH environment variable. If none of the components are installed, no changes are required. If an older version of a component is detected, the user can uninstall the older version of the component without exiting the installer. Red Hat Development Suite detects when the older version of the component is uninstalled.

    1. To Install Red Hat Development Suite:

      1. All required components are already selected by default.

      2. Click Download & Install to continue.

        Figure 4.3. Download and install all components

        Download and install all components

    2. To only install Red Hat Container Development Kit:

      1. Deselect the Red Hat JBoss Developer Studio and OpenJDK. You must deselect JBoss Developer Studio before its dependency (OpenJDK) is available to select.
      2. Deselect Kompose.
      3. For Windows only: Enable Hyper-V or proceed with selected component VirtualBox. If user chooses to enable Hyper-V, a reboot is required and then restart Red Hat Development Suite. Once Red Hat Development Suite detects that Hyper-V is enabled, VirtualBox is removed from the component list.

      4. Click Download & Install to continue.

        Figure 4.4. Enable Hyper-V

        Enable Hyper-V or select VirtualBox

    3. To only install JBoss Developer Studio:

      1. Deselect the Red Hat Container Development Kit, Cygwin, and VirtualBox options. You must deselect the Container Development Kit option before its dependencies are available to select.
      2. Deselect Kompose.
      3. Click Download & Install to continue.

    4. To only install any of the tools (VirtualBox, Cygwin, Kompose, OpenJDK):

      1. Deselect the Red Hat Container Development Kit and JBoss Developer Studio options.
      2. Select and deselect any of the other components as desired.
      3. Click Download & Install to continue.
  6. The Online installer then downloads the selected components and installs it. This process involves large file downloads and can take some time to complete. The Bundled installer includes the components and directly installs them.

  7. When complete, Red Hat Development Suite indicates that the download and install were successful and provides a link to the Red Hat Container Development Kit Getting Started page. Depending on what you want to do next, you can either:

    1. Click the Open Red Hat JBoss Developer Studio button to start using the Red Hat Container Development Kit Server Adapter.
    2. Visit Red Hat Container Development Kit to learn about using Red Hat Container Development Kit.
    3. For Windows only: if Hyper-V is enabled, the user must log off and log in again in order to run CDK without administrative privileges.

    4. Start a local OpenShift cluster with minishift: 

      minishift start --cpus 3 --disk-size 20g

      Visit Minishift to learn about using minishift.

  8. To run Red Hat Development Suite, click the Open Red Hat JBoss Developer Studio button:

    1. Set up a workspace folder, as prompted.
    2. Click the Servers tab to view the configured Red Hat Container Development Kit server adapter.
    3. Right-click the server and select Start to initiate the Red Hat Container Development Kit server.
    4. When prompted, enter your Red Hat Customer Portal credentials and click OK. The Console tab displays the details of the Red Hat Container Development Kit server.
    5. When prompted, read the details of the new SSL certificate for OpenShift and click Yes to accept it.
    6. Click the OpenShift Explorer tab to view the new OpenShift server and sample project.

4.3.2. Installing Red Hat Development Suite on Red Hat Enterprise Linux

Red Hat Development Suite includes the following packages:

  • rh-devsuite - all tools integrated together
  • rh-eclipse46-devstudio - Red Hat JBoss Developer Studio 10.4
  • cdk-minishift - Red Hat Container Development Kit 3.0
  • docker-machine-kvm - Red Hat Container Development Kit minishift kvm driver


To install Red Hat Development Suite using the RPM package:

  1. As root, create the etc/yum/repos.d/'rh-devsuite.repo' file and add the following content: 

    [rh-devsuite]
name=Red Hat Developemnt Suite RPMs
baseurl=file://opt/rh-devsuite-repo/
gpgkey=https://www.redhat.com/security/data/a5787476.txt
enabled=1
gpgcheck=1

  2. To install Red Hat Development Suite with all components, run the following command: 

    # yum -y install rh-devsuite

  3. To only install Red Hat JBoss Developer Studio, run the following command: 

    # yum install rh-eclipse46-devstudio

  4. To only install Red Hat Container Development Kit, run the following command: 

    # yum install cdk-minishift


To setup Red Hat Container Development Kit, enter the following commands:

  1. Create a symbolic link for minishift: 

    sudo ln -s /var/lib/cdk-minishift-3.0.0/minishift /usr/bin/minishift

  2. Install required CDK components: 

    minishift setup-cdk --force --default-vm-driver="kvm"

  3. Create a symbolic link: 

    sudo ln -s /home/$(whoami)/.minishift/cache/oc/v3.5.5.8/oc /usr/bin/oc

Visit Minishift to learn about using minishift.


To run Red Hat JBoss Developer Studio:

  1. Use Applications→Programming→Red Hat Eclipse 4.6 launcher.