---
order: 6
navTitle: JDK
---
# JDK安装配置

SuccBI运行需要配置JDK环境，推荐安装17版本，本篇介绍Windows和Linux系统下JDK 17.0.12安装配置：

\[\[toc]]

## JDK兼容版本{#compatible-jdks}

SuccBI兼容以下版本的JDK，推荐安装17.0.12版本，可根据实际部署需求选择

|JDK|推荐版本|说明|
|:-:|:-:|:-:|
|Oracle JDK|[17.0.12](https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html)|[官方说明](https://www.oracle.com/java/technologies/javase/products-doc-jdk17certconfig.html)|
|Open JDK|[17.0.12](https://developers.redhat.com/products/openjdk/download)|[官方说明](https://developers.redhat.com/products/openjdk/overview)|

## Windows安装配置JDK{#windows-jdk}

下载方式有如下两种：

1. 从[ORACLE官方](https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html)下载Windows版本的JDK，选择对应操作系统的版本是64位。
2. 点击[这里](https://www.jianguoyun.com/p/DWtd3qUQ3O-gChiUnaUGIAA)下载。

下载完成后，安装JDK：

- 安装配置为全局JDK

  安装到`C:\Program Files\java\jdk-17.0.12`，安装完成后，配置系统变量:

  1. 在Windows 10中打开`控制面板`>`系统和安全`>`系统`。
  2. 点击`高级系统设置`，在弹出的`系统属性`对话框中点击`高级`下的`环境变量`。
  3. 在`系统变量`中点击`新建`，变量名为`JAVA_HOME`，变量值为`C:\Program Files\java\jdk-17.0.12`。
  4. 在`用户变量`中找到`Path`，编辑该变量，新建路径为`%JAVA_HOME%\bin`。

  配置完路径后就可以使用java命令了。打开命令提示符，在窗口中输入 `java` 获取命令参数帮助，输入 `java -version` 获取当前JDK版本。

- 配置为SuccBI指定JDK

  安装到`\path\to\tomcat\jdk-17.0.12`

  编辑tomcat[启动环境变量](../middleware/tomcat.md#env)

  在`\path\to\tomcat\bin\setenv.bat`中插入如下内容

  ```batch
  set JAVA_HOME=\path\to\tomcat\jdk-17.0.12
  ```

  配置完成后，进入SuccezBI系统设置可查看当前JDK版本为17.0.12

## linux安装配置JDK{#linux-jdk}

下载方式有如下两种：

1. 在Windows中从[ORACLE官方](https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html)或[这里](https://www.jianguoyun.com/p/DVdotHIQ3O-gChjvnaUGIAA)下载Linux版本的JDK，再上传到Linux服务器
2. 在服务器上通过wget命令，直接下载安装包，可从Oracle下载页获取对应版本的下载地址

   ```sh
   wget https://download.oracle.com/java/17/archive/jdk-17.0.12_linux-x64_bin.tar.gz
   ```

下载完成后，将压缩包解压到安装目录：

- 安装配置为全局JDK

  安装到`/usr/local`，使用如下命令：

  ```sh
  tar -zxvf jdk-17.0.12_linux-x64_bin.tar.gz -C /usr/local
  ```

  配置系统变量

  ```sh
  vim /etc/profile
  #在最后一行插入以下内容
  export JAVA_HOME=/usr/local/jdk-17.0.12
  export PATH=$JAVA_HOME/bin:$PATH
  ```

  立即生效更改

  ```sh
  source /etc/profile
  ```

  配置完系统变量后就可以使用java命令了。输入`java`获取命令参数帮助，输入`java -version`获取当前JDK版本。

- 安装配置为SuccBI指定JDK

  安装到`/path/to/tomcat`，使用如下命令：

  ```sh
  tar -zxvf jdk-17.0.12_linux-x64_bin.tar.gz -C /path/to/tomcat
  ```

  安装完成后配置tomcat的[启动环境变量](../middleware/tomcat.md#env)

  ```sh
  vim /path/to/tomcat/bin/setenv.sh
  #插入如下内容
  export JAVA_HOME=/path/to/tomcat/jdk-17.0.12
  ```

  配置完成后，进入SuccBI[系统设置](../../../sys-settings/basic/sysinfo.md)可查看当前JDK版本为17.0.12

## 常见问题{#faq}

### 安装JDK提示执行格式错误{#linux-arm}

**问题原因：**

ARM架构服务器如果误用了x86架构的JDK安装包，操作系统无法正确执行对应二进制文件，通常会提示`cannot execute binary file: Exec format error`。

**解决方法**：先执行如下命令查看服务器架构：

```sh
uname -m
```

常见ARM服务器通常返回`aarch64`或`arm64`，此时需要下载并安装对应的`linux-aarch64`版本JDK安装包。