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

大数据真好玩

发布于 2021-12-02 10:11:44

4K0

发布于 2021-12-02 10:11:44

文章被收录于专栏：暴走大数据暴走大数据

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
cd dolphinscheduler

# 解压缩
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: open for write: 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版本。

查看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
export JAVA_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

export HADOOP_HOME=/opt/soft/hadoop
export HADOOP_CONF_DIR=/opt/soft/hadoop/etc/hadoop
# export SPARK_HOME1=/opt/soft/spark1
export SPARK_HOME2=/opt/soft/spark2
export PYTHON_HOME=/opt/soft/python
export JAVA_HOME=/opt/soft/java
export HIVE_HOME=/opt/soft/hive
export FLINK_HOME=/opt/soft/flink
export DATAX_HOME=/opt/soft/datax/bin/datax.py
export PATH=$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