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

[iotdb] 01/01: add solution for network broken when downloading thrift files from github

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

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

commit c8b95000394f737bd73f9eb06e91ae0026827047
Author: xiangdong huang <sa...@gmail.com>
AuthorDate: Tue Nov 3 13:41:08 2020 +0800

    add solution for network broken when downloading thrift files from github
---
 README.md                              |  5 +++++
 README_ZH.md                           |  4 ++++
 docs/Development/ContributeGuide.md    | 13 +++++++++++++
 docs/zh/Development/ContributeGuide.md | 13 +++++++++++++
 4 files changed, 35 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 541d700..b65c9f5 100644
--- a/docs/Development/ContributeGuide.md
+++ b/docs/Development/ContributeGuide.md
@@ -108,3 +108,16 @@ 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;
+* 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..3fdd296 100644
--- a/docs/zh/Development/ContributeGuide.md
+++ b/docs/zh/Development/ContributeGuide.md
@@ -127,3 +127,16 @@ 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`
+
+这一般是网络问题,这时候需要手动下载上述文件:
+
+* 根据上述网址手动下载上述文件;
+* 将该文件拷贝到thrift/target/tools/目录下
+* 重新执行maven的编译命令
+