You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@iotdb.apache.org by qi...@apache.org on 2020/11/03 07:12:44 UTC

[iotdb] branch master updated: add solution for network broken when downloading thrift files from github (#1921)

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

qiaojialin pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/iotdb.git


The following commit(s) were added to refs/heads/master by this push:
     new 6e67357  add solution for network broken when downloading thrift files from github (#1921)
6e67357 is described below

commit 6e67357bdcc29cbc90769500723c0f68a54b5aac
Author: Xiangdong Huang <hx...@apache.org>
AuthorDate: Tue Nov 3 15:12:35 2020 +0800

    add solution for network broken when downloading thrift files from github (#1921)
---
 README.md                              |  5 +++++
 README_ZH.md                           |  4 ++++
 docs/Development/ContributeGuide.md    | 15 +++++++++++++++
 docs/zh/Development/ContributeGuide.md | 15 +++++++++++++++
 4 files changed, 39 insertions(+)

diff --git a/README.md b/README.md
index be83178..0b35840 100644
--- a/README.md
+++ b/README.md
@@ -131,6 +131,7 @@ Then the binary version (including both server and cli) can be found at **distri
 
 > NOTE: Directories "thrift/target/generated-sources/thrift" and "antlr/target/generated-sources/antlr4" need to be added to sources roots to avoid compilation errors in the IDE.
 
+
 ### Configurations
 
 configuration files are under "conf" folder
@@ -384,3 +385,7 @@ Time,root.fit.d1.s1,root.fit.d1.s2,root.fit.d2.s1,root.fit.d2.s3,root.fit.p.s1
 ```
 select * from root.fit.d1
 ```
+
+
+# Frequent Questions for Compiling
+see [Frequent Questions when Compiling the Source Code](https://iotdb.apache.org/Development/ContributeGuide.html#_Frequent-Questions-when-Compiling-the-Source-Code)
diff --git a/README_ZH.md b/README_ZH.md
index e7772bd..9545377 100644
--- a/README_ZH.md
+++ b/README_ZH.md
@@ -387,3 +387,7 @@ Time,root.fit.d1.s1,root.fit.d1.s2,root.fit.d2.s1,root.fit.d2.s3,root.fit.p.s1
 ```
 select * from root.fit.d1
 ```
+
+
+# 常见编译错误
+see [Frequent Questions when Compiling the Source Code](https://iotdb.apache.org/zh/Development/ContributeGuide.html#%E5%B8%B8%E8%A7%81%E7%BC%96%E8%AF%91%E9%94%99%E8%AF%AF)
diff --git a/docs/Development/ContributeGuide.md b/docs/Development/ContributeGuide.md
index 2d57c1f..06f2da6 100644
--- a/docs/Development/ContributeGuide.md
+++ b/docs/Development/ContributeGuide.md
@@ -110,3 +110,18 @@ Recommended Use Intellij idea. ```mvn clean package -DskipTests``` After putting
 
 * Storage engine org.apache.iotdb.db.engine.StorageEngine
 * Query engine org.apache.iotdb.db.qp.QueryProcessor
+
+
+## Frequent Questions when Compiling the Source Code
+
+1. I could not download thrift-* tools, like `Could not get content
+org.apache.maven.wagon.TransferFailedException: Transfer failed for https://github.com/jt2594838/mvn-thrift-compiler/raw/master/thrift_0.12.0_0.13.0_linux.exe`
+
+It is due to some network problems (especially in China), you can:
+
+* Download the file from the URL manually;
+  * https://github.com/jt2594838/mvn-thrift-compiler/blob/master/thrift_0.12.0_0.13.0_mac.exe
+  * https://github.com/jt2594838/mvn-thrift-compiler/raw/master/thrift_0.12.0_0.13.0_mac.exe
+* Put the file to thrift/target/tools/
+* Re-run maven command like `mvn compile`
+
diff --git a/docs/zh/Development/ContributeGuide.md b/docs/zh/Development/ContributeGuide.md
index 6cdbd87..a978393 100644
--- a/docs/zh/Development/ContributeGuide.md
+++ b/docs/zh/Development/ContributeGuide.md
@@ -127,3 +127,18 @@ import -> Maven -> Existing Maven Projects
 * 存储引擎 org.apache.iotdb.db.engine.StorageEngine
 * 查询引擎 org.apache.iotdb.db.qp.Planner
 
+
+
+## 常见编译错误
+
+1. 无法下载 thrift-* 等文件, 例如 `Could not get content
+org.apache.maven.wagon.TransferFailedException: Transfer failed for https://github.com/jt2594838/mvn-thrift-compiler/raw/master/thrift_0.12.0_0.13.0_linux.exe`
+
+这一般是网络问题,这时候需要手动下载上述文件:
+
+* 根据以下网址手动下载上述文件;
+  * https://github.com/jt2594838/mvn-thrift-compiler/blob/master/thrift_0.12.0_0.13.0_mac.exe
+  * https://github.com/jt2594838/mvn-thrift-compiler/raw/master/thrift_0.12.0_0.13.0_mac.exe
+* 将该文件拷贝到thrift/target/tools/目录下
+* 重新执行maven的编译命令
+