Liberica NIK 21.0.0.2 Install Guide
The following sections constitute a native image installation guide for Liberica NIK. It describes the experience of using native images in correspondence to different operating systems.
Apple MacOS
Installing standalone package on MacOS
To install Liberica NIK download the .zip package.
curl -O https://download.bell-sw.com/vm/21.0.0.2/bellsoft-liberica-vm-openjdk11-21.0.0.2-macos-amd64.zip
After it is finished, verify the file by comparing its size on your drive and on the downloads page. A more advanced approach is to verify the checksum in the command line:
shasum -a 1 bellsoft-liberica-vm-openjdk11-21.0.0.2-macos-amd64.zip
Now unpack it.
unzip bellsoft-liberica-vm-openjdk11-21.0.0.2-macos-amd64.zip
sudo mv bellsoft-liberica-vm-openjdk11-21.0.0.2 /Library/Java/JavaVirtualMachines
This will unpack Liberica NIK to /Library/Java/JavaVirtualMachines. Either add Contents/Home/bin subdirectory to $PATH, or remember /Library/Java/JavaVirtualMachines/bellsoft-liberica-vm-openjdk11-21.0.0.2/Contents/Home/ as the $NIK_HOME environment variable and run Liberica NIK as
$NIK_HOME/bin/java -jar $your_app
and the gu utility as
$NIK_HOME/bin/gu available
Finally, install Native Image with
$NIK_HOME/bin/gu install native-image
To uninstall Liberica NIK, simply remove this directory and unset the related environmental variables. This concludes the native image macOS example.
Installing language plugins on MacOS
Open the terminal and type:
$NIK_HOME/bin/gu available
You’ll see a list of available languages:
Downloading: Component catalog from download.bell-sw.com
ComponentId Version Component name Stability Origin
--------------------------------------------------------------------------------------------------------
llvm-toolchain 21.0.0.2 LLVM.org toolchain Supported download.bell-sw.com
native-image 21.0.0.2 Native Image Early adopter download.bell-sw.com
python 21.0.0.2 Graal.Python Experimental download.bell-sw.com
R 21.0.0.2 FastR Experimental download.bell-sw.com
ruby 21.0.0.2 TruffleRuby Experimental download.bell-sw.com
wasm 21.0.0.2 GraalWasm Experimental download.bell-sw.com
Execute $NIK_HOME/bin/gu install [language] to install a specific language. For example, $NIK_HOME/bin/gu install python.
This is also possible to execute manually:
curl -O https://download.bell-sw.com/vm/21.0.0.2/python-installable-openjdk11-21.0.0.2-macos-amd64.jar
$NIK_HOME/bin/gu -L install python-installable-openjdk11-21.0.0.2-macos-amd64.jar
Linux
Installing standalone JDK package on GNU/Linux
To install Liberica NIK download the .tar.gz package.
wget https://download.bell-sw.com/vm/21.0.0.2/bellsoft-liberica-vm-openjdk11-21.0.0.2-linux-amd64.tar.gz
After it is finished, verify the file by comparing its size on your drive and on the downloads page. A more advanced approach is to verify the checksum in the command line:
shasum -a 1 bellsoft-liberica-vm-openjdk11-21.0.0.2-linux-amd64.tar.gz
Unpack it with the following command.
export INSTALL_DIR=<your directory>
tar -C $INSTALL_DIR -xzf bellsoft-liberica-vm-openjdk11-21.0.0.2-linux-amd64.tar.gz
This will unpack Liberica NIK to the selected directory. Either add $INSTALL_DIR/bellsoft-liberica-vm-openjdk11-21.0.0/bin to $PATH, or remember $INSTALL_DIR/bellsoft-liberica-vm-openjdk11-21.0.0 as the $NIK_HOME environment variable and run Liberica NIK as
$NIK_HOME/bin/java -jar $your_app
and the gu utility as
$NIK_HOME/bin/gu available
Finally, install Native Image with
$NIK_HOME/bin/gu install native-image
To uninstall Liberica NIK, simply remove this directory and unset the related environmental variables. This concludes the native image Linux example.
Installing language plugins on Linux
Open the terminal and type:
$NIK_HOME/bin/gu available
You’ll see a list of available languages:
Downloading: Component catalog from download.bell-sw.com
ComponentId Version Component name Stability Origin
--------------------------------------------------------------------------------------------------------
llvm-toolchain 21.0.0.2 LLVM.org toolchain Supported download.bell-sw.com
native-image 21.0.0.2 Native Image Early adopter download.bell-sw.com
python 21.0.0.2 Graal.Python Experimental download.bell-sw.com
R 21.0.0.2 FastR Experimental download.bell-sw.com
ruby 21.0.0.2 TruffleRuby Experimental download.bell-sw.com
wasm 21.0.0.2 GraalWasm Experimental download.bell-sw.com
Execute $NIK_HOME/bin/gu install [language] to install specific language. For example, $NIK_HOME/bin/gu install python.
This is also possible to execute manually:
wget https://download.bell-sw.com/vm/21.0.0.2/python-installable-openjdk11-21.0.0.2-linux-amd64.jar
$NIK_HOME/bin/gu -L install python-installable-openjdk11-21.0.0.2-linux-amd64.jar
Alpine Linux
Installing standalone JDK package on GNU/Linux
To install Liberica NIK download the .tar.gz package.
wget https://download.bell-sw.com/vm/21.0.0.2/bellsoft-liberica-vm-openjdk11-21.0.0.2-linux-x64-musl.tar.gz
After it is finished, verify the file by comparing its size on your drive and on the downloads page. A more advanced approach is to verify the checksum in the command line:
shasum -a 1 bellsoft-liberica-vm-openjdk11-21.0.0.2-linux-x64-musl.tar.gz
Unpack it with the following command.
export INSTALL_DIR=<your directory>
tar -C $INSTALL_DIR -xzf bellsoft-liberica-vm-openjdk11-21.0.0.2-linux-x64-musl.tar.gz
This will unpack Liberica NIK to the selected directory. Either add $INSTALL_DIR/bellsoft-liberica-vm-openjdk11-21.0.0/bin to $PATH, or remember $INSTALL_DIR/bellsoft-liberica-vm-openjdk11-21.0.0 as the $NIK_HOME environment variable and run Liberica NIK as
$NIK_HOME/bin/java -jar $your_app
and the gu utility as
$NIK_HOME/bin/gu available
Finally, install Native Image with
$NIK_HOME/bin/gu install native-image
To uninstall Liberica NIK, simply remove this directory and unset the related environmental variables. This concludes the native image Alpine Linux example.
Installing language plugins on Alpine Linux
Open the terminal and type:
$NIK_HOME/bin/gu available
You’ll see a list of available languages:
Downloading: Component catalog from download.bell-sw.com
ComponentId Version Component name Stability Origin
--------------------------------------------------------------------------------------------------------
llvm-toolchain 21.0.0.2 LLVM.org toolchain Supported download.bell-sw.com
native-image 21.0.0.2 Native Image Early adopter download.bell-sw.com
python 21.0.0.2 Graal.Python Experimental download.bell-sw.com
R 21.0.0.2 FastR Experimental download.bell-sw.com
ruby 21.0.0.2 TruffleRuby Experimental download.bell-sw.com
wasm 21.0.0.2 GraalWasm Experimental download.bell-sw.com
Execute $NIK_HOME/bin/gu install [language] to install specific language. For example, $NIK_HOME/bin/gu install python.
This is also possible to execute manually:
wget https://download.bell-sw.com/vm/21.0.0.2/python-installable-openjdk11-21.0.0.2-linux-x64-musl.jar
$NIK_HOME/bin/gu -L install python-installable-openjdk11-21.0.0.2-linux-x64-musl.jar