EMR 集群 JindoSDK 升级流程（旧版控制台）§

背景§

在旧版管控平台中创建E-MapReduce EMR-5.5.0/EMR-3.39.0 以前版本的集群，在使用过程中遇到了问题，或者需要使用 JindoSDK 的新功能，具体查看版本说明, 可以根据下面的步骤完成 JindoSDK 升级。

场景一：升级已有集群§

1. 准备软件包和升级脚本§

登录EMR集群的Master节点，并将下载的patch包放在 hadoop 用户的HOME目录下，将patch包解压缩后，使用 hadoop 用户执行操作。

su - hadoop
cd /home/hadoop/
wget https://jindodata-binary.oss-cn-shanghai.aliyuncs.com/resources/jindosdk-patches.tar.gz
tar zxf jindosdk-patches.tar.gz

下载 JindoSDK 软件包 jindosdk-{VERSION}-{PLATFORM}.tar.gz（以下以linux x86平台为例），放在解压后的目录。

cd jindosdk-patches

wget https://jindodata-binary.oss-cn-shanghai.aliyuncs.com/release/6.7.5/jindosdk-6.7.5-linux.tar.gz

ls -l

jindosdk-patches 内容示例如下：

-rwxrwxr-x 1 hadoop hadoop      1263 May 01 00:00 apply_all.sh
-rwxrwxr-x 1 hadoop hadoop      6840 May 01 00:00 apply.sh
-rw-rw-r-- 1 hadoop hadoop        40 May 01 00:00 hosts
-rw-r----- 1 hadoop hadoop xxxxxxxxx May 01 00:00 jindosdk-6.7.5-linux.tar.gz
-rwxrwxr-x 1 hadoop hadoop      1308 May 01 00:00 revert_all.sh
-rwxrwxr-x 1 hadoop hadoop      6326 May 01 00:00 revert.sh

注意：如果从4.6.8以下版本升级到4.6.9以上或6.x版本时，由于 JindoCommitter 默认使用的作业临时路径发生变化，需要在升级前先设置 fs.jdo.committer.allow.concurrent=false （core-site.xml）或在 Spark 配置中设置 spark.hadoop.fs.jdo.committer.allow.concurrent=false，确保升级期间不会出现丢数据的情况。后续在包含GATEWAY节点的所有JindoSDK全部升级完成后，可以择机去掉该配置。

2. 配置升级节点信息§

编辑patch包下的hosts文件，添加集群所有节点的host name，如emr-header-1或emr-worker-1，文件内容以行分割。

cd jindosdk-patches
vim hosts

hosts文件内容示例如下：

emr-header-1
emr-worker-1
emr-worker-2

3. 执行升级§

通过apply_all.sh 脚本执行修复操作。

./apply_all.sh $JINDOSDK_VERSION

如

./apply_all.sh 6.7.5

脚本执行完成后，返回如下提示信息。

>>> updating ...  emr-header-1
>>> updating ...  emr-worker-1
>>> updating ...  emr-worker-2
### DONE

4. 修改集群配置§

4.1 兼容 JindoSDK 老版本配置（升级到 JindoSDK-6.1.1版本及以上支持）§

a. 在SmartData服务的配置页面，单击smartdata-site页签。 b. 在smartdata-site页面，单击自定义配置。 c. 在新增配置项对话框中，添加配置项。

参数	描述
fs.oss.legacy.version	配置需要兼容smartdata版本的前两位。例如：3.8

**注：仅测试了3.8.x版本，其他版本请谨慎使用。

4.2 修改 hive/spark 配置§

a. 对应组件(如HIVE)服务的页面，单击配置（如hive-site.xml）页签。 b. 在配置（如hive-site.xml）页面，在配置搜索中搜索参数（如hive.exec.post.hooks）。 c. 如参数value存在需要删除的参数，修改后点击保存，并更新部署配置。不存在则跳过。

组件	配置	参数	描述
HIVE	hive-site.xml	hive.exec.post.hooks	删除com.aliyun.emr.table.hive.HivePostHook(或com.aliyun.jindotable.hive.HivePostHook)，保留其余hook，如com.aliyun.emr.meta.hive.hook.LineageLoggerHook
SPARK	spark-defaults.conf	spark.sql.queryExecutionListeners	删除com.aliyun.emr.table.spark.SparkSQLQueryListener(或com.aliyun.jindotable.spark.SparkSQLQueryListener)，保留其余hook，如com.aliyun.emr.meta.spark.listener.EMRQueryLogger

5. 确认升级成功§

ls -l /opt/apps/extra-jars/

以升级为 6.7.5 版本为例，返回示例如下：

drwxr-xr-x 2 root   root       4096 Apr 24 16:19 flink
-rw-r--r-- 1 hadoop hadoop   189081 Apr 24 15:33 hadoop-lzo-0.4.21-SNAPSHOT.jar
drwxr-xr-x 2 hadoop hadoop     4096 Apr 24 15:33 hive
-rw-r--r-- 1 root   root   16264149 Apr 24 16:19 jindo-core-6.7.5.jar
-rw-r--r-- 1 root   root   14429862 Apr 24 16:19 jindo-core-linux-el7-aarch64-6.7.5.jar
-rw-r--r-- 1 root   root    4459297 Apr 24 16:19 jindo-sdk-6.7.5.jar
-rw-r--r-- 1 hadoop hadoop  1438552 Apr 24 15:33 jindotable-common.jar
drwxr-xr-x 2 root   root       4096 Apr 24 16:19 spark
drwxr-xr-x 2 root   root       4096 Apr 24 16:19 spark3

6. 升级后重启服务§

说明对于已经在运行的YARN作业（Application，例如，Spark Streaming或Flink作业），需要停止作业后，批量滚动重启YARN NodeManager。

Hive、Presto、Impala、Druid、Flink、Solr、Ranger、Storm、Oozie、Spark 和 Zeppelin 等组件需要重启之后才能完全升级。

以Hive组件为例，在EMR集群的Hive服务页面，选择右上角的操作 > 重启 All Components。

7. 日志等级调整§

Hadoop命令，Spark作业日志等log4j日志可通过以下配置调整。以调整 hadoop 命令日志配置为例：

vim /etc/ecm/hadoop-conf/log4j.properties

添加以下配置：

log4j.logger.com.aliyun.jindodata=WARN

如需看到操作日志，则再添加以下配置：

log4j.logger.com.aliyun.jindodata=WARN
log4j.logger.com.aliyun.jindodata.common.FsStats=INFO

场景二：扩容已有集群§

扩容已有集群时可以自动升级修复。具体操作步骤如下：

1. 制作引导升级包§

下载的 jindosdk-patches.tar.gz ，jindosdk-6.7.5-linux.tar.gz 和 bootstrap_jindosdk.sh。

mkdir jindo-patch

cd jindo-patch

wget https://jindodata-binary.oss-cn-shanghai.aliyuncs.com/resources/jindosdk-patches.tar.gz

wget https://jindodata-binary.oss-cn-shanghai.aliyuncs.com/release/6.7.5/jindosdk-6.7.5-linux.tar.gz

wget https://jindodata-binary.oss-cn-shanghai.aliyuncs.com/resources/bootstrap_jindosdk.sh

ls -l

内容示例如下：

-rw-r----- 1 hadoop hadoop      xxxx May 01 00:00 bootstrap_jindosdk.sh
-rw-r----- 1 hadoop hadoop xxxxxxxxx May 01 00:00 jindosdk-6.7.5-linux.tar.gz
-rw-r----- 1 hadoop hadoop      xxxx May 01 00:00 jindosdk-patches.tar.gz

执行命令制作升级包

bash bootstrap_jindosdk.sh -gen $JINDOSDK_VERSION

如

bash bootstrap_jindosdk.sh -gen 6.7.5

参数说明：-gen生成lite升级包，-gen-full表示生成完整升级包。

成功后可以看到如下：


Generated patch at /home/hadoop/jindo-patch/jindosdk-bootstrap-patches.tar.gz

制作完成，得到patch包： jindosdk-bootstrap-patches.tar.gz。

2. 上传引导升级包§

将 patch包和 bootstrap脚本上传到OSS上。

EMR 集群内可以通过 hadoop 命令上传，或者通过 oss 控制台、ossutil 或 OSS Browser 等工具。

hadoop dfs -mkdir -p oss://<bucket-name>/path/to/patch/

cd /home/hadoop/jindo-patch/
hadoop dfs -put jindosdk-bootstrap-patches.tar.gz oss://<bucket-name>/path/to/patch/
hadoop dfs -put bootstrap_jindosdk.sh oss://<bucket-name>/path/to/patch/

hadoop dfs -ls oss://<bucket-name>/path/to/patch/

可看到返回内容示例如下：

Found 2 items
-rw-rw-rw-   1       2634 2022-05-13 14:07 oss://<bucket-name>/.../bootstrap_jindosdk.sh
-rw-rw-rw-   1  597342992 2022-05-13 13:41 oss://<bucket-name>/.../jindosdk-bootstrap-patches.tar.gz

例如，上传到OSS的路径为oss://<bucket-name>/path/to/jindosdk-bootstrap-patches.tar.gz和oss://<bucket-name>/path/to/bootstrap_jindosdk.sh。

3. 在EMR控制台添加引导操作§

在EMR控制台添加引导操作，详细信息请参见管理引导操作.

在添加引导操作对话框中，填写配置项。

参数	描述	示例
名称	引导操作的名称。例如，升级JINDOSDK。	update_jindosdk
脚本位置	选择脚本所在OSS的位置。脚本路径格式必须为oss://*/.sh格式。	oss:///path/to/patch/bootstrap_jindosdk.sh
参数	引导操作脚本的参数，指定脚本中所引用的变量的值。	-bootstrap oss:///path/to/patch/jindosdk-bootstrap-patches.tar.gz
执行范围	选择集群。
执行时间	选择组件启动后。
执行失败策略	选择继续执行。

4. 确保加载到最新的修复§

如果是新建集群，则需要重启Hive、Presto、Impala、Druid、Flink、Solr、Ranger、Storm、Oozie、Spark和Zeppelin等组件。
如果是扩容新节点，则需要重启对应节点上的 Hive、Presto、Impala、Druid、Flink、Solr、Ranger、Storm、Oozie、Spark和Zeppelin等组件。

场景三：新建集群§

新建EMR集群时在EMR控制台添加引导操作。具体操作步骤如下：

1. 制作引导升级包§

下载的 jindosdk-patches.tar.gz ，jindosdk-6.7.5-linux.tar.gz 和 bootstrap_jindosdk.sh。

mkdir jindo-patch

cd jindo-patch

wget https://jindodata-binary.oss-cn-shanghai.aliyuncs.com/resources/jindosdk-patches.tar.gz

wget https://jindodata-binary.oss-cn-shanghai.aliyuncs.com/release/6.7.5/jindosdk-6.7.5-linux.tar.gz

wget https://jindodata-binary.oss-cn-shanghai.aliyuncs.com/resources/bootstrap_jindosdk.sh

ls -l

内容示例如下：

-rw-r----- 1 hadoop hadoop      xxxx May 01 00:00 bootstrap_jindosdk.sh
-rw-r----- 1 hadoop hadoop xxxxxxxxx May 01 00:00 jindosdk-6.7.5-linux.tar.gz
-rw-r----- 1 hadoop hadoop      xxxx May 01 00:00 jindosdk-patches.tar.gz

执行命令制作升级包

bash bootstrap_jindosdk.sh -gen-full $JINDOSDK_VERSION

如

bash bootstrap_jindosdk.sh -gen-full 6.7.5

参数说明：-gen生成lite升级包，-gen-full表示生成完整升级包。

成功后可以看到如下：


Generated patch at /home/hadoop/jindo-patch/jindosdk-bootstrap-patches.tar.gz

制作完成，得到patch包： jindosdk-bootstrap-patches.tar.gz。

2. 上传引导升级包§

将 patch包和 bootstrap脚本上传到OSS上。

EMR 集群内可以通过 hadoop 命令上传，或者通过 oss 控制台、ossutil 或 OSS Browser 等工具。

hadoop dfs -mkdir -p oss://<bucket-name>/path/to/patch/

cd /home/hadoop/jindo-patch/
hadoop dfs -put jindosdk-bootstrap-patches.tar.gz oss://<bucket-name>/path/to/patch/
hadoop dfs -put bootstrap_jindosdk.sh oss://<bucket-name>/path/to/patch/

hadoop dfs -ls oss://<bucket-name>/path/to/patch/

可看到返回内容示例如下：

Found 2 items
-rw-rw-rw-   1       2634 2022-05-13 14:07 oss://<bucket-name>/.../bootstrap_jindosdk.sh
-rw-rw-rw-   1  597342992 2022-05-13 13:41 oss://<bucket-name>/.../jindosdk-bootstrap-patches.tar.gz

例如，上传到OSS的路径为oss://<bucket-name>/path/to/jindosdk-bootstrap-patches.tar.gz和oss://<bucket-name>/path/to/bootstrap_jindosdk.sh。

在EMR控制台添加引导操作§

在EMR控制台添加引导操作，详细信息请参见管理引导操作.

在添加引导操作对话框中，填写配置项。

参数	描述	示例
名称	引导操作的名称。例如，升级JINDOSDK。	update_jindosdk
脚本位置	选择脚本所在OSS的位置。脚本路径格式必须为oss://*/.sh格式。	oss:///path/to/patch/bootstrap_jindosdk.sh
参数	引导操作脚本的参数，指定脚本中所引用的变量的值。	-bootstrap oss:///path/to/patch/jindosdk-bootstrap-patches.tar.gz
执行范围	选择集群。
执行时间	选择组件启动后。
执行失败策略	选择继续执行。

确保加载到最新的修复§

如果是新建集群，则需要重启Hive、Presto、Impala、Druid、Flink、Solr、Ranger、Storm、Oozie、Spark和Zeppelin等组件。
如果是扩容新节点，则需要重启对应节点上的 Hive、Presto、Impala、Druid、Flink、Solr、Ranger、Storm、Oozie、Spark和Zeppelin等组件。

场景四：回滚 JindoSDK 到集群初始版本§

1. 准备回滚脚本§

登录EMR集群的Master节点，并将下载的patch包放在 hadoop 用户的HOME目录下，将patch包解压缩后，使用 hadoop 用户执行操作。

su - hadoop
cd /home/hadoop/
wget https://jindodata-binary.oss-cn-shanghai.aliyuncs.com/resources/jindosdk-patches.tar.gz
tar zxf jindosdk-patches.tar.gz
cd jindosdk-patches
ls -l

jindosdk-patches 内容示例如下：

-rwxrwxr-x 1 hadoop hadoop      1263 May 01 00:00 apply_all.sh
-rwxrwxr-x 1 hadoop hadoop      6840 May 01 00:00 apply.sh
-rw-rw-r-- 1 hadoop hadoop        40 May 01 00:00 hosts
-rwxrwxr-x 1 hadoop hadoop      1308 May 01 00:00 revert_all.sh
-rwxrwxr-x 1 hadoop hadoop      6326 May 01 00:00 revert.sh

2. 配置回滚节点信息§

编辑patch包下的hosts文件，添加集群所有节点的host name，如emr-header-1或emr-worker-1，文件内容以行分割。

cd jindosdk-patches
vim hosts

hosts文件内容示例如下：

emr-header-1
emr-worker-1
emr-worker-2

3. 执行回滚§

通过revert_all.sh 脚本执行修复操作。

./revert_all.sh

脚本执行完成后，返回如下提示信息。

>>> updating ...  emr-header-1
>>> updating ...  emr-worker-1
>>> updating ...  emr-worker-2
### DONE

4. 确认回滚成功§

ls -l /opt/apps/extra-jars/

以回滚为 3.7.2 版本为例，返回示例如下：

drwxr-xr-x 2 root   root       4096 Apr 24 16:22 flink
-rw-r--r-- 1 hadoop hadoop   189081 Apr 24 15:33 hadoop-lzo-0.4.21-SNAPSHOT.jar
drwxr-xr-x 2 root   root       4096 Apr 24 16:22 hive
-rw-r--r-- 1 root   root    1438552 Apr 24 16:22 jindotable-common.jar
drwxr-xr-x 2 root   root       4096 Apr 24 16:22 native
-rw-r--r-- 1 root   root   29389473 Apr 24 16:22 smartdata-jindofs-3.7.2.jar
drwxr-xr-x 2 root   root       4096 Apr 24 16:22 spark
drwxr-xr-x 2 root   root       4096 Apr 24 16:22 spark3

5. 回滚后重启服务§

说明对于已经在运行的YARN作业（Application，例如，Spark Streaming或Flink作业），需要停止作业后，批量滚动重启YARN NodeManager。

Hive、Presto、Impala、Druid、Flink、Solr、Ranger、Storm、Oozie、Spark 和 Zeppelin 等组件需要重启之后才能完全回滚。

以Hive组件为例，在EMR集群的Hive服务页面，选择右上角的操作 > 重启 All Components。

Keys	Action
`?`	Open this help
`n`	Next page
`p`	Previous page
`s`	Search