DolphinScheduler单机部署分为后端部署和前端部署两部分：

1、后端部署

1.1 : 基础软件安装(必装项请自行安装)

• PostgreSQL (8.2.15+) or MySQL (5.7系列) : 两者任选其一即可
• JDK (1.8+) : 必装，请安装好后在/etc/profile下配置 JAVA_HOME 及 PATH 变量
• ZooKeeper (3.4.6+) ：必装
• Hadoop (2.6+) or MinIO ：选装， 如果需要用到资源上传功能，针对单机可以选择本地文件目录作为上传文件夹(此操作不需要部署Hadoop)；当然也可以选择上传到Hadoop or MinIO集群上

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

1.2 : 下载后端tar.gz包

• 请下载最新版本的后端安装包至服务器部署目录,比如创建 /opt/dolphinscheduler 做为安装部署目录，下载地址： 下载 (以1.2.0版本为例)，下载后上传tar包到该目录中，并进行解
• # 创建部署目录,部署目录请不要创建在/root、/home等高权限目录
• mkdir -p /opt/dolphinscheduler;
• cd /opt/dolphinscheduler;
• # 解压缩
• tar -zxvf apache-dolphinscheduler-incubating-1.2.0-dolphinscheduler-backend-bin.tar.gz -C /opt/dolphinscheduler;
• mv apache-dolphinscheduler-incubating-1.2.0-dolphinscheduler-backend-bin dolphinscheduler-backend

1.3：创建部署用户并赋予目录操作权限

• 创建部署用户，并且一定要配置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-backend目录有操作权限
• chown -R dolphinscheduler:dolphinscheduler dolphinscheduler-backend

注意：

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

– 如果发现/etc/sudoers文件中有”Default requiretty”这行，也请注释掉

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

1.4 : 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 是不需要再输入密码的

1.5 : 数据库初始化

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

mysql -uroot -p

• 进入数据库命令行窗口后，执行数据库初始化命令，设置访问账号和密码。注: {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;

• 创建表和导入基础数据
• 修改 conf 目录下 application-dao.properties 中的下列配置

vi conf/application-dao.properties

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

# 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 需要修改ip，本机localhost即可

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

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

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

sh script/create-dolphinscheduler.sh

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

1.6 : 修改运行参数

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

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 PATH=$HADOOP_HOME/bin:$SPARK_HOME2/bin:$PYTHON_HOME:$JAVA_HOME/bin:$HIVE_HOME/bin:$PATH:$FLINK_HOME/bin:$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

• 修改一键部署脚本 install.sh中的各参数，特别注意以下参数的配置

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

sudo mkdir /data/dolphinscheduler

sudo chown -R dolphinscheduler:dolphinscheduler /data/dolphinscheduler

1.7 : 安装python的Zookeeper工具kazoo

• 安装python的 Zookeeper 工具 ，此步骤仅在一键部署时候用到

#安装pip

sudo yum -y install python-pip; #ubuntu请使用 sudo apt-get install python-pip

sudo pip install kazoo;

注意：如果yum没找到python-pip，也可以通过下面方式安装

sudo curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py

sudo python get-pip.py # 如果是python3，使用sudo python3 get-pip.py #然后

sudo pip install kazoo;

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

sh install.sh

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

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

MasterServer —– master服务

WorkerServer —– worker服务

LoggerServer —– logger服务

ApiApplicationServer —– api服务

AlertServer —– alert服务

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

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

logs/

├── dolphinscheduler-alert-server.log

├── dolphinscheduler-master-server.log

|—— dolphinscheduler-worker-server.log

|—— dolphinscheduler-api-server.log

|—— dolphinscheduler-logger-server.log

2、前端部署

请下载最新版本的前端安装包至服务器部署目录，下载地址： 下载 (以1.2.0版本为例)，下载后上传tar包到该目录中，并进行解压

cd /opt/dolphinscheduler;

tar -zxvf apache-dolphinscheduler-incubating-1.2.0-dolphinscheduler-front-bin.tar.gz -C /opt/dolphinscheduler;

mv apache-dolphinscheduler-incubating-1.2.0-dolphinscheduler-front-bin dolphinscheduler-ui

以下两种部署方式任选其一种即可，推荐自动化部署

2.1 自动化部署

• 进入dolphinscheduler-ui目录下执行(注意：自动化部署会自动下载 nginx)

cd dolphinscheduler-ui;

sh ./install-dolphinscheduler-ui.sh;

• 执行后，会在运行中请键入前端端口，默认端口是8888，如果选择默认，请直接回车，或者键入其他端口
• 然后会让键入跟前端ui交互的api-server的ip
• 接着是让键入跟前端ui交互的api-server的port
• 接着是操作系统选择
• 等待部署完成

• 部署完，为防止资源过大无法上传到资源中心,建议修改nginx上传大小参数，具体如下
  • 添加nginx配置 client_max_body_size 1024m，在http方法体内添加即可

vi /etc/nginx/nginx.conf

# add param

client_max_body_size 1024m;

• • 然后重启Nginx服务

systemctl restart nginx

• 访问前端页面地址: http://localhost:8888 ，出现前端登录页面，前端web也安装完成了
• 默认用户名密码：admin/dolphinscheduler123

2.2 手动部署

• 自行安装nginx，去官网下载: http://nginx.org/en/download.html 或者 yum install nginx -y
• 安装文档：https://blog.kgraph.cn/416.html
• 修改nginx配置文件(注意自行修改的几处)
• 然后重启Nginx服务

  systemctl restart nginx
  

• 访问前端页面地址: http://localhost:8888 ，出现前端登录页面，前端web也安装完成了

  默认用户名密码：admin/dolphinscheduler123

  

  3、启停服务

  • 一键停止集群所有服务

    sh ./bin/stop-all.sh

  • 一键开启集群所有服务

    sh ./bin/start-all.sh

  • 启停Master

  sh ./bin/dolphinscheduler-daemon.sh start master-server
  sh ./bin/dolphinscheduler-daemon.sh stop master-server
  

  • 启停Worker

  sh ./bin/dolphinscheduler-daemon.sh start worker-server
  sh ./bin/dolphinscheduler-daemon.sh stop worker-server
  

  • 启停Api

  sh ./bin/dolphinscheduler-daemon.sh start api-server
  sh ./bin/dolphinscheduler-daemon.sh stop api-server
  

  • 启停Logger

  sh ./bin/dolphinscheduler-daemon.sh start logger-server
  sh ./bin/dolphinscheduler-daemon.sh stop logger-server
  

  • 启停Alert

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