Skip to content

Commit

Permalink
[GR-51348] [GR-51350] Add required 24.0.0 release updates to docs.
Browse files Browse the repository at this point in the history
PullRequest: graal/17051
  • Loading branch information
olyagpl committed Feb 28, 2024
2 parents 34929a0 + d69cc91 commit 9358f24
Show file tree
Hide file tree
Showing 20 changed files with 97 additions and 115 deletions.
14 changes: 7 additions & 7 deletions docs/enterprise-overview/support.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,25 +7,25 @@ permalink: /support/

## Available Distributions

Oracle GraalVM for JDK 21 is based on Oracle JDK 21.
Each release of Oracle GraalVM for JDK 21 includes all Oracle Java critical patch updates (CPUs), which are provided on a regular schedule to remedy defects and known vulnerabilities.
Oracle GraalVM for JDK 22 is based on Oracle JDK 22.
Each release of Oracle GraalVM for JDK 22 includes all Oracle Java critical patch updates (CPUs), which are provided on a regular schedule to remedy defects and known vulnerabilities.

Oracle GraalVM for JDK 21 is available for Linux, macOS, and Windows on the x64 architecture, and for Linux and macOS on the AArch64 architecture.
Oracle GraalVM for JDK 22 is available for Linux, macOS, and Windows on the x64 architecture, and for Linux and macOS on the AArch64 architecture.

## Certified Platforms

Oracle GraalVM for JDK 21 is certified on the following platforms:
Oracle GraalVM for JDK 22 is certified on the following platforms:

| Operating System | Version | Architecture | Installation Guide |
|------------------------------------ |-------------- |-------------- |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Oracle Linux | 7, 8, 9 | x64, AArch64| [Installation Guide for Oracle Linux](../getting-started/graalvm-enterprise/oci/installation-compute-instance-with-OL.md) |
| Red Hat Enterprise Linux (RHEL) | 7, 8, 9 | x64 | [Installation Guide for Linux](../getting-started/graalvm-enterprise/linux.md) |
| macOS | 11 (Big Sur), 12.4 (Monterey), 13.3 (Ventura) | x64, AArch64 | [Installation Guide for macOS](../getting-started/graalvm-enterprise/macos.md) |
| macOS | 11 (Big Sur), 12.4 (Monterey), 13.3 (Ventura), 14.3 (Sonoma) | x64, AArch64 | [Installation Guide for macOS](../getting-started/graalvm-enterprise/macos.md) |
| Microsoft Windows | Server 2016, 2019, 2022 | x64 | [Installation Guide for Windows](../getting-started/graalvm-enterprise/windows.md) |

## Experimental Components

Oracle GraalVM for JDK 21 includes some components that are considered experimental.
Oracle GraalVM for JDK 22 includes some components that are considered experimental.
These components are not meant for use in production and are not supported by Oracle.
Some components are considered experimental on specific platforms.
The GraalVM team welcomes feedback on these components, but users should be aware that the components may not be included in a future release or may change significantly before being considered production-ready:
Expand All @@ -41,7 +41,7 @@ The following components are deprecated and will be removed in Oracle GraalVM fo

## Related Technologies

Additional open source language runtimes designed for use with Oracle GraalVM for JDK 21 are available on [graalvm.org](https://www.graalvm.org/reference-manual/languages/).
Additional open source language runtimes designed for use with Oracle GraalVM for JDK 22 are available on [graalvm.org](https://www.graalvm.org/reference-manual/languages/).

## Licensing and Support

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,13 +11,12 @@ To support container-based development, GraalVM Community Edition container imag

## Repositories

There are different GraalVM Community Edition container images provided depending on the architecture and the Java version.
The container image repositories for the latest GraalVM versions (GraalVM for JDK 17, GraalVM for JDK 20, and GraalVM for JDK 21) have a `-community` suffix.
There are different GraalVM Community Edition container images provided depending on the architecture and the Java version, and have `-community` as part of their names.
These are: **native-image-community**, **jdk-community**, **truffleruby-community**, **nodejs-community**, and **graalpy-community**.
The container images are multi-arch, for AMD64 and AArch64 processor architectures, with a choice of Oracle Linux versions 7, 8, or 9.
The container images are multi-arch, for AMD64 and AArch64 processor architectures, with a choice of Oracle Linux versions 7, 8, or 9.

GraalVM is installed in `/usr/lib64/graalvm/graalvm-java<$FeatureVersion>` where `<$FeatureVersion>` is `17`, `21`, etc.
For instance, GraalVM for JDK 21 is installed in `/usr/lib64/graalvm/graalvm-java21`.
GraalVM is installed in `/usr/lib64/graalvm/graalvm-java<$FeatureVersion>` where `<$FeatureVersion>` is `17`, `21`, `22`, etc.
For instance, GraalVM for JDK 22 is installed in `/usr/lib64/graalvm/graalvm-java22`.
All binaries, including `java`, `javac`, `native-image`, and other binaries are available as global commands via the `alternatives` command.

See a full list of GraalVM Community Edition container images [here](https://github.com/graalvm/container).
Expand All @@ -33,7 +32,7 @@ $version[-muslib(for native image only)][-$platform][-$buildnumber]

The following tags are listed from the most-specific tag (at the top) to the least-specific tag (at the bottom).
The most-specific tag is unique and always points to the same image, while the less-specific tags point to newer image variants over time.

For example:
```
21.0.0-ol9-20230919
21.0.0-ol9
Expand All @@ -44,36 +43,36 @@ The most-specific tag is unique and always points to the same image, while the l

## Pulling Images

1. To pull the container image for GraalVM JDK for a specific JDK feature version, e.g, _21_, run:
1. To pull the container image for GraalVM JDK for a specific JDK feature version, e.g, _22_, run:
```bash
docker pull ghcr.io/graalvm/jdk-community:21
docker pull ghcr.io/graalvm/jdk-community:22
```

Alternatively, to use the container image as the base image in your Dockerfile, use:
```bash
FROM ghcr.io/graalvm/jdk-community:21
FROM ghcr.io/graalvm/jdk-community:22
```

You have pulled a size compact GraalVM Community Edition container image with the GraalVM JDK and the Graal compiler pre-installed.

2. To pull the container image with the `native-image` utility for a specific JDK feature version, e.g, _21_, run:
2. To pull the container image with the `native-image` utility for a specific JDK feature version, e.g, _22_, run:
```bash
docker pull ghcr.io/graalvm/native-image-community:21
docker pull ghcr.io/graalvm/native-image-community:22
```

Alternatively, to pull the container image with the `native-image` utility with the `musl libc` toolchain to create fully statically linked executables, use:
```bash
docker pull ghcr.io/graalvm/native-image-community:21-muslib
docker pull ghcr.io/graalvm/native-image-community:22-muslib
```

Alternatively, to use the container image as the base image in your Dockerfile, use:
```bash
FROM ghcr.io/graalvm/native-image-community:21-muslib
FROM ghcr.io/graalvm/native-image-community:22-muslib
```

3. To verify, start the container and enter the Bash session:
```bash
docker run -it --rm --entrypoint /bin/bash ghcr.io/graalvm/native-image-community:21
docker run -it --rm --entrypoint /bin/bash ghcr.io/graalvm/native-image-community:22
```

To check the version of GraalVM and its installed location, run the `env` command from the Bash prompt:
Expand All @@ -95,7 +94,7 @@ The most-specific tag is unique and always points to the same image, while the l

4. Calling `docker pull` without specifying a processor architecture pulls container images for the processor architecture that matches your Docker client. To pull container images for a different platform architecture, specify the desired platform architecture with the `--platform` option and either `linux/amd64` or `linux/aarch64` as follows:
```bash
docker pull --platform linux/aarch64 ghcr.io/graalvm/native-image-community:21
docker pull --platform linux/aarch64 ghcr.io/graalvm/native-image-community:22
```

## Oracle GraalVM Container Images
Expand Down
2 changes: 1 addition & 1 deletion docs/getting-started/graalvm-community/linux.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ You can install GraalVM on Linux from an archive (_.tar.gz_) for the current use

Follow these steps to install GraalVM:

1. Navigate to the [GraalVM Downloads page](https://www.graalvm.org/downloads/). Select **21** for the Java version, **Linux** for the operating system, **x64** or **aarch64** for the architecture, and download.
1. Navigate to the [GraalVM Downloads page](https://www.graalvm.org/downloads/). Select **22** for the Java version, **Linux** for the operating system, **x64** or **aarch64** for the architecture, and download.

2. Change to directory where you want to install GraalVM, then move the _.tar.gz_ file to that directory.

Expand Down
6 changes: 3 additions & 3 deletions docs/getting-started/graalvm-community/macos.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ Note that on macOS the JDK installation path is: <em>/Library/Java/JavaVirtualMa

Follow these steps to install GraalVM:

1. Navigate to the [GraalVM Downloads page](https://www.graalvm.org/downloads/). Select **21** for the Java version, **macOS** for the operating system, **x64** or **aarch64** for the architecture, and download.
1. Navigate to the [GraalVM Downloads page](https://www.graalvm.org/downloads/). Select **22** for the Java version, **macOS** for the operating system, **x64** or **aarch64** for the architecture, and download.

2. Remove the quarantine attribute (required for macOS Catalina and later):
```shell
Expand Down Expand Up @@ -50,6 +50,6 @@ Optionally, you can specify GraalVM as the default JRE or JDK installation in yo

### On JAVA_HOME Command
The information property file, _Info.plist_, is in the top level _Contents_ directory.
This means that GraalVM participates in the macOS-specific `/usr/libexec/java_home` mechanism. Depending on other JDK installation(s) available, it is now possible that `/usr/libexec/java_home -v21` returns `/Library/Java/JavaVirtualMachines/<graalvm>/Contents/Home`.
You can run `/usr/libexec/java_home -v21 -V` to see the complete list of JVMs available to the `java_home` command. This command sorts the JVMs in decreasing version order and chooses the top one as the default for the specified version.
This means that GraalVM participates in the macOS-specific `/usr/libexec/java_home` mechanism. Depending on other JDK installation(s) available, it is now possible that `/usr/libexec/java_home -v22` returns `/Library/Java/JavaVirtualMachines/<graalvm>/Contents/Home`.
You can run `/usr/libexec/java_home -v22 -V` to see the complete list of JVMs available to the `java_home` command. This command sorts the JVMs in decreasing version order and chooses the top one as the default for the specified version.
Within a specific version, the sort order appears to be stable but is unspecified.
2 changes: 1 addition & 1 deletion docs/getting-started/graalvm-community/windows.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ You can install it on Windows from an archive file (_zip_).

Follow these steps to install GraalVM:

1. Navigate to the [GraalVM Downloads page](https://www.graalvm.org/downloads/). Select **21** for the Java version, **Windows** for the operating system, and download.
1. Navigate to the [GraalVM Downloads page](https://www.graalvm.org/downloads/). Select **22** for the Java version, **Windows** for the operating system, and download.

2. Change to the directory where you want to install GraalVM, then move the _.zip_ archive file to it.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -15,13 +15,13 @@ Oracle GraalVM container images are published in two OCR repositories: **jdk** a

| Repository | Description |
|------------------|-------------|
| **jdk** | Provides container images with Oracle GraalVM JDK which can be used to both compile and deploy Java applications. Image tags let you select the Java version and Oracle Linux version. |
| **jdk** | Provides container images with Oracle GraalVM JDK (without the `native-image` utility) which can be used to both compile and deploy Java applications. Image tags let you select the Java version and Oracle Linux version. |
| **native-image** | Provides Oracle GraalVM container images with the `native-image` utility along with all tools required to compile applications into native Linux executables. These images are commonly used in multi-stage builds to compile applications into executables that are then packaged in a lightweight container image. Image tags let you select the Java version and Oracle Linux version as well as variants that include the musl toolchain for the creation of fully statically linked executables. |

Both repositories provide container images for AMD64 and AArch64 processor architectures, with a choice of Oracle Linux versions 7, 8, or 9.

Oracle GraalVM is installed in `/usr/lib64/graalvm/graalvm-java<$FeatureVersion>` where `<$FeatureVersion>` is `17`, `20`, etc.
For instance, Oracle GraalVM for JDK 17 is installed in `/usr/lib64/graalvm/graalvm-java17`.
Oracle GraalVM is installed in `/usr/lib64/graalvm/graalvm-java<$FeatureVersion>` where `<$FeatureVersion>` is `17`, `21`, `22`, etc.
For instance, Oracle GraalVM for JDK 22 is installed in `/usr/lib64/graalvm/graalvm-java22`.
All binaries, including `java`, `javac`, `native-image`, and other binaries are available as global commands via the `alternatives` command.

## Tags
Expand All @@ -46,40 +46,40 @@ The most-specific tag is unique and always points to the same image, while the l

## Pulling Images

1. To pull the container image for Oracle GraalVM JDK for a specific JDK feature version, e.g., _17_, run:
1. To pull the container image for Oracle GraalVM JDK for a specific JDK feature version, e.g., _22_, run:

```bash
docker pull container-registry.oracle.com/graalvm/jdk:17
docker pull container-registry.oracle.com/graalvm/jdk:22
```

Alternatively, to use the container image as the base image in your Dockerfile, use:

```bash
FROM container-registry.oracle.com/graalvm/jdk:17
FROM container-registry.oracle.com/graalvm/jdk:22
```

2. To pull the container image for Oracle GraalVM `native-image` utility for a specific JDK feature version, e.g., _17_, run:
2. To pull the container image for Oracle GraalVM `native-image` utility for a specific JDK feature version, e.g., _22_, run:

```bash
docker pull container-registry.oracle.com/graalvm/native-image:17
docker pull container-registry.oracle.com/graalvm/native-image:22
```

Alternatively, to pull the container image for Oracle GraalVM `native-image` utility with the `musl libc` toolchain to create fully statically linked executables, run:

```bash
docker pull container-registry.oracle.com/graalvm/native-image:17-muslib
docker pull container-registry.oracle.com/graalvm/native-image:22-muslib
```

Alternatively, to use the container image as the base image in your Dockerfile, use:

```bash
FROM container-registry.oracle.com/graalvm/native-image:17-muslib
FROM container-registry.oracle.com/graalvm/native-image:22-muslib
```

3. To verify, start the container and enter the Bash session:

```bash
docker run -it --rm --entrypoint /bin/bash container-registry.oracle.com/graalvm/native-image:17
docker run -it --rm --entrypoint /bin/bash container-registry.oracle.com/graalvm/native-image:22
```

To check the version of Oracle GraalVM and its installed location, run the `env` command from the Bash prompt:
Expand Down Expand Up @@ -110,7 +110,7 @@ The most-specific tag is unique and always points to the same image, while the l
To pull container images for a different platform architecture, specify the desired platform architecture with the `--platform` option and either `linux/amd64` or `linux/aarch64` as follows:

```bash
docker pull --platform linux/aarch64 container-registry.oracle.com/graalvm/native-image:17
docker pull --platform linux/aarch64 container-registry.oracle.com/graalvm/native-image:22
```

### Learn More
Expand Down
2 changes: 1 addition & 1 deletion docs/getting-started/graalvm-enterprise/linux.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ This distribution can be installed on Oracle Linux and Red Hat Enterprise Linux
Follow these steps to install Oracle GraalVM:

1. Navigate to [Oracle Java Downloads](https://www.oracle.com/java/technologies/downloads/).
Select the preferred Oracle GraalVM version, **21** for the Java version, **Linux** for the operating system, and the architecture. Start downloading.
Select the preferred Oracle GraalVM version, **22** for the Java version, **Linux** for the operating system, and the architecture. Start downloading.

2. Change directory to the location where you want to install Oracle GraalVM, then move the _.tar.gz_ file to that directory.

Expand Down
6 changes: 3 additions & 3 deletions docs/getting-started/graalvm-enterprise/macos.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ Note that on macOS the JDK installation path is: <em>/Library/Java/JavaVirtualMa

Follow these steps to install Oracle GraalVM:

1. Navigate to [Oracle Java Downloads](https://www.oracle.com/java/technologies/downloads/). Select the preferred Oracle GraalVM version, **21** for the Java version, **macOS** for the operating system, and the architecture. Start downloading.
1. Navigate to [Oracle Java Downloads](https://www.oracle.com/java/technologies/downloads/). Select the preferred Oracle GraalVM version, **22** for the Java version, **macOS** for the operating system, and the architecture. Start downloading.

2. Remove the quarantine attribute (required for macOS Catalina and later):
```shell
Expand Down Expand Up @@ -47,6 +47,6 @@ Optionally, you can specify Oracle GraalVM as the default JRE or JDK installatio

### On JAVA_HOME Command
The information property file, _Info.plist_, is in the top level _Contents_ folder.
This means that Oracle GraalVM participates in the macOS-specific `/usr/libexec/java_home` mechanism. Depending on other JDK 17 installation(s) available, it is now possible that `/usr/libexec/java_home -v21` returns `/Library/Java/JavaVirtualMachines/<graalvm>/Contents/Home`.
You can run `/usr/libexec/java_home -v21 -V` to see the complete list of JVMs available to the `java_home` command. This command sorts the JVMs in decreasing version order and chooses the top one as the default for the specified version.
This means that Oracle GraalVM participates in the macOS-specific `/usr/libexec/java_home` mechanism. Depending on other JDK 17 installation(s) available, it is now possible that `/usr/libexec/java_home -v22` returns `/Library/Java/JavaVirtualMachines/<graalvm>/Contents/Home`.
You can run `/usr/libexec/java_home -v22 -V` to see the complete list of JVMs available to the `java_home` command. This command sorts the JVMs in decreasing version order and chooses the top one as the default for the specified version.
Within a specific version, the sort order appears to be stable but is unspecified.
Loading

0 comments on commit 9358f24

Please sign in to comment.