You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@dolphinscheduler.apache.org by ch...@apache.org on 2021/06/03 07:44:57 UTC

[dolphinscheduler-website] branch master updated: add dolphinscheduler network obtaining problem documents and solution (#379)

This is an automated email from the ASF dual-hosted git repository.

chengshiwen 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 2af1eb1  add dolphinscheduler network obtaining problem documents and solution (#379)
2af1eb1 is described below

commit 2af1eb160b54c250de7e78b50b225b16dcc14ce9
Author: Shiwen Cheng <ch...@gmail.com>
AuthorDate: Thu Jun 3 15:44:50 2021 +0800

    add dolphinscheduler network obtaining problem documents and solution (#379)
---
 asset/dolphinscheduler-netutils.jar             | Bin 0 -> 62446 bytes
 docs/zh-cn/1.3.1/user_doc/cluster-deployment.md |  37 ++++++-------------
 docs/zh-cn/1.3.2/user_doc/cluster-deployment.md |  37 ++++++-------------
 docs/zh-cn/1.3.3/user_doc/cluster-deployment.md |  36 ++++++------------
 docs/zh-cn/1.3.4/user_doc/cluster-deployment.md |  47 +++++++++++-------------
 docs/zh-cn/1.3.5/user_doc/cluster-deployment.md |  47 +++++++++++-------------
 docs/zh-cn/1.3.6/user_doc/cluster-deployment.md |  45 ++++++++++++++---------
 site_config/site.js                             |   2 +-
 8 files changed, 108 insertions(+), 143 deletions(-)

diff --git a/asset/dolphinscheduler-netutils.jar b/asset/dolphinscheduler-netutils.jar
new file mode 100644
index 0000000..cc2fbfa
Binary files /dev/null and b/asset/dolphinscheduler-netutils.jar differ
diff --git a/docs/zh-cn/1.3.1/user_doc/cluster-deployment.md b/docs/zh-cn/1.3.1/user_doc/cluster-deployment.md
index 201a6cc..0ff7329 100644
--- a/docs/zh-cn/1.3.1/user_doc/cluster-deployment.md
+++ b/docs/zh-cn/1.3.1/user_doc/cluster-deployment.md
@@ -444,32 +444,19 @@ sh ./bin/dolphinscheduler-daemon.sh stop alert-server
     #发送消息格式,无需改动
     enterprise.wechat.user.send.msg={\"touser\":\"{toUser}\",\"agentid\":\"{agentId}\",\"msgtype\":\"markdown\",\"markdown\":{\"content\":\"{msg}\"}}
    ```
- - 关于dolphinscheduler 在运行过程中,网卡使用说明:
+
+ - 关于 dolphinscheduler 在运行过程中,ip地址获取错误的问题:
  
-   > master服务,worker服务在zookeeper注册时,会以ip:port的形式创建相关信息。
+   > master服务、worker服务在zookeeper注册时,会以ip:port的形式创建相关信息。
      
-      在明确通信网卡情况下,可以指定网卡名称的方式获取ip地址,配置方式是在`common.properties`中修改配置:
-                                                                                                                                                                                                                                                                                                                                                                                                                                                        
-      ```
-      dolphin.scheduler.network.interface.preferred=eth0
-      ```  
-                                                                                                                                                                                                                                                                                                                                                                                                                                                        
-     如linux系统通过`ifconfig`命令查看网络信息,以下图为例,配置eth0就是使用图中eth0的网卡作为通信网卡:
+   如果ip地址获取错误,请检查网络信息,如linux系统通过`ifconfig`命令查看网络信息,以下图为例:
      
-      <p align="center">
-           <img src="/img/network/network_config.png" width="60%" />
-      </p>
-                                       
-     还可以使用dolphinscheduler提供的三种策略,获取可用ip:
+    <p align="center">
+      <img src="/img/network/network_config.png" width="60%" />
+    </p>
    
-      1. default: 优先获取内网网卡获取ip地址,其次获取外网网卡获取ip地址,在前两项失效情况下,使用第一块可用网卡的地址。
-      2. inner: 使用内网网卡获取ip地址,如果获取失败抛出异常信息。
-      3. outer: 使用外网网卡获取ip地址,如果获取失败抛出异常信息。
-      
-      配置方式是在`common.properties`中修改相关配置:
-      
-      ```
-       # Network IP gets priority, default inner outer
-       #dolphin.scheduler.network.priority.strategy=default
-      ```
-      以上配置修改后重启服务生效。                         
+   如果ip地址获取依然错误,请下载[dolphinscheduler-netutils.jar](/asset/dolphinscheduler-netutils.jar)到相应机器,执行以下命令以进一步排障,并反馈给社区开发人员:
+
+   ```
+   java -jar target/dolphinscheduler-netutils.jar
+   ```
diff --git a/docs/zh-cn/1.3.2/user_doc/cluster-deployment.md b/docs/zh-cn/1.3.2/user_doc/cluster-deployment.md
index 992c1c4..9394a19 100644
--- a/docs/zh-cn/1.3.2/user_doc/cluster-deployment.md
+++ b/docs/zh-cn/1.3.2/user_doc/cluster-deployment.md
@@ -444,32 +444,19 @@ sh ./bin/dolphinscheduler-daemon.sh stop alert-server
     #发送消息格式,无需改动
     enterprise.wechat.user.send.msg={\"touser\":\"{toUser}\",\"agentid\":\"{agentId}\",\"msgtype\":\"markdown\",\"markdown\":{\"content\":\"{msg}\"}}
    ```
- - 关于dolphinscheduler 在运行过程中,网卡使用说明:
+
+ - 关于 dolphinscheduler 在运行过程中,ip地址获取错误的问题:
  
-   > master服务,worker服务在zookeeper注册时,会以ip:port的形式创建相关信息。
+   > master服务、worker服务在zookeeper注册时,会以ip:port的形式创建相关信息。
      
-      在明确通信网卡情况下,可以指定网卡名称的方式获取ip地址,配置方式是在`common.properties`中修改配置:
-                                                                                                                                                                                                                                                                                                                                                                                                                                                        
-      ```
-      dolphin.scheduler.network.interface.preferred=eth0
-      ```  
-                                                                                                                                                                                                                                                                                                                                                                                                                                                        
-     如linux系统通过`ifconfig`命令查看网络信息,以下图为例,配置eth0就是使用图中eth0的网卡作为通信网卡:
+   如果ip地址获取错误,请检查网络信息,如linux系统通过`ifconfig`命令查看网络信息,以下图为例:
      
-      <p align="center">
-           <img src="/img/network/network_config.png" width="60%" />
-      </p>
-                                       
-     还可以使用dolphinscheduler提供的三种策略,获取可用ip:
+    <p align="center">
+      <img src="/img/network/network_config.png" width="60%" />
+    </p>
    
-      1. default: 优先获取内网网卡获取ip地址,其次获取外网网卡获取ip地址,在前两项失效情况下,使用第一块可用网卡的地址。
-      2. inner: 使用内网网卡获取ip地址,如果获取失败抛出异常信息。
-      3. outer: 使用外网网卡获取ip地址,如果获取失败抛出异常信息。
-      
-      配置方式是在`common.properties`中修改相关配置:
-      
-      ```
-       # Network IP gets priority, default inner outer
-       #dolphin.scheduler.network.priority.strategy=default
-      ```
-      以上配置修改后重启服务生效。                        
+   如果ip地址获取依然错误,请下载[dolphinscheduler-netutils.jar](/asset/dolphinscheduler-netutils.jar)到相应机器,执行以下命令以进一步排障,并反馈给社区开发人员:
+
+   ```
+   java -jar target/dolphinscheduler-netutils.jar
+   ```
diff --git a/docs/zh-cn/1.3.3/user_doc/cluster-deployment.md b/docs/zh-cn/1.3.3/user_doc/cluster-deployment.md
index 7d9de4a..a62fd07 100644
--- a/docs/zh-cn/1.3.3/user_doc/cluster-deployment.md
+++ b/docs/zh-cn/1.3.3/user_doc/cluster-deployment.md
@@ -444,36 +444,22 @@ sh ./bin/dolphinscheduler-daemon.sh stop alert-server
     #发送消息格式,无需改动
     enterprise.wechat.user.send.msg={\"touser\":\"{toUser}\",\"agentid\":\"{agentId}\",\"msgtype\":\"markdown\",\"markdown\":{\"content\":\"{msg}\"}}
    ```
- - 关于dolphinscheduler 在运行过程中,网卡使用说明:
+
+ - 关于 dolphinscheduler 在运行过程中,ip地址获取错误的问题:
  
-   > master服务,worker服务在zookeeper注册时,会以ip:port的形式创建相关信息。
+   > master服务、worker服务在zookeeper注册时,会以ip:port的形式创建相关信息。
      
-      在明确通信网卡情况下,可以指定网卡名称的方式获取ip地址,配置方式是在`common.properties`中修改配置:
-                                                                                                                                                                                                                                                                                                                                                                                                                                                        
-      ```
-      dolphin.scheduler.network.interface.preferred=eth0
-      ```  
-                                                                                                                                                                                                                                                                                                                                                                                                                                                        
-     如linux系统通过`ifconfig`命令查看网络信息,以下图为例,配置eth0就是使用图中eth0的网卡作为通信网卡:
+   如果ip地址获取错误,请检查网络信息,如linux系统通过`ifconfig`命令查看网络信息,以下图为例:
      
-      <p align="center">
-           <img src="/img/network/network_config.png" width="60%" />
-      </p>
-                                       
-     还可以使用dolphinscheduler提供的三种策略,获取可用ip:
+    <p align="center">
+      <img src="/img/network/network_config.png" width="60%" />
+    </p>
    
-      1. default: 优先获取内网网卡获取ip地址,其次获取外网网卡获取ip地址,在前两项失效情况下,使用第一块可用网卡的地址。
-      2. inner: 使用内网网卡获取ip地址,如果获取失败抛出异常信息。
-      3. outer: 使用外网网卡获取ip地址,如果获取失败抛出异常信息。
-      
-      配置方式是在`common.properties`中修改相关配置:
-      
-      ```
-       # Network IP gets priority, default inner outer
-       #dolphin.scheduler.network.priority.strategy=default
-      ```
-      以上配置修改后重启服务生效。                        
+   如果ip地址获取依然错误,请下载[dolphinscheduler-netutils.jar](/asset/dolphinscheduler-netutils.jar)到相应机器,执行以下命令以进一步排障,并反馈给社区开发人员:
 
+   ```
+   java -jar target/dolphinscheduler-netutils.jar
+   ```
 
  - 配置sudo免密,用于解决默认配置sudo权限过大或不能申请root权限的使用问题
 
diff --git a/docs/zh-cn/1.3.4/user_doc/cluster-deployment.md b/docs/zh-cn/1.3.4/user_doc/cluster-deployment.md
index 4825374..bd3abd1 100644
--- a/docs/zh-cn/1.3.4/user_doc/cluster-deployment.md
+++ b/docs/zh-cn/1.3.4/user_doc/cluster-deployment.md
@@ -444,32 +444,29 @@ sh ./bin/dolphinscheduler-daemon.sh stop alert-server
     #发送消息格式,无需改动
     enterprise.wechat.user.send.msg={\"touser\":\"{toUser}\",\"agentid\":\"{agentId}\",\"msgtype\":\"markdown\",\"markdown\":{\"content\":\"{msg}\"}}
    ```
- - 关于dolphinscheduler 在运行过程中,网卡使用说明:
+
+ - 关于 dolphinscheduler 在运行过程中,ip地址获取错误的问题:
  
-   > master服务,worker服务在zookeeper注册时,会以ip:port的形式创建相关信息。
+   > master服务、worker服务在zookeeper注册时,会以ip:port的形式创建相关信息。
      
-      在明确通信网卡情况下,可以指定网卡名称的方式获取ip地址,配置方式是在`common.properties`中修改配置:
-                                                                                                                                                                                                                                                                                                                                                                                                                                                        
-      ```
-      dolphin.scheduler.network.interface.preferred=eth0
-      ```  
-                                                                                                                                                                                                                                                                                                                                                                                                                                                        
-     如linux系统通过`ifconfig`命令查看网络信息,以下图为例,配置eth0就是使用图中eth0的网卡作为通信网卡:
+   如果ip地址获取错误,请检查网络信息,如linux系统通过`ifconfig`命令查看网络信息,以下图为例:
      
-      <p align="center">
-           <img src="/img/network/network_config.png" width="60%" />
-      </p>
-                                       
-     还可以使用dolphinscheduler提供的三种策略,获取可用ip:
+    <p align="center">
+      <img src="/img/network/network_config.png" width="60%" />
+    </p>
    
-      1. default: 优先获取内网网卡获取ip地址,其次获取外网网卡获取ip地址,在前两项失效情况下,使用第一块可用网卡的地址。
-      2. inner: 使用内网网卡获取ip地址,如果获取失败抛出异常信息。
-      3. outer: 使用外网网卡获取ip地址,如果获取失败抛出异常信息。
-      
-      配置方式是在`common.properties`中修改相关配置:
-      
-      ```
-       # Network IP gets priority, default inner outer
-       #dolphin.scheduler.network.priority.strategy=default
-      ```
-      以上配置修改后重启服务生效。                        
+   如果ip地址获取依然错误,请下载[dolphinscheduler-netutils.jar](/asset/dolphinscheduler-netutils.jar)到相应机器,执行以下命令以进一步排障,并反馈给社区开发人员:
+
+   ```
+   java -jar target/dolphinscheduler-netutils.jar
+   ```
+
+ - 配置sudo免密,用于解决默认配置sudo权限过大或不能申请root权限的使用问题
+
+    配置dolphinscheduler OS账号的sudo权限为部分普通用户范围内的一个普通用户管理者,限制指定用户在指定主机上运行某些命令,详细配置请看sudo权限管理。
+    例如sudo权限管理配置dolphinscheduler OS账号只能操作用户userA,userB,userC的权限(其中用户userA,userB,userC用于多租户向大数据集群提交作业)
+    
+    ```shell
+    echo 'dolphinscheduler  ALL=(userA,userB,userC)  NOPASSWD: NOPASSWD: ALL' >> /etc/sudoers
+    sed -i 's/Defaults    requirett/#Defaults    requirett/g' /etc/sudoers
+    ```
diff --git a/docs/zh-cn/1.3.5/user_doc/cluster-deployment.md b/docs/zh-cn/1.3.5/user_doc/cluster-deployment.md
index 6baab52..d378c4e 100644
--- a/docs/zh-cn/1.3.5/user_doc/cluster-deployment.md
+++ b/docs/zh-cn/1.3.5/user_doc/cluster-deployment.md
@@ -444,32 +444,29 @@ sh ./bin/dolphinscheduler-daemon.sh stop alert-server
     #发送消息格式,无需改动
     enterprise.wechat.user.send.msg={\"touser\":\"{toUser}\",\"agentid\":\"{agentId}\",\"msgtype\":\"markdown\",\"markdown\":{\"content\":\"{msg}\"}}
    ```
- - 关于dolphinscheduler 在运行过程中,网卡使用说明:
+
+ - 关于 dolphinscheduler 在运行过程中,ip地址获取错误的问题:
  
-   > master服务,worker服务在zookeeper注册时,会以ip:port的形式创建相关信息。
+   > master服务、worker服务在zookeeper注册时,会以ip:port的形式创建相关信息。
      
-      在明确通信网卡情况下,可以指定网卡名称的方式获取ip地址,配置方式是在`common.properties`中修改配置:
-                                                                                                                                                                                                                                                                                                                                                                                                                                                        
-      ```
-      dolphin.scheduler.network.interface.preferred=eth0
-      ```  
-                                                                                                                                                                                                                                                                                                                                                                                                                                                        
-     如linux系统通过`ifconfig`命令查看网络信息,以下图为例,配置eth0就是使用图中eth0的网卡作为通信网卡:
+   如果ip地址获取错误,请检查网络信息,如linux系统通过`ifconfig`命令查看网络信息,以下图为例:
      
-      <p align="center">
-           <img src="/img/network/network_config.png" width="60%" />
-      </p>
-                                       
-     还可以使用dolphinscheduler提供的三种策略,获取可用ip:
+    <p align="center">
+      <img src="/img/network/network_config.png" width="60%" />
+    </p>
    
-      1. default: 优先获取内网网卡获取ip地址,其次获取外网网卡获取ip地址,在前两项失效情况下,使用第一块可用网卡的地址。
-      2. inner: 使用内网网卡获取ip地址,如果获取失败抛出异常信息。
-      3. outer: 使用外网网卡获取ip地址,如果获取失败抛出异常信息。
-      
-      配置方式是在`common.properties`中修改相关配置:
-      
-      ```
-       # Network IP gets priority, default inner outer
-       #dolphin.scheduler.network.priority.strategy=default
-      ```
-      以上配置修改后重启服务生效。                        
+   如果ip地址获取依然错误,请下载[dolphinscheduler-netutils.jar](/asset/dolphinscheduler-netutils.jar)到相应机器,执行以下命令以进一步排障,并反馈给社区开发人员:
+
+   ```
+   java -jar target/dolphinscheduler-netutils.jar
+   ```
+
+ - 配置sudo免密,用于解决默认配置sudo权限过大或不能申请root权限的使用问题
+
+    配置dolphinscheduler OS账号的sudo权限为部分普通用户范围内的一个普通用户管理者,限制指定用户在指定主机上运行某些命令,详细配置请看sudo权限管理。
+    例如sudo权限管理配置dolphinscheduler OS账号只能操作用户userA,userB,userC的权限(其中用户userA,userB,userC用于多租户向大数据集群提交作业)
+    
+    ```shell
+    echo 'dolphinscheduler  ALL=(userA,userB,userC)  NOPASSWD: NOPASSWD: ALL' >> /etc/sudoers
+    sed -i 's/Defaults    requirett/#Defaults    requirett/g' /etc/sudoers
+    ```
diff --git a/docs/zh-cn/1.3.6/user_doc/cluster-deployment.md b/docs/zh-cn/1.3.6/user_doc/cluster-deployment.md
index 6c24bd6..4e75547 100644
--- a/docs/zh-cn/1.3.6/user_doc/cluster-deployment.md
+++ b/docs/zh-cn/1.3.6/user_doc/cluster-deployment.md
@@ -444,24 +444,19 @@ sh ./bin/dolphinscheduler-daemon.sh stop alert-server
     #发送消息格式,无需改动
     enterprise.wechat.user.send.msg={\"touser\":\"{toUser}\",\"agentid\":\"{agentId}\",\"msgtype\":\"markdown\",\"markdown\":{\"content\":\"{msg}\"}}
    ```
- - 关于dolphinscheduler 在运行过程中,网卡使用说明:
+
+ - 关于 dolphinscheduler 在运行过程中,ip地址获取错误的问题:
  
-   > master服务,worker服务在zookeeper注册时,会以ip:port的形式创建相关信息。
+   > master服务、worker服务在zookeeper注册时,会以ip:port的形式创建相关信息。
      
-      在明确通信网卡情况下,可以指定网卡名称的方式获取ip地址,配置方式是在`common.properties`中修改配置:
-                                                                                                                                                                                                                                                                                                                                                                                                                                                        
-      ```
-      dolphin.scheduler.network.interface.preferred=eth0
-      ```  
-                                                                                                                                                                                                                                                                                                                                                                                                                                                        
-     如linux系统通过`ifconfig`命令查看网络信息,以下图为例,配置eth0就是使用图中eth0的网卡作为通信网卡:
+   如果ip地址获取错误,请检查网络信息,如linux系统通过`ifconfig`命令查看网络信息,以下图为例:
      
-      <p align="center">
-           <img src="/img/network/network_config.png" width="60%" />
-      </p>
-                                       
-     还可以使用dolphinscheduler提供的三种策略,获取可用ip:
-   
+    <p align="center">
+      <img src="/img/network/network_config.png" width="60%" />
+    </p>
+
+   可以使用dolphinscheduler提供的三种策略,获取可用ip:
+
       1. default: 优先获取内网网卡获取ip地址,其次获取外网网卡获取ip地址,在前两项失效情况下,使用第一块可用网卡的地址。
       2. inner: 使用内网网卡获取ip地址,如果获取失败抛出异常信息。
       3. outer: 使用外网网卡获取ip地址,如果获取失败抛出异常信息。
@@ -469,7 +464,23 @@ sh ./bin/dolphinscheduler-daemon.sh stop alert-server
       配置方式是在`common.properties`中修改相关配置:
       
       ```
-       # Network IP gets priority, default inner outer
+       # network IP gets priority, default: inner outer
        #dolphin.scheduler.network.priority.strategy=default
       ```
-      以上配置修改后重启服务生效。                        
+      以上配置修改后重启服务生效。
+
+   如果ip地址获取依然错误,请下载[dolphinscheduler-netutils.jar](/asset/dolphinscheduler-netutils.jar)到相应机器,执行以下命令以进一步排障,并反馈给社区开发人员:
+
+   ```
+   java -jar target/dolphinscheduler-netutils.jar
+   ```
+
+ - 配置sudo免密,用于解决默认配置sudo权限过大或不能申请root权限的使用问题
+
+    配置dolphinscheduler OS账号的sudo权限为部分普通用户范围内的一个普通用户管理者,限制指定用户在指定主机上运行某些命令,详细配置请看sudo权限管理。
+    例如sudo权限管理配置dolphinscheduler OS账号只能操作用户userA,userB,userC的权限(其中用户userA,userB,userC用于多租户向大数据集群提交作业)
+    
+    ```shell
+    echo 'dolphinscheduler  ALL=(userA,userB,userC)  NOPASSWD: NOPASSWD: ALL' >> /etc/sudoers
+    sed -i 's/Defaults    requirett/#Defaults    requirett/g' /etc/sudoers
+    ```
diff --git a/site_config/site.js b/site_config/site.js
index b9323ed..64f94c6 100644
--- a/site_config/site.js
+++ b/site_config/site.js
@@ -3,7 +3,7 @@ export default {
   rootPath: '', // 发布到服务器的根目录,需以/开头但不能有尾/,如果只有/,请填写空字符串
   port: 8080, // 本地开发服务器的启动端口
   domain: 'dolphinscheduler.apache.org', // 站点部署域名,无需协议和path等
-  copyToDist: ['img', 'file', '.asf.yaml', 'sitemap.xml', '.nojekyll', '.htaccess'], // 当build发布时,需要额外复制到dist目录的资源,默认有:index.html, 404.html, en-us, zh-cn, build
+  copyToDist: ['asset', 'img', 'file', '.asf.yaml', 'sitemap.xml', '.nojekyll', '.htaccess'], // 当build发布时,需要额外复制到dist目录的资源,默认有:index.html, 404.html, en-us, zh-cn, build
   docsLatest: '1.3.6', // docs的最新版本,当docs有多个版本时支持latest访问,空则不启用此特性
   defaultSearch: 'google', // 默认搜索引擎,baidu或者google
   defaultLanguage: 'en-us',