Previous Topic: Volume ManagementNext Topic: volume list Command Output Specification


list (Volume Management)--Retrieve List of Volumes

List volumes in the specified scope

Syntax
volume list --all [--verbose][--batch] [--mounted]
volume list --global | _GLOBAL | _GLOBAL_RO [--verbose][--batch] [--mounted]
volume list server=<name> [ --verbose ][ --batch ] [--mounted]
volume list <name> [ --verbose ] [ --batch ] [ --all ] [--mounted]
  
Arguments
name

application, catalog, class, cache, or server name.

For global catalogs, the format of name is /catalog.

For application volumes, the format of name is application.

For application class volumes, the format of name is application:class.

For local catalogs, the format of name is application/local.

For local catalog class volumes, the format of name is application/local:class.

For cached volumes, the format of name is application/volcache.

If server is specified, name is the name of a server.

--verbose

Include volume comment in the list

--batch

Display output in UDL format

--mounted

Display only those volumes that are mounted on the controller.

--all

List all volumes. When specified in addition to an application name, all volumes for that application are listed.

--global

List all global volumes.

--_GLOBAL

List global volumes.

--_GLOBAL_RO

List only global read-only volumes.

--server=<name>

List all volumes that have at least one mirror on the specified server.

Examples
volume list --all

List all volumes

volume list server=srv2

List all volumes with a mirror on 'srv2'

volume list my-app

List volumes for 'my-app'

volume list my-app --all

List ALL volumes for 'my-app'

volume list my-app/volcache

List instance volumes for 'my-app'

volume list my-app:DBASE

List volumes for application singleton class 'DBASE'

volume list /system:MYSQL5

List volumes for global catalog class 'MYSQL5'

volume list _GLOBAL

List all global read-write volumes

volume list _GLOBAL_RO

List all global read-only volumes

Notes: If no name is specified and the --sys option is specified, all volumes in the grid are listed.

If an application name is specified and the --all option is specified, ALL volumes for the application are listed.

A specification of the output of this command can be found here.

Typical Output
Scope               Name               Size(MB)   Server              State       Filesystem   Mirrored   Mount State
   ---------------------------------------------------------------------------------------------------------------------
   perf                perf               2500       srv2,srv3           ok          ext3         Y          available
   perf                perf1              2500       srv2                ok          ext3         N          available
   perf                PERF1.boot         1650       srv2,srv3           ok          ext3         Y          available
   sugarcrm            code               50         srv2,srv3           ok          ext3         Y          in_use
   sugarcrm            config             50         srv1,srv2           ok          ext3         Y          in_use
   sugarcrm            data               50         srv3,srv1           ok          ext3         Y          in_use
   sugarcrm            logs               50         srv2,srv3           ok          ext3         Y          in_use
   test                uservol            10         srv2,srv3           ok          ext3         Y          available
   applfc/local        in1.boot           80         srv1,srv2           ok          ext3         Y          available
   applfc/local        in1.usr            200        srv2,srv3           ok          ext3         Y          available
   jsperf/catalog      PERF.boot          1650       srv2,srv3           ok          ext3         Y          available
   newcat/catalog      HLB.boot           80         srv3,srv1           ok          ext3         Y          available
   newcat/catalog      HLB.usr            200        srv2,srv3           ok          ext3         Y          available
   newcat/catalog      IN.boot            80         srv2,srv3           ok          ext3         Y          available
   newcat/catalog      IN.usr             200        srv2,srv3           ok          ext3         Y          available
   applfc/volcache     main.T_DRN.boot    901        srv1,srv3           ok          ext3         Y          available
   applfc/volcache     main.T_SRC.boot    1101       srv1,srv3           ok          ext3         Y          available
   bh/volcache         main.LUX.boot      80         srv3,srv1           ok          ext3         Y          available
   jsperf/volcache     main.PERF.boot     1650       srv2                degraded    ext3         Y          available
   jsperf/volcache     main.PERF1.boot    1650       srv3                degraded    ext3         Y          available
   jsperf/volcache     main.T_DRN.boot    901        srv1,srv2           ok          ext3         Y          available
   perf/volcache       main.PERF.boot     1650       srv3,srv2           ok          ext3         Y          available
   qa_app1/volcache    main.comp1.boot    901        srv1,srv2           degraded    ext3         Y          available
   qa_app1/volcache    main.comp2.boot    901        srv2,srv3           degraded    ext3         Y          available
   qa_app1/volcache    main.comp3.boot    901        srv3,srv1           ok          ext3         Y          available
   qa_app1/volcache    main.comp4.boot    901        srv1,srv2           degraded    ext3         Y          available
   qa_app1/volcache    main.comp5.boot    901        srv3,srv1           ok          ext3         Y          available
   qa_app1/volcache    main.comp6.boot    901        srv2,srv3           degraded    ext3         Y          available
   qa_app1/volcache    main.comp7.boot    901        srv1,srv2           degraded    ext3         Y          available
   qa_app1/volcache    main.comp8.boot    901        srv2,srv3           degraded    ext3         Y          available
   qa_gway/volcache    main.in1.boot      80         srv3,srv1           ok          ext3         Y          available
   qa_gway/volcache    main.in2.boot      80         srv1,srv2           ok          ext3         Y          available
   qa_gway/volcache    main.out1.boot     80         srv1,srv2           ok          ext3         Y          available
   qa_gway/volcache    main.out2.boot     80         srv3,srv1           ok          ext3         Y          available
   qa_gway/volcache    main.prc1.boot     901        srv2,srv3           ok          ext3         Y          available
   qa_gway/volcache    main.prc2.boot     901        srv2,srv3           ok          ext3         Y          available
   sugarcrm/volcache   main.admin.boot    80         srv2,srv3           ok          ext3         Y          in_use
   sugarcrm/volcache   main.config.boot   80         srv1,srv2           ok          ext3         Y          in_use
   sugarcrm/volcache   main.dbase.boot    80         srv3,srv1           ok          ext3         Y          in_use
   sugarcrm/volcache   main.logs.boot     80         srv3,srv1           ok          ext3         Y          in_use
   sugarcrm/volcache   main.mail.boot     80         srv1,srv2           ok          ext3         Y          in_use
   sugarcrm/volcache   main.srv1.boot     110        srv3,srv1           ok          ext3         Y          in_use
   sugarcrm/volcache   main.srv2.boot     110        srv1,srv2           ok          ext3         Y          in_use
   sugarcrm/volcache   main.usr.boot      80         srv2,srv3           ok          ext3         Y          in_use
   sugarcrm/volcache   main.webs.boot     80         srv2,srv3           ok          ext3         Y          in_use
   /proto              LINUX.boot         2048       srv2,srv3           ok          ext3         Y          available
   /system             HLB.boot           80         srv1,srv2           ok          ext3         Y          available
   /system             HLB.usr            200        srv3,srv1           ok          ext3         Y          in_use
   /system             IN.boot            80         srv2,srv3           ok          ext3         Y          available
   /system             IN.usr             200        srv1,srv2           ok          ext3         Y          in_use
   /system             LUX.boot           80         srv3,srv1           ok          ext3         Y          available
   /system             LUX.usr            200        srv2,srv3           ok          ext3         Y          available
   /system             MYSQL.boot         80         srv1,srv2           ok          ext3         Y          available
   /system             MYSQL.usr          200        srv3,srv1           ok          ext3         Y          in_use
   /system             NAS.boot           80         srv2,srv3           ok          ext3         Y          available
   /system             NAS.usr            200        srv1,srv2           ok          ext3         Y          in_use
   /system             NET.boot           80         srv2,srv3           ok          ext3         Y          available
   /system             NET.usr            200        srv1,srv2           ok          ext3         Y          available
   /system             OUT.boot           80         srv3,srv1           ok          ext3         Y          available
   /system             OUT.usr            200        srv2,srv3           ok          ext3         Y          in_use
   /system             WEB.boot           110        srv1,srv2           ok          ext3         Y          available
   /system             WEB.usr            400        srv3,srv1           ok          ext3         Y          in_use
   /test               LINUX.boot         2048       srv1,srv2           ok          ext3         Y          available
   /test               PERF.boot          1650       srv1,srv2           ok          ext3         Y          available

This section contains the following topics:

volume list Command Output Specification