• PostgreSQL (8.2.15+) or MySQL (5.7系列):两者任选其一即可
  • JDK (1.8+):必装,请安装好后在/etc/profile下配置 JAVA_HOME 及 PATH 变量
  • ZooKeeper (3.4.6+):必装
  • pstree or psmisc:Mac OS必装pstree,Fedora/Red/Hat/CentOS/Ubuntu/Debian必装psmisc
  • Hadoop (2.6+) or MinIO:选装,如果需要用到资源上传功能,可以选择上传到Hadoop or MinIO上

注意:DolphinScheduler本身不依赖Hadoop、Hive、Spark,仅是会调用他们的Client,用于对应任务的提交。

  • 请下载最新版本的后端安装包至服务器部署目录,比如创建 /opt/dolphinscheduler 做为安装部署目录,下载地址: 下载,下载后上传tar包到该目录中,并进行解压
  1. # 创建部署目录,部署目录请不要创建在/root、/home等高权限目录
  2. mkdir -p /opt/dolphinscheduler;
  3. cd /opt/dolphinscheduler;
  4. # 解压缩
  5. tar -zxvf apache-dolphinscheduler-incubating-1.3.1-dolphinscheduler-bin.tar.gz -C /opt/dolphinscheduler;
  6. mv apache-dolphinscheduler-incubating-1.3.1-dolphinscheduler-bin dolphinscheduler-bin
  • 所有部署调度的机器上创建部署用户,并且一定要配置sudo免密。假如我们计划在ds1,ds2,ds3,ds4这4台机器上部署调度,首先需要在每台机器上都创建部署用户
  1. # 创建用户需使用root登录,设置部署用户名,请自行修改,后面以dolphinscheduler为例
  2. useradd dolphinscheduler;
  3. # 设置用户密码,请自行修改,后面以dolphinscheduler123为例
  4. echo "dolphinscheduler123" | passwd --stdin dolphinscheduler
  5. # 配置sudo免密
  6. echo 'dolphinscheduler ALL=(ALL) NOPASSWD: NOPASSWD: ALL' >> /etc/sudoers
  7. sed -i 's/Defaults requirett/#Defaults requirett/g' /etc/sudoers
  1. 注意:
  2. - 因为是以 sudo -u {linux-user} 切换不同linux用户的方式来实现多租户运行作业,所以部署用户需要有 sudo 权限,而且是免密的。
  3. - 如果发现/etc/sudoers文件中有"Default requiretty"这行,也请注释掉
  4. - 如果用到资源上传的话,还需要在`HDFS或者MinIO`上给该部署用户分配读写的权限
  • 以第一台机器(hostname为ds1)作为部署机,在ds1上配置所有待部署机器的hosts, 在ds1以root登录
  1. vi /etc/hosts
  2. #add ip hostname
  3. 192.168.xxx.xxx ds1
  4. 192.168.xxx.xxx ds2
  5. 192.168.xxx.xxx ds3
  6. 192.168.xxx.xxx ds4

注意:请删掉或者注释掉127.0.0.1这行

  • 同步ds1上的/etc/hosts到所有部署机器
  1. for ip in ds2 ds3; #请将此处ds2 ds3替换为自己要部署的机器的hostname
  2. do
  3. sudo scp -r /etc/hosts $ip:/etc/ #在运行中需要输入root密码
  4. done

备注:当然 通过sshpass -p xxx sudo scp -r /etc/hosts $ip:/etc/就可以省去输入密码了

centos下sshpass的安装:

  1. 先安装epel

    yum install -y epel-release

    yum repolist

  2. 安装完成epel之后,就可以按照sshpass了

    yum install -y sshpass

  • 在ds1上,切换到部署用户并配置ssh本机免密登录
  1. su dolphinscheduler;
  2. ssh-keygen -t rsa -P '' -f ~/.ssh/id_rsa
  3. cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys
  4. chmod 600 ~/.ssh/authorized_keys

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

  • 在ds1上,配置部署用户dolphinscheduler ssh打通到其他待部署的机器
  1. su dolphinscheduler;
  2. for ip in ds2 ds3; #请将此处ds2 ds3替换为自己要部署的机器的hostname
  3. do
  4. ssh-copy-id $ip #该操作执行过程中需要手动输入dolphinscheduler用户的密码
  5. done
  6. # 当然 通过 sshpass -p xxx ssh-copy-id $ip 就可以省去输入密码了
  • 在ds1上,修改目录权限,使得部署用户对dolphinscheduler-bin目录有操作权限
  1. sudo chown -R dolphinscheduler:dolphinscheduler dolphinscheduler-bin
  • 进入数据库,默认数据库是PostgreSQL,如选择MySQL的话,后续需要添加mysql-connector-java驱动包到DolphinScheduler的lib目录下,这里以MySQL为例
  1. mysql -h192.168.xx.xx -P3306 -uroot -p
  • 进入数据库命令行窗口后,执行数据库初始化命令,设置访问账号和密码。注: {user} 和 {password} 需要替换为具体的数据库用户名和密码
  1. mysql> CREATE DATABASE dolphinscheduler DEFAULT CHARACTER SET utf8 DEFAULT COLLATE utf8_general_ci;
  2. mysql> GRANT ALL PRIVILEGES ON dolphinscheduler.* TO '{user}'@'%' IDENTIFIED BY '{password}';
  3. mysql> GRANT ALL PRIVILEGES ON dolphinscheduler.* TO '{user}'@'localhost' IDENTIFIED BY '{password}';
  4. mysql> flush privileges;
  • 创建表和导入基础数据

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

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

      1. #postgre
      2. #spring.datasource.driver-class-name=org.postgresql.Driver
      3. #spring.datasource.url=jdbc:postgresql://localhost:5432/dolphinscheduler
      4. # mysql
      5. spring.datasource.driver-class-name=com.mysql.jdbc.Driver
      6. spring.datasource.url=jdbc:mysql://xxx:3306/dolphinscheduler?useUnicode=true&characterEncoding=UTF-8&allowMultiQueries=true 需要修改ip
      7. spring.datasource.username=xxx 需要修改为上面的{user}值
      8. spring.datasource.password=xxx 需要修改为上面的{password}值
    • 修改并保存完后,执行 script 目录下的创建表及导入基础数据脚本

      1. sh script/create-dolphinscheduler.sh

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

  • 修改 conf/env 目录下的 dolphinscheduler_env.sh 环境变量(以相关用到的软件都安装在/opt/soft下为例)
  1. export HADOOP_HOME=/opt/soft/hadoop
  2. export HADOOP_CONF_DIR=/opt/soft/hadoop/etc/hadoop
  3. #export SPARK_HOME1=/opt/soft/spark1
  4. export SPARK_HOME2=/opt/soft/spark2
  5. export PYTHON_HOME=/opt/soft/python
  6. export JAVA_HOME=/opt/soft/java
  7. export HIVE_HOME=/opt/soft/hive
  8. export FLINK_HOME=/opt/soft/flink
  9. export DATAX_HOME=/opt/soft/datax/bin/datax.py
  10. export PATH=$HADOOP_HOME/bin:$SPARK_HOME2/bin:$PYTHON_HOME:$JAVA_HOME/bin:$HIVE_HOME/bin:$PATH:$FLINK_HOME/bin:$DATAX_HOME:$PATH

注: 这一步非常重要,例如 JAVA_HOME 和 PATH 是必须要配置的,没有用到的可以忽略或者注释掉

  • 将jdk软链到/usr/bin/java下(仍以 JAVA_HOME=/opt/soft/java 为例)
  1. sudo ln -s /opt/soft/java/bin/java /usr/bin/java
  • 修改一键部署配置文件 conf/config/install_config.conf中的各参数,特别注意以下参数的配置
  1. # 这里填 mysql or postgresql
  2. dbtype="mysql"
  3. # 数据库连接地址
  4. dbhost="192.168.xx.xx:3306"
  5. # 数据库名
  6. dbname="dolphinscheduler"
  7. # 数据库用户名,此处需要修改为上面设置的{user}具体值
  8. username="xxx"
  9. # 数据库密码, 如果有特殊字符,请使用\转义,需要修改为上面设置的{password}具体值
  10. password="xxx"
  11. #Zookeeper地址
  12. zkQuorum="192.168.xx.xx:2181,192.168.xx.xx:2181,192.168.xx.xx:2181"
  13. #将DS安装到哪个目录,如: /opt/soft/dolphinscheduler,不同于现在的目录
  14. installPath="/opt/soft/dolphinscheduler"
  15. #使用哪个用户部署,使用第3节创建的用户
  16. deployUser="dolphinscheduler"
  17. # 邮件配置,以qq邮箱为例
  18. # 邮件协议
  19. mailProtocol="SMTP"
  20. # 邮件服务地址
  21. mailServerHost="smtp.qq.com"
  22. # 邮件服务端口
  23. mailServerPort="25"
  24. # mailSender和mailUser配置成一样即可
  25. # 发送者
  26. mailSender="xxx@qq.com"
  27. # 发送用户
  28. mailUser="xxx@qq.com"
  29. # 邮箱密码
  30. mailPassword="xxx"
  31. # TLS协议的邮箱设置为true,否则设置为false
  32. starttlsEnable="true"
  33. # 开启SSL协议的邮箱配置为true,否则为false。注意: starttlsEnable和sslEnable不能同时为true
  34. sslEnable="false"
  35. # 邮件服务地址值,参考上面 mailServerHost
  36. sslTrust="smtp.qq.com"
  37. # 业务用到的比如sql等资源文件上传到哪里,可以设置:HDFS,S3,NONE,单机如果想使用本地文件系统,请配置为HDFS,因为HDFS支持本地文件系统;如果不需要资源上传功能请选择NONE。强调一点:使用本地文件系统不需要部署hadoop
  38. resourceStorageType="HDFS"
  39. # 如果上传资源保存想保存在hadoop上,hadoop集群的NameNode启用了HA的话,需要将hadoop的配置文件core-site.xml和hdfs-site.xml放到安装路径(上面的installPath)的conf目录下,本例即是放到/opt/soft/dolphinscheduler/conf下面,并配置namenode cluster名称;如果NameNode不是HA,则只需要将mycluster修改为具体的ip或者主机名即可
  40. defaultFS="hdfs://mycluster:8020"
  41. # 如果没有使用到Yarn,保持以下默认值即可;如果ResourceManager是HA,则配置为ResourceManager节点的主备ip或者hostname,比如"192.168.xx.xx,192.168.xx.xx";如果是单ResourceManager请配置yarnHaIps=""即可
  42. yarnHaIps="192.168.xx.xx,192.168.xx.xx"
  43. # 如果ResourceManager是HA或者没有使用到Yarn保持默认值即可;如果是单ResourceManager,请配置真实的ResourceManager主机名或者ip
  44. singleYarnIp="yarnIp1"
  45. # 资源上传根路径,主持HDFS和S3,由于hdfs支持本地文件系统,需要确保本地文件夹存在且有读写权限
  46. resourceUploadPath="/data/dolphinscheduler"
  47. # 具备权限创建resourceUploadPath的用户
  48. hdfsRootUser="hdfs"
  49. #在哪些机器上部署DS服务,本机选localhost
  50. ips="ds1,ds2,ds3,ds4"
  51. #ssh端口,默认22
  52. sshPort="22"
  53. #master服务部署在哪台机器上
  54. masters="ds1,ds2"
  55. #worker服务部署在哪台机器上,并指定此worker属于哪一个worker组,下面示例的default即为组名
  56. workers="ds3:default,ds4:default"
  57. #报警服务部署在哪台机器上
  58. alertServer="ds2"
  59. #后端api服务部署在在哪台机器上
  60. apiServers="ds1"

特别注意:

如果需要用资源上传到Hadoop集群功能, 并且Hadoop集群的NameNode 配置了 HA的话 ,需要开启 HDFS类型的资源上传,同时需要将Hadoop集群下的core-site.xml和hdfs-site.xml复制到/opt/dolphinscheduler/conf,非NameNode HA跳过次步骤

  • 切换到部署用户dolphinscheduler,然后执行一键部署脚本

    1. `sh install.sh`

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

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

  • 脚本完成后,会启动以下5个服务,使用jps命令查看服务是否启动(jpsjava JDK自带)

    1. MasterServer ----- master服务
    2. WorkerServer ----- worker服务
    3. LoggerServer ----- logger服务
    4. ApiApplicationServer ----- api服务
    5. AlertServer ----- alert服务

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

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

  1. logs/
  2. ├── dolphinscheduler-alert-server.log
  3. ├── dolphinscheduler-master-server.log
  4. |—— dolphinscheduler-worker-server.log
  5. |—— dolphinscheduler-api-server.log
  6. |—— dolphinscheduler-logger-server.log
  • 访问前端页面地址,接口ip(自行修改) http://localhost:12345/dolphinscheduler

    Image 1

  • 一键停止集群所有服务

    1. `sh ./bin/stop-all.sh`
  • 一键开启集群所有服务

    1. `sh ./bin/start-all.sh`
  • 启停Master

    1. sh ./bin/dolphinscheduler-daemon.sh start master-server
    2. sh ./bin/dolphinscheduler-daemon.sh stop master-server
  • 启停Worker

    1. sh ./bin/dolphinscheduler-daemon.sh start worker-server
    2. sh ./bin/dolphinscheduler-daemon.sh stop worker-server
  • 启停Api

    1. sh ./bin/dolphinscheduler-daemon.sh start api-server
    2. sh ./bin/dolphinscheduler-daemon.sh stop api-server
  • 启停Logger

    1. sh ./bin/dolphinscheduler-daemon.sh start logger-server
    2. sh ./bin/dolphinscheduler-daemon.sh stop logger-server
  • 启停Alert

    1. sh ./bin/dolphinscheduler-daemon.sh start alert-server
    2. sh ./bin/dolphinscheduler-daemon.sh stop alert-server

注:服务用途请具体参见《系统架构设计》小节


附录:

  • 如果您需要使用到企业微信进行告警,请在安装完成后,修改 alert.properties 文件,然后重启 alert 服务即可:
  1. # 设置企业微信告警功能是否开启:开启为 true,否则为 false。
  2. enterprise.wechat.enable="true"
  3. # 设置 corpid,每个企业都拥有唯一的 corpid,获取此信息可在管理后台“我的企业”-“企业信息”下查看“企业 ID”(需要有管理员权限)
  4. enterprise.wechat.corp.id="xxx"

Image 2

  1. # 设置 secret,secret 是企业应用里面用于保障数据安全的“钥匙”,每一个应用都有一个独立的访问密钥。
  2. enterprise.wechat.secret="xxx"

Image 3

  1. # 设置 agentid,每个应用都有唯一的 agentid。在管理后台->“应用与小程序”->“应用”,点进某个应用,即可看到 agentid。
  2. enterprise.wechat.agent.id="xxxx"

Image 4

  1. # 设置 userid,多个用逗号分隔。每个成员都有唯一的 userid,即所谓“帐号”。在管理后台->“通讯录”->点进某个成员的详情页,可以看到。
  2. enterprise.wechat.users=zhangsan,lisi

Image 5

  1. # 获取 access_token 的地址,使用如下例子无需修改。
  2. enterprise.wechat.token.url=https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid={corpId}&corpsecret={secret}
  3. # 发送应用消息地址,使用如下例子无需改动。
  4. enterprise.wechat.push.url=https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token={token}
  5. #发送消息格式,无需改动
  6. enterprise.wechat.user.send.msg={\"touser\":\"{toUser}\",\"agentid\":\"{agentId}\",\"msgtype\":\"markdown\",\"markdown\":{\"content\":\"{msg}\"}}
  • 关于 dolphinscheduler 在运行过程中,ip地址获取错误的问题:

    master服务、worker服务在zookeeper注册时,会以ip:port的形式创建相关信息。

    如果ip地址获取错误,请检查网络信息,如linux系统通过ifconfig命令查看网络信息,以下图为例:

    Image 6

如果ip地址获取依然错误,请下载dolphinscheduler-netutils.jar到相应机器,执行以下命令以进一步排障,并反馈给社区开发人员:

  1. java -jar target/dolphinscheduler-netutils.jar