wu-sheng closed pull request #1117: FAQ about protoc plugin fails when build
URL: https://github.com/apache/incubator-skywalking/pull/1117
This is a PR merged from a forked repository.
As GitHub hides the original diff on merge, it is displayed below for
the sake of provenance:
As this is a foreign pull request (from a fork), the diff is supplied
below (as it won't show otherwise due to GitHub magic):
diff --git a/docs/README.md b/docs/README.md
index da1e1390b..7336158aa 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -42,4 +42,5 @@
* [Too many GRPC logs in the console](en/FAQ/Too-many-gRPC-logs.md)
* [The trace doesn't continue in kafka consumer
side](en/FAQ/kafka-plugin.md)
* [Agent or collector version upgrade](en/FAQ/Upgrade.md)
+ * [Protoc plugin fails in maven
build](en/FAQ/Protoc-Plugin-Fails-When-Build.md)
diff --git a/docs/README_ZH.md b/docs/README_ZH.md
index d0462f13a..2fde3a268 100644
--- a/docs/README_ZH.md
+++ b/docs/README_ZH.md
@@ -40,3 +40,4 @@
* [Trace查询有数据，但是没有拓扑图和JVM数据?](cn/FAQ/Why-have-traces-no-others-CN.md)
* [加载探针，Console被GRPC日志刷屏](cn/FAQ/Too-many-gRPC-logs-CN.md)
* [Kafka消息消费端链路断裂](cn/FAQ/Kafka-plugin-CN.md)
+ * [Protoc-Plugin Maven编译时异常](cn/FAQ/Protoc-Plugin-Fails-When-Build-CN.md)
diff --git a/docs/cn/FAQ/Protoc-Plugin-Fails-When-Build-CN.md
b/docs/cn/FAQ/Protoc-Plugin-Fails-When-Build-CN.md
new file mode 100644
index 000000000..ea7cca43f
--- /dev/null
+++ b/docs/cn/FAQ/Protoc-Plugin-Fails-When-Build-CN.md
@@ -0,0 +1,11 @@
+现象：
+- maven编译加载protoc-plugins插件产生如下错误：
+```
+[ERROR] Failed to execute goal
org.xolstice.maven.plugins:protobuf-maven-plugin:0.5.0:compile-custom (default)
on project apm-network: Unable to copy the file to
\incubator-skywalking\apm-network\target\protoc-plugins:
\incubator-skywalking\apm-network\target\protoc-plugins\protoc-3.3.0-linux-x86_64.exe
(另一个程序正在使用此文件，进程无法访问。) -> [Help 1]
+```
+
+原因：
+- Protobuf编译器依赖于glibc环境，部分linux操作系统未安装或未升级该函数库会产生该问题。
+
+解决方法：
+-
检查并升级最新版本glibc库，若使用容器镜像环境推荐含有最新版本glibc的alpine系统。请参考官方手册：http://www.gnu.org/software/libc/documentation.html
diff --git a/docs/en/FAQ/Protoc-Plugin-Fails-When-Build.md
b/docs/en/FAQ/Protoc-Plugin-Fails-When-Build.md
new file mode 100644
index 000000000..330b4fffe
--- /dev/null
+++ b/docs/en/FAQ/Protoc-Plugin-Fails-When-Build.md
@@ -0,0 +1,12 @@
+**Problem**：
+- In maven build, the protoc-plugin occurs error:
+```
+[ERROR] Failed to execute goal
org.xolstice.maven.plugins:protobuf-maven-plugin:0.5.0:compile-custom (default)
on project apm-network: Unable to copy the file to
\incubator-skywalking\apm-network\target\protoc-plugins:
\incubator-skywalking\apm-network\target\protoc-plugins\protoc-3.3.0-linux-x86_64.exe
(The process cannot access the file because it is being used by another
process) -> [Help 1]
+```
+
+**Reason**：
+- Protobuf compiler is dependent on the glibc, but it is not-installed or
installed old version in the system.
+
+**Resolve**：
+- Install or upgrade to the latest version of the glibc library. In container
env, recommend using the latest glibc version of the alpine system.
+Please refer to http://www.gnu.org/software/libc/documentation.html
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org
With regards,
Apache Git Services
