volume select show

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.

Table 9: Current 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.

Table 10: Requested Volume Status

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