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 Bring Your Own Eclipse (BYOE). 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 the Eclipse IDE.

  2. Click Help → Eclipse Marketplace.

    crs eclipse marketplace

    The Eclipse Marketplace window appears.

  3. Locate Red Hat CodeReady Studio 12.16 GA.

    install crs from eclipse
  4. Click Install.

  5. 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.

    crs fuse tooling

    If you receive warnings about installing unsigned content, review the details of the content and, if satisfied, click Install Anyway to continue with the installation.

  6. Restart Eclipse.

    When prompted to restart the Eclipse IDE, click Restart Now. 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 the Eclipse IDE.

  2. Click Help → Install New Software.

    crs install new software

    The Available Software window appears.

  3. Click Add.

    The Add Repository window appears.

    crs locating update site zip
  4. Click Archive and locate the Update Site Zip file.
  5. Click Add.

  6. Select the Red Hat CodeReady Studio - Bring Your Own Eclipse and Red Hat Fuse Tooling check boxes.

    crs offline install
  7. Click Next.

  8. 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 Install Anyway to continue with the installation.

  9. Restart Eclipse.

    When prompted to restart the Eclipse IDE, click Restart Now. 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 using the Installer.

Procedure

  1. Download the Red Hat CodeReady Studio 12.16 Installer from the Red Hat Developer Portal.
  2. Go to the directory that contains the downloaded codereadystudio-12.16.0.GA-installer-standalone.jar file.

  3. Start the Installer: 

    $ java -jar codereadystudio-12.16.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.

    crs intaller fuse

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.16 Installer from the Red Hat Developer Portal.
  2. Go to the directory that contains the downloaded codereadystudio-12.16.0.GA-installer-standalone.jar file.

  3. Start the installer: 

    $ java -jar codereadystudio-12.16.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. Run the following command: 

    $ java -jar codereadystudio-12.16.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

  • Maven 3.3 or later with Java 8 must be installed. To obtain and configure Maven, see the Apache Maven Project.

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.

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