You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@dolphinscheduler.apache.org by li...@apache.org on 2021/06/29 04:03:15 UTC
[dolphinscheduler-website] branch master updated: #5608 move the
Doc of Ambari Integration to official website repository (#389)
This is an automated email from the ASF dual-hosted git repository.
lidongdai pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/dolphinscheduler-website.git
The following commit(s) were added to refs/heads/master by this push:
new d068f49 #5608 move the Doc of Ambari Integration to official website repository (#389)
d068f49 is described below
commit d068f49cc3235a444133856dcf438b2057eabbd3
Author: kevinfujiang <ke...@gmail.com>
AuthorDate: Tue Jun 29 12:03:10 2021 +0800
#5608 move the Doc of Ambari Integration to official website repository (#389)
* move the Doc of Ambari Integration to official website repository
* File extension changed from html to md.
* Update docs/en-us/1.3.6/user_doc/ambari-integration.md
Co-authored-by: QuakeWang <45...@users.noreply.github.com>
* Update docs/en-us/1.3.6/user_doc/ambari-integration.md
Co-authored-by: QuakeWang <45...@users.noreply.github.com>
* Update ambari-integration.md
* Update docs/en-us/1.3.6/user_doc/ambari-integration.md
Co-authored-by: QuakeWang <45...@users.noreply.github.com>
Co-authored-by: 徐小荣 <xi...@ruisdata.com>
Co-authored-by: dailidong <da...@gmail.com>
Co-authored-by: QuakeWang <45...@users.noreply.github.com>
---
docs/en-us/1.3.6/user_doc/ambari-integration.md | 132 ++++++++++++++++++++++++
site_config/docs1-3-6.js | 9 ++
2 files changed, 141 insertions(+)
diff --git a/docs/en-us/1.3.6/user_doc/ambari-integration.md b/docs/en-us/1.3.6/user_doc/ambari-integration.md
new file mode 100644
index 0000000..25a22fb
--- /dev/null
+++ b/docs/en-us/1.3.6/user_doc/ambari-integration.md
@@ -0,0 +1,132 @@
+### Instructions for using the DolphinScheduler's Ambari plug-in
+
+#### Note
+
+1. This document is intended for users with a basic understanding of Ambari
+2. This document is a description of adding the DolphinScheduler service to the installed Ambari service
+3. This document is based on version 2.5.2 of Ambari
+
+#### Installation preparation
+
+1. Prepare the RPM packages
+
+ - It is generated by executing the command ```mvn -U clean install -Prpmbuild -Dmaven.test.skip=true -X``` in the project root directory (In the directory: dolphinscheduler-dist/target/rpm/apache-dolphinscheduler/RPMS/noarch )
+
+2. Create an installation for DS,who have read and write access to the installation directory (/opt/soft)
+
+3. Install with rpm package
+
+ - Manual installation (recommended):
+ - Copy the prepared RPM packages to each node of the cluster.
+ - Execute with DS installation user: ```rpm -ivh apache-dolphinscheduler-xxx.noarch.rpm```
+ - Mysql-connector-java packaged using the default POM file will not be included.
+ - The RPM package was packaged in the project with the installation path of /opt/soft.
+ If you use mysql as the database, you need add it manually.
+
+ - Automatic installation with ambari
+ - Each node of the cluster needs to be configured the local yum source
+ - Copy the prepared RPM packages to each node local yum source
+
+4. Copy plug-in directory
+
+ - copy directory ambari_plugin/common-services/DOLPHIN to ambari-server/resources/common-services/
+ - copy directory ambari_plugin/statcks/DOLPHIN to ambari-server/resources/stacks/HDP/2.6/services/--stack version is selected based on the actual situation
+
+5. Initializes the database information
+
+ ```
+ -- Create the database for the DolphinScheduler:dolphinscheduler
+ CREATE DATABASE dolphinscheduler DEFAULT CHARACTER SET utf8 DEFAULT COLLATE
+ utf8_general_ci;
+
+ -- Initialize the user and password for the dolphinscheduler database and assign permissions
+ -- Replace the {user} in the SQL statement below with the user of the dolphinscheduler database
+ GRANT ALL PRIVILEGES ON dolphinscheduler.* TO '{user}'@'%' IDENTIFIED BY '{password}';
+ GRANT ALL PRIVILEGES ON dolphinscheduler.* TO '{user}'@'localhost' IDENTIFIED BY
+ '{password}';
+ flush privileges;
+ ```
+
+
+
+#### Ambari Install DolphinScheduler
+- **NOTE: You have to install zookeeper first**
+
+1. Install DolphinScheduler on ambari web interface
+
+ ![](https://dolphinscheduler.apache.org/img/ambari-plugin/DS2_AMBARI_001.png)
+
+2. Select the nodes for the DolphinScheduler's Master installation
+
+ ![](https://dolphinscheduler.apache.org/img/ambari-plugin/DS2_AMBARI_002.png)
+
+3. Configure the DolphinScheduler's nodes for Worker, Api, Logger, Alert installation
+
+ ![](https://dolphinscheduler.apache.org/img/ambari-plugin/DS2_AMBARI_003.png)
+
+4. Set the installation users of the DolphinScheduler service (created in step 1) and the user groups they belong to
+
+ ![](https://dolphinscheduler.apache.org/img/ambari-plugin/DS2_AMBARI_004.png)
+
+5. System Env Optimization will export some system environment config. Modify according to actual situation
+
+ ![](https://dolphinscheduler.apache.org/img/ambari-plugin/DS2_AMBARI_020.png)
+
+6. Configure the database information (same as in the initialization database in step 1)
+
+ ![](https://dolphinscheduler.apache.org/img/ambari-plugin/DS2_AMBARI_005.png)
+
+7. Configure additional information if needed
+
+ ![](https://dolphinscheduler.apache.org/img/ambari-plugin/DS2_AMBARI_006.png)
+
+ ![](https://dolphinscheduler.apache.org/img/ambari-plugin/DS2_AMBARI_007.png)
+
+8. Perform the next steps as normal
+
+ ![](https://dolphinscheduler.apache.org/img/ambari-plugin/DS2_AMBARI_008.png)
+
+9. The interface after successful installation
+
+ ![](https://dolphinscheduler.apache.org/img/ambari-plugin/DS2_AMBARI_009.png)
+
+
+
+------
+
+
+
+#### Add components to the node through Ambari -- for example, add a DS Worker
+
+***NOTE***: DS Logger is the installation dependent component of DS Worker in Dolphin's Ambari installation (need to add installation first; Prevent the Job log on the corresponding Worker from being checked)
+
+1. Locate the component node to add -- for example, node ark3
+
+ ![DS2_AMBARI_011](https://dolphinscheduler.apache.org/img/ambari-plugin/DS2_AMBARI_011.png)
+
+2. Add components -- the drop-down list is all addable
+
+ ![DS2_AMBARI_012](https://dolphinscheduler.apache.org/img/ambari-plugin/DS2_AMBARI_012.png)
+
+3. Confirm component addition
+
+ ![DS2_AMBARI_013](https://dolphinscheduler.apache.org/img/ambari-plugin/DS2_AMBARI_013.png)
+
+4. After adding DS Worker and DS Logger components
+
+ ![DS2_AMBARI_015](https://dolphinscheduler.apache.org/img/ambari-plugin/DS2_AMBARI_015.png)
+
+5. Start the component
+
+ ![DS2_AMBARI_016](https://dolphinscheduler.apache.org/img/ambari-plugin/DS2_AMBARI_016.png)
+
+
+#### Remove the component from the node with Ambari
+
+1. Stop the component in the corresponding node
+
+ ![DS2_AMBARI_018](https://dolphinscheduler.apache.org/img/ambari-plugin/DS2_AMBARI_018.png)
+
+2. Remove components
+
+ ![DS2_AMBARI_019](https://dolphinscheduler.apache.org/img/ambari-plugin/DS2_AMBARI_019.png)
diff --git a/site_config/docs1-3-6.js b/site_config/docs1-3-6.js
index c8e8f32..b9081ac 100644
--- a/site_config/docs1-3-6.js
+++ b/site_config/docs1-3-6.js
@@ -73,6 +73,15 @@ export default {
],
},
{
+ title: "Integration",
+ children: [
+ {
+ title: 'Ambari Integration',
+ link: '/en-us/docs/1.3.6/user_doc/ambari-integration.html',
+ },
+ ],
+ },
+ {
title: 'Upgrade',
children: [
{