[jira] [Created] (DRILL-6504) Typos in S3 storage doc pages

["Paul Rogers (JIRA)" <ji...@apache.org>]

Paul Rogers created DRILL-6504:
----------------------------------

             Summary: Typos in S3 storage doc pages
                 Key: DRILL-6504
                 URL: https://issues.apache.org/jira/browse/DRILL-6504
             Project: Apache Drill
          Issue Type: Bug
    Affects Versions: 1.13.0
            Reporter: Paul Rogers
            Assignee: Bridget Bevens


[The documentation for S3 storage|http://drill.apache.org/docs/s3-storage-plugin/] contains a number of minor errors.

"using the S3a library."

Change to "using the HDFS s3a library." (The library is provided via HDFS, not Drill.)

"Drill's previous S3n interface"

Change to "the older HDFS s3n library." (Again, S3 support is provided by HDFS.)

"Starting with version 1.3.0"

Can probably be removed, 1.3 was quite a long time ago.

"To enable Drill's S3a support"

Change to "To enable HDFS s3a support"

"edit the file conf/core-site.xml in your Drill install directory,"

Change to "in the $DRILL_HOME/conf or $DRILL_SITE directory, rename core-site-example.xml to core-site.xml and ..."

Note: once the file is renamed, it the user had $HADOOP_HOME on their path, Hadoop support will break because Drill will pull in the Drill version of core-site.xml rather than the Hadoop one. This will cause tools such as Drill-on-YARN to fail.

In this situation, the user should make the changes in Hadoop's core-site.xml and should not create one for Drill. (In fact, if the user is using Hadoop and want to use S3 with Drill, they probably already had S3 support configured...)

"Point your browser to http://:8047"

Change to "http://<drill-host>:8047, where <drill-host> is a node on which Drill is running."

"Note: on a single machine system, you'll need to run drill-embedded before you can access the web console site"

The general rule is that Drill must be running, whether embedded, in server-mode on the local host, or in a cluster.

"Duplicate the 'dfs' plugin."

This is not necessary. If Drill is local (single server) then it is helpful to allow both local and S3 access. But, if Drill is deployed in a cluster, local file access is problematic. In short, make this section closer to the [HDFS storage|http://drill.apache.org/docs/file-system-storage-plugin/] page.

"you can set this parameter in conf/core-site.xml file in your Drill install directory"

Based on the comments above, change this to: "you can set this parameter in core-site.xml"



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)