XtremIO: How to search a string on xmcli (user)>show commands - "like grep" ?

           

   Article Number:     538331                                   Article Version: 2     Article Type:    How To 
   

 


Product:

 

XtremIO Family,XtremIO X1,XtremIO X2,XtremIO HW Gen1,XtremIO HW Gen2 400GB,XtremIO HW Gen2 400GB Encrypt Capbl,XtremIO HW Gen2 400GB Encrypt Disable,XtremIO HW Gen2 400GB Exp Encrypt Disable,XtremIO HW Gen2 400GB Expandable

 

Instructions:

 

 

   

      All show commands, i.e commands that provide information about the sytem (rather than manipulate it) support the option to filter the displayed results of the command on XMS's running 6.0.0-55 code or greater..   

   
         -- Any object property can be selected as a filter.       
       
        If you want to use multiple filters, separate them with a logical AND or a logical OR, using ampersand (&) and comma, recpectively.       
       
            -- The filter implements all AND rules first and then all OR rules on the received results.       
       
        The filters are based on a logical statement as described in the following table.       
       
        xmcli (tech)> help-filters       
        Show commands support defining filters, based on a logical statement (as listed below), to filter result sets of any given command.       
        Any object property can be used as a filtering parameter.       
        When using multiple filters, you can separate them by a logical AND,       
        using the & sign, and/or a logical OR, using a comma.       
        On execution, the filter first implements all AND rules and then all OR rules on the received results.       
       
        OBJECT TYPE             |INTERNAL PROPERTIES       
        ==============================================       
        Numeric                 |eq (equal)       
                                |ne (not equal)       
                                |ge (greater equal)       
                                |gt (greater than)       
                                |lt (less than)       
                                |le (less equal)       
        ----------------------------------------------       
        String                  |like (contains all or       
                                |part of the string)       
        ----------------------------------------------       
        Date time               |Yyyy-mm-dd hh:mm-ss+       
                                |Difference to       
                                |Greenwich time       
        ----------------------------------------------       
       
        Filtering syntax:       
        Filter=property1:OPERATOR:value&filter=property2:OPERATOR:Value       
        Filter example:       
        show-volumes filter=Vol-Size:gt:1T&vol-name:like:ProdTime       
        Filter Example:       
        show-volumes filter="Creation-Time:ge:2017-02-05 10:39:50+03"
   
    xmcli (tech)>       
       
        Examples       
       
          --Filtering a ssd by his name (wwn)
   
   
    xmcli (tech)> show-ssds   
   
    Name                   Index Cluster-Name Index Brick-Name Index Slot Model-Name                FW-Version FW-State Part-Number SSD-Size DPG-Name Index SSD-DPG-State Lifecycle-State Endurance-Remaining-% Certainty Encryption-Status                SSD-Temperature   
    wwn-0x58ce38ee203898d9 1     XtremIO_R20  1     X1         1     0    TOSHIBA  4SVQ040B CLAR400 PB13       no_error 118000492   372.529G X1-DPG-1 1     in_rg         healthy         100                   ok        enc_supported_locked_cluster_pin 31   
    wwn-0x58ce38ee203898f5 2     XtremIO_R20  1     X1         1     1    TOSHIBA  4SVQ040B CLAR400 PB13       no_error 118000492   372.529G X1-DPG-1 1     in_rg         healthy         99                    ok        enc_supported_locked_cluster_pin 32   
    wwn-0x58ce38ee203898ed 3     XtremIO_R20  1     X1         1     2    TOSHIBA  4SVQ040B CLAR400 PB13       no_error 118000492   372.529G X1-DPG-1 1     in_rg         healthy         99                    ok        enc_supported_locked_cluster_pin 32   
    wwn-0x58ce38ee2037bda9 4     XtremIO_R20  1     X1         1     3    TOSHIBA  4SVQ040B CLAR400 PB13       no_error 118000492   372.529G X1-DPG-1 1     in_rg         healthy         99                    ok        enc_supported_locked_cluster_pin 33   
    wwn-0x500003972c8b1c59 5     XtremIO_R20  1     X1         1     4    TOSHIBA  4SVQ040B CLAR400 PB13       no_error 118000492   372.529G X1-DPG-1 1     in_rg         healthy         94                    ok        enc_supported_locked_cluster_pin 32   
    wwn-0x58ce38ee202e6141 6     XtremIO_R20  1     X1         1     5    TOSHIBA  4SVQ040B CLAR400 PB13       no_error 118000492   372.529G X1-DPG-1 1     in_rg         healthy         99                    ok        enc_supported_locked_cluster_pin 34   
    wwn-0x500003971c886849 7     XtremIO_R20  1     X1         1     6    TOSHIBA  4SVQ040B CLAR400 PB13       no_error 118000492   372.529G X1-DPG-1 1     in_rg         healthy         95                    ok        enc_supported_locked_cluster_pin 35   
    wwn-0x58ce38ee2038a9d5 8     XtremIO_R20  1     X1         1     7    TOSHIBA  4SVQ040B CLAR400 PB13       no_error 118000492   372.529G X1-DPG-1 1     in_rg         healthy         99                    ok        enc_supported_locked_cluster_pin 36   
    wwn-0x50000396bc89ade9 9     XtremIO_R20  1     X1         1     8    TOSHIBA  4SVQ040B CLAR400 PB13       no_error 118000492   372.529G X1-DPG-1 1     in_rg         healthy         95                    ok        enc_supported_locked_cluster_pin 39   
    wwn-0x500003972c8b6b65 10    XtremIO_R20  1     X1         1     9    TOSHIBA  4SVQ040B CLAR400 PB13       no_error 118000492   372.529G X1-DPG-1 1     in_rg         healthy         94                    ok        enc_supported_locked_cluster_pin 37   
    wwn-0x500003972c8b1aa1 11    XtremIO_R20  1     X1         1     10   TOSHIBA  4SVQ040B CLAR400 PB13       no_error 118000492   372.529G X1-DPG-1 1     in_rg         healthy         94                    ok        enc_supported_locked_cluster_pin 36   
    wwn-0x50000396bc89add1 12    XtremIO_R20  1     X1         1     11   TOSHIBA  4SVQ040B CLAR400 PB13       no_error 118000492   372.529G X1-DPG-1 1     in_rg         healthy         95                    ok        enc_supported_locked_cluster_pin 34   
    wwn-0x50000396bc89aeb5 13    XtremIO_R20  1     X1         1     12   TOSHIBA  4SVQ040B CLAR400 PB13       no_error 118000492   372.529G X1-DPG-1 1     in_rg         healthy         96                    ok        enc_supported_locked_cluster_pin 33   
    wwn-0x50000396bc89ace5 14    XtremIO_R20  1     X1         1     13   TOSHIBA  4SVQ040B CLAR400 PB13       no_error 118000492   372.529G X1-DPG-1 1     in_rg         healthy         95                    ok        enc_supported_locked_cluster_pin 33   
    wwn-0x50000396bc89adad 15    XtremIO_R20  1     X1         1     14   TOSHIBA  4SVQ040B CLAR400 PB13       no_error 118000492   372.529G X1-DPG-1 1     in_rg         healthy         94                    ok        enc_supported_locked_cluster_pin 34   
    wwn-0x50000396bc886435 16    XtremIO_R20  1     X1         1     15   TOSHIBA  4SVQ040B CLAR400 PB13       no_error 118000492   372.529G X1-DPG-1 1     in_rg         healthy         96                    ok        enc_supported_locked_cluster_pin 34   
    wwn-0x50000396bc89ad95 17    XtremIO_R20  1     X1         1     16   TOSHIBA  4SVQ040B CLAR400 PB13       no_error 118000492   372.529G X1-DPG-1 1     in_rg         healthy         94                    ok        enc_supported_locked_cluster_pin 33   
    wwn-0x58ce38ee2037bdb9 18    XtremIO_R20  1     X1         1     17   TOSHIBA  4SVQ040B CLAR400 PB13       no_error 118000492   372.529G X1-DPG-1 1     in_rg         healthy         99                    ok        enc_supported_locked_cluster_pin 32   
   
    xmcli (tech)> show-ssds filter=Name:like:wwn-0x58ce38ee2037bdb9   
   
    Name                   Index Cluster-Name Index Brick-Name Index Slot Model-Name  FW-Version FW-State Part-Number SSD-Size DPG-Name Index SSD-DPG-State Lifecycle-State Endurance-Remaining-% Certainty Encryption-Status  SSD-Temperature   
    wwn-0x58ce38ee2037bdb9 18    XtremIO_R20  1     X1         1     17   TOSHIBA  4SVQ040B CLAR400 PB13       no_error 118000492   372.529G X1-DPG-1 1     in_rg         healthy         99                    ok        enc_supported_locked_cluster_pin 32     
     
          --Filtering a ssd by his endurance-remaining
   
   
    xmcli (tech)> show-ssds filter=Endurance-Remaining-%:gt:99   
   
    Name                   Index Cluster-Name Index Brick-Name Index Slot Model-Name                FW-Version FW-State Part-Number SSD-Size DPG-Name Index SSD-DPG-State Lifecycle-State Endurance-Remaining-% Certainty Encryption-Status                SSD-Temperature   
    wwn-0x58ce38ee203898d9 1     XtremIO_R20  1     X1         1     0    TOSHIBA  4SVQ040B CLAR400 PB13       no_error 118000492   372.529G X1-DPG-1 1     in_rg         healthy         100                   ok        enc_supported_locked_cluster_pin 31     
     
         --Filtering a volume(s)  by creation time
   
   
    xmcli (tech)> show-volumes   
   
    Volume-Name               Index   Cluster-Name Index Vol-Size LB-Size Logical-Space-In-Use Offset Created-From-Volume VSG-Index Small-IO-Alerts Unaligned-IO-Alerts VAAI-TP-Alerts Total-Writes Total-Reads NAA-Identifier   Certainty Created-By-Application Volume-Type Creation-Time       Volume-Access Tag-List   
    test                      1       XtremIO_R20  1     4G       512     0                    0                          1         disabled        disabled            disabled       0            0                            ok        xms                    regular     2019-04-19 01:24:29 write_access   
    APIEL1                    2       XtremIO_R20  1     20G      512     0                    0                          2         disabled        disabled            disabled       0            0                            ok        xms                    regular     2019-09-16 06:06:48 write_access   
    test.1568628958572        3       XtremIO_R20  1     4G       512     0                    0      test                1         disabled        disabled            disabled       0            0                            ok        xms                    readonly    2019-09-16 06:16:49 read_access   
    APIEL1.1568628958572      4       XtremIO_R20  1     20G      512     0                    0      APIEL1              2         disabled        disabled            disabled       0            0           514f0c5251200011 ok        xms                    readonly    2019-09-16 06:16:49 read_access   
    APIEL1.AAA                52      XtremIO_R20  1     20G      512     0                    0      APIEL1              2         disabled        disabled            disabled       0            0           514f0c525120002f ok        xms                    readonly    2019-09-19 02:55:30 read_access   
    test.1570009920518        2025629 XtremIO_R20  1     4G       512     0                    0      test                1         disabled        disabled            disabled       0            0                            ok        scheduler              regular     2019-10-02 05:52:00 write_access   
    test.1570010030549        2025638 XtremIO_R20  1     4G       512     0                    0      test                1         disabled        disabled            disabled       0            0                            ok        scheduler              regular     2019-10-02 05:53:50 write_access   
    test.1570010400681        2025663 XtremIO_R20  1     4G       512     0                    0      test                1         disabled        disabled            disabled       0            0                            ok        scheduler              regular     2019-10-02 06:00:00 write_access   
    APIEL1.Piel.1572424860910 2055623 XtremIO_R20  1     20G      512     0                    0      APIEL1              2         disabled        disabled            disabled       0            0                            ok        scheduler              readonly    2019-10-30 04:41:00 read_access   
    test.Piel.1572424860910   2055624 XtremIO_R20  1     4G       512     0                    0      test                1         disabled        disabled            disabled       0            0                            ok        scheduler              readonly    2019-10-30 04:41:00 read_access   
    APIEL1.Piel.1572424890916 2055625 XtremIO_R20  1     20G      512     0                    0      APIEL1              2         disabled        disabled            disabled       0            0                            ok        scheduler              readonly    2019-10-30 04:41:30 read_access   
    test.Piel.1572424890916   2055626 XtremIO_R20  1     4G       512     0                    0      test                1         disabled        disabled            disabled       0            0                            ok        scheduler              readonly    2019-10-30 04:41:30 read_access   
    APIEL1.Piel.1572424920930 2055627 XtremIO_R20  1     20G      512     0                    0      APIEL1              2         disabled        disabled            disabled       0            0                            ok        scheduler              readonly    2019-10-30 04:42:00 read_access   
    test.Piel.1572424920930   2055628 XtremIO_R20  1     4G       512     0                    0      test                1         disabled        disabled            disabled       0            0                            ok        scheduler              readonly    2019-10-30 04:42:00 read_access   
    APIEL1.Piel.1572424950933 2055629 XtremIO_R20  1     20G      512     0                    0      APIEL1              2         disabled        disabled            disabled       0            0                            ok        scheduler              readonly    2019-10-30 04:42:30 read_access   
    test.Piel.1572424950933   2055630 XtremIO_R20  1     4G       512     0                    0      test                1         disabled        disabled            disabled       0            0                            ok        scheduler              readonly    2019-10-30 04:42:30 read_access   
   
    xmcli (tech)> show-volumes filter=Creation-Time:like:2019-04-19   
   
    Volume-Name Index Cluster-Name Index Vol-Size LB-Size Logical-Space-In-Use Offset Created-From-Volume VSG-Index Small-IO-Alerts Unaligned-IO-Alerts VAAI-TP-Alerts Total-Writes Total-Reads NAA-Identifier Certainty Created-By-Application Volume-Type Creation-Time       Volume-Access Tag-List   
    test        1     XtremIO_R20  1     4G       512     0                    0                          1         disabled        disabled            disabled       0            0                          ok        xms                    regular     2019-04-19 01:24:29 write_access   
   
    xmcli (tech)> show-volumes filter=Creation-Time:like:2019-10-30   
   
    Volume-Name               Index   Cluster-Name Index Vol-Size LB-Size Logical-Space-In-Use Offset Created-From-Volume VSG-Index Small-IO-Alerts Unaligned-IO-Alerts VAAI-TP-Alerts Total-Writes Total-Reads NAA-Identifier Certainty Created-By-Application Volume-Type Creation-Time       Volume-Access Tag-List   
    APIEL1.Piel.1572425130977 2055641 XtremIO_R20  1     20G      512     0     0      APIEL1     2         disabled        disabled            disabled       0            0     ok        scheduler              readonly    2019-10-30 04:45:30 read_access   
    test.Piel.1572425130977   2055642 XtremIO_R20  1     4G       512     0          0      test            1         disabled        disabled            disabled       0            0     ok        scheduler              readonly    2019-10-30 04:45:30 read_access   
    APIEL1.Piel.1572425160990 2055643 XtremIO_R20  1     20G      512     0     0      APIEL1      2         disabled        disabled            disabled       0            0     ok        scheduler              readonly    2019-10-30 04:46:00 read_access   
    test.Piel.1572425160990   2055644 XtremIO_R20  1     4G       512     0           0      test            1         disabled        disabled            disabled       0            0     ok        scheduler              readonly    2019-10-30 04:46:00 read_access   
    APIEL1.Piel.1572425190998 2055645 XtremIO_R20  1     20G      512     0       0      APIEL1     2         disabled        disabled            disabled       0            0    ok        scheduler              readonly    2019-10-30 04:46:30 read_access   
    test.Piel.1572425190998   2055646 XtremIO_R20  1     4G       512     0                    0      test     1         disabled        disabled            disabled       0            0   ok        scheduler              readonly    2019-10-30 04:46:30 read_access   
    APIEL1.Piel.1572425220012 2055647 XtremIO_R20  1     20G      512     0       APIEL1              2         disabled        disabled            disabled       0            0   ok        scheduler              readonly    2019-10-30 04:47:00 read_access   
    test.Piel.1572425220012   2055648 XtremIO_R20  1     4G       512     0       0      test                1           disabled        disabled            disabled       0            0   ok        scheduler              readonly    2019-10-30 04:47:00 read_access       
       
          --filtering a target by Port-type
   
   
    xmcli (tech)> show-targets   
   
    Name           Index Cluster-Name Index Port-Type Port-Address                                            Mac-Addr          Port-Speed Port-State Health-Level  Storage-Controller-Name Index TG-Name Index MTU  Jumbo-Frames Certainty Relative-Id Target-Port-HW-Label   
    X1-SC1-target1 1     XtremIO_R20  1     iscsi     iqn.2008-05.com.xtremio:fnm00191000909-514f0c501c6f4f01 00:90:fa:c4:b4:51 10Gb       down       level_1_clear X1-SC1                  1     Default 1     1500 False        ok        5           Port1   
    X1-SC1-target2 2     XtremIO_R20  1     iscsi     iqn.2008-05.com.xtremio:fnm00191000909-514f0c501c6f4f00 00:90:fa:c4:b4:4f 10Gb       down       level_1_clear X1-SC1                  1     Default 1     1500 False        ok        6           Port2   
    X1-SC1-target3 3     XtremIO_R20  1     fc        51:4f:0c:50:1c:6f:4f:01                                                   8GFC       up         level_1_clear X1-SC1                  1     Default 1     1500 False        ok        1           Port3   
    X1-SC1-target4 4     XtremIO_R20  1     fc        51:4f:0c:50:1c:6f:4f:00                                                   8GFC       up         level_1_clear X1-SC1                  1     Default 1     1500 False        ok        2           Port4   
    X1-SC2-target1 5     XtremIO_R20  1     iscsi     iqn.2008-05.com.xtremio:fnm00191000909-514f0c501c6f4f05 00:90:fa:fc:23:15 10Gb       down       level_1_clear X1-SC2                  2     Default 1     1500 False        ok        15          Port1   
    X1-SC2-target2 6     XtremIO_R20  1     iscsi     iqn.2008-05.com.xtremio:fnm00191000909-514f0c501c6f4f04 00:90:fa:fc:23:13 10Gb       down       level_1_clear X1-SC2                  2     Default 1     1500 False        ok        16          Port2   
    X1-SC2-target3 7     XtremIO_R20  1     fc        51:4f:0c:50:1c:6f:4f:05                                                   8GFC       up         level_1_clear X1-SC2                  2     Default 1     1500 False        ok        11          Port3   
    X1-SC2-target4 8     XtremIO_R20  1     fc        51:4f:0c:50:1c:6f:4f:04                                                   8GFC       up         level_1_clear X1-SC2                  2     Default 1     1500 False        ok        12          Port4   
   
    xmcli (tech)> show-targets filter=Port-Type:eq:fc   
   
    Name           Index Cluster-Name Index Port-Type Port-Address            Mac-Addr Port-Speed Port-State Health-Level  Storage-Controller-Name Index TG-Name Index MTU  Jumbo-Frames Certainty Relative-Id Target-Port-HW-Label   
    X1-SC1-target3 3     XtremIO_R20  1     fc        51:4f:0c:50:1c:6f:4f:01          8GFC       up         level_1_clear X1-SC1                  1     Default 1     1500 False        ok        1           Port3   
    X1-SC1-target4 4     XtremIO_R20  1     fc        51:4f:0c:50:1c:6f:4f:00          8GFC       up         level_1_clear X1-SC1                  1     Default 1     1500 False        ok        2           Port4   
    X1-SC2-target3 7     XtremIO_R20  1     fc        51:4f:0c:50:1c:6f:4f:05          8GFC       up         level_1_clear X1-SC2                  2     Default 1     1500 False        ok        11          Port3   
    X1-SC2-target4 8     XtremIO_R20  1     fc        51:4f:0c:50:1c:6f:4f:04          8GFC       up         level_1_clear X1-SC2                  2     Default 1     1500 False        ok        12          Port4   
    xmcli (tech)>   
                                                                                                                                

 

 

Notes:

 

 

   

      XMS MUST BE RUNNING 6.0.0-55 OR GREATER              
              There is no option to apply the filtering logic to xmcli commands with a 4. XMS.
           
           
            The complete Adminitrator's CLI Guide reference can be found in support.emc.com:           
                 -- For XMS 6.0 (and later):