This project is a wrapper around Hadoop's swift native file system. By pulling a smaller dependency tree and shading all dependencies away, this keeps the appearance of Flink being Hadoop-free, from a dependency perspective.

We also relocate the shaded Hadoop version to allow running in a different setup. For this to work, however, we needed to adapt Hadoop's Configuration class to load a (shaded) core-default-shaded.xml configuration with the relocated class names of classes loaded via reflection (in the future, we may need to extend this to mapred-default.xml and hdfs-defaults.xml and their respective configuration classes).

Changing the Hadoop Version

If you want to change the Hadoop version this project depends on, the following steps are required to keep the shading correct:

1. from the respective Hadoop jar (currently 2.8.1 as of the openstackhadoop.hadoop.version property our pom.xml),

• copy org/apache/hadoop/conf/Configuration.java to src/main/java/org/apache/hadoop/conf/ and
  • replace core-default.xml with core-default-shaded.xml.
• copy org/apache/hadoop/util/NativeCodeLoader.java to src/main/java/org/apache/hadoop/util/ and
  • replace the static initializer with

  static {
    LOG.info("Skipping native-hadoop library for flink-openstack-fs-hadoop's relocated Hadoop... " +
           "using builtin-java classes where applicable");
  }
  

• copy core-default.xml to src/main/resources/core-default-shaded.xml and
  • change every occurrence of org.apache.hadoop into org.apache.flink.fs.openstackhadoop.shaded.org.apache.hadoop
• copy core-site.xml to src/test/resources/core-site.xml (as is)

2. verify the shaded jar:

• does not contain any unshaded classes except for org.apache.hadoop.fs.swift.snative.SwiftNativeFileSystem
• all other classes should be under org.apache.flink.fs.openstackhadoop.shaded
• there should be a META-INF/services/org.apache.flink.core.fs.FileSystemFactory file pointing to the org.apache.flink.fs.openstackhadoop.SwiftFileSystemFactory class
• other service files under META-INF/services should have their names and contents in the relocated org.apache.flink.fs.swifthadoop.shaded package
• contains a core-default-shaded.xml file
• does not contain a core-default.xml or core-site.xml file