Chapter 2. Download Red Hat JBoss Data Grid

2.1. Red Hat JBoss Data Grid Installation Prerequisites

The only prerequisite to set up Red Hat JBoss Data Grid is an installed Java Virtual Machine (compatible with Java 8.0 or later).

2.2. Java Virtual Machine

A Java Virtual Machine (JVM) is a virtual environment that runs and executes Java programs on a host operating system. The JVM acts as an abstract computer and is a platform-independent execution environment that converts the Java programming code into machine language. A Java Virtual Machine (JVM) makes Java portable by providing an abstraction layer between the compiled Java program and the underlying hardware platform and operating system.

Red Hat recommends using OpenJDK Java platform as it is an open source, supported Java Virtual Machine that runs well on Red Hat Enterprise Linux systems. For Windows users, Oracle JDK 1.8 installation is recommended.

2.3. Install OpenJDK on Red Hat Enterprise Linux

Install OpenJDK on Red Hat Enterprise Linux

  1. Subscribe to the Base Channel

    Obtain the OpenJDK from the RHN base channel. Your installation of Red Hat Enterprise Linux is subscribed to this channel by default.

  2. Install the Package

    Use the yum utility to install OpenJDK:

    $ sudo yum install java-1.8.0-openjdk-devel
  3. Verify that OpenJDK is the System Default

    Ensure that the correct JDK is set as the system default as follows:

    1. Log in as a user with root privileges and run the alternatives command:

      $ /usr/sbin/alternatives --config java
    2. Select /usr/lib/jvm/java-1.8.0-openjdk-${java-version}.x86_64/bin/java .
    3. Use the following command to set javac :

      $ /usr/sbin/alternatives --config javac
    4. Select /usr/lib/jvm/java-1.8.0-openjdk-${java-version}.x86_64/bin/javac .

2.4. Download and Install JBoss Data Grid

2.4.1. Download and Install JBoss Data Grid

Use the following steps to download and install Red Hat JBoss Data Grid:

  1. Download JBoss Data Grid from the Red Hat Customer Portal.
  2. Verify the downloaded files.
  3. Install JBoss Data Grid.

2.4.2. Download Red Hat JBoss Data Grid

Follow the listed steps to download Red Hat JBoss Data Grid from the Customer Portal:

Download JBoss Data Grid

  1. Log into the Customer Portal at https://access.redhat.com.
  2. Click the Downloads button near the top of the page.
  3. In the Product Downloads page, click *Red Hat JBoss Data GridRed Hat JBoss Data Grid.
  4. Select the appropriate JBoss Data Grid version from the Version drop down menu.
  5. Download the appropriate files from the list that is displayed.

2.4.3. About the Red Hat Customer Portal

The Red Hat Customer Portal is the centralized platform for Red Hat knowledge and subscription resources. Use the Red Hat Customer Portal to do the following:

  • Manage and maintain Red Hat entitlements and support contracts.
  • Download officially-supported software.
  • Access product documentation and the Red Hat Knowledgebase.
  • Contact Global Support Services.
  • File bugs against Red Hat products.

The Customer Portal is available here: https://access.redhat.com.

2.4.4. Checksum Validation

Checksum validation is used to ensure a downloaded file has not been corrupted. Checksum validation employs algorithms that compute a fixed-size datum (or checksum) from an arbitrary block of digital data. If two parties compute a checksum of a particular file using the same algorithm, the results will be identical. Therefore, when computing the checksum of a downloaded file using the same algorithm as the supplier, if the checksums match, the integrity of the file is confirmed. If there is a discrepancy, the file has been corrupted in the download process.

2.4.5. Verify the Downloaded File

Verify the Downloaded File

  1. To verify that a file downloaded from the Red Hat Customer Portal is error-free, access the portal site and go to that package’s Software Details page. The Software Details page displays the MD5 and SHA256 checksum values. Use the checksum values to check the integrity of the file.
  2. Open a terminal window and run either the md5sum or sha256sum command, with the downloaded file as an argument. The program displays the checksum value for the file as the output for the command.
  3. Compare the checksum value returned by the command to the corresponding value displayed on the Software Details page for the file.

    Note

    Microsoft Windows does not come equipped with a checksum tool. Windows operating system users have to download a third-party product instead.

Result

If the two checksum values are identical then the file has not been altered or corrupted and is, therefore, safe to use.

If the two checksum values are not identical, then download the file again. A difference between the checksum values means that the file has either been corrupted during download or has been modified since it was uploaded to the server. If, after several downloads, the checksum will still not successfully validate, contact Red Hat Support for assistance.

2.4.6. Install Red Hat JBoss Data Grid

Prerequisite

Locate the appropriate version, platform, and file type and download Red Hat JBoss Data Grid from the Customer Portal.

Install JBoss Data Grid

  1. Copy the downloaded JBoss Data Grid package to the preferred location on your machine.
  2. Run the following command to extract the downloaded JBoss Data Grid package:

    $ unzip JDG_PACKAGE

    Replace JDG_PACKAGE with the name of the JBoss Data Grid usage mode package downloaded from the Red Hat Customer Portal.

  3. The resulting unzipped directory will now be referred to as $JDG_HOME.

2.4.7. Red Hat Documentation Site

Red Hat’s official documentation site is available at https://access.redhat.com/site/documentation/. There you will find the latest version of every book, including this one.