DolphinScheduler架构图
目录
一、补充
二、部署流程
1.下载二进制tar.gz包
2.创建部署用户并赋予目录操作权限
3.ssh免密配置
4.数据库初始化
5.修改运行参数
6.一键部署
7.登录系统
如果你还不够熟悉DolphinScheduler,可以参考:
《调度系统Apache DolphinScheduler介绍和设计原理》
一、补充
安装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文件
解压
# 创建部署目录,部署目录请不要创建在 /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连接虚拟机,传输文件
主机号即为刚刚查询的结果,协议选择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后直接拖拽文件进虚拟机界面也能实现文件传输,但就笔者而言这一操作偶尔能够成功但常常导致系统死机。
创建部署用户,并且一定要配置 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
另外这五条指令在第一次成功运行时都没有运行成功提示。
切换到部署用户并配置 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用户执行。除此之外可能还需要对这些目录进行授权。
进入数据库,默认数据库是 PostgreSQL,如选择 MySQL 的话,后续需要添加 mysql-connector-java 驱动包到 DolphinScheduler 的 lib 目录下
mysql-connector-java下载网址:MySQL :: Download Connector/J
注意切换下载linux版并且注意对应版本号。
这里对应的主要是ubuntu的版本而不是linux版本。
查看ubuntu版本的方法 :
cat /proc/version
结果如下:
笔者用的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
访问前端页面地址,接口 ip (自行修改) http://192.168.xx.xx:12345/dolphinscheduler
部署完成,成功进入界面。
推荐参考文档:
官网网址:
https://dolphinscheduler.apache.org/zh-cn/
官网使用教程:https://www.bilibili.com/video/BV1d64y1s7eZ
你可以在这里参考原文链接:https://blog.csdn.net/qq_50740678/article/details/120615253