[
https://issues.apache.org/jira/browse/HDDS-1971?focusedWorklogId=295898&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-295898
]
ASF GitHub Bot logged work on HDDS-1971:
----------------------------------------
Author: ASF GitHub Bot
Created on: 16/Aug/19 00:30
Start Date: 16/Aug/19 00:30
Worklog Time Spent: 10m
Work Description: bharatviswa504 commented on pull request #1306:
HDDS-1971. Update document for HDDS-1891: Ozone fs shell command should work
with default port when port number is not specified
URL: https://github.com/apache/hadoop/pull/1306#discussion_r314547870
##########
File path: hadoop-hdds/docs/content/interface/OzoneFS.md
##########
@@ -77,13 +77,39 @@ Or put command etc. In other words, all programs like
Hive, Spark, and Distcp wi
Please note that any keys created/deleted in the bucket using methods apart
from OzoneFileSystem will show up as directories and files in the Ozone File
System.
Note: Bucket and volume names are not allowed to have a period in them.
-Moreover, the filesystem URI can take a fully qualified form with the OM host
and port as a part of the path following the volume name.
-For example,
+Moreover, the filesystem URI can take a fully qualified form with the OM host
and an optional port as a part of the path following the volume name.
+For example, you can specify both host and port:
{{< highlight bash>}}
hdfs dfs -ls o3fs://bucket.volume.om-host.example.com:5678/key
{{< /highlight >}}
+When the port number is not specified, it will be retrieved from config key
`ozone.om.address`.
+For example, we have `ozone.om.address` configured as following in
`ozone-site.xml`:
+
+{{< highlight xml >}}
+ <property>
+ <name>ozone.om.address</name>
+ <value>0.0.0.0:6789</value>
+ </property>
+{{< /highlight >}}
+
+When we run command:
+
+{{< highlight bash>}}
+hdfs dfs -ls o3fs://bucket.volume.om-host.example.com/key
+{{< /highlight >}}
+
+The above command is essentially equivalent to:
+
+{{< highlight bash>}}
+hdfs dfs -ls o3fs://bucket.volume.om-host.example.com:6789/key
+{{< /highlight >}}
+
+Note only the port number in the config is relevant. The host name in config
`ozone.om.address` is ignored in this case.
Review comment:
Can we reword this as:
Note: In the above case, port number from the config is used, whereas
hostname in the config `ozone.om.address` is ignored.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
[email protected]
Issue Time Tracking
-------------------
Worklog Id: (was: 295898)
Time Spent: 20m (was: 10m)
> Update document for HDDS-1891: Ozone fs shell command should work with
> default port when port number is not specified
> ---------------------------------------------------------------------------------------------------------------------
>
> Key: HDDS-1971
> URL: https://issues.apache.org/jira/browse/HDDS-1971
> Project: Hadoop Distributed Data Store
> Issue Type: Task
> Components: documentation
> Reporter: Siyao Meng
> Assignee: Siyao Meng
> Priority: Major
> Labels: pull-request-available
> Time Spent: 20m
> Remaining Estimate: 0h
>
> This should've been part of HDDS-1891.
> Now that fs shell command works without specifying a default OM port number.
> We should update the doc on
> https://hadoop.apache.org/ozone/docs/0.4.0-alpha/ozonefs.html:
> {code}
> ... Moreover, the filesystem URI can take a fully qualified form with the OM
> host and port as a part of the path following the volume name.
> {code}
> CC [~bharatviswa]
--
This message was sent by Atlassian JIRA
(v7.6.14#76016)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
