Using the Toolkit for Java Download

This topic shows how to use the Toolkit for Java Download to install an Oracle Java release in Oracle Cloud Shell.

Before You Begin

To use the toolkit, ensure that:

You're signed in to your Oracle Cloud Infrastructure (OCI) account.
You have launched Cloud Shell in the OCI Console.

Step 1: Run the Toolkit Script

In your Cloud Shell session, run the toolkit script:

jms-java-download.sh

Example output:

<username>@cloudshell:jms (oci_region_id)$ jms-java-download.sh 
Fetching Java releases.
Current Java Versions:
    Version         Type       Security status      Release date         EOSL date            Release notes                           
1)  24.0.1          CPU        UP_TO_DATE           Apr 15, 2025         Sep 18, 2025         https://www.oracle.com/java/technologies/javase/24-0-1-relnotes.html
2)  21.0.7          CPU        UP_TO_DATE           Apr 15, 2025         Sep 19, 2031         https://www.oracle.com/java/technologies/javase/21-0-7-relnotes.html
3)  17.0.15         CPU        UP_TO_DATE           Apr 15, 2025         Sep 18, 2029         https://www.oracle.com/java/technologies/javase/17-0-15-relnotes.html
4)  11.0.27         CPU        UP_TO_DATE           Apr 15, 2025         Jan 30, 2032         https://www.oracle.com/java/technologies/javase/11-0-27-relnotes.html
5)  1.8.0_451       CPU        UP_TO_DATE           Apr 15, 2025         Dec 31, 2030         https://www.oracle.com/java/technologies/javase/8u451-relnotes.html
6)  Show Archived Versions
Enter the number corresponding to the version to install (or 6 to view archived versions):

Step 2: Select a Java Version

You can:

Select a current release, or
Choose the option labelled "Show Archived Versions" to view older releases.

Note

The option number for archived versions might vary depending on how many current versions are listed.

Selecting a Current Release

If the Java version you want to install is listed in the current releases, enter its corresponding number. This will proceed the process to Step 3: Token Management.

Viewing Archived Versions

Note

The non-current releases in Archived releases table are provided to help developers debug issues in older systems. They aren’t updated with the latest security patches and aren’t recommended for use in production.

If you choose "Show Archived Versions", the toolkit will list available major Java versions with archived releases:

Enter the number corresponding to the version to install (or 6 to view archived versions): 6
JDK major versions:
1)  24                  
2)  23                  
3)  22                  
4)  21                  
5)  20                  
6)  17                  
7)  11                  
8)  8
Enter the number corresponding to the JDK version to view archived versions:

Choose the JDK major version you are interested in.

Enter the number corresponding to the JDK version to view archived versions: 7
Archived Java 11 Versions:
    Version         Type       Security status      Release date         EOSL date            Release notes                           
1)  11.0.26         CPU        UPDATE_REQUIRED      Jan 21, 2025         Jan 30, 2032         https://www.oracle.com/java/technologies/javase/11-0-26-relnotes.html
2)  11.0.25         CPU        UPDATE_REQUIRED      Oct 15, 2024         Jan 30, 2032         https://www.oracle.com/java/technologies/javase/11-0-25-relnotes.html
3)  11.0.24         CPU        UPDATE_REQUIRED      Jul 16, 2024         Jan 30, 2032         https://www.oracle.com/java/technologies/javase/11-0-24-relnotes.html
4)  11.0.23         CPU        UPDATE_REQUIRED      Apr 16, 2024         Jan 30, 2032         https://www.oracle.com/java/technologies/javase/11-0-23-relnotes.html
5)  11.0.22         CPU        UPDATE_REQUIRED      Jan 16, 2024         Jan 30, 2032         https://www.oracle.com/java/technologies/javase/11-0-22-relnotes.html
6)  11.0.21         CPU        UPDATE_REQUIRED      Oct 17, 2023         Jan 30, 2032         https://www.oracle.com/java/technologies/javase/11-0-21-relnotes.html
7)  11.0.20         CPU        UPDATE_REQUIRED      Jul 18, 2023         Jan 30, 2032         https://www.oracle.com/java/technologies/javase/11-0-20-relnotes.html
8)  11.0.19         CPU        UPDATE_REQUIRED      Apr 18, 2023         Jan 30, 2032         https://www.oracle.com/java/technologies/javase/11-0-19-relnotes.html
Enter the number corresponding to the version to install:

Step 3: Token Management

Each Java download through the toolkit must be associated with a valid token managed by the Java Download feature in JMS.

If a valid token already exists, it can be reused.
If no suitable token is found, the toolkit helps you create a new one during the installation process.

Case 1: Active Token Exists

If one or more valid tokens already exist, the toolkit will prompt you to reuse an existing token or create a new one:

Enter the number corresponding to the version to install (or 6 to view archived versions): 1
Use an existing download token? (Y/N): Y
Active Tokens for Java Version 24 with license type NFTC:
    Name                  Description                    License Type Expiry        Created By    OCID
1)  JDK24NFTCToken        Token for downloading JDK 24   NFTC         Sep 18, 2027  <username>    {token_ocid}

Enter the number corresponding to the token to use or enter 'N' to create a new token: 1

Case 2: Create New Token or No Active Token Exists

The example shows JDK 24.0.1, which falls under Oracle No-Fee Terms and Conditions (NFTC):

Enter the number corresponding to the version to install (or 6 to view archived versions): 1
No active tokens found for Java version 24. Creating a new token.

JDK 24 is licensed under Oracle No-Fee Terms and Conditions (NFTC).
Read the full agreement here: https://java.com/freeuselicense

Enter details for new Java Download token.
Enter name (max 64 characters): JDK24NFTCToken
Enter description (max 255 characters): Token for downloading JDK 24 releases
Enter expiry date (UTC) (YYYY-MM-DD, leave blank for default: 2025-09-18. Minimum: 2025-05-20, Maximum: 2027-09-18): 2027-09-18

Note

If the selected release is distributed under Oracle Technology Network License Agreement for Oracle Java SE (OTN) License, you’ll be prompted to accept the license terms before a token can be created and the download initiated.

Once a token is selected or created, the download begins automatically.

Step 4: Download and Complete Installation

If your Cloud Shell instance already has an Oracle Java installation, the toolkit detects it and prompts whether to remove existing JDK directories:

The following JDK directories were found in /home/<username>/jms-java-download:
/home/<username>/jms-java-download/jdk-24.0.1
Current available space: 4673 MB.
Estimated space needed: 660 MB.
Do you want to remove all existing JDK directories? (Y/N):

Once confirmed (or skipped), the download begins:

 % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                   Dload  Upload   Total   Spent    Left  Speed
  0     0    0     0    0     0      0      0 --:--:--  0:00:01 --:--:--     0
100  229M  100  229M    0     0  74.5M      0  0:00:03  0:00:03 --:--:--  123M

At successful installation, the toolkit automatically updates your environment variables and exits execution.

JAVA_HOME and PATH updated in /home/<username>/.java_env.
Run 'source ~/.bashrc' to apply changes.

This completes the installation process in Oracle Cloud Shell. You can now begin using the installed Java version immediately.

To verify the installation, run: