Chapter 3. Installing CodeReady Studio

The following section describes how to install CodeReady Studio:

Note that you can have multiple versions of CodeReady Studio installed on your system with Installer or Eclipse, provided you have these versions located in different directories.

3.1. Installing CodeReady Studio in Eclipse

CodeReady Studio for Eclipse packages the CodeReady Studio plug-ins for your existing Eclipse instance. You can install CodeReady Studio from the Eclipse Marketplace when you are online. This installation method is referred to as BYOE (Bring Your Own Eclipse). Alternatively, you can use the Update Site Zip to install CodeReady Studio when you are offline.

The following section describes how to install CodeReady Studio when you are online and when you are offline.

3.1.1. Installing CodeReady Studio in Eclipse when online

The following section describes how to install CodeReady Studio BYOE from Eclipse Marketplace.

Procedure

  1. Start Eclipse IDE 2019‑12.
  2. Click Help → Eclipse Marketplace
  3. Locate Red Hat CodeReady Studio 12.14 GA.

  4. Click Install.

    Important

    When prompted to select additional features to install, select the Fuse Tooling feature for creating, testing and debugging integration applications.

  5. Follow the on-screen instructions to complete 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.

  6. Restart Eclipse.

    Note that the changes do not take effect until you restart Eclipse.

3.1.2. Installing CodeReady Studio in Eclipse when offline

The following section describes how to install CodeReady Studio with the Update Site Zip. Alternatively, you can also use an Installer downloaded on your system instead of the Update Site Zip.

Note that the Target Platform Zip contains the features on which CodeReady Studio depends. It also contains the sources of all the included plug-ins.

Prerequisites

Procedure

  1. Start Eclipse IDE 2019‑12.

  2. Click Help → Install New Software

    The Available software window appears.

  3. Click Add → Archive to locate the Update Site Zip file.
  4. Click Add.
  5. Check the Red Hat CodeReady Studio - Bring Your Own Eclipse and Red Hat Fuse Tooling check boxes.
  6. Click Next.

  7. Follow the on-screen instructions to complete 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.

  8. Restart Eclipse.

    Note that the changes do not take effect until you restart Eclipse.

3.2. Installing CodeReady Studio stand-alone using the Installer

The Installer contains CodeReady Studio stand-alone that packages the CodeReady Studio plug-ins with Eclipse and dependent third-party plug-ins. The Installer is compatible with all operating systems and is available from a variety of sources, including the Red Hat Customer Portal.

The following section describes how to install CodeReady Studio stand-alone.

Procedure

  1. Download the Red Hat CodeReady Studio 12.14 Installer from https://developers.redhat.com/products/codeready-studio/download.

  2. Go to the directory that contains the .jar file for the Red Hat CodeReady Studio 12.14 Stand-alone Installer.

    Review the contents of the .jar file. If satisfied, continue with the installation.

  3. Start the installer: 

    $ java -jar codereadystudio-12.14.0.GA-installer-standalone.jar

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

    Important

    When prompted to select additional features to install, select the Fuse Tooling feature for creating, testing and debugging integration applications.

3.3. Performing advanced installation tasks

The following section describes how to:

  • Install CodeReady Studio using a script.
  • Build the Red Hat CodeReady Studio Installer from the source code.

3.3.1. Installing CodeReady Studio using a script

The following section describes how to install CodeReady Studio using a script.

Procedure

  1. Download the Red Hat CodeReady Studio 12.14 Installer from https://developers.redhat.com/products/codeready-studio/download.

  2. Go to the directory that contains .jar file for the Red Hat CodeReady Studio 12.14 Stand-alone Installer.

    Review the contents of the .jar file. If satisfied, continue with the installation.

  3. Start the installer: 

    $ java -jar codereadystudio-12.14.0.GA-installer-standalone.jar

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

    Important

    When prompted to select additional features to install, select the Fuse Tooling feature for creating, testing and debugging integration applications.

    After the installation is complete, an InstallConfigRecord.xml file is generated in the CodeReady Studio installation directory.

  5. In a terminal window, use: 

    $ java -jar codereadystudio-12.14.0.GA-installer-standalone.jar \
  /path-to/InstallConfigRecord.xml

    Replace path-to with the path to the InstallConfigRecord.xml file.

Note

The generated InstallConfigRecord.xml file is machine-specific and uses the Java Development Kit (JDK) and installation paths of your system. To use the InstallConfigRecord.xml file for other operating systems, JDKs, or paths, you must manually modify the file.

3.3.2. Building the CodeReady Studio stand-alone Installer from source

The following section describes how to build the CodeReady Studio stand-alone Installer from source.

Prerequisites

Procedure

  1. Clone the git repository: 

    $ git clone https://github.com/jbdevstudio/jbdevstudio-product.git

  2. Navigate to the jbdevstudio-product directory: 

    $ cd jbdevstudio-product

  3. Checkout into master: 

    $ git checkout master

  4. Follow the instructions in the README.adoc file.

    Note that building the CodeReady Studio stand-alone Installer takes some time.

When the build is complete, the .jar file for the CodeReady Studio stand-alone Installer is located in the /jbdevstudio-product/installer/target directory.