• 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)；当然也可以选择上传到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;
    7. mv apache-dolphinscheduler-incubating-1.3.1-dolphinscheduler-bin  dolphinscheduler-bin
    • 创建部署用户，并且一定要配置sudo免密。以创建dolphinscheduler用户为例
    1. # 创建用户需使用root登录
    2. useradd dolphinscheduler;
    4. # 添加密码
    5. echo "dolphinscheduler" | passwd --stdin dolphinscheduler
    7. # 配置sudo免密
    8. sed -i '$adolphinscheduler  ALL=(ALL)  NOPASSWD: NOPASSWD: ALL' /etc/sudoers
    9. sed -i 's/Defaults    requirett/#Defaults    requirett/g' /etc/sudoers
    11. # 修改目录权限，使得部署用户对dolphinscheduler-bin目录有操作权限
    12. chown -R dolphinscheduler:dolphinscheduler dolphinscheduler-bin
    1.  注意：
    2.      - 因为任务执行服务是以 sudo -u {linux-user} 切换不同linux用户的方式来实现多租户运行作业，所以部署用户需要有 sudo 权限，而且是免密的。初学习者不理解的话，完全可以暂时忽略这一点
    3.      - 如果发现/etc/sudoers文件中有"Default requiretty"这行，也请注释掉
    4.      - 如果用到资源上传的话，还需要给该部署用户分配操作`本地文件系统或者HDFS或者MinIO`的权限
    • 切换到部署用户并配置ssh本机免密登录
    1. su dolphinscheduler;
    3. ssh-keygen -t rsa -P '' -f ~/.ssh/id_rsa
    4. cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys
    5. chmod 600 ~/.ssh/authorized_keys

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

    • 进入数据库，默认数据库是PostgreSQL，如选择MySQL的话，后续需要添加mysql-connector-java驱动包到DolphinScheduler的lib目录下
    1. mysql -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，本机localhost即可
        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 是必须要配置的，没有用到的可以忽略或者注释掉；如果找不到dolphinscheduler_env.sh, 请运行 ls -a

    • 将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"
    4. # 数据库连接地址
    5. dbhost="localhost:3306"
    7. # 数据库名
    8. dbname="dolphinscheduler"
    10. # 数据库用户名，此处需要修改为上面设置的{user}具体值
    11. username="xxx"    
    13. # 数据库密码, 如果有特殊字符，请使用\转义，需要修改为上面设置的{password}具体值
    14. password="xxx"
    16. #Zookeeper地址，单机本机是localhost:2181，记得把2181端口带上
    17. zkQuorum="localhost:2181"
    19. #将DS安装到哪个目录，如: /opt/soft/dolphinscheduler，不同于现在的目录
    20. installPath="/opt/soft/dolphinscheduler"
    22. #使用哪个用户部署，使用第3节创建的用户
    23. deployUser="dolphinscheduler"
    25. # 邮件配置，以qq邮箱为例
    26. # 邮件协议
    27. mailProtocol="SMTP"
    29. # 邮件服务地址
    30. mailServerHost="smtp.qq.com"
    32. # 邮件服务端口
    33. mailServerPort="25"
    35. # mailSender和mailUser配置成一样即可
    36. # 发送者
    37. mailSender="xxx@qq.com"
    39. # 发送用户
    40. mailUser="xxx@qq.com"
    42. # 邮箱密码
    43. mailPassword="xxx"
    45. # TLS协议的邮箱设置为true，否则设置为false
    46. starttlsEnable="true"
    48. # 开启SSL协议的邮箱配置为true，否则为false。注意: starttlsEnable和sslEnable不能同时为true
    49. sslEnable="false"
    51. # 邮件服务地址值，参考上面 mailServerHost
    52. sslTrust="smtp.qq.com"
    54. # 业务用到的比如sql等资源文件上传到哪里，可以设置：HDFS,S3,NONE，单机如果想使用本地文件系统，请配置为HDFS，因为HDFS支持本地文件系统；如果不需要资源上传功能请选择NONE。强调一点：使用本地文件系统不需要部署hadoop
    55. resourceStorageType="HDFS"
    57. # 这里以保存到本地文件系统为例
    58. # 如果上传资源保存想保存在hadoop上，hadoop集群的NameNode启用了HA的话，需要将hadoop的配置文件core-site.xml和hdfs-site.xml放到安装路径(上面的installPath)的conf目录下，本例即是放到/opt/soft/dolphinscheduler/conf下面，并配置namenode cluster名称；如果NameNode不是HA,则只需要将mycluster修改为具体的ip或者主机名即可
    59. defaultFS="file:///data/dolphinscheduler"    #hdfs://{具体的ip/主机名}:8020
    61. # 如果没有使用到Yarn,保持以下默认值即可；如果ResourceManager是HA，则配置为ResourceManager节点的主备ip或者hostname,比如"192.168.xx.xx,192.168.xx.xx";如果是单ResourceManager请配置yarnHaIps=""即可
    62. # 注：依赖于yarn执行的任务，为了保证执行结果判断成功,需要确保yarn信息配置正确。
    63. yarnHaIps="192.168.xx.xx,192.168.xx.xx"
    65. # 如果ResourceManager是HA或者没有使用到Yarn保持默认值即可；如果是单ResourceManager，请配置真实的ResourceManager主机名或者ip
    66. singleYarnIp="yarnIp1"
    68. # 资源上传根路径,支持HDFS和S3,由于hdfs支持本地文件系统，需要确保本地文件夹存在且有读写权限
    69. resourceUploadPath="/data/dolphinscheduler"
    71. # 具备权限创建resourceUploadPath的用户
    72. hdfsRootUser="hdfs"
    74. #在哪些机器上部署DS服务，本机选localhost
    75. ips="localhost"
    77. #ssh端口,默认22
    78. sshPort="22"
    80. #master服务部署在哪台机器上
    81. masters="localhost"
    83. #worker服务部署在哪台机器上,并指定此worker属于哪一个worker组,下面示例的default即为组名
    84. workers="localhost:default"
    86. #报警服务部署在哪台机器上
    87. alertServer="localhost"
    89. #后端api服务部署在在哪台机器上
    90. apiServers="localhost"

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

    1. sudo mkdir /data/dolphinscheduler
    2. sudo chown -R dolphinscheduler:dolphinscheduler /data/dolphinscheduler

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

      sh install.sh

      1.   注意：
      2.   第一次部署的话，在运行中第3步`3,stop server`出现5次以下信息，此信息可以忽略
      3.   sh: bin/dolphinscheduler-daemon.sh: No such file or directory

    • 脚本完成后，会启动以下5个服务，使用jps命令查看服务是否启动(jps为java 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

    • 一键停止集群所有服务

      sh ./bin/stop-all.sh

    • 一键开启集群所有服务

      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

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