You are viewing a plain text version of this content. The canonical link for it is here.
Posted to common-dev@hadoop.apache.org by "Suman Sehgal (JIRA)" <ji...@apache.org> on 2008/08/01 11:50:32 UTC

[jira] Created: (HADOOP-3887) Distcp help needs to be more elaborated.

Distcp help needs to be more elaborated.
----------------------------------------

                 Key: HADOOP-3887
                 URL: https://issues.apache.org/jira/browse/HADOOP-3887
             Project: Hadoop Core
          Issue Type: Bug
          Components: documentation
    Affects Versions: 0.18.0
            Reporter: Suman Sehgal
            Priority: Minor


"hadoop distcp --help" command gives help regarding the execution of the distcp command but it doesn't give the details about copying data between different versions of Hadoop.

The example displayed by the help documentation is :
hadoop distcp -p -update "hdfs://A:8020/user/foo/bar" "hdfs://B:8020/user/foo/baz"

while copying between different versions, distcp uses hftp protocol instead of hdfs for source path.


-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


[jira] Commented: (HADOOP-3887) Distcp help needs to be more elaborated.

Posted by "Chris Douglas (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/HADOOP-3887?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12619623#action_12619623 ] 

Chris Douglas commented on HADOOP-3887:
---------------------------------------

While protocol compatibility is certainly relevant when using distcp, it's not part of its command-line usage, which \-\-help describes. I'm not sure which online help you refer to, but the same documentation will be posted once 0.18 is released.

> Distcp help needs to be more elaborated.
> ----------------------------------------
>
>                 Key: HADOOP-3887
>                 URL: https://issues.apache.org/jira/browse/HADOOP-3887
>             Project: Hadoop Core
>          Issue Type: Bug
>          Components: documentation
>    Affects Versions: 0.18.0
>            Reporter: Suman Sehgal
>            Priority: Minor
>             Fix For: 0.18.0
>
>
> "hadoop distcp --help" command gives help regarding the execution of the distcp command but it doesn't give the details about copying data between different versions of Hadoop.
> The example displayed by the help documentation is :
> hadoop distcp -p -update "hdfs://A:8020/user/foo/bar" "hdfs://B:8020/user/foo/baz"
> while copying between different versions, distcp uses hftp protocol instead of hdfs for source path.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


[jira] Commented: (HADOOP-3887) Distcp help needs to be more elaborated.

Posted by "Jayant Mahajan (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/HADOOP-3887?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12620220#action_12620220 ] 

Jayant Mahajan commented on HADOOP-3887:
----------------------------------------

I agree with Nicholas. We can provide link to pdf help file is fine as a solution to command line help. Currently command line help is not providing sufficient information to copy between different version of Hadoop.

> Distcp help needs to be more elaborated.
> ----------------------------------------
>
>                 Key: HADOOP-3887
>                 URL: https://issues.apache.org/jira/browse/HADOOP-3887
>             Project: Hadoop Core
>          Issue Type: Bug
>          Components: documentation
>    Affects Versions: 0.18.0
>            Reporter: Suman Sehgal
>            Priority: Minor
>             Fix For: 0.18.0
>
>
> "hadoop distcp --help" command gives help regarding the execution of the distcp command but it doesn't give the details about copying data between different versions of Hadoop.
> The example displayed by the help documentation is :
> hadoop distcp -p -update "hdfs://A:8020/user/foo/bar" "hdfs://B:8020/user/foo/baz"
> while copying between different versions, distcp uses hftp protocol instead of hdfs for source path.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


[jira] Commented: (HADOOP-3887) Distcp help needs to be more elaborated.

Posted by "Chris Douglas (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/HADOOP-3887?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12619696#action_12619696 ] 

Chris Douglas commented on HADOOP-3887:
---------------------------------------

This will be distributed with the tarball (under docs) and posted on hadoop.apache.org under documentation. I guess we could refer the user to the docs distributed with Hadoop in the \-\-help message, but shouldn't this be sufficient? Since we're talking about 0.18, isn't it redundant? I'd worry that users of 0.17.x will, reasonably, expect to find distcp documentation where it only exists in >0.18 releases, but I think the situation in 0.18 is acceptable.

> Distcp help needs to be more elaborated.
> ----------------------------------------
>
>                 Key: HADOOP-3887
>                 URL: https://issues.apache.org/jira/browse/HADOOP-3887
>             Project: Hadoop Core
>          Issue Type: Bug
>          Components: documentation
>    Affects Versions: 0.18.0
>            Reporter: Suman Sehgal
>            Priority: Minor
>             Fix For: 0.18.0
>
>
> "hadoop distcp --help" command gives help regarding the execution of the distcp command but it doesn't give the details about copying data between different versions of Hadoop.
> The example displayed by the help documentation is :
> hadoop distcp -p -update "hdfs://A:8020/user/foo/bar" "hdfs://B:8020/user/foo/baz"
> while copying between different versions, distcp uses hftp protocol instead of hdfs for source path.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


[jira] Resolved: (HADOOP-3887) Distcp help needs to be more elaborated.

Posted by "Chris Douglas (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/HADOOP-3887?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Chris Douglas resolved HADOOP-3887.
-----------------------------------

       Resolution: Duplicate
    Fix Version/s: 0.18.0

Better documentation for distcp was added in [0.18|http://svn.apache.org/viewvc/hadoop/core/branches/branch-0.18/docs/distcp.pdf?revision=667705&pathrev=667705]

> Distcp help needs to be more elaborated.
> ----------------------------------------
>
>                 Key: HADOOP-3887
>                 URL: https://issues.apache.org/jira/browse/HADOOP-3887
>             Project: Hadoop Core
>          Issue Type: Bug
>          Components: documentation
>    Affects Versions: 0.18.0
>            Reporter: Suman Sehgal
>            Priority: Minor
>             Fix For: 0.18.0
>
>
> "hadoop distcp --help" command gives help regarding the execution of the distcp command but it doesn't give the details about copying data between different versions of Hadoop.
> The example displayed by the help documentation is :
> hadoop distcp -p -update "hdfs://A:8020/user/foo/bar" "hdfs://B:8020/user/foo/baz"
> while copying between different versions, distcp uses hftp protocol instead of hdfs for source path.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


[jira] Commented: (HADOOP-3887) Distcp help needs to be more elaborated.

Posted by "Tsz Wo (Nicholas), SZE (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/HADOOP-3887?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12619625#action_12619625 ] 

Tsz Wo (Nicholas), SZE commented on HADOOP-3887:
------------------------------------------------

How about we display a link to distcp.pdf  in the distcp command help?

> Distcp help needs to be more elaborated.
> ----------------------------------------
>
>                 Key: HADOOP-3887
>                 URL: https://issues.apache.org/jira/browse/HADOOP-3887
>             Project: Hadoop Core
>          Issue Type: Bug
>          Components: documentation
>    Affects Versions: 0.18.0
>            Reporter: Suman Sehgal
>            Priority: Minor
>             Fix For: 0.18.0
>
>
> "hadoop distcp --help" command gives help regarding the execution of the distcp command but it doesn't give the details about copying data between different versions of Hadoop.
> The example displayed by the help documentation is :
> hadoop distcp -p -update "hdfs://A:8020/user/foo/bar" "hdfs://B:8020/user/foo/baz"
> while copying between different versions, distcp uses hftp protocol instead of hdfs for source path.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


[jira] Commented: (HADOOP-3887) Distcp help needs to be more elaborated.

Posted by "Suman Sehgal (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/HADOOP-3887?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12619578#action_12619578 ] 

Suman Sehgal commented on HADOOP-3887:
--------------------------------------

Although the description is there in distcp.pdf but this information is not being displayed by online help (on running "hadoop distcp -help" command).

> Distcp help needs to be more elaborated.
> ----------------------------------------
>
>                 Key: HADOOP-3887
>                 URL: https://issues.apache.org/jira/browse/HADOOP-3887
>             Project: Hadoop Core
>          Issue Type: Bug
>          Components: documentation
>    Affects Versions: 0.18.0
>            Reporter: Suman Sehgal
>            Priority: Minor
>             Fix For: 0.18.0
>
>
> "hadoop distcp --help" command gives help regarding the execution of the distcp command but it doesn't give the details about copying data between different versions of Hadoop.
> The example displayed by the help documentation is :
> hadoop distcp -p -update "hdfs://A:8020/user/foo/bar" "hdfs://B:8020/user/foo/baz"
> while copying between different versions, distcp uses hftp protocol instead of hdfs for source path.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.