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: [
           {