Uploaded image for project: 'Lustre'
  1. Lustre
  2. LU-13841

error messages need additional explanation for lctl pcc commands

Details

    • Bug
    • Resolution: Fixed
    • Trivial
    • None
    • Lustre 2.14.0
    • None
    • Virtual machine
    • 3
    • 9223372036854775807

    Description

       

      From user  perspective:

      • different cases reports same error. 
      • error message itself does not explain what File exists, so it should be documented or changed. Also error message assumed that user knows PCC internals to understand it.

       

      From my point of view this can fixed by added some notes or explanation to documentation, or change error message itself, like "cache already enabled for ..."

       

      Steps to reproduce:

      Directory  for cache is created and exists.

      1. ls /mnt/pcc2

      #  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid={100} rwid=2"

      Try to add pcc cache multiple times with same rwid

      #  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid={100} rwid=2"

      lctl pcc pcc: error: setting llite.lustre-ffff8b405721f800.pcc='add /mnt/pcc2 projid={100} rwid=2': File exists (17)

       

      Try to add pcc cache with same path to /mtn/pcc2 but with  with different rwid

      [#  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid={100} rwid=5"

      lctl pcc pcc: error: setting llite.lustre-ffff8b405721f800.pcc='add /mnt/pcc2 projid={100} rwid=5*': File exists (17)*

       

      Use incorrect arguments: to get path with numbers

      1. lctl pcc add /mnt/lustre pccro --param projid={100} rwid=2
        add: must specify mount path and PCC path 3:6
        Add a PCC backend to a client.
        usage: lctl pcc add <mntpath> <pccpath> [--param|-p <param>]
        mntpath: Lustre mount point.
        pccpath: Path of the PCC backend.
        param: Setting parameters for PCC backend.

       What is "PCC path 3:6" about? Similar to lctl pcc del

      lctl pcc del /mnt/pcc2
      del: must speficy mount path and PCC path 1:2
      Delete the specified PCC backend on a client.
      usage: clt pcc del <mntpath> <pccpath>

       

      Typo in error mesage:

      del: must speficy mount path and PCC path 1:2  -> specify

       

      Incorrect number of arguments in help output:

      1. lctl pcc list
        list: require 2 arguments
        List all PCC backends on a client.
        usage: lctl pcc list <mntpath>**Command output shows 2 arguments in help but only one is required.

       

      Attachments

        Issue Links

          Activity

            [LU-13841] error messages need additional explanation for lctl pcc commands
            vilapa Vikentsi Lapa made changes -
            Resolution New: Fixed [ 1 ]
            Status Original: Open [ 1 ] New: Closed [ 6 ]
            vilapa Vikentsi Lapa made changes -
            Description Original:  

            From user  perspective:
             * different cases reports same error. 
             * error message itself does not explain what File exists, so it should be documented or changed. Also error message assumed that user knows PCC internals to understand it.

             

            From my point of view this can fixed by added some notes or explanation to documentation, or change error message itself, like "cache already enabled for ..."

             

            Steps to reproduce:

            Directory  for cache is created and exists.
             # ls /mnt/pcc2

            #  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid=\{100} *rwid=2"*

            Try to add pcc cache multiple times with same rwid

            #  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid=\{100} *rwid=2*"

            lctl pcc pcc: error: setting llite.lustre-ffff8b405721f800.pcc='add /mnt/pcc2 projid=\{100} rwid=2': *File exists (17)*

             

            Try to add pcc cache with same path to /mtn/pcc2 but with  with different rwid

            [#  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid=\{100} *rwid=5"*

            lctl pcc pcc: error: setting llite.lustre-ffff8b405721f800.pcc='add /mnt/pcc2 projid=\{100} rwid=5*': File exists (17)*

             

            Use incorrect arguments:
             # lctl pcc add /mnt/lustre pccro --param projid=\{100} rwid=2
             add: must specify *mount path and PCC path 3:6*
             Add a PCC backend to a client.
             usage: lctl pcc add <mntpath> <pccpath> [--param|-p <param>]
             mntpath: Lustre mount point.
             pccpath: Path of the PCC backend.
             param: Setting parameters for PCC backend.

             What is "PCC path 3:6" about?

             

            # lctl pcc list
            list: require *2 arguments*
            List all PCC backends on a client.
            usage: lctl pcc list *<mntpath>***Command output shows 2 arguments in help but only one is required.

             
            New:  

            From user  perspective:
             * different cases reports same error. 
             * error message itself does not explain what File exists, so it should be documented or changed. Also error message assumed that user knows PCC internals to understand it.

             

            From my point of view this can fixed by added some notes or explanation to documentation, or change error message itself, like "cache already enabled for ..."

             

            Steps to reproduce:

            Directory  for cache is created and exists.
             # ls /mnt/pcc2

            #  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid=\{100} *rwid=2"*

            Try to add pcc cache multiple times with same rwid

            #  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid=\{100} *rwid=2*"

            lctl pcc pcc: error: setting llite.lustre-ffff8b405721f800.pcc='add /mnt/pcc2 projid=\{100} rwid=2': *File exists (17)*

             

            Try to add pcc cache with same path to /mtn/pcc2 but with  with different rwid

            [#  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid=\{100} *rwid=5"*

            lctl pcc pcc: error: setting llite.lustre-ffff8b405721f800.pcc='add /mnt/pcc2 projid=\{100} rwid=5*': File exists (17)*

             

            Use incorrect arguments: to get path with numbers
             # lctl pcc add /mnt/lustre pccro --param projid=\{100} rwid=2
             add: must specify *mount path and PCC path 3:6*
             Add a PCC backend to a client.
             usage: lctl pcc add <mntpath> <pccpath> [--param|-p <param>]
             mntpath: Lustre mount point.
             pccpath: Path of the PCC backend.
             param: Setting parameters for PCC backend.

             What is "PCC path 3:6" about? Similar to lctl pcc del

            lctl pcc del /mnt/pcc2
            del: must speficy mount path and *PCC path 1:2*
            Delete the specified PCC backend on a client.
            usage: clt pcc del <mntpath> <pccpath>

             

            Typo in error mesage:

            del: must *speficy* mount path and PCC path 1:2  -> specify

             

            Incorrect number of arguments in help output:
             # lctl pcc list
             list: require *2 arguments*
             List all PCC backends on a client.
             usage: lctl pcc list *<mntpath>***Command output shows 2 arguments in help but only one is required.

             
            vilapa Vikentsi Lapa made changes -
            Description Original:  

            From user  perspective:
             * different cases reports same error. 
             * error message itself does not explain what File exists, so it should be documented or changed. Also error message assumed that user knows PCC internals to understand it.

             

            From my point of view this can fixed by added some notes or explanation to documentation, or change error message itself, like "cache already enabled for ..."

             

            Steps to reproduce:

            Directory  for cache is created and exists.
             # ls /mnt/pcc2

            #  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid=\{100} *rwid=2"*

            Try to add pcc cache multiple times with same rwid

            #  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid=\{100} *rwid=2*"

            lctl pcc pcc: error: setting llite.lustre-ffff8b405721f800.pcc='add /mnt/pcc2 projid=\{100} rwid=2': *File exists (17)*

             

            Try to add pcc cache with same path to /mtn/pcc2 but with  with different rwid

            [#  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid=\{100} *rwid=5"*

            lctl pcc pcc: error: setting llite.lustre-ffff8b405721f800.pcc='add /mnt/pcc2 projid=\{100} rwid=5*': File exists (17)*

             

            Use incorrect arguments:
             # lctl pcc add /mnt/lustre pccro --param projid=\{100} rwid=2
             add: must specify *mount path and PCC path 3:6*
             Add a PCC backend to a client.
             usage: lctl pcc add <mntpath> <pccpath> [--param|-p <param>]
             mntpath: Lustre mount point.
             pccpath: Path of the PCC backend.
             param: Setting parameters for PCC backend.

             What is "PCC path 3:6" about?
            New:  

            From user  perspective:
             * different cases reports same error. 
             * error message itself does not explain what File exists, so it should be documented or changed. Also error message assumed that user knows PCC internals to understand it.

             

            From my point of view this can fixed by added some notes or explanation to documentation, or change error message itself, like "cache already enabled for ..."

             

            Steps to reproduce:

            Directory  for cache is created and exists.
             # ls /mnt/pcc2

            #  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid=\{100} *rwid=2"*

            Try to add pcc cache multiple times with same rwid

            #  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid=\{100} *rwid=2*"

            lctl pcc pcc: error: setting llite.lustre-ffff8b405721f800.pcc='add /mnt/pcc2 projid=\{100} rwid=2': *File exists (17)*

             

            Try to add pcc cache with same path to /mtn/pcc2 but with  with different rwid

            [#  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid=\{100} *rwid=5"*

            lctl pcc pcc: error: setting llite.lustre-ffff8b405721f800.pcc='add /mnt/pcc2 projid=\{100} rwid=5*': File exists (17)*

             

            Use incorrect arguments:
             # lctl pcc add /mnt/lustre pccro --param projid=\{100} rwid=2
             add: must specify *mount path and PCC path 3:6*
             Add a PCC backend to a client.
             usage: lctl pcc add <mntpath> <pccpath> [--param|-p <param>]
             mntpath: Lustre mount point.
             pccpath: Path of the PCC backend.
             param: Setting parameters for PCC backend.

             What is "PCC path 3:6" about?

             

            # lctl pcc list
            list: require *2 arguments*
            List all PCC backends on a client.
            usage: lctl pcc list *<mntpath>***Command output shows 2 arguments in help but only one is required.

             
            vilapa Vikentsi Lapa made changes -
            Description Original:  

            From user  perspective:
             * different cases reports same error. 
             * error message itself does not explain what File exists, so it should be documented or changed. Also error message assumed that user knows PCC internals to understand it.

             

            From my point of view this can fixed by added some notes or explanation to documentation, or change error message itself, like "cache already enabled for ..."

             

            Steps to reproduce:

            Directory  for cache is created and exists.
             # ls /mnt/pcc2

            #  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid=\{100} *rwid=2"*

            Try to add pcc cache multiple times with same rwid

            #  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid=\{100} *rwid=2*"

            lctl pcc pcc: error: setting llite.lustre-ffff8b405721f800.pcc='add /mnt/pcc2 projid=\{100} rwid=2': *File exists (17)*

             

            Try to add pcc cache with same path to /mtn/pcc2 but with  with different rwid

            [#  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid=\{100} *rwid=5"*

            lctl pcc pcc: error: setting llite.lustre-ffff8b405721f800.pcc='add /mnt/pcc2 projid=\{100} rwid=5*': File exists (17)*

             

            Use incorrect arguments:
             # lctl pcc add /mnt/lustre pccro --param projid=\{100} rwid=2
             add: must specify *mount path and PCC path 3:6*
             Add a PCC backend to a client.
             usage: lctl pcc add <mntpath> <pccpath> [--param|-p <param>]
             mntpath: Lustre mount point.
             pccpath: Path of the PCC backend.
             param: Setting parameters for PCC backend.

             
            New:  

            From user  perspective:
             * different cases reports same error. 
             * error message itself does not explain what File exists, so it should be documented or changed. Also error message assumed that user knows PCC internals to understand it.

             

            From my point of view this can fixed by added some notes or explanation to documentation, or change error message itself, like "cache already enabled for ..."

             

            Steps to reproduce:

            Directory  for cache is created and exists.
             # ls /mnt/pcc2

            #  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid=\{100} *rwid=2"*

            Try to add pcc cache multiple times with same rwid

            #  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid=\{100} *rwid=2*"

            lctl pcc pcc: error: setting llite.lustre-ffff8b405721f800.pcc='add /mnt/pcc2 projid=\{100} rwid=2': *File exists (17)*

             

            Try to add pcc cache with same path to /mtn/pcc2 but with  with different rwid

            [#  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid=\{100} *rwid=5"*

            lctl pcc pcc: error: setting llite.lustre-ffff8b405721f800.pcc='add /mnt/pcc2 projid=\{100} rwid=5*': File exists (17)*

             

            Use incorrect arguments:
             # lctl pcc add /mnt/lustre pccro --param projid=\{100} rwid=2
             add: must specify *mount path and PCC path 3:6*
             Add a PCC backend to a client.
             usage: lctl pcc add <mntpath> <pccpath> [--param|-p <param>]
             mntpath: Lustre mount point.
             pccpath: Path of the PCC backend.
             param: Setting parameters for PCC backend.

             What is "PCC path 3:6" about?
            vilapa Vikentsi Lapa made changes -
            Description Original: From user  perspective:
             * different cases reports same error. 
             * error message itself does not explain what File exists, so it should be documented or changed. Also error message assumed that user knows PCC internals to understand it.

             

            From my point of view this can fixed by added some notes or explanation to documentation, or change error message itself, like "cache already enabled for ..."

             

            Steps to reproduce:

            Directory  for cache is created and exists.
             # ls /mnt/pcc2

            #  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid=\{100} *rwid=2"*

            Try to add pcc cache multiple times with same rwid

            #  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid=\{100} *rwid=2*"

            lctl pcc pcc: error: setting llite.lustre-ffff8b405721f800.pcc='add /mnt/pcc2 projid=\{100} rwid=2': *File exists (17)*

             

            Try to add pcc cache with same path to /mtn/pcc2 but with  with different rwid

            [#  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid=\{100} *rwid=5"*

            lctl pcc pcc: error: setting llite.lustre-ffff8b405721f800.pcc='add /mnt/pcc2 projid=\{100} rwid=5*': File exists (17)*

             

            # lctl pcc add /mnt/lustre pccro --param projid=\{100} rwid=2
            add: must specify *mount path and PCC path 3:6*
            Add a PCC backend to a client.
            usage: lctl pcc add <mntpath> <pccpath> [--param|-p <param>]
             mntpath: Lustre mount point.
             pccpath: Path of the PCC backend.
             param: Setting parameters for PCC backend.

             
            New:  

            From user  perspective:
             * different cases reports same error. 
             * error message itself does not explain what File exists, so it should be documented or changed. Also error message assumed that user knows PCC internals to understand it.

             

            From my point of view this can fixed by added some notes or explanation to documentation, or change error message itself, like "cache already enabled for ..."

             

            Steps to reproduce:

            Directory  for cache is created and exists.
             # ls /mnt/pcc2

            #  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid=\{100} *rwid=2"*

            Try to add pcc cache multiple times with same rwid

            #  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid=\{100} *rwid=2*"

            lctl pcc pcc: error: setting llite.lustre-ffff8b405721f800.pcc='add /mnt/pcc2 projid=\{100} rwid=2': *File exists (17)*

             

            Try to add pcc cache with same path to /mtn/pcc2 but with  with different rwid

            [#  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid=\{100} *rwid=5"*

            lctl pcc pcc: error: setting llite.lustre-ffff8b405721f800.pcc='add /mnt/pcc2 projid=\{100} rwid=5*': File exists (17)*

             

            Use incorrect arguments:
             # lctl pcc add /mnt/lustre pccro --param projid=\{100} rwid=2
             add: must specify *mount path and PCC path 3:6*
             Add a PCC backend to a client.
             usage: lctl pcc add <mntpath> <pccpath> [--param|-p <param>]
             mntpath: Lustre mount point.
             pccpath: Path of the PCC backend.
             param: Setting parameters for PCC backend.

             
            vilapa Vikentsi Lapa made changes -
            Summary Original: file exists error needs additional explanation for case lctl pcc add New: error messages need additional explanation for lctl pcc commands
            vilapa Vikentsi Lapa made changes -
            Description Original: From user  perspective:
             * different cases reports same error. 
             * error message itself does not explain what File exists, so it should be documented or changed. Also error message assumed that user knows PCC internals to understand it.

             

            From my point of view this can fixed by added some notes or explanation to documentation, or change error message itself, like "cache already enabled for ..."

             

            Steps to reproduce:

            Directory  for cache is created and exists.

            # ls /mnt/pcc2

            #  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid=\{100} *rwid=2"*

            Try to add pcc cache multiple times with same rwid

            #  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid=\{100} *rwid=2*"

            lctl pcc pcc: error: setting llite.lustre-ffff8b405721f800.pcc='add /mnt/pcc2 projid=\{100} rwid=2': *File exists (17)*

             

            Try to add pcc cache with same path to /mtn/pcc2 but with  with different rwid

            [#  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid=\{100} *rwid=5"*

            lctl pcc pcc: error: setting llite.lustre-ffff8b405721f800.pcc='add /mnt/pcc2 projid=\{100} rwid=5*': File exists (17)*
            New: From user  perspective:
             * different cases reports same error. 
             * error message itself does not explain what File exists, so it should be documented or changed. Also error message assumed that user knows PCC internals to understand it.

             

            From my point of view this can fixed by added some notes or explanation to documentation, or change error message itself, like "cache already enabled for ..."

             

            Steps to reproduce:

            Directory  for cache is created and exists.
             # ls /mnt/pcc2

            #  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid=\{100} *rwid=2"*

            Try to add pcc cache multiple times with same rwid

            #  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid=\{100} *rwid=2*"

            lctl pcc pcc: error: setting llite.lustre-ffff8b405721f800.pcc='add /mnt/pcc2 projid=\{100} rwid=2': *File exists (17)*

             

            Try to add pcc cache with same path to /mtn/pcc2 but with  with different rwid

            [#  lctl pcc add /mnt/lustre /mnt/pcc2 --param "projid=\{100} *rwid=5"*

            lctl pcc pcc: error: setting llite.lustre-ffff8b405721f800.pcc='add /mnt/pcc2 projid=\{100} rwid=5*': File exists (17)*

             

            # lctl pcc add /mnt/lustre pccro --param projid=\{100} rwid=2
            add: must specify *mount path and PCC path 3:6*
            Add a PCC backend to a client.
            usage: lctl pcc add <mntpath> <pccpath> [--param|-p <param>]
             mntpath: Lustre mount point.
             pccpath: Path of the PCC backend.
             param: Setting parameters for PCC backend.

             
            vilapa Vikentsi Lapa made changes -
            Link New: This issue is related to LU-10499 [ LU-10499 ]
            vilapa Vikentsi Lapa created issue -

            People

              wc-triage WC Triage
              vilapa Vikentsi Lapa
              Votes:
              0 Vote for this issue
              Watchers:
              3 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: