You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@flink.apache.org by se...@apache.org on 2015/09/09 20:16:42 UTC
[3/5] flink git commit: [FLINK-2003] [docs] Added instructions for
encrypted filesystems
[FLINK-2003] [docs] Added instructions for encrypted filesystems
This closes #1100
Project: http://git-wip-us.apache.org/repos/asf/flink/repo
Commit: http://git-wip-us.apache.org/repos/asf/flink/commit/4b6eae5a
Tree: http://git-wip-us.apache.org/repos/asf/flink/tree/4b6eae5a
Diff: http://git-wip-us.apache.org/repos/asf/flink/diff/4b6eae5a
Branch: refs/heads/master
Commit: 4b6eae5a612ab1b28b64715acd831dccc0ea6d35
Parents: d0502e4
Author: Theodore Vasiloudis <tv...@sics.se>
Authored: Mon Sep 7 16:25:58 2015 +0200
Committer: Stephan Ewen <se...@apache.org>
Committed: Wed Sep 9 19:10:51 2015 +0200
----------------------------------------------------------------------
docs/setup/building.md | 20 ++++++++++++++++++++
1 file changed, 20 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/flink/blob/4b6eae5a/docs/setup/building.md
----------------------------------------------------------------------
diff --git a/docs/setup/building.md b/docs/setup/building.md
index 2581812..ce59761 100644
--- a/docs/setup/building.md
+++ b/docs/setup/building.md
@@ -122,6 +122,26 @@ Flink is developed against Scala *2.10*, and tested additionally against Scala *
Newer versions may be compatible, depending on breaking changes in the language features used by Flink, and the availability of Flink's dependencies in those Scala versions. The dependencies written in Scala include for example *Kafka*, *Akka*, *Scalatest*, and *scopt*.
+## Building in encrypted filesystems
+
+If your home directory is encrypted you might encounter a `java.io.IOException: File
+name too long` exception. Some encrypted file systems, like encfs used by Ubuntu, do not allow
+long filenames, which is the cause of this error.
+
+The workaround is to add:
+
+~~~xml
+<args>
+ <arg>-Xmax-classfile-name</arg>
+ <arg>128</arg>
+</args>
+~~~
+
+in the compiler configuration of the `pom.xml` file of the module causing the error. For example,
+if the error appears in the `flink-yarn` module, the above code should
+be added under the `<configuration>` tag of `scala-maven-plugin`. See
+[this issue](https://issues.apache.org/jira/browse/FLINK-2003) for more information.
+
## Background
The builds with Maven are controlled by [properties](http://maven.apache.org/pom.html#Properties) and <a href="http://maven.apache.org/guides/introduction/introduction-to-profiles.html">build profiles</a>.