Repository: nifi Updated Branches: refs/heads/master b2c68d2b2 -> 13e42678b
NIFI-4338. This closes #2143. add docs for ssl configurations in HDFS processors remove redundant additionalDetails.html and add docs to CapabilityDescription in HDFS processors revert the modified CapabilityDescriptions in HDFS processors and add it to AbstractHadoopProcessor Project: http://git-wip-us.apache.org/repos/asf/nifi/repo Commit: http://git-wip-us.apache.org/repos/asf/nifi/commit/13e42678 Tree: http://git-wip-us.apache.org/repos/asf/nifi/tree/13e42678 Diff: http://git-wip-us.apache.org/repos/asf/nifi/diff/13e42678 Branch: refs/heads/master Commit: 13e42678b64953de593456363fcf3ffb97e00731 Parents: b2c68d2 Author: Takanobu Asanuma <[email protected]> Authored: Thu Sep 14 14:25:15 2017 +0900 Committer: joewitt <[email protected]> Committed: Tue Oct 10 00:17:44 2017 -0400 ---------------------------------------------------------------------- .../hadoop/AbstractHadoopProcessor.java | 3 +- .../nifi/processors/hadoop/DeleteHDFS.java | 2 +- .../additionalDetails.html | 101 +++++++++++++++++++ 3 files changed, 104 insertions(+), 2 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/nifi/blob/13e42678/nifi-nar-bundles/nifi-extension-utils/nifi-hadoop-utils/src/main/java/org/apache/nifi/processors/hadoop/AbstractHadoopProcessor.java ---------------------------------------------------------------------- diff --git a/nifi-nar-bundles/nifi-extension-utils/nifi-hadoop-utils/src/main/java/org/apache/nifi/processors/hadoop/AbstractHadoopProcessor.java b/nifi-nar-bundles/nifi-extension-utils/nifi-hadoop-utils/src/main/java/org/apache/nifi/processors/hadoop/AbstractHadoopProcessor.java index 378dd70..89590fc 100644 --- a/nifi-nar-bundles/nifi-extension-utils/nifi-hadoop-utils/src/main/java/org/apache/nifi/processors/hadoop/AbstractHadoopProcessor.java +++ b/nifi-nar-bundles/nifi-extension-utils/nifi-hadoop-utils/src/main/java/org/apache/nifi/processors/hadoop/AbstractHadoopProcessor.java @@ -67,7 +67,8 @@ public abstract class AbstractHadoopProcessor extends AbstractProcessor { public static final PropertyDescriptor HADOOP_CONFIGURATION_RESOURCES = new PropertyDescriptor.Builder() .name("Hadoop Configuration Resources") .description("A file or comma separated list of files which contains the Hadoop file system configuration. Without this, Hadoop " - + "will search the classpath for a 'core-site.xml' and 'hdfs-site.xml' file or will revert to a default configuration.") + + "will search the classpath for a 'core-site.xml' and 'hdfs-site.xml' file or will revert to a default configuration. " + + "To use swebhdfs, see 'Additional Details' section of PutHDFS's documentation.") .required(false) .addValidator(HadoopValidators.ONE_OR_MORE_FILE_EXISTS_VALIDATOR) .expressionLanguageSupported(true) http://git-wip-us.apache.org/repos/asf/nifi/blob/13e42678/nifi-nar-bundles/nifi-hadoop-bundle/nifi-hdfs-processors/src/main/java/org/apache/nifi/processors/hadoop/DeleteHDFS.java ---------------------------------------------------------------------- diff --git a/nifi-nar-bundles/nifi-hadoop-bundle/nifi-hdfs-processors/src/main/java/org/apache/nifi/processors/hadoop/DeleteHDFS.java b/nifi-nar-bundles/nifi-hadoop-bundle/nifi-hdfs-processors/src/main/java/org/apache/nifi/processors/hadoop/DeleteHDFS.java index 197228a..0fe9dc4 100644 --- a/nifi-nar-bundles/nifi-hadoop-bundle/nifi-hdfs-processors/src/main/java/org/apache/nifi/processors/hadoop/DeleteHDFS.java +++ b/nifi-nar-bundles/nifi-hadoop-bundle/nifi-hdfs-processors/src/main/java/org/apache/nifi/processors/hadoop/DeleteHDFS.java @@ -64,7 +64,7 @@ import com.google.common.collect.Maps; @WritesAttribute(attribute="hdfs.path", description="HDFS Path specified in the delete request"), @WritesAttribute(attribute="hdfs.error.message", description="HDFS error message related to the hdfs.error.code") }) -@SeeAlso({ListHDFS.class}) +@SeeAlso({ListHDFS.class, PutHDFS.class}) public class DeleteHDFS extends AbstractHadoopProcessor { public static final Relationship REL_SUCCESS = new Relationship.Builder() http://git-wip-us.apache.org/repos/asf/nifi/blob/13e42678/nifi-nar-bundles/nifi-hadoop-bundle/nifi-hdfs-processors/src/main/resources/docs/org.apache.nifi.processors.hadoop.PutHDFS/additionalDetails.html ---------------------------------------------------------------------- diff --git a/nifi-nar-bundles/nifi-hadoop-bundle/nifi-hdfs-processors/src/main/resources/docs/org.apache.nifi.processors.hadoop.PutHDFS/additionalDetails.html b/nifi-nar-bundles/nifi-hadoop-bundle/nifi-hdfs-processors/src/main/resources/docs/org.apache.nifi.processors.hadoop.PutHDFS/additionalDetails.html new file mode 100644 index 0000000..a504228 --- /dev/null +++ b/nifi-nar-bundles/nifi-hadoop-bundle/nifi-hdfs-processors/src/main/resources/docs/org.apache.nifi.processors.hadoop.PutHDFS/additionalDetails.html @@ -0,0 +1,101 @@ +<!DOCTYPE html> +<html lang="en"> +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + http://www.apache.org/licenses/LICENSE-2.0 + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + --> + +<head> + <meta charset="utf-8" /> + <title>PutHDFS</title> + <link rel="stylesheet" href="../../../../../css/component-usage.css" type="text/css" /> +</head> + +<body> + <!-- Processor Documentation ================================================== --> + <h2>SSL Configuration:</h2> + <p> + Hadoop provides the ability to configure keystore and/or truststore properties. If you want to use SSL-secured file system like swebhdfs, you can use the Hadoop configurations instead of using SSL Context Service. + <ol> + <li>create 'ssl-client.xml' to configure the truststores.</li> + <p>ssl-client.xml Properties:</p> + <table> + <tr> + <th>Property</th> + <th>Default Value</th> + <th>Explanation</th> + </tr> + <tr> + <td>ssl.client.truststore.type</td> + <td>jks</td> + <td>Truststore file type</td> + </tr> + <tr> + <td>ssl.client.truststore.location</td> + <td>NONE</td> + <td>Truststore file location</td> + </tr> + <tr> + <td>ssl.client.truststore.password</td> + <td>NONE</td> + <td>Truststore file password</td> + </tr> + <tr> + <td>ssl.client.truststore.reload.interval</td> + <td>10000</td> + <td>Truststore reload interval, in milliseconds</td> + </tr> + </table> + + <p>ssl-client.xml Example:</p> + <pre> +<configuration> + <property> + <name>ssl.client.truststore.type</name> + <value>jks</value> + </property> + <property> + <name>ssl.client.truststore.location</name> + <value>/path/to/truststore.jks</value> + </property> + <property> + <name>ssl.client.truststore.password</name> + <value>clientfoo</value> + </property> + <property> + <name>ssl.client.truststore.reload.interval</name> + <value>10000</value> + </property> +</configuration> + </pre> + + <li>put 'ssl-client.xml' to the location looked up in the classpath, like under NiFi conriguration directory.</li> + + <li>set the name of 'ssl-client.xml' to <i>hadoop.ssl.client.conf</i> in the 'core-site.xml' which HDFS processors use.</li> + <pre> +<configuration> + <property> + <name>fs.defaultFS</name> + <value>swebhdfs://{namenode.hostname:port}</value> + </property> + <property> + <name>hadoop.ssl.client.conf</name> + <value>ssl-client.xml</value> + </property> +<configuration> + </pre> + </ol> + </p> +</body> + +</html>
