This is an automated email from the ASF dual-hosted git repository.
jiafengzheng pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/doris.git
The following commit(s) were added to refs/heads/master by this push:
new bb2d6addaf [typo](docs)Upgrade 1.2, Java UDF function depends on the
installation method (#14785)
bb2d6addaf is described below
commit bb2d6addaf4fac9c91711163a10c5c4b9cf5f077
Author: jiafeng.zhang <zhang...@gmail.com>
AuthorDate: Sun Dec 4 08:53:42 2022 +0800
[typo](docs)Upgrade 1.2, Java UDF function depends on the installation
method (#14785)
---
docs/en/docs/admin-manual/cluster-management/upgrade.md | 5 +++--
docs/en/docs/faq/install-faq.md | 9 +++++++++
docs/en/docs/install/install-deploy.md | 2 ++
docs/zh-CN/docs/admin-manual/cluster-management/upgrade.md | 7 +++++--
docs/zh-CN/docs/faq/install-faq.md | 9 +++++++++
docs/zh-CN/docs/install/install-deploy.md | 3 +++
6 files changed, 31 insertions(+), 4 deletions(-)
diff --git a/docs/en/docs/admin-manual/cluster-management/upgrade.md
b/docs/en/docs/admin-manual/cluster-management/upgrade.md
index 450867bcca..07a48b2109 100644
--- a/docs/en/docs/admin-manual/cluster-management/upgrade.md
+++ b/docs/en/docs/admin-manual/cluster-management/upgrade.md
@@ -59,8 +59,9 @@ Doris can upgrade smoothly by rolling upgrades. The following
steps are recommen
## Test the correctness of BE upgrade
1. Arbitrarily select a BE node and deploy the latest doris_be binary file.
-2. Restart the BE node and check the BE log be.INFO to see if the boot was
successful.
-3. If the startup fails, you can check the reason first. If the error is not
recoverable, you can delete the BE directly through DROP BACKEND, clean up the
data, and restart the BE using the previous version of doris_be. Then re-ADD
BACKEND. (**This method will result in the loss of a copy of the data, please
make sure that three copies are complete, and perform this operation!!!**
+2. <version since="1.2">Install Java UDF function: </version>, because Java
UDF function is supported from version 1.2, you need to download the JAR
package of Java UDF function from the official website and put it in the lib
directory of BE, otherwise it may will fail to start.
+3. Restart the BE node and check the BE log be.INFO to see if the boot was
successful.
+4. If the startup fails, you can check the reason first. If the error is not
recoverable, you can delete the BE directly through DROP BACKEND, clean up the
data, and restart the BE using the previous version of doris_be. Then re-ADD
BACKEND. (**This method will result in the loss of a copy of the data, please
make sure that three copies are complete, and perform this operation!!!**
## Testing FE Metadata Compatibility
diff --git a/docs/en/docs/faq/install-faq.md b/docs/en/docs/faq/install-faq.md
index a4882740e1..67c4c01d2d 100644
--- a/docs/en/docs/faq/install-faq.md
+++ b/docs/en/docs/faq/install-faq.md
@@ -293,3 +293,12 @@ You can verify the version of openssl used by MySQL ODBC
Driver by
ldd /path/to/libmyodbc8w.so |grep libssl.so
```
If the output contains ``libssl.so.10``, there may be problems using it, if it
contains ``libssl.so.1.1``, it is compatible with doris 1.0
+
+### Q15. After upgrading to version 1.2, the BE NoClassDefFoundError issue
failed to start
+<version since="1.2"> Java UDF dependency error </version>
+If the upgrade support starts be, the following Java `NoClassDefFoundError`
error occurs
+```
+Exception in thread "main" java.lang.NoClassDefFoundError:
org/apache/doris/udf/IniUtil
+Caused by: java.lang.ClassNotFoundException: org.apache.doris.udf.JniUtil
+```
+You need to download the Java UDF function dependency package of
`apache-doris-java-udf-jar-with-dependencies-1.2.0` from the official website,
put it in the lib directory under the BE installation directory, and then
restart BE
diff --git a/docs/en/docs/install/install-deploy.md
b/docs/en/docs/install/install-deploy.md
index 5ac4a0358a..c87151f98a 100644
--- a/docs/en/docs/install/install-deploy.md
+++ b/docs/en/docs/install/install-deploy.md
@@ -221,6 +221,8 @@ See the section on `lower_case_table_names` variables in
[Variables](../../advan
* BE webserver_port configuration
If the Be componet is installed in hadoop cluster , need to change
configuration `webserver_port=8040` to avoid port used.
+* <version since="1.2">Install Java UDF functions</version>
+ Because Java UDF functions are supported from version 1.2, you need to
download the JAR package of Java UDF functions from the official website and
put them in the lib directory of BE, otherwise it may fail to start.
* Add all BE nodes to FE
diff --git a/docs/zh-CN/docs/admin-manual/cluster-management/upgrade.md
b/docs/zh-CN/docs/admin-manual/cluster-management/upgrade.md
index b125eb34a1..0d434d6ba8 100644
--- a/docs/zh-CN/docs/admin-manual/cluster-management/upgrade.md
+++ b/docs/zh-CN/docs/admin-manual/cluster-management/upgrade.md
@@ -59,8 +59,11 @@ Doris 可以通过滚动升级的方式，平滑进行升级。建议按照以
## 测试 BE 升级正确性
1. 任意选择一个 BE 节点，部署最新的 doris_be 二进制文件。
-2. 重启 BE 节点，通过 BE 日志 be.INFO，查看是否启动成功。
-3. 如果启动失败，可以先排查原因。如果错误不可恢复，可以直接通过 DROP BACKEND 删除该 BE、清理数据后，使用上一个版本的 doris_be
重新启动 BE。然后重新 ADD BACKEND。（**该方法会导致丢失一个数据副本，请务必确保3副本完整的情况下，执行这个操作！！！**）
+2. <version since="1.2">安装 Java UDF 函数： </version>, 因为从1.2 版本开始支持Java UDF
函数，需要从官网下载 Java UDF 函数的 JAR 包放到 BE 的 lib 目录下，否则可能会启动失败。
+3. 重启 BE 节点，通过 BE 日志 be.INFO，查看是否启动成功。
+4. 如果启动失败，可以先排查原因。如果错误不可恢复，可以直接通过 DROP BACKEND 删除该 BE、清理数据后，使用上一个版本的 doris_be
重新启动 BE。然后重新 ADD BACKEND。（**该方法会导致丢失一个数据副本，请务必确保3副本完整的情况下，执行这个操作！！！**）
+
+
## 测试 FE 元数据兼容性
diff --git a/docs/zh-CN/docs/faq/install-faq.md
b/docs/zh-CN/docs/faq/install-faq.md
index 445f4facbb..315ac9831c 100644
--- a/docs/zh-CN/docs/faq/install-faq.md
+++ b/docs/zh-CN/docs/faq/install-faq.md
@@ -293,3 +293,12 @@ ERROR 1105 (HY000): errCode = 2, detailMessage = driver
connect Error: HY000 [My
ldd /path/to/libmyodbc8w.so |grep libssl.so
```
如果输出包含 `libssl.so.10` 则使用过程中可能出现问题， 如果包含`libssl.so.1.1` 则与doris 1.0 兼容
+
+### Q15. 升级到 1.2 版本，BE NoClassDefFoundError 问题启动失败
+<version since="1.2"> Java UDF 依赖错误 </version>
+如果升级支持启动 be 出现下面这种 Java `NoClassDefFoundError` 错误
+```
+Exception in thread "main" java.lang.NoClassDefFoundError:
org/apache/doris/udf/IniUtil
+Caused by: java.lang.ClassNotFoundException: org.apache.doris.udf.JniUtil
+```
+需要重官网下载 `apache-doris-java-udf-jar-with-dependencies-1.2.0` 的 Java UDF
函数依赖包，放到 BE 安装目录下的 lib 目录，然后重新启动 BE
diff --git a/docs/zh-CN/docs/install/install-deploy.md
b/docs/zh-CN/docs/install/install-deploy.md
index b55b42b32d..d18c890029 100644
--- a/docs/zh-CN/docs/install/install-deploy.md
+++ b/docs/zh-CN/docs/install/install-deploy.md
@@ -222,6 +222,9 @@ doris默认为表名大小写敏感，如有表名大小写不敏感的需求需
如果 be 部署在 hadoop 集群中，注意调整 be.conf 中的 `webserver_port = 8040` ,以免造成端口冲突
+* <version since="1.2">安装Java UDF 函数</version>
+ 因为从1.2 版本开始支持Java UDF 函数，需要从官网下载 Java UDF 函数的 JAR 包放到 BE 的 lib 目录下，否则可能会启动失败。
+
* 在 FE 中添加所有 BE 节点
BE 节点需要先在 FE 中添加，才可加入集群。可以使用 mysql-client([下载MySQL
5.7](https://dev.mysql.com/downloads/mysql/5.7.html)) 连接到 FE：
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@doris.apache.org
For additional commands, e-mail: commits-h...@doris.apache.org
