Displays detailed information about the selected volume, including access control records, replication activity, and in-progress operations (for example, replication, bind, or pool move operations). You can specify (display) only one parameter at a time.
Format
volume select vol_name show|parameter
Variable
|
vol_name |
Name of a volume. |
Parameters
|
access |
Access control records. |
|
connections |
Active iSCSI connections. |
|
members |
Members that contain volume data. |
|
replicas |
Volume replicas. |
|
replication |
Replication partners storing volume replicas. |
|
schedules |
Snapshot and replication schedules. |
|
snapshots |
Snapshots. |
Examples
The following command displays detailed information about a volume:
> volume select newvol show
__________________________ Volume Information ___________________________
Name: newvol Size: 100GB
VolReserve: 100GB VolReserveInUse: 0MB
ReplReserveInUse: 0MB iSCSI Alias: newvol
iSCSI Name: ActualMembers: 1
iqn.2001-05.com.equallogic:0-8a0906- Snap-Warn: 10%
9711d1a02-47affd39be246375-newvol Snap-Depletion: delete-oldest
Description: Snap-Reserve: 100%
Snap-Reserve-Avail: 100% (100GB) Permission: read-write
DesiredStatus: online Status: online
Connections: 0 Snapshots: 0
Bind: Type: replicated
ReplicationReserveSpace: 100GB Replicas: 0
ReplicationPartner: group2 Pool: default
Transmitted-Data: 0MB Received-Data: 0MB
Pref-Raid-Policy: none Pref-Raid-Policy-Status: none
Thin-Provision: disabled Thin-Min-Reserve: 0% (0MB)
Thin-Growth-Warn: 0% (0MB) Thin-Growth-Max: 0% (0MB)
ReplicationTxData: 0MB
_________________________________________________________________________
____________________________ Access Records _____________________________
ID Initiator Ipaddress AuthMethod UserName Apply-To
--- ------------------ --------------- ---------- ---------- --------
1 172.17.30.22 none both
_________________________ Replication Partners __________________________
Partner Name CurrReplicas Status Remaining StartingTime
--------------- ------------ ---------------- ---------- ----------------
group2 0 ready 0MB None
_________________________ Operations InProgress _________________________
ID StartTime Progress Operation Details
-- -------------------- -------- ----------------------------------------
The Status field in the Volume Information section displays the current volume status, as described in Table 9: Current Volume Status. The requested status (DesiredStatus field) is set by an administrator and described in Table 10: Requested Volume Status.
|
Status |
Description |
|---|---|
|
online |
Volume was set online by an administrator, and no failures have occurred. Authorized hosts can access the volume. |
|
offline |
Volume was set offline by an administrator, but no failures have occurred. Hosts cannot access the volume. |
|
offline-snap-reserve-met |
Volume was automatically set offline because the reserved snapshot space was exceeded and the snapshot recovery policy dictates that the volume be set offline. Note: To correct this condition, increase the amount of reserved snapshot space. See volume select . |
|
offline-thin-max-grow-met |
Volume was automatically set offline because the in-use volume reserve reached the maximum in-use value. Note: To correct this condition, increase the value of the maximum in-use space level for the volume; see volume select . You can also add more space to the pool (by adding a member). |
|
offline-nospace-auto-grow |
Volume was automatically set offline because there is not enough free space in the pool for the thin-provisioned volume to grow. Note: To correct this condition, add more space to the pool (by adding a member). |
|
offline-member-down |
Volume was automatically set offline because a member that contains volume data is down or cannot be reached by the other members over the network. Note: To correct this condition, fix the problem that caused the member to go down or become unreachable. |
|
offline-lost-blocks |
Volume was automatically set offline because blocks were lost. Note: To correct this condition, choose how to handle the lost blocks. See volume select for more information. |
|
Status |
Description |
|---|---|
|
online |
Administrator set the volume online. Authorized hosts can access the volume. |
|
offline |
Administrator set the volume offline. Hosts cannot access the volume. |
|
online-lost-blocks |
Administrator chose to set the volume online despite lost blocks. Authorized hosts can access the volume. If an application attempts to read a lost block, an error will occur. If the block is re-written, no error will occur, and the block will no longer be marked lost. |
The following command displays the access control records for a volume:
> volume select dbvol2 show access
ID Initiator Ipaddress AuthMethod UserName Apply-To
-- --------- --------- ---------- -------- --------
1 182.19.1.200 none volume
2 182.19.2.120 chap dos3 both
The following command displays volume replicas being stored on partner beta1:
> volume select staff30 show replicas
____________________________ beta1 ______________________________
Name TimeStamp
---------------------------------- -------------------------
staff30.1-2006-07-10-21:50:30.1763 Mon Jul 10 21:50:30 2006
staff30.1-2006-07-10-22:50:05.1786 Mon Jul 10 22:50:05 2006
staff30.1-2006-07-10-23:49:59.1808 Mon Jul 10 23:49:59 2006
The following command displays information about the active iSCSI connections to a volume:
> volume select dbvol2 show connections
Initiator UpTime RxData TxData
---------- ------------ ------------- -----------
182.19.1.200 28min 58sec 0.00KB 12.00KB
The following command displays the amount of volume data on the members:
> volume select dbvol2 show members
Member Name Contribution
--------------- ------------
mem24 95.03GB
mem23 105.00GB