Apache SeaTunnel 及 Web 端安装常见问题及解决方法

如果机器可以连接外网,可使用命令方式shbininstall-plugin.sh直接下载,这个命令会自动下载文件apache-seatunnel-2.3.3connectorsplugin-mapping.properties中指定的所有Connector的Jar包,每个人可根据自己情况自行增减需要的connector依赖包

本文是作者在安装Apache SeaTunnel过程中,新手可能会遇到的一些棘手问题总结,希望给到大家帮助和参考!

17182861705135a05c0b73049c39ce3157e0454167bc1

常见错误问题

java.lang.NoClassDefFoundError:com/sun/jersey/client/impl/CopyOnWriteHashMap

主要原因是,Hadoop相关的Jar包找不到,需要将Jar包放到lib下。

atunnel-hadoop3-3.1.4-uber-2.3.3-optional.jar到SeaTnnel的lib包下即可。

下载方法见文章后面的详细介绍:

SqlServer-cdc的Jar包安全问题

使用高版本的mssql的JDBC的Jar包时,有安全检查机制,会导致进行使用SeaTunnel的sqlserver-cdc时报异常:

Caused by: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target

我使用的是mssql-jdbc-11.2.3.jre8.jar,结果一直报异常,添加了trustServerCertificate=true;encrypt=true参数也会报错(只针对seatunnel的SqlServer-cdc场景,在jdbc场景使用此jar包正常)。

经过查看源码与issue,发现源码中是低版本mssql-jdbc-9.4.1.jre8.jar,替换此Jar包后SqlServer-cdcSqlServer2016上能够实现CDC功能。

有的同学使用的是mssql-jdbc-9.2.0.jre8.jar,也可以实现SqlServer-cdc功能。

Jar包下载地址https://repo1.maven.org/maven2/com/microsoft/sqlserver/mssql-jdbc/

SqlServer 2016无法开启表的CDC

安装进行开启SqlServer 2016的CDC功能时,遇到问题是: 以开启SqlServer的库的CDC,但是在开启表的CDC时,一直无法执行成功。

可能得原因是,计算机的名称发生了变化,需要将计算机的名称还原到安装SqlServer 2016的时候的名称。

**参考材料:**sql - 在表级别启用CDC时出错 - Thinbug: https://www.thinbug.com/q/23969742

mvn加速下载相关Jar包

安装SeaTunnel过程中,解压文件后官方默认提供的Connector的Jar包只有2个,要想连接MySQL、Oracle、SqlServer、Hive、Kafka、Clickhouse、Doris等时,还需下载对应的Jar包。

1718286179928979993955e6eac9c8e89f26c50d29d53

解决办法:

如果机器可以连接外网,可使用命令方式sh bin/install-plugin.sh直接下载,这个命令会 自动下载文件apache-seatunnel-2.3.3/connectors/plugin-mapping.properties中指定的所有Connector的Jar包,每个人可根据自己情况自行增减需要的connector依赖包。

1718286179942d13118f5734badfbd7dddf9c601c7214

加速下载Connector相关Jar包

SeaTunnel下载Connector的Jar包时,从https://repo.maven.apache.org 下载,速度及其缓慢,且公司机器不能上外网,改用自己Windows本地的mvn,从阿里云mvn源下载情况会得到大大的改善。

解决办法:

修改其安装插件相关脚本,复制bin目录下install-plugin.sh重命名为install-plugin-mvn.sh

1718286180029886d38abe15b7a95e1bd05ce4c9ec5be

替换脚本中的${SEATUNNEL_HOME}/mvnw为mvn,即可使用本地mvn,配合阿里云的mvn源,可加速下载。

1718286180002650a29d9beccefc6b08175ca9d66808c

然后执行install-plugin-mvn.sh即可,我们可以看到原本2个小时没有下载完成的,改写后几分钟下载完成了。

171828618003152b21df002025a1709dc50cc53268eaa

将下载后的Jar包复制到connectors/seatunnel/下即完成connector的Jar包补充。

注意 :在安装SeaTunnel的时候可能会出现java.lang.NoClassDefFoundError错误,大部分时候是因为缺少 Apache Hadoop的Jar包,在执行install-plugin-mvn.sh的时候会下载一个jar包seatunnel-hadoop3-3.1.4-uber-2.3.3-optional.jar,存放于上一级目录的lib文件夹下。

如果是在其他路径下载jar包,将下载的seatunnel-hadoop3-3.1.4-uber-2.3.3-optional.jar放在SeaTunnel的lib文件夹下,就可以解决这个问题了。

1718286179988bebee74fdfafd1fa4b7b3f20adda6172

Datasource相关Jar包

安装好seatunnel-web1.0.0后,新建数据源时,无下拉框和数据源选项,

171828618095436b4649acf6a7790699d16ccd60a5593

查找资料中官方大佬给出的解决方式如下:

[Improve] Add "download_datasource.sh" for downloading datasource. by FlechazoW · Pull Request #136 · apache/seatunnel-web · GitHub

跳转链接:https://github.com/apache/seatunnel-web/pull/136

注意,这里的解决方式需要下载最新的seatunnel-web源代码,执行download_datasource.sh下载数据源jar包

1718286180989cae869d6f709aeee5764b0b902b21d8c

查看源代码,也是使用mvnw的方式下载,windows上进行修改

download\_datasource.sh复制到 D:\\jar\\seatunnel\\script后改名为download\_datasource-mvn.sh,替换"$SEATUNNEL\_WEB\_HOME"/mvnw为本地环境变量中配置好的mvn即可。

1718286180954cd57eb2eb837a55885df499ec726bc34

执行sh download_datasource-mvn.sh命令就会将Jar包下载到相应为文件夹中

file

下载完成后,将相应的Jar包放置到apache-seatunnel-web的libs下,重启之后,显示正常。

17182861810100fdc4be20f95c3b4c1cb9137c3c9d98a

注意事项

1.元数据和数据源的jar包还需要要复制到后端lib文件夹/opt/seatunnel/backend/apache-seatunnel-2.3.3/lib

否则在配置好web任务时,后台根本不执行!!!

2.有的同学各种准备工作都做好了,还是不显示数据源,这个时候把后端的connectorsplugins相关jar包放到web下的lib下再试试。

相关问题

配置阿里云mvn源加速

如何配置的阿里云mvn源https://blog.csdn.net/zhang19903848257/article/details/107923791

如何在windows环境下执行shell命令

因为所有linux机器不能外网,先在windows下执行shell脚本,下载jar包,然后复制到相关机器即可。

如何在windows下执行shell命令,可参考下面的文章。

Windows中运行Linux命令的6种方法https://www.eet-china.com/mp/a228539.html

感谢大家的浏览,希望对接大家有所帮助!

本文由 白鲸开源科技 提供发布支持!