Skip to content

Commit 69b3637

Browse files
committed
Review and update Get Started with GraalVM Enterprise on OCI guide
1 parent 8aa8858 commit 69b3637

File tree

1 file changed

+71
-35
lines changed

1 file changed

+71
-35
lines changed

docs/getting-started/graalvm-enterprise/oci/compute-instances.md

Lines changed: 71 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,6 @@ For more details, refer to the [Connecting to Your Linux Instance Using SSH](ht
3333
1. Having connected to the instance, verify which GraalVM Enterprise RPMs are available for the installation, narrowing down the search to the latest release, and Java 11.
3434

3535
```shell
36-
yum check-update
3736
sudo yum provides graalvm22-ee-11-jdk
3837
```
3938
The resulting list includes both current and previous versions of all of the core package and additional features.
@@ -44,62 +43,98 @@ For example, to install the latest version of "Oracle GraalVM Enterprise Edition
4443
```shell
4544
sudo yum install graalvm22-ee-11-jdk
4645
```
47-
The dependent packages, e.g., `libpolyglot`, `llvm` and so on, will also be resolved.
46+
Confirm if the installed package size is okay by typing `yes` at the prompt.
47+
It will install the latest version of **graalvm22-ee-11-jdk** which includes the JVM runtime, the Graal compiler, and all dependent packages, for example, `libpolyglot`, `llvm`, etc.
4848

49-
![See the resolved dependencies for GraalVM Enterprise](dependencies-resolved.png)
49+
After the installation, the GraalVM Enterprise binary is placed in _/usr/lib64/graalvm_. You can check this with:
5050

51-
After the installation, the GraalVM Enterprise binary is placed in _/usr/lib64/graalvm_.
52-
53-
3. Set up environment variables to point to the GraalVM Enterprise directory.
54-
55-
- Configure the `PATH` and `JAVA_HOME` environment variables in the bash configuration to point to GraalVM Enterprise for this SSH session with the following commands:
5651
```shell
57-
echo "export JAVA_HOME=/usr/lib64/graalvm/graalvm22-ee-java11" >> ~/.bashrc
58-
echo "export PATH='$JAVA_HOME'/bin:'$PATH' " >> ~/.bashrc
52+
ls /usr/lib64/graalvm
5953
```
54+
55+
3. Configure environment variables to point to the GraalVM Enterprise installation for this SSH session. After the installation, the package files are placed in the `/usr/lib64/graalvm` directory, and binaries in `bin` accordingly.
56+
57+
- Set the `PATH` and `JAVA_HOME` environment variables in the bash configuration to point to GraalVM Enterprise with the following commands:
58+
59+
```shell
60+
echo "export JAVA_HOME=/usr/lib64/graalvm/graalvm22-ee-java11" >> ~/.bashrc
61+
```
62+
63+
```shell
64+
echo 'export PATH=$JAVA_HOME/bin:$PATH' >> ~/.bashrc
65+
```
6066
- Activate this change:
61-
```shell
62-
source ~/.bashrc
63-
```
64-
- Verify the values of `PATH` and `JAVA_HOME` to check if the change was successful:
65-
```shell
66-
echo $JAVA_HOME
67-
echo $PATH
68-
```
6967

70-
Now you have a ready-to-go VM instance with GraalVM Enterprise installed and ready to use.
68+
```shell
69+
source ~/.bashrc
70+
```
71+
72+
- Verify the values of `PATH` and `JAVA_HOME` to check if it was successful:
73+
74+
```shell
75+
echo $JAVA_HOME
76+
echo $PATH
77+
```
78+
79+
Now you have a ready-to-go VM instance with GraalVM Enterprise installed.
7180

7281
## Install Additional Features
7382

74-
1. Check what additional features are available for your current GraalVM Enterprise version:
83+
GraalVM Enterprise is shipped with core components (to save the filesize) and can be extended with more features on demand. For example, you can install Native Image, the Node.js runtime, the LLVM toolchain, etc. Find information on available features [here](https://docs.oracle.com/en/graalvm/enterprise/22/docs/overview/architecture/).
84+
85+
To add additional features to GraalVM Enterprise, use the `yum install <package_name>` command.
86+
87+
1. Check what additional features are available for your current GraalVM Enterprise installation:
7588

7689
```shell
77-
yum check-update
7890
sudo yum provides graalvm22*
7991
```
80-
81-
2. Look up the necessary RPM package name and add it to GraalVM Enterprise with the `yum install <package_name> command` command.
82-
For example, to install [Native Image](../../../reference-manual/native-image/README.md), which is a technology to turn your Java application into a standalone native executable, run this command:
92+
The printed list is enormous. If you are interested in a particular component, for example, the Python runtime, narrow down the search providing the exact package name:
8393

8494
```shell
85-
sudo yum install graalvm22-ee-11-native-image
95+
sudo yum provides graalvm21-ee-11-python*
8696
```
87-
All required dependencies will be automatically installed:
8897

89-
![See the resolved dependencies for GraalVM Enterprise Native Image](ni-dependencies-resolved.png)
98+
2. Install the component to GraalVM Enterprise with the `yum install <package_name> command` command. To install the Python runtime, run:
9099

91-
> **Note:** To add Native Image to GraalVM Enterprise on Oracle Linux 8, currently run these commands:
92100
```shell
93-
sudo yum update -y oraclelinux-release-el8
94-
sudo yum config-manager --set-enabled ol8_codeready_builder
95-
sudo yum install graalvm22-ee-11-native-image
101+
sudo yum install graalvm22-ee-11-python
96102
```
97-
For Linux images with `dnf` or `microdnf` default package managers, run:
103+
Confirm if the installed package size is okay by typing `yes` at the prompt.
104+
105+
### Install Native Image
106+
107+
[Native Image](../../../reference-manual/native-image/README.md) is a technology to turn your Java application into a standalone native executable and has to be installed to GraalVM Enterprise core installation.
108+
109+
110+
1. Search for Native Image PRMs available for your installation:
111+
98112
```shell
99-
dnf update -y oraclelinux-release-el8
100-
dnf --enablerepo ol8_codeready_builder
101-
dnf install graalvm22-ee-11-native-image
113+
sudo yum provides graalvm21-ee-11-native-image*
102114
```
115+
2. Install Native Image using the `yum install <package_name> command` command. All required dependencies will be automatically resolved.
116+
117+
- On Oracle Linux 7.9, run:
118+
```shell
119+
sudo yum install graalvm22-ee-11-native-image
120+
```
121+
Confirm if the installed package size is okay by typing `yes` at the prompt.
122+
123+
- On Oracle Linux 8, run these commands one by one:
124+
```shell
125+
sudo yum update -y oraclelinux-release-el8
126+
sudo yum config-manager --set-enabled ol8_codeready_builder
127+
sudo yum install graalvm22-ee-11-native-image
128+
```
129+
Confirm if the installed package size is okay by typing `yes` at the prompt.
130+
131+
- On Oracle Linux 8 with `dnf` or `microdnf` default package managers, run these commands one by one:
132+
```shell
133+
dnf update -y oraclelinux-release-el8
134+
dnf --enablerepo ol8_codeready_builder
135+
dnf install graalvm22-ee-11-native-image
136+
```
137+
Confirm if the installed package size is okay by typing `yes` at the prompt.
103138

104139
## Update GraalVM Enterprise
105140

@@ -127,6 +162,7 @@ The `yum upgrade` command can be used to update on the same year package line, f
127162
```shell
128163
sudo yum upgrade graalvm22-ee-17-jdk
129164
```
165+
If there is no newer package available, you will see the `No packages marked for update` message.
130166

131167
It will update the whole system and remove the obsolete GraalVM Enterprise installation.
132168

0 commit comments

Comments
 (0)