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)
