安装说明

本文介绍如何安装龙芯平台Java环境。

安装方法

TAR包

1. 从 下载页面 下载.tar.ga安装文件，请确认所使用的版本。
2. 验证下载文件的校验和是否与下载页面上提供的值匹配。要计算校验和，请使用以下命令：

    $ md5sum <package>.tar.gz
   

   示例：

    $ md5sum loongson21.1.0-fx-jdk21_35-linux-loongarch64.tar.gz
    8b196334043bf4368dbd4b0d97b338cd  loongson21.1.0-fx-jdk21_35-linux-loongarch64.tar.gz
   

3. 解压缩下载的TAR包。

    $ tar zxf <package>.tar.gz
   

   解压至/opt目录下为例：

    $ tar zxf loongson21.1.0-fx-jdk21_35-linux-loongarch64.tar.gz -C /opt
   

4. 验证是否安装成功。

    $ <installation_folder>/bin/java -version
    openjdk version "21" 2023-09-19
    OpenJDK Runtime Environment Loongson21.1.0 (build 21+35)
    OpenJDK 64-Bit Server VM Loongson21.1.0 (build 21+35, mixed mode, sharing)
   

5. （可选的）将<installation_folder>/bin添加至PATH环境变量，这样可以从任何目录执行java而无需指定完整路径。

    $ export PATH=<installation_folder>/bin:$PATH
    $ java -version
    openjdk version "21" 2023-09-19
    OpenJDK Runtime Environment Loongson21.1.0 (build 21+35)
    OpenJDK 64-Bit Server VM Loongson21.1.0 (build 21+35, mixed mode, sharing)
   

DEB包

根据不同的系统环境，选择相应的安装包形式。在基于Debian的发行版上，选择DEB包的安装方式。

1. 从 下载页面 下载.deb安装文件，请确认所使用的版本。

2. 在软件包下载目录，运行下面的命令。将<package>替换为实际的文件名。该命令可能会要求您确认是否要安装包的依赖项。使用包管理器安装需要root权限。请登录到root账户或使用sudo来运行下面列出的命令。

    sudo apt install ./<package>.deb
   

   比如，在Loongnix Desktop上安装JDK 23 DEB包：

    sudo apt install ./loongson23.1.17-fx-jdk23_37-linux-loongarch64.deb
   

   该软件包安装在/usr/lib/jvm/loongson-jdk23-fx-loongarch64。

3. 切换到目标版本。请参考下面的章节，在多个JDK版本间切换。

4. 在终端窗口中运行java -version来验证安装是否成功。应该会看到类似的输出：

    $ java -version
    openjdk version "23" 2024-09-17
    OpenJDK Runtime Environment Loongson23.1.17 (build 23+37)
    OpenJDK 64-Bit Server VM Loongson23.1.17 (build 23+37, mixed mode, sharing)
   

RPM包

根据不同的系统环境，选择相应的安装包形式。在基于RPM的发行版上，选择RPM包的安装方式。

1. 从 下载页面 下载.rpm安装文件，请确认所使用的版本。

2. 在软件包下载目录，运行下面的命令。将<package>替换为实际的文件名。该命令可能会要求您确认是否要安装包的依赖项。使用包管理器安装需要root权限。请登录到root账户或使用sudo来运行下面列出的命令。

    sudo yum install ./<package>.rpm
   

   比如，在Loongnix Server上安装JDK 23 RPM包：

    sudo yum install ./loongson23.1.17-fx-jdk23_37-linux.loongarch64.rpm
   

   该软件包安装在/usr/lib/jvm/loongson-jdk23-fx。

3. 切换到目标版本。请参考下面的章节，在多个JDK版本间切换。

4. 在终端窗口中运行java -version来验证安装是否成功。应该会看到类似的输出：

    $ java -version
    openjdk version "23" 2024-09-17
    OpenJDK Runtime Environment Loongson23.1.17 (build 23+37)
    OpenJDK 64-Bit Server VM Loongson23.1.17 (build 23+37, mixed mode, sharing)
   

Docker镜像

龙芯平台提供了预装JDK的Docker镜像，这些镜像基于以下操作系统之一。

其中，${JDK_VER}的值为龙芯已发布JDK版本中大版本的值，比如8，11，17，21，23等。

要拉取特定的镜像，请在docker pull中使用相应的镜像名称。比如，要拉取带有龙芯平台JDK 23的anolisos镜像，请运行：

docker pull cr.loongnix.cn/library/openjdk:23-anolisos

使用docker运行Java应用

1. 测试docker镜像

    docker run -it --rm cr.loongnix.cn/library/openjdk:23-anolisos java -version
   

   如果在终端中能正确打印版本信息，则说明在容器内成功执行了java。

2. 在容器内启动应用程序

   假设运行的应用程序位于一个单独的目录中，在该目录中通过执行java MyApp来运行应用程序。使用docker run的-v选项可以使该目录在容器内可用。命令可能如下所示：

    docker run -it --rm \
        -v ${PWD}:/usr/src/project  \
        -e CLASSPATH=/usr/src/project \
        cr.loongnix.cn/library/openjdk:23-anolisos java MyApp
   

通过操作系统源

Loongnix等操作系统源中会集成龙芯平台Java环境及其后续更新。

比如，在Loongnix Server 8.3上可通过如下命令安装JDK 8：

$ sudo yum install java-1.8.0-openjdk-devel

在Loongnix Desktop 20.6上可通过如下命令安装JDK 8：

$ sudo apt install openjdk-8-jdk

卸载方法

DEB

如果使用DEB包安装了Java环境，可使用apt包管理器将其卸载：

$ sudo apt remove <package_name>

RPM

如果使用RPM包安装了Java环境，可使用yum包管理器将其卸载：

$ sudo yum remove <package_name>

在多个JDK版本间切换

一个系统可以同时安装多个Java环境，并通过如下命令切换默认版本（以8和13并存为例）

$ sudo update-alternatives --config java

共有 2 个提供“java”的程序。

  选项    命令
-----------------------------------------------
*+ 1           /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.202-1.b08.8.1.2.fc21.loongson.mips64el/jre/bin/java
   2           /usr/lib/jvm/java-13-openjdk-13.0.0.33-0.3.ea.rolling.fc21.loongson.mips64el/bin/java

按 Enter 保留当前选项[+]，或者键入选项编号：

选择2并确认。

验证JDK版本

$ java -version
openjdk version "13" 2019-09-17
OpenJDK Runtime Environment Loongson13-ea (build 13+33-20190916)
OpenJDK 64-Bit Server VM Loongson13-ea (build 13+33-20190916, mixed mode, sharing)