Added docmentation about workaround for clang build errors. (#8867)
* Added docmentation about workaround for clang build errors. * Update packaging/installer/methods/manual.md Co-authored-by: Joel Hans <joel.g.hans@gmail.com> Co-authored-by: Joel Hans <joel.g.hans@gmail.com>
Austin S. Hemmelgarn committed
May 4, 2020 at 08:52 UTC
a325c20b7d13479173902f0495f6f403482b83f6
1 file changed
+8
packaging/installer/methods/manual.md
+8
@@ -206,6 +206,14 @@ You can edit this file to set options. One common option to tweak is `history`,
206
207
To apply the changes you made, you have to restart Netdata.
208
209
+### 'nonrepresentable section on output' errors
210
+
211
+Our current build process unfortunately has some issues when using certain configurations of the `clang` C compiler on Linux.
212
+
213
+If the installation fails with errors like `/bin/ld: externaldeps/libwebsockets/libwebsockets.a(context.c.o): relocation R_X86_64_32 against '.rodata.str1.1' can not be used when making a PIE object; recompile with -fPIC`, and you are trying to build with `clang` on Linux, you will need to build Netdata using GCC to get a fully functional install.
214
+
215
+In most cases, you can do this by running `CC=gcc ./netdata-installer.sh`.
216
+
217
## What's next?
218
219
When you finish installing Netdata, be sure to visit our [step-by-step tutorial](../../../docs/step-by-step/step-00.md)