3 Installation of the JDK on Linux Platforms

This topic describes the installation procedures of the JDK on the Linux platform, along with the system requirements.

General Notes About Installing the JDK on Linux Platforms from Archive Files

This topic describes general information about installing JDK 21 on Linux platforms.

Installing the JDK automatically creates a directory called jdk–feature.interim.update.patch where feature (21),interim, update, and patch represent corresponding values of version information.

Root Access

If you install JDK in a specific location such as /opt, you must log in with root credentials to gain the necessary permissions. If you do not have the root access, either install the JDK in your home directory or a sub directory for which you have the write permissions.

Overwriting Files

If you install the software in a directory that contains a sub directory named jdk–21.interim.update.patch, the new software overwrites files of the same name in that directory. Ensure that you rename the old directory if it contains files that you would like to keep.

System Preferences

Installing the JDK from archive files doesn't configure the backing store for the system node of Java Preferences API (java.util.prefs Java package). If this functionality of the JDK is required, you need to manually configure it by making sure either /etc/.java/.systemPrefs or jdk–21.interim.update.patch/.systemPrefs directory exists.

General Notes About Installing the JDK on Linux Platforms from RPM packages

This topic describes general information about installing JDK 21 from RPM packages on Linux platforms.

You can install only one version of JDK of the same feature release. If you try to install the newer version of the same feature release while the older version exists, the installer uninstalls the older version and installs the new version. For example, you can't install jdk-21 and jdk-21.0.1 simultaneously. If you attempt to install jdk-21.0.1 after jdk-21 is installed, the installer uninstalls jdk-21 and installs jdk-21.0.1.

All versions of JDK of the same feature release are installed in /usr/lib/jvm/jdk-21-oracle-<ARCH> directory, where <ARCH> equals x64 or aarch64. Additionally /usr/java/jdk-21 symbolic link pointing to the installation directory is created for backward compatibility.

Note:

If you install an older version of a JDK when the newer version of the same feature family already exists, an error is displayed, prompting you to uninstall a newer JDK version if an older version has to be installed.

Root Access

You must log in with root credentials to install or update JDK.

System Preferences

By default, the installation script configures the system such that the backing store for the system node of Java Preferences API (java.util.prefs Java package) is configured in /etc/.java/.systemPrefs directory.

System Integration

The JDK installation is integrated with the alternatives framework. After installation, the alternatives framework is updated to reflect the binaries from the recently installed JDK. Java commands such as java, javac, javadoc, and javap can be called from the command line.

Using the java -version command, you can confirm the default (recently installed) JDK version.

In addition, you can check which specific RPM package provides the java files:
$ rpm -q --whatprovides java

System Requirements for Installing JDK on Linux Platforms

See Oracle JDK Certified Systems Configurations for information about supported platforms, operating systems, and browsers.

Installing the JDK on Linux from Archive Files, Debian Packages, RPM Packages, and Oracle Linux Repositories

You can install the JDK on a Linux platform from archive files, debian packages, downloadable Red Hat Package Manager (RPM) packages files, or RPM packages from Oracle Linux (OL) repositories.

Installation can be performed by using one of the following processes:

  • From archive files (.tar.gz): This allows you to install a private version of the JDK for the current user into any location, without affecting other JDK installations. However, it may involve manual steps to get some of the features to work. See the following table for the options available for downloading and installing the JDK from archive files. The bundles are available for Linux x64 and Linux aarch64 (64-bit ARM) systems. Install the required bundle.

  • From Debian packages (.deb): This allows you to perform a system-wide JDK installation on Debian-based Linux platforms, and requires root access.
  • From downloadable RPM packages (.rpm): This allows you to perform a system-wide JDK installation on RPM-based Linux platforms for all users, and requires root access. See the following table for the options available for downloading and installing the JDK from Linux x64 and Linux aarch64 (64-bit ARM) RPM packages.

  • From Oracle Linux repositories: This allows you to perform a system-wide JDK installation on OL platforms starting from OL7 for all users, and requires root access. JDK RPM packages in Oracle Linux RPM repositories are available for x64 and aarch64 (64-bit ARM) OL platforms. Explicit download of JDK RPM packages is not required, the package manager will do it automatically for you.

JDK RPM packages for Generic Linux platforms and Oracle Linux platforms differ. The following table lists the differences:

Table 3-1 Difference between Generic Linux and OL platforms

Feature Downloadable JDK RPM Package for Generic Linux Platforms JDK RPM package for Oracle Linux platforms
Supported Linux Platforms Any RPM-based Linux platform. For example, Red Hat, SuSE OL platforms starting from OL7
Package name JDK image is packed in a single package named jdk-21

JDK image is split into two packages: jdk-21-headless and jdk-21-headful.

  • jdk-21-headless is a headless Java Runtime for running non-GUI applications.
  • jdk-21-headful is headful Java Runtime and Development Tools for developing and running all types of applications.

jdk-21-headful package requires jdk-21-headless package. When these packages are installed together, they provide the same functionality as the jdk-21 package for Generic Linux Platforms.

Installation directory name /usr/lib/jvm/jdk-21-oracle-<ARCH> /usr/lib/jvm/jdk-21-oracle-<ARCH>
Available for download from Java SE Downloads Yes No. The packages are hosted in Oracle Linux RPM repositories.
Integration with the alternatives framework jdk-21 package registers java and javac groups with the alternatives framework.

jdk-21-headless package registers java group with the alternatives framework.

jdk-21-headful package registers javac group with the alternatives framework.

Will automatically install the required 3rd party packages? No. You need to manually install the required packages. Yes. All required packages will be installed automatically.

Downloading the JDK Installer

Access Java SE Downloads page and click Accept License Agreement. Under the Download menu, click the Download link corresponding your requirement.

The following table lists the options and instructions for downloading and installing the JDK 21 release on a Linux platform:

Download File Instructions Architecture (CPU Type) Who Can Install
For Linux x64 systems: jdk-21.interim.update.patch_linux-x64.tar.gz Installing the 64-Bit JDK on Linux Platforms Intel - 64-bit Anyone
For Linux aarch64 (64-bit ARM) systems: jdk-21.interim.update.patch_linux-aarch64.tar.gz Installing the 64-Bit JDK on Linux Platforms ARM - 64-bit Anyone
For Linux x64 systems: jdk-21.interim.update.patch_linux-x64.deb Installing the 64-Bit JDK Package on Debian-based Linux Platforms Intel - 64-bit RPM-based Linux Root
For Linux x64 systems: jdk-21.interim.update.patch_linux-x64.rpm Installing the 64-Bit JDK on RPM-Based Linux Platforms Intel - 64-bit RPM-based Linux Root
For Linux aarch64 (64-bit ARM) systems: jdk-21.interim.update.patch_linux-aarch64.rpm Installing the 64-Bit JDK on RPM-Based Linux Platforms ARM - 64-bit RPM-based Linux Root

Installing the 64-Bit JDK on Linux Platforms

You can install the JDK for 64-bit Linux from an archive file (.tar.gz). The .tar.gz archive file (also called a tarball) is a file that can be uncompressed and extracted in a single step.

To install the 64-bit JDK on a Linux platform:
  1. Download the required file:
    • For Linux x64 systems: jdk-21.interim.update.patch_linux-x64_bin.tar.gz. For example jdk-21_linux-x64_bin.tar.gz
    • For Linux aarch64 (64-bit ARM) systems: jdk-21.interim.update.patch_linux-aarch64_bin.tar.gz. For example, jdk-21_linux-aarch64_bin.tar.gz

    Before you download a file, you must accept the license agreement. Anyone (not only root users) can install the archive file in any location having write access.

  2. Change the directory to the location where you want to install the JDK, then move the .tar.gz archive file to the current directory.
  3. Unpack the tarball and install the downloaded JDK:

    $ tar zxvf jdk-21_linux-x64_bin.tar.gz

    OR

    $ tar zxvf jdk-21_linux-aarch64_bin.tar.gz

    The Java Development Kit files are installed in a directory named jdk-21.interim.update.patch.

  4. Delete the .tar.gz file if you want to save disk space.

Installing the 64-Bit JDK Package on Debian-based Linux Platforms

You can install the JDK Debian package for 64-bit Linux from the (.deb) file.

To install the 64-bit JDK Debian package on a Linux platform:
  1. Download the required file:
    jdk-21.interim.update.patch_linux-x64_bin.deb. For example jdk-21_linux-x64_bin.deb

    Before you download a file, you must accept the license agreement. Anyone (not only root users) can install the archive file in any location having write access.

  2. Install the package using the following command:

    $ sudo dpkg -i jdk-21_linux-x64_bin.deb

    The Java Development Kit files are installed into /usr/lib/jvm/jdk-<FEATURE>-oracle-<ARCH> directory. For example, JDK 21 releases for x64 will be installed in /usr/lib/jvm/jdk-21-oracle-x64 directory.

  3. Delete the .deb file if you want to save disk space.

Installing the 64-Bit JDK on RPM-Based Linux Platforms

You can install the JDK on 64-bit RPM-based Linux platforms, such as Red Hat and SuSE by using a downloadable RPM package file (.rpm) in the system location.

Note:

You can install the JDK using a downloadable RPM package file on an OL system too, but the preferred way to install the JDK on OL systems is from Oracle Linux RPM repositories.
Ensure that you have the root user access. You can do this by running the command su and entering the superuser password.
To install the 64-bit JDK on an RPM-based Linux platform:
  1. Download the required file:
    • For x64 systems: jdk-21.interim.update.patch_linux-x64_bin.rpm. For example, jdk-21_linux-x64_bin.rpm
    • For aarch64 (64-bit ARM) systems: jdk-21.interim.update.patch_linux-aarch64_bin.rpm. For example, jdk-21_linux-aarch64_bin.rpm

    Before you download a file, you must accept the license agreement.

  2. Install the required package using the following command:

    $ sudo rpm -ivh jdk-21_linux-x64_bin.rpm

    OR

    $ sudo rpm -ivh jdk-21_linux-aarch64_bin.rpm

    Upgrade the required package using the following command:

    $ sudo rpm -Uvh jdk-21_linux-x64_bin.rpm

    OR

    $ sudo rpm -Uvh jdk-21_linux-aarch64_bin.rpm

    Note:

    JDK 21 can coexist with other feature releases of JDK. For each feature release, a separate directory is created, the default directory being /usr/lib/jvm/jdk-<FEATURE>-oracle-<ARCH>. For example, JDK 21 releases for x64 will be installed in /usr/lib/jvm/jdk-21-oracle-x64 directory.
  3. Delete the .rpm file if you want to save disk space.
    It is not required to reboot.
Installation of Public Key on RPM-based Linux Platforms

From JDK version 8, the JDK RPMs are signed with OL keys. RPMs installed on Linux distributions other than OL may display a warning message indicating that security validation of the package failed. This indicates that the public key used to sign this RPM needs to be installed in the system.

A sample warning message and the public key installation steps are as follows:

Sample Warning Message

jdk-21.0.3_linux-aarch64_bin.rpm: Header V3 RSA/SHA256 Signature, key
        ID ec551f03: NOKEY

Installation Steps

  1. Download the key file from https://yum.oracle.com/RPM-GPG-KEY-oracle-ol7 using the following command:
    wget
        https://yum.oracle.com/RPM-GPG-KEY-oracle-ol7
  2. Install the key using the following command:
    sudo rpm --import RPM-GPG-KEY-oracle-ol7

Note:

Public key installation needs to be done only once. The key installation is persistent across reboots.
Installation of Public Key on RPM-based Linux Platforms

From JDK version 8, the JDK RPMs are signed with OL keys. RPMs installed on Linux distributions other than OL may display a warning message indicating that security validation of the package failed. This indicates that the public key used to sign this RPM needs to be installed in the system.

A sample warning message and the public key installation steps are as follows:

Sample Warning Message

jdk-21.0.3_linux-aarch64_bin.rpm: Header V3 RSA/SHA256 Signature, key
        ID ec551f03: NOKEY

Installation Steps

  1. Download the key file from https://yum.oracle.com/RPM-GPG-KEY-oracle-ol7 using the following command:
    wget
        https://yum.oracle.com/RPM-GPG-KEY-oracle-ol7
  2. Install the key using the following command:
    sudo rpm --import RPM-GPG-KEY-oracle-ol7

Note:

Public key installation needs to be done only once. The key installation is persistent across reboots.

Installing the 64-Bit JDK on Oracle Linux Platforms

There are two OL-specific JDK RPM packages, jdk-21-headless and jdk-21-headful. When these packages are installed together, they provide full JDK functionality.

Install jdk-21-headless package if you only need headless Java Runtime for running non-GUI applications.

Install jdk-21-headful package if you need full JDK functionality for running any Java application and development.

Note:

The jdk-21-headful package depends on jdk-21-headless, hence installing jdk-21-headful package will result in the automatic installation of jdk-21-headless, if it is not installed yet.
To install the 64-bit JDK headless on an Oracle Linux platform use either dnf or yum command:

sudo dnf install jdk-21-headless

OR

sudo yum install jdk-21-headless

To install the 64-bit JDK headful on an Oracle Linux platform use the following command:

sudo dnf install jdk-21-headful

OR

sudo yum install jdk-21-headful