You are viewing a plain text version of this content. The canonical link for it is here.
Posted to common-commits@hadoop.apache.org by bh...@apache.org on 2019/08/19 01:29:58 UTC
[hadoop] branch trunk updated: HDDS-1971. Update document for
HDDS-1891: Ozone fs shell command should work with default port when port
number is not specified (#1306)
This is an automated email from the ASF dual-hosted git repository.
bharat pushed a commit to branch trunk
in repository https://gitbox.apache.org/repos/asf/hadoop.git
The following commit(s) were added to refs/heads/trunk by this push:
new 12c7084 HDDS-1971. Update document for HDDS-1891: Ozone fs shell command should work with default port when port number is not specified (#1306)
12c7084 is described below
commit 12c7084be3b03be81cdb688c911798d52dcfc160
Author: Siyao Meng <50...@users.noreply.github.com>
AuthorDate: Sun Aug 18 18:29:52 2019 -0700
HDDS-1971. Update document for HDDS-1891: Ozone fs shell command should work with default port when port number is not specified (#1306)
---
hadoop-hdds/docs/content/interface/OzoneFS.md | 30 +++++++++++++++++++++++++--
1 file changed, 28 insertions(+), 2 deletions(-)
diff --git a/hadoop-hdds/docs/content/interface/OzoneFS.md b/hadoop-hdds/docs/content/interface/OzoneFS.md
index 310b41d..6863b46 100644
--- a/hadoop-hdds/docs/content/interface/OzoneFS.md
+++ b/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`
+if defined; or it will fall back to the default port `9862`.
+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 port number from the config is used in this case,
+whereas the host name in the config `ozone.om.address` is ignored.
+
## Supporting older Hadoop version (Legacy jar, BasicOzoneFilesystem)
---------------------------------------------------------------------
To unsubscribe, e-mail: common-commits-unsubscribe@hadoop.apache.org
For additional commands, e-mail: common-commits-help@hadoop.apache.org