diff --git a/docs/README.md b/docs/README.md index da1e1390b4033a5df073087b9cf11e35aed629bf..7336158aa3881b8019f41775bed48f0e542f1806 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 d0462f13a14fd30d8c77598b3d2127bffe3ef9a9..2fde3a268f4cd7657807c46505176cbce597352b 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 0000000000000000000000000000000000000000..ea7cca43f8ab0eb15909a5d5dda4eca40cec8f5f --- /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 0000000000000000000000000000000000000000..330b4fffe693c68f9bdfc3630306628358bd2423 --- /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