Details

    • Type: Sub-task
    • Status: Closed
    • Priority: Minor
    • Resolution: Fixed
    • Affects Version/s: 2.7.0
    • Fix Version/s: 2.7.0
    • Component/s: documentation
    • Labels:
      None
    • Target Version/s:
    • Hadoop Flags:
      Reviewed

      Description

      The JIRA is to further update user doc for truncate, for example, WebHDFS and so on.

      1. HDFS-7760.patch
        2 kB
        Konstantin Shvachko
      2. HDFS-7760-02.patch
        2 kB
        Konstantin Shvachko

        Activity

        Hide
        shv Konstantin Shvachko added a comment -

        Yi, I was planning to add this into HDFS-7665, then saw this jira. It makes sense to split the two documentation changes since this one is in HDFS and the other is in common. Hope you don't mind.

        Show
        shv Konstantin Shvachko added a comment - Yi, I was planning to add this into HDFS-7665 , then saw this jira. It makes sense to split the two documentation changes since this one is in HDFS and the other is in common. Hope you don't mind.
        Hide
        hitliuyi Yi Liu added a comment -

        Sure, thanks Konstantin Shvachko.

        The patch looks good, just one comment:
        We need to define following NewLength

        ** {NewLength}
        
        *----------------+-------------------------------------------------------------------+
        || Name          | <<<newlength>>> |
        *----------------+-------------------------------------------------------------------+
        || Description   | The size the file is to be truncated to. |
        *----------------+-------------------------------------------------------------------+
        || Type          | long |
        *----------------+-------------------------------------------------------------------+
        || Valid Values  | \>= 0 |
        *----------------+-------------------------------------------------------------------+
        || Syntax        | Any long. |
        *----------------+-------------------------------------------------------------------+
        

        And change following to newlength

        +  See also:
        +  {{{Length}<<<length>>>}},
        +  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.truncate
        
        Show
        hitliuyi Yi Liu added a comment - Sure, thanks Konstantin Shvachko . The patch looks good, just one comment: We need to define following NewLength ** {NewLength} *----------------+-------------------------------------------------------------------+ || Name | <<<newlength>>> | *----------------+-------------------------------------------------------------------+ || Description | The size the file is to be truncated to. | *----------------+-------------------------------------------------------------------+ || Type | long | *----------------+-------------------------------------------------------------------+ || Valid Values | \>= 0 | *----------------+-------------------------------------------------------------------+ || Syntax | Any long . | *----------------+-------------------------------------------------------------------+ And change following to newlength + See also: + {{{Length}<<<length>>>}}, + {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.truncate
        Hide
        hadoopqa Hadoop QA added a comment -

        -1 overall. Here are the results of testing the latest attachment
        http://issues.apache.org/jira/secure/attachment/12697862/HDFS-7760.patch
        against trunk revision 3f5431a.

        +1 @author. The patch does not contain any @author tags.

        +0 tests included. The patch appears to be a documentation patch that doesn't require tests.

        +1 javac. The applied patch does not increase the total number of javac compiler warnings.

        +1 javadoc. There were no new javadoc warning messages.

        +1 eclipse:eclipse. The patch built with eclipse:eclipse.

        -1 findbugs. The patch appears to introduce 1 new Findbugs (version 2.0.3) warnings.

        +1 release audit. The applied patch does not increase the total number of release audit warnings.

        +1 core tests. The patch passed unit tests in hadoop-hdfs-project/hadoop-hdfs.

        Test results: https://builds.apache.org/job/PreCommit-HDFS-Build/9521//testReport/
        Findbugs warnings: https://builds.apache.org/job/PreCommit-HDFS-Build/9521//artifact/patchprocess/newPatchFindbugsWarningshadoop-hdfs.html
        Console output: https://builds.apache.org/job/PreCommit-HDFS-Build/9521//console

        This message is automatically generated.

        Show
        hadoopqa Hadoop QA added a comment - -1 overall . Here are the results of testing the latest attachment http://issues.apache.org/jira/secure/attachment/12697862/HDFS-7760.patch against trunk revision 3f5431a. +1 @author . The patch does not contain any @author tags. +0 tests included . The patch appears to be a documentation patch that doesn't require tests. +1 javac . The applied patch does not increase the total number of javac compiler warnings. +1 javadoc . There were no new javadoc warning messages. +1 eclipse:eclipse . The patch built with eclipse:eclipse. -1 findbugs . The patch appears to introduce 1 new Findbugs (version 2.0.3) warnings. +1 release audit . The applied patch does not increase the total number of release audit warnings. +1 core tests . The patch passed unit tests in hadoop-hdfs-project/hadoop-hdfs. Test results: https://builds.apache.org/job/PreCommit-HDFS-Build/9521//testReport/ Findbugs warnings: https://builds.apache.org/job/PreCommit-HDFS-Build/9521//artifact/patchprocess/newPatchFindbugsWarningshadoop-hdfs.html Console output: https://builds.apache.org/job/PreCommit-HDFS-Build/9521//console This message is automatically generated.
        Hide
        shv Konstantin Shvachko added a comment -

        I thought it is the definition of length. newLength is not optional in truncate so the null values are not applicable here. And the rest is the same.

        Show
        shv Konstantin Shvachko added a comment - I thought it is the definition of length . newLength is not optional in truncate so the null values are not applicable here. And the rest is the same.
        Hide
        shv Konstantin Shvachko added a comment -

        Sorry, you are right, need to add newlength definition as it belongs to the Parameter Dictionary. Done.

        Show
        shv Konstantin Shvachko added a comment - Sorry, you are right, need to add newlength definition as it belongs to the Parameter Dictionary. Done.
        Hide
        hadoopqa Hadoop QA added a comment -

        -1 overall. Here are the results of testing the latest attachment
        http://issues.apache.org/jira/secure/attachment/12698023/HDFS-7760-02.patch
        against trunk revision a4ceea6.

        +1 @author. The patch does not contain any @author tags.

        +0 tests included. The patch appears to be a documentation patch that doesn't require tests.

        +1 javac. The applied patch does not increase the total number of javac compiler warnings.

        +1 javadoc. There were no new javadoc warning messages.

        +1 eclipse:eclipse. The patch built with eclipse:eclipse.

        +1 findbugs. The patch does not introduce any new Findbugs (version 2.0.3) warnings.

        +1 release audit. The applied patch does not increase the total number of release audit warnings.

        -1 core tests. The patch failed these unit tests in hadoop-hdfs-project/hadoop-hdfs:

        org.apache.hadoop.hdfs.server.datanode.fsdataset.impl.TestLazyPersistFiles
        org.apache.hadoop.hdfs.server.namenode.ha.TestPipelinesFailover

        Test results: https://builds.apache.org/job/PreCommit-HDFS-Build/9534//testReport/
        Console output: https://builds.apache.org/job/PreCommit-HDFS-Build/9534//console

        This message is automatically generated.

        Show
        hadoopqa Hadoop QA added a comment - -1 overall . Here are the results of testing the latest attachment http://issues.apache.org/jira/secure/attachment/12698023/HDFS-7760-02.patch against trunk revision a4ceea6. +1 @author . The patch does not contain any @author tags. +0 tests included . The patch appears to be a documentation patch that doesn't require tests. +1 javac . The applied patch does not increase the total number of javac compiler warnings. +1 javadoc . There were no new javadoc warning messages. +1 eclipse:eclipse . The patch built with eclipse:eclipse. +1 findbugs . The patch does not introduce any new Findbugs (version 2.0.3) warnings. +1 release audit . The applied patch does not increase the total number of release audit warnings. -1 core tests . The patch failed these unit tests in hadoop-hdfs-project/hadoop-hdfs: org.apache.hadoop.hdfs.server.datanode.fsdataset.impl.TestLazyPersistFiles org.apache.hadoop.hdfs.server.namenode.ha.TestPipelinesFailover Test results: https://builds.apache.org/job/PreCommit-HDFS-Build/9534//testReport/ Console output: https://builds.apache.org/job/PreCommit-HDFS-Build/9534//console This message is automatically generated.
        Hide
        hitliuyi Yi Liu added a comment -
        Show
        hitliuyi Yi Liu added a comment - +1, Thanks Konstantin Shvachko
        Hide
        shv Konstantin Shvachko added a comment -

        I just committed this.

        Show
        shv Konstantin Shvachko added a comment - I just committed this.
        Hide
        shv Konstantin Shvachko added a comment -

        Renamed from: "Further update user doc for truncate"

        Show
        shv Konstantin Shvachko added a comment - Renamed from: "Further update user doc for truncate"
        Hide
        hudson Hudson added a comment -

        FAILURE: Integrated in Hadoop-trunk-Commit #7075 (See https://builds.apache.org/job/Hadoop-trunk-Commit/7075/)
        HDFS-7760. Document truncate for WebHDFS. Contributed by Konstantin Shvachko. (shv: rev e42fc1a251e91d25dbc4b3728b3cf4554ca7bee1)

        • hadoop-hdfs-project/hadoop-hdfs/src/site/apt/WebHDFS.apt.vm
        • hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt
        Show
        hudson Hudson added a comment - FAILURE: Integrated in Hadoop-trunk-Commit #7075 (See https://builds.apache.org/job/Hadoop-trunk-Commit/7075/ ) HDFS-7760 . Document truncate for WebHDFS. Contributed by Konstantin Shvachko. (shv: rev e42fc1a251e91d25dbc4b3728b3cf4554ca7bee1) hadoop-hdfs-project/hadoop-hdfs/src/site/apt/WebHDFS.apt.vm hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt
        Hide
        hudson Hudson added a comment -

        FAILURE: Integrated in Hadoop-Yarn-trunk-Java8 #102 (See https://builds.apache.org/job/Hadoop-Yarn-trunk-Java8/102/)
        HDFS-7760. Document truncate for WebHDFS. Contributed by Konstantin Shvachko. (shv: rev e42fc1a251e91d25dbc4b3728b3cf4554ca7bee1)

        • hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt
        • hadoop-hdfs-project/hadoop-hdfs/src/site/apt/WebHDFS.apt.vm
        Show
        hudson Hudson added a comment - FAILURE: Integrated in Hadoop-Yarn-trunk-Java8 #102 (See https://builds.apache.org/job/Hadoop-Yarn-trunk-Java8/102/ ) HDFS-7760 . Document truncate for WebHDFS. Contributed by Konstantin Shvachko. (shv: rev e42fc1a251e91d25dbc4b3728b3cf4554ca7bee1) hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt hadoop-hdfs-project/hadoop-hdfs/src/site/apt/WebHDFS.apt.vm
        Hide
        hudson Hudson added a comment -

        SUCCESS: Integrated in Hadoop-Yarn-trunk #836 (See https://builds.apache.org/job/Hadoop-Yarn-trunk/836/)
        HDFS-7760. Document truncate for WebHDFS. Contributed by Konstantin Shvachko. (shv: rev e42fc1a251e91d25dbc4b3728b3cf4554ca7bee1)

        • hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt
        • hadoop-hdfs-project/hadoop-hdfs/src/site/apt/WebHDFS.apt.vm
        Show
        hudson Hudson added a comment - SUCCESS: Integrated in Hadoop-Yarn-trunk #836 (See https://builds.apache.org/job/Hadoop-Yarn-trunk/836/ ) HDFS-7760 . Document truncate for WebHDFS. Contributed by Konstantin Shvachko. (shv: rev e42fc1a251e91d25dbc4b3728b3cf4554ca7bee1) hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt hadoop-hdfs-project/hadoop-hdfs/src/site/apt/WebHDFS.apt.vm
        Hide
        hudson Hudson added a comment -

        FAILURE: Integrated in Hadoop-Hdfs-trunk #2034 (See https://builds.apache.org/job/Hadoop-Hdfs-trunk/2034/)
        HDFS-7760. Document truncate for WebHDFS. Contributed by Konstantin Shvachko. (shv: rev e42fc1a251e91d25dbc4b3728b3cf4554ca7bee1)

        • hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt
        • hadoop-hdfs-project/hadoop-hdfs/src/site/apt/WebHDFS.apt.vm
        Show
        hudson Hudson added a comment - FAILURE: Integrated in Hadoop-Hdfs-trunk #2034 (See https://builds.apache.org/job/Hadoop-Hdfs-trunk/2034/ ) HDFS-7760 . Document truncate for WebHDFS. Contributed by Konstantin Shvachko. (shv: rev e42fc1a251e91d25dbc4b3728b3cf4554ca7bee1) hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt hadoop-hdfs-project/hadoop-hdfs/src/site/apt/WebHDFS.apt.vm
        Hide
        hudson Hudson added a comment -

        FAILURE: Integrated in Hadoop-Mapreduce-trunk-Java8 #103 (See https://builds.apache.org/job/Hadoop-Mapreduce-trunk-Java8/103/)
        HDFS-7760. Document truncate for WebHDFS. Contributed by Konstantin Shvachko. (shv: rev e42fc1a251e91d25dbc4b3728b3cf4554ca7bee1)

        • hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt
        • hadoop-hdfs-project/hadoop-hdfs/src/site/apt/WebHDFS.apt.vm
        Show
        hudson Hudson added a comment - FAILURE: Integrated in Hadoop-Mapreduce-trunk-Java8 #103 (See https://builds.apache.org/job/Hadoop-Mapreduce-trunk-Java8/103/ ) HDFS-7760 . Document truncate for WebHDFS. Contributed by Konstantin Shvachko. (shv: rev e42fc1a251e91d25dbc4b3728b3cf4554ca7bee1) hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt hadoop-hdfs-project/hadoop-hdfs/src/site/apt/WebHDFS.apt.vm
        Hide
        hudson Hudson added a comment -

        FAILURE: Integrated in Hadoop-Mapreduce-trunk #2053 (See https://builds.apache.org/job/Hadoop-Mapreduce-trunk/2053/)
        HDFS-7760. Document truncate for WebHDFS. Contributed by Konstantin Shvachko. (shv: rev e42fc1a251e91d25dbc4b3728b3cf4554ca7bee1)

        • hadoop-hdfs-project/hadoop-hdfs/src/site/apt/WebHDFS.apt.vm
        • hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt
        Show
        hudson Hudson added a comment - FAILURE: Integrated in Hadoop-Mapreduce-trunk #2053 (See https://builds.apache.org/job/Hadoop-Mapreduce-trunk/2053/ ) HDFS-7760 . Document truncate for WebHDFS. Contributed by Konstantin Shvachko. (shv: rev e42fc1a251e91d25dbc4b3728b3cf4554ca7bee1) hadoop-hdfs-project/hadoop-hdfs/src/site/apt/WebHDFS.apt.vm hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt
        Hide
        hudson Hudson added a comment -

        SUCCESS: Integrated in Hadoop-Hdfs-trunk-Java8 #97 (See https://builds.apache.org/job/Hadoop-Hdfs-trunk-Java8/97/)
        HDFS-7760. Document truncate for WebHDFS. Contributed by Konstantin Shvachko. (shv: rev e42fc1a251e91d25dbc4b3728b3cf4554ca7bee1)

        • hadoop-hdfs-project/hadoop-hdfs/src/site/apt/WebHDFS.apt.vm
        • hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt
        Show
        hudson Hudson added a comment - SUCCESS: Integrated in Hadoop-Hdfs-trunk-Java8 #97 (See https://builds.apache.org/job/Hadoop-Hdfs-trunk-Java8/97/ ) HDFS-7760 . Document truncate for WebHDFS. Contributed by Konstantin Shvachko. (shv: rev e42fc1a251e91d25dbc4b3728b3cf4554ca7bee1) hadoop-hdfs-project/hadoop-hdfs/src/site/apt/WebHDFS.apt.vm hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt

          People

          • Assignee:
            shv Konstantin Shvachko
            Reporter:
            hitliuyi Yi Liu
          • Votes:
            0 Vote for this issue
            Watchers:
            4 Start watching this issue

            Dates

            • Created:
              Updated:
              Resolved:

              Development