当前位置：首页>前端>正文

保姆级超详细教程：DolphinScheduler单机(本地)部署及软件运行测试

前端2024-04-05 00:35:21

DolphinScheduler架构图

保姆级超详细教程：DolphinScheduler单机(本地)部署及软件运行测试,第1张

一、补充

安装psmisc：

apt-get?install?psmisc

二、部署流程

1.下载二进制tar.gz包

下载最新版本的后端安装包至服务器部署目录，比如创建 /opt/dolphinscheduler 做为安装部署目录，下载地址：https://dlcdn.apache.org/dolphinscheduler/1.3.8/apache-dolphinscheduler-1.3.8-src.tar.gz，下载后上传 tar 包到该目录中

注：此处应当下载bin文件

保姆级超详细教程：DolphinScheduler单机(本地)部署及软件运行测试,第2张

解压

#?创建部署目录，部署目录请不要创建在?/root、/home?等高权限目录?

mkdir?-p?/opt/dolphinscheduler

cd/opt/dolphinscheduler

#?解压缩

tar?-zxvf?apache-dolphinscheduler-1.3.8-bin.tar.gz

#重命名

mv?apache-dolphinscheduler-1.3.8-bin??dolphinscheduler-bin

笔者在/usr/local位置上创建dolphinscheduler文件夹，上传并解压了安装包。随后将压缩包重命名为dolphinscheduler-bin。

mkdir?dolphinscheduler

cddolphinscheduler

#?解压缩

tar?-zxvf?apache-dolphinscheduler-1.3.8-bin.tar.gz?-C

#重命名

mv?apache-dolphinscheduler-1.3.8-bin??dolphinscheduler-bin

附：

查看虚拟机ip地址

ifconfig

inet后跟的值即为ip地址

随后用filezilla连接虚拟机，传输文件

保姆级超详细教程：DolphinScheduler单机(本地)部署及软件运行测试,第3张

主机号即为刚刚查询的结果，协议选择SFTP而不是默认的FTP，用户名为虚拟机系统的用户名而不是linux终端terminal的用户。

连接成功后即可看到linux文件目录，用拖拽的方式即可传输文件。

笔者此处遇到权限问题：

filezilla报错：

命令:????put"C:\Users\86136\Desktop\apache-dolphinscheduler-1.3.8-src.tar.gz""apache-dolphinscheduler-1.3.8-src.tar.gz"

错误:????/usr/local/dolphinscheduler/apache-dolphinscheduler-1.3.8-src.tar.gz:?openforwrite:?permission?denied

错误:????文件传输失败

在虚拟机上授权

sudo?chmod?777?/usr/local/dolphinscheduler

重新传输，问题解决。

实际上，在安装filezilla后直接拖拽文件进虚拟机界面也能实现文件传输，但就笔者而言这一操作偶尔能够成功但常常导致系统死机。

2.创建部署用户并赋予目录操作权限

创建部署用户，并且一定要配置 sudo 免密。以创建 dolphinscheduler 用户为例

#?创建用户需使用?root?登录

useradd?dolphinscheduler

#?添加密码

echo"dolphinscheduler"|?passwd?--stdin?dolphinscheduler

#?配置?sudo?免密

sed?-i'$adolphinscheduler??ALL=(ALL)??NOPASSWD:?NOPASSWD:?ALL'/etc/sudoers

sed?-i's/Defaults????requirett/#Defaults????requirett/g'/etc/sudoers

#?修改目录权限，使得部署用户对?dolphinscheduler-bin?目录有操作权限

chown?-R?dolphinscheduler:dolphinscheduler?dolphinscheduler-bin

注意：

因为任务执行服务是以 sudo -u {linux-user} 切换不同 linux 用户的方式来实现多租户运行作业，所以部署用户需要有 sudo 权限，而且是免密的。初学习者不理解的话，完全可以暂时忽略这一点

如果发现 /etc/sudoers 文件中有 "Defaults requirett" 这行，也请注释掉

如果用到资源上传的话，还需要给该部署用户分配操作本地文件系统或者 HDFS 或者 MinIO的权限

坑：

echo"dolphinscheduler"|?passwd?--stdin?dolphinscheduler

这步会报错。linux的passwd命令没有--stdin的语法

应该用

echo"dolphinscheduler:123456"|?chpasswd

修改用户dolphinscheduler密码为123456

另外这五条指令在第一次成功运行时都没有运行成功提示。

3.ssh免密配置

切换到部署用户并配置 ssh 本机免密登录

su?dolphinscheduler

ssh-keygen?-t?rsa?-P''-f?~/.ssh/id_rsa

cat?~/.ssh/id_rsa.pub?>>?~/.ssh/authorized_keys

chmod?600?~/.ssh/authorized_keys

注意：正常设置后，dolphinscheduler 用户在执行命令 ssh localhost 是不需要再输入密码的

坑：这里运行会报错Could not create directory '/home/dolphinscheduler/.ssh

需要先以root身份在/home下创建dolphinscheduler目录再在dolphinscheduler里创建.ssh目录，

然后切换回dolphinscheduler用户执行。除此之外可能还需要对这些目录进行授权。

4.数据库初始化

进入数据库，默认数据库是 PostgreSQL，如选择 MySQL 的话，后续需要添加 mysql-connector-java 驱动包到 DolphinScheduler 的 lib 目录下

mysql-connector-java下载网址：MySQL :: Download Connector/J

注意切换下载linux版并且注意对应版本号。

这里对应的主要是ubuntu的版本而不是linux版本。

保姆级超详细教程：DolphinScheduler单机(本地)部署及软件运行测试,第4张

查看ubuntu版本的方法：

cat?/proc/version

结果如下：

保姆级超详细教程：DolphinScheduler单机(本地)部署及软件运行测试,第5张

笔者用的18.04版本

下载好后放到DolphinScheduler 的 lib 目录下解压

但是笔者此处遇到一点问题，下载下来的文件解压后的结果似乎并不太常规，没法简单地tar解包

解决方法是在windows中解压，然后打开解压出的压缩包，该压缩包里./usr/share/java里有我们需要的mysql-connector-java-8.0.26.jar，取出来传入linux的lib文件夹下。

之后执行如下指令进入数据库：

#启动mysql服务

service?mysql?start

#登录

mysql?-uroot?-p

此处遇到了另一个问题，运行service mysql start报错Failed to start mysql.service: Unit mysql.service not found.

解决方法：

#查询/etc/init.d/下是否存在mysql，无结果说明不存在

ll?/etc/init.d/?|?grep?mysql

#查询mysql.server所在位置

find?/?-name?mysql.server

#把mysql.server复制过去，其中/usr/local/mysql/是笔者的mysql安装目录

cp?/usr/local/mysql/support-files/mysql.server?/etc/init.d/mysql

进入数据库命令行窗口后，执行数据库初始化命令，设置访问账号和密码。注: {user} 和 {password} 需要替换为具体的数据库用户名和密码

mysql>?CREATE?DATABASE?dolphinscheduler?DEFAULT?CHARACTER?SET?utf8?DEFAULT?COLLATE?utf8_general_ci;

mysql>?GRANT?ALL?PRIVILEGES?ON?dolphinscheduler.*?TO'{user}'@'%'IDENTIFIED?BY'{password}';

mysql>?GRANT?ALL?PRIVILEGES?ON?dolphinscheduler.*?TO'{user}'@'localhost'IDENTIFIED?BY'{password}';

mysql>?flush?privileges;

注：如果需要查看mysql中的用户及其密码可使用如下代码

SELECT?User,?Host,?Password?FROM?mysql.user;

创建表和导入基础数据

首先退出sql(按Ctrl+c)

接下来修改 conf 目录下 datasource.properties 中的下列配置

cd/usr/local/dolphinscheduler/dolphinscheduler-bin

vi?conf/datasource.properties

如果选择 MySQL，请注释(用‘#’)掉 PostgreSQL 相关配置(反之同理)，还需要手动添加 [ mysql-connector-java 驱动 jar ] 包到 lib 目录下，这里下载的是 mysql-connector-java-5.1.47.jar，然后正确配置数据库连接相关信息

提示：切换至英文输入法，输入i进入修改状态，方向键改变光标位置，完成后先按Esc退出插入状态，再输入:wq保存并退出。:q可用来直接退出而不保存。

#?postgre

#?spring.datasource.driver-class-name=org.postgresql.Driver

#?spring.datasource.url=jdbc:postgresql://localhost:5432/dolphinscheduler

#?mysql

spring.datasource.driver-class-name=com.mysql.jdbc.Driver

spring.datasource.url=jdbc:mysql://xxx:3306/dolphinscheduler?useUnicode=true&characterEncoding=UTF-8&allowMultiQueries=true#?需要修改ip，本机localhost即可

spring.datasource.username=xxx#?需要修改为上面的{user}值

spring.datasource.password=xxx#?需要修改为上面的{password}值

先把PostgreSQL 相关的代码注释掉，然后注意修改这里的xxx

修改并保存完后，执行 script 目录下的创建表及导入基础数据脚本

sh?script/create-dolphinscheduler.sh

注意: 如果执行上述脚本提示 “/bin/java: No such file or directory” 错误，请在 /etc/profile 下配置 JAVA_HOME 及 PATH 变量

正好笔者此处也遇到了类似的问题：

script/create-dolphinscheduler.sh: 37: script/create-dolphinscheduler.sh: /bin/java: not found

那么我们就按照提示进入/etc文件夹下的profile文件进行编辑吧：

vi?/etc/profile

在最下方添加如下代码：

JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64

JRE_HOME=/usr/lib/jvm/java-8-openjdk-amd64/jre

PATH=$JAVA_HOME/bin:$JRE_HOME/bin:$PATH

CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar:$JRE_HOME/lib

exportJAVA_HOME?JRE_HOME?PATH?CLASSPATH

当然此处可能由于每个人jdk所在位置以及版本不同而需要做出适当修改。

如果之前使用的npm安装jdk，那么jdk很有可能被安装在/usr/lib/jvm目录下

而我们所需的java文件地址为：/usr/lib/jvm/java-8-openjdk-amd64/bin/java （此处可能略有不同）

:wq保存退出。

之后再敲入如下代码：

source/etc/profile???//使修改立即生效

echo$JAVA_HOME//查看JAVA_HOME的值

javac?-version

第一条使设置生效，二三条检验配置是否成功。

5.修改运行参数

修改 /usr/local/dolphinscheduler/dolphinscheduler-bin/conf/env 目录下的 dolphinscheduler_env.sh 环境变量(以相关用到的软件都安装在 /opt/soft 下为例)

vi?/usr/local/dolphinscheduler/dolphinscheduler-bin/conf/env/dolphinscheduler_env.sh

注释export SPARK_HOME1=/opt/soft/spark1这行

export DATAX_HOME=/opt/soft/datax/bin/datax这行加上.py

exportHADOOP_HOME=/opt/soft/hadoop

exportHADOOP_CONF_DIR=/opt/soft/hadoop/etc/hadoop

#?export?SPARK_HOME1=/opt/soft/spark1

exportSPARK_HOME2=/opt/soft/spark2

exportPYTHON_HOME=/opt/soft/python

exportJAVA_HOME=/opt/soft/java

exportHIVE_HOME=/opt/soft/hive

exportFLINK_HOME=/opt/soft/flink

exportDATAX_HOME=/opt/soft/datax/bin/datax.py

exportPATH=$HADOOP_HOME/bin:$SPARK_HOME2/bin:$PYTHON_HOME:$JAVA_HOME/bin:$HIVE_HOME/bin:$FLINK_HOME/bin:$DATAX_HOME:$PATH

注意: 这一步非常重要，例如 JAVA_HOME 和 PATH 是必须要配置的，没有用到的可以忽略或者注释掉；如果找不到 dolphinscheduler_env.sh，请运行 ls -a

将 jdk 软链到 /usr/bin/java 下(仍以 JAVA_HOME=/opt/soft/java 为例)

sudo?ln?-s?/opt/soft/java/bin/java?/usr/bin/java

修改一键部署配置文件conf/config/install_config.conf中的各参数，特别注意以下参数的配置

vim?/usr/local/dolphinscheduler/dolphinscheduler-bin/conf/config/install_config.conf

#?这里填?mysql?or?postgresql

dbtype="mysql"

#?数据库连接地址

dbhost="localhost:3306"

#?数据库名

dbname="dolphinscheduler"

#?数据库用户名，此处需要修改为上面设置的?{user}?具体值

username="xxx"

#?数据库密码，如果有特殊字符，请使用?\?转义，需要修改为上面设置的?{password}?具体值

password="xxx"

#?Zookeeper地址，单机本机是?localhost:2181，记得把?2181?端口带上

zkQuorum="localhost:2181"

#?将?DS?安装到哪个目录，如:?/opt/soft/dolphinscheduler，不同于现在的目录

installPath="/opt/soft/dolphinscheduler"

#?使用哪个用户部署，使用第?3?节创建的用户

deployUser="dolphinscheduler"

#?邮件配置，以?qq?邮箱为例

#?邮件协议

mailProtocol="SMTP"

#?邮件服务地址

mailServerHost="smtp.qq.com"

#?邮件服务端口

mailServerPort="25"

#?mailSender?和?mailUser?配置成一样即可

#?发送者

mailSender="xxx@qq.com"

#?发送用户

mailUser="xxx@qq.com"

#?邮箱密码

mailPassword="xxx"

#?TLS?协议的邮箱设置为?true，否则设置为?false

starttlsEnable="true"

#?开启 SSL 协议的邮箱配置为 true，否则为 false。注意: starttlsEnable 和 sslEnable 不能同时为 true

sslEnable="false"

#?邮件服务地址值，参考上面?mailServerHost

sslTrust="smtp.qq.com"

#?业务用到的比如 sql 等资源文件上传到哪里，可以设置：HDFS,S3,NONE，单机如果想使用本地文件系统，请配置为 HDFS，因为 HDFS 支持本地文件系统；如果不需要资源上传功能请选择 NONE。强调一点：使用本地文件系统不需要部署 hadoop

resourceStorageType="HDFS"

#?这里以保存到本地文件系统为例

#?注：但是如果你想上传到 HDFS 的话，NameNode 启用了 HA，则需要将 hadoop 的配置文件 core-site.xml 和 hdfs-site.xml 放到 conf 目录下，本例即是放到?/opt/dolphinscheduler/conf 下面，并配置 namenode cluster 名称；如果 NameNode 不是 HA，则修改为具体的 ip 或者主机名即可

defaultFS="file:///data/dolphinscheduler"#hdfs://{具体的ip/主机名}:8020

#?如果没有使用到 Yarn，保持以下默认值即可；如果 ResourceManager 是 HA，则配置为 ResourceManager 节点的主备 ip 或者 hostname，比如?"192.168.xx.xx,192.168.xx.xx"?;如果是单 ResourceManager 请配置 yarnHaIps=""?即可

#?注：依赖于yarn执行的任务，为了保证执行结果判断成功，需要确保yarn信息配置正确

yarnHaIps="192.168.xx.xx,192.168.xx.xx"

#?如果 ResourceManager 是 HA 或者没有使用到 Yarn 保持默认值即可；如果是单 ResourceManager，请配置真实的 ResourceManager 主机名或者 ip

singleYarnIp="yarnIp1"

#?资源上传根路径，支持?HDFS?和?S3，由于?hdfs?支持本地文件系统，需要确保本地文件夹存在且有读写权限

resourceUploadPath="/data/dolphinscheduler"

#?具备权限创建?resourceUploadPath的用户

hdfsRootUser="hdfs"

#?配置?api?server?port

apiServerPort="12345"

#?在哪些机器上部署?DS?服务，本机选?localhost

ips="localhost"

#?ssh端口，默认22

sshPort="22"

#?master服务部署在哪台机器上

masters="localhost"

#?worker服务部署在哪台机器上，并指定此?worker?属于哪一个?worker?组，下面示例的?default?即为组名

workers="localhost:default"

#?报警服务部署在哪台机器上

alertServer="localhost"

#?后端api服务部署在在哪台机器上

apiServers="localhost"

注：如果打算用到资源中心功能，请执行以下命令：

sudo?mkdir?/data/dolphinscheduler

sudo?chown?-R?dolphinscheduler:dolphinscheduler?/data/dolphinscheduler

6.一键部署

切换到部署用户，执行一键部署脚本

sh?install.sh

注意：第一次部署的话，在运行中第3步 3,stop server 出现 5 次以下信息，此信息可以忽略

sh:?bin/dolphinscheduler-daemon.sh:?No?such?file?or?directory

运行时报错：install.sh: 22: install.sh: source: not found 1.replace file install.sh: 28: install.sh: [[: not found install.sh: 34: [: ==: unexpected operator 2.create directory 3.scp resources /usr/local/dolphinscheduler/dolphinscheduler-bin/script/scp-hosts.sh: 21: /usr/local/dolphinscheduler/dolphinscheduler-bin/script/scp-hosts.sh: source: not found /usr/local/dolphinscheduler/dolphinscheduler-bin/script/scp-hosts.sh: 24: /usr/local/dolphinscheduler/dolphinscheduler-bin/script/scp-hosts.sh: [[: not found /usr/local/dolphinscheduler/dolphinscheduler-bin/script/scp-hosts.sh: 29: /usr/local/dolphinscheduler/dolphinscheduler-bin/script/scp-hosts.sh: Syntax error: "(" unexpected scp copy failed to exit

原因：默认使用dash作为shell，但sh是bash shell的命令。

解决方案：

dpkg-reconfigure?dash（需要root权限）

在界面中选择no

再运行ls?-l?/bin/sh?后显示/bin/sh?->?bash

再运行sh命令即可

脚本完成后，会启动以下 5 个服务，使用

jps

命令查看服务是否启动( jps 为 JDK 自带)

如果显示中包含：

MasterServer?????????-----?master服务

WorkerServer?????????-----?worker服务

LoggerServer?????????-----?logger服务

ApiApplicationServer?-----?api服务

AlertServer??????????-----?alert服务

如果以上服务都正常启动，说明自动部署成功

部署成功后，可以进行日志查看，日志统一存放于 logs 文件夹内

/usr/dolphinscheduler/logs

logs/

├──?dolphinscheduler-alert-server.log

├──?dolphinscheduler-master-server.log

|——?dolphinscheduler-worker-server.log

|——?dolphinscheduler-api-server.log

|——?dolphinscheduler-logger-server.log

7.登录系统

访问前端页面地址，接口 ip (自行修改) http://192.168.xx.xx:12345/dolphinscheduler