PRIMECLUSTER Global Disk Services Configuration and Administration Guide 4.1 (Solaris(TM) Operating System)

D.6 sdxinfo - Display object configuration and status information

SYNOPSIS

sdxinfo [-ACDGSV] [-c class] [-o object] [-e long]

 

DESCRIPTION

Use sdxinfo to display configuration and status information of the objects which the current node shares.
The sdxinfo command allows you to view configurations and status information of SDX objects, proxy objects and shadow objects.

 

PRIMARY OPTIONS

Primary options indicate the type of objects to display.
If nothing is specified, only information on the pertinent object will be displayed.

Object types can be any combination of the following.

 

-A

All

Displays all specified objects, and information on all related objects.
This is equivalent to -CDGSV.
If any other options are combined with this, they are ignored.

-C

Class

Displays all specified objects, and class information of the related objects.

-D

Disk

Displays all specified objects, and disk information of the related objects.

-G

Group

Displays all specified objects, and group information of the related objects.

-S

Slice

Displays all specified objects, and slice information of the related objects.

-V

Volume

Displays all specified objects, and volume information of the related objects.

 

SUB OPTIONS

Sub options are used to specify the names of objects to display.

If nothing is specified, the command is interpreted as if all objects at the current node had been specified.

-c class

The class indicates the class name whose information will be displayed.
If this option is omitted, this command is interpreted as if all classes had been specified.
In case of combining this option with the -o option, the objects related to the specified object within the class is displayed.

 

-e long

Displays detailed object information.

 

-o object

The object indicates the object name (class name, disk name, group name or volume name) whose information will be displayed.
If this option is omitted, this command is interpreted as if all object names had been specified.
In case of combining this option with the -c option, the objects related to the specified object within the class is displayed.

 

DISPLAYED INFORMATION

Information displayed in response to the sdxinfo command can be interpreted as follows.

Class information:

OBJ

Displays class as an object classification.

 

NAME

Displays the class name.

 

TYPE

Displays one of the following values.

root

root class

local

local class

shared

shared class

 

SCOPE

Displays the node names as scope attribute values. In a PRIMECLUSTER system, "(local)" is displayed for the root class, the node identifier (CF node name) is displayed for a local class, and node identifiers separated by colons (:) are displayed for a shared class.

 

HS

When the -e long option is used, this displays hot spare operation, which can be either of the following.

on

Enables the hot spare.

off

Disables the hot spare.
Be aware that spare disk automatic connection is prevented.

For a shadow class it always displays "on", but the hot spare feature is practically invalid since a shadow class cannot include a spare disk.

 

SPARE

Displays the number of spare disks that are not connected to the group.

 

SHADOW

When the -e long option is specified, one of the following is displayed as the class description.

0

Class created with the sdxdisk -M command.

1

Shadow class created with the sdxshadowdisk -M command.

 

HSMODE

Displays one of the following values to indicate the spare disk selection method for automatic connection by hot spare when the -e long option is specified. For a shadow class, an asterisk (*) is displayed.

exbox

External mode.
If an I/O error occurs in a disk of a disk array unit, this method selects a spare disk that belongs to a different disk case from that of the failed disk. If an I/O error occurs in a disk irrelevant to a disk array unit (such as an internal disk), it selects a spare disk that is connected to a different controller from that of the failed disk. When no applicable unconnected spare disk is found there, a spare disk that belongs to the same disk case or is connected to the same controller as that of the disk with the I/O error, is selected.

bybox

Internal mode.
If an I/O error occurs in a disk of a disk array unit, this method selects a spare disk that belongs to the same disk case as that of the failed disk. If an I/O error occurs in a disk irrelevant to a disk array unit (such as an internal disk), it selects a spare disk that is connected to the same controller as that of the failed disk. When no applicable unconnected spare disk is found there, spare disk automatic connection is prevented.

 

Disk information:

OBJ

Displays disk as an object classification.

 

NAME

Displays the disk name.

 

TYPE

The type attribute value can be any of the following:

mirror

Mirror. It is connected to a mirror group.

stripe

Stripe. It is connected to a stripe group.

concat

Concatenation. It is connected to a concatenation group.

switch

Switch. It is connected to a switch group.

keep

Keep. When it is registered with a class or connected to a group, the format and data of the disk are retained.

single

Single. Single volumes can be created on it.

spare

Spare. Also the same when the spare disk is connected to the group.

undef

Undefined. Its usage is not determined yet.

 

CLASS

Displays the class name to which the disk belongs.

 

GROUP

Displays the group name to which the disk is connected. If the disk is not connected to any group, an asterisk (*) is displayed.

 

DEVNAM

Displays the physical disk name in either the following formats. If the disk is not connected to the local node, an asterisk (*) is displayed.

cCtTdD        (for normal hard disks)
mphdI      (for MPHD disks)
mplbI      (for MPLB disks)
emcpowerN(for emcpower disks)

where C is the controller number, T is the target ID, D is the disk number, I is the MPHD instance number or the MPLB instance number, and N is the emcpower device number.

 

DEVBLKS

Displays the size of the physical disk. The size is given in blocks (sectors.) If the disk is not connected to the local node, 0 (zero) is displayed.

 

FREEBLKS

When the -e long option is used, displays the number of free allocatable blocks (sectors) for a new volume. If the disk is not a single disk, an asterisk (*) is displayed.

 

DEVCONNECT

Displays a list of node identifiers of the nodes to which the physical disk is connected, separated using colons ( : ) as delimiters. If PRIMECLUSTER has not been installed or the physical disk has not been registered in the PRIMECLUSTER resource database, an asterisk (*) is displayed.

 

STATUS

Disk status can be any of the following:

ENABLE

Available for work.

DISABLE

Not available for work.

SWAP

Not available for work, but available for disk exchanging.

 

E

When -e long option is used, displays error status of disk, which can be any of the following.

0

I/O error has not occurred on both the current node and the shared node.

1

I/O error has occurred on either the current node or the shared node.

 

Group information:

OBJ

Displays group as an object classification.

 

NAME

Displays the group name.

 

CLASS

Displays the class name to which the group belongs.

 

DISKS

Displays the name of disks or lower level groups that are connected to the group, separated using colons ( : ) as delimiters. In case of a stripe group, names are listed in the order they are striped. Likewise, in case of a concatenation group, names are listed in the order they are concatenated.

 

BLKS

Displays the size of the group, which is the total of available size of group (available capacity as volumes) plus one private slice size. Size is given in blocks (sectors).

 

FREEBLKS

The number of free allocatable blocks for a new volume.
If the group is a lower level group, an asterisk (*) is displayed.

 

SPARE

Displays the number of spare disks that can be connected to the group. Unless it is a mirror group, an asterisk (*) is displayed.

 

MASTER

When the -e long option is used, it displays the group name of master group. When it is not a proxy group, an asterisk (*) is displayed.

 

TYPE

When -e long option is used, displays type attribute value, which can be any of the following.

mirror

Mirror group.

stripe

Stripe group.

concat

Concatenation group.

switch

Switch group

 

WIDTH

When the -e long option is used, displays stripe width in blocks (sectors). If the group is not a stripe group, an asterisk (*) is displayed.

 

ACTDISK

Displays the disk name of the active disk when the -e long option is specified. Unless it is a switch group, an asterisk (*) is displayed.

 

Volume information:

OBJ

Displays volume as an object classification.

 

NAME

Displays the name of the volume.

If it is an area that cannot be allocated (area for private slice) or that can be allocated but have not (unallocated area), an asterisk (*) is displayed.

 

TYPE

When the -e long option is used, displays type attribute, which can be any of the following.

mirror

Mirror. It belongs to a mirror group.

stripe

Stripe. It belongs to a stripe group.

concat

Concatenation. It belongs to a concatenation group.

switch

Switch. It belongs to a switch group.

single

Single. It belongs to a single disk.

 

CLASS

Displays the class name to which the volume belongs.

 

GROUP

Displays the highest level group name to which the volume belongs. When it belongs to a single disk, an asterisk (*) is displayed.

 

DISK

When the -e long option is used, displays the name of the single disk to which the volume belongs. When it belongs to a group, an asterisk (*) is displayed.

 

MASTER

When the -e long option is used, it displays the volume name of master volume. When it is not a proxy volume, an asterisk (*) is displayed.

 

PROXY

When the -e long option is used, it displays the proxy volume status in one of the two ways as given below. When it is not a proxy volume, an asterisk (*) is displayed.

Join

The volume is being joined to a master volume.

Part

The volume is being parted from a master volume.

 

SKIP

Displays the skip-resynchronization mode setting, which can be either of the following.
If the volume is neither a mirror volume nor a single volume, an asterisk (*) is displayed.

on

Skip resynchronization.

off

Execute resynchronization.

Note that the interface for setting or changing this option is not available.

 

JRM

Displays the just resynchronization mode setting, which can be either on or off.
If the volume is neither a mirror volume nor a single volume, an asterisk (*) is displayed.

on

JRM is on.

off

JRM is off.

 

MODE

When the -e long option is used, it displays the access mode attribute value (default access mode) for the current node, which can be either of the following. If it is either an area for private slice or an unallocated area, an asterisk (*) is displayed.

rw

Read and write mode.

ro

Read only mode.

 

CMODE

When -e long option is used, it displays the present access mode of the activated volume from the current node. If the volume is not activated, an asterisk (*) is displayed.

rw

Read and write mode.

ro

Read only mode.

 

LOCK

When the -e long option is used, displays the lock mode of current node, which can be either of the following. If it is either a private area or an unallocated area, an asterisk (*) is displayed.

on

The volume is locked from activating thereafter.

off

The volume is not locked from activating thereafter.

 

1STBLK

Displays the block (sector) number of the first block.
The block number is the logical block number, which is the offset in the group to which the volume belongs, and not the physical block number indicating the offset on the physical disk. However, when the volume belongs to a single disk, the block number will match the physical block number on the single disk. Also, when it belongs to a mirror group to which a disk is directly connected or a switch group, the block number will match the physical block number on the disk.

 

LASTBLK

Displays the block (sector) number of the last block.
The block number is the logical block number, which is the offset in the group to which the volume belongs, and not the physical block number indicating the offset on the physical disk. However, when the volume belongs to a single disk, the block number will match the physical block number on the single disk. Also, when it belongs to a mirror group to which a disk is directly connected or a switch group, the block number will match the physical block number on the disk.

 

BLOCKS

Displays the size in blocks (sectors).

 

STATUS

Displays the volume status of the current node, which can be any of the following.

ACTIVE

Ready for work.

STOP

Stopped.

INVALID

Stopped, and cannot be activated due to problem with data.

FREE

Not yet allocated as a volume.

PRIVATE

An area reserved for GDS control, so cannot be allocated as a volume.

 

PSLICE

When the -e long option is used, displays the physical slice attribute value, which can be either of the following. If it is either a private area or an unallocated area, an asterisk (*) is displayed.

on

Physical slice attribute of the volume is set to "on." Among slices comprising volumes, slices on single disks, on disks connected to switch groups and on disks directly connected to mirror groups are registered with VTOC and have physical slices. If a lower level group is the only object directly connected to mirror group, the volume will not have a physical slice, regardless to this attribute being set to "on." Also, when the volume belongs to either a stripe group or a concatenation group, this attribute value will never be set to "on."

off

Physical slice attribute of the volume is set to "off." The volume has no physical slices, and none of the slices in the volume is registered to the VTOC.

For a shadow volume it always displays off no matter whether the shadow slice is registered with VTOC.

 

SNUM

When the -e long option is specified, the slice number of the slice configuring the volume is displayed.
If the physical slice attribute is off or no physical slice configures the volume, an asterisk (*) is displayed.

 

PJRM

When the -e long option is specified, either of the following values is displayed to indicate the just resynchronization mechanism mode on the proxy volume.
If it is not a proxy volume parted from the master volume with the sdxproxy Part command, an asterisk (*) is displayed.

on

JRM is "on".

off

JRM is "off".

 

Slice information:

OBJ

Displays slice as an object classification.

 

NAME

When -e long option is used, display the name of slice.
When the slice is not a mirror slice that is temporarily detached from the mirror volume using the sdxslice -M command, an asterisk (*) is displayed.

 

CLASS

Displays the class name to which the slice belongs.

 

GROUP

Displays the highest level group name to which the slice belongs.
If it is a single slice, an asterisk (*) is displayed.

 

DISK

Displays the name of the disk or the lower level group (i.e. the group to which this slice belongs, among the groups that are directly connected to the relevant highest level group) to which the slice belongs. If the highest level group is a switch group, the disk name of the active disk is displayed. If the highest level group is a stripe group or a concatenation group, an asterisk (*) is displayed.

 

VOLUME

Displays the volume name to which the slice belongs.

 

JRM

When the -e long option is used, displays the just resynchronization mode setting, which can be either on or off.
When the slice is not a mirror slice that is temporarily detached from the mirror volume using the sdxslice -M command, an asterisk (*) is displayed.

on

JRM is on.

off

JRM is off.

 

MODE

When -e long option is used, this displays the access mode, which can be either of the following.
When the slice is not a mirror slice that is temporarily detached from the mirror volume using the sdxslice -M command, an asterisk (*) is displayed.

rw

Read and write mode.

ro

Read only mode.

 

STATUS

Displays the slice status on the current node, which can be any of the following.

ACTIVE

Ready for work.

STOP

Stopped.

INVALID

Due to a problem with data, has been temporarily detached from the volume.

COPY

Specifies a copy is underway, to maintain data uniformity.

TEMP

Temporarily detached from volume. Slice is operating in isolation.

TEMP-STOP

Temporarily detached from volume. Slice is stopping in isolation.

NOUSE

Stopped, with no operations possible.

 

COPY

When the -e long option is used, displays either of the following copying process statuses.
When not in COPY status, an asterisk (*) is displayed.

run

Copying is underway.

bg

Copying is in process in the background, but you can access valid data.

intr

Copying has been interrupted. Executing the sdxcopy -I command interrupts the copy.

wait

Since many copying processes are in progress, it is waiting to be scheduled.

 

CURBLKS

When the -e long option is used, this displays the number of blocks (sectors) that have already been copied.
When CURBLKS and the later described COPYBLKS match, all copying has been completed.
When the slice is not in COPY status, or when copying is in process through TimeFinder or SRDF by use of GDS Snapshot, an asterisk (*) is displayed.

 

COPYBLKS

When the -e long option is used, this displays the number of blocks (sectors) that needs to be copied.
Usually this is the same size as the volume size it is registered with, but when just resynchronization copying is in process, the number of blocks that actually needs to be copied will be displayed.
When the slice is not in COPY status, an asterisk (*) is displayed.

 

DLY

When the -e long option is used, this displays the copy delay time in milliseconds.
When not in COPY status, an asterisk (*) is displayed.

 

CPTYPE

When the -e long option is used, one of the following values is displayed as copy function which is used for copying process between the master and the proxy. When copying is not in process, or if the volume to which the slice belongs is not a target volume of copying process between a master volume and a proxy volume, an asterisk (*) is displayed.

soft

Copying is in process using the soft copy function provided by the GDS sfdsk driver.

EC

Copying is in process using the Equivalent Copy function.

OPC

Copying is in process using the One Point Copy function. When the master and the proxy have been joined, and the copy source volume is active, the soft copy function may be involved in part of the copying process.

REC

Copying is in process using the Remote Equivalent Copy function.

ROPC

Copying is in process using the Remote One Point Copy function. When the master and the proxy have been joined, and the copy source volume is active, the soft copy function may be involved in part of the copying process.

TF

Copying is in process using EMC TimeFinder.

SRDF

Copying is in process using EMC SRDF.

 

CPSOURCE

When the -e long option is used, the volume name of source proxy volume which is used to restore data is displayed. When the volume to which the slice belongs is not a target master volume of restoring process, an asterisk (*) is displayed.

 

FUNC

Displays one of the following values to indicate the session type of the disk unit's copy function when the -e long option is specified. If there is no session, an asterisk (*) is displayed.

EC

Source or target of the Equivalent Copy session.

OPC

Source or target of the One Point Copy session.

REC

Source or target of the Remote Equivalent Copy session.

ROPC

Source or target of the Remote One Point Copy session.

TF

Source or target of a BCV pair with EMC TimeFinder.

SRDF

Source or target of an SRDF pair with EMC SRDF.

 

CPSTAT

Displays one of the following values to indicate the session status of the disk unit's copy function when the -e long option is specified. If there is no session, an asterisk (*) is displayed.

equiv

Synchronized.

copy

In process of copying.

suspend

EC or REC session suspended.

split

BCV pair or SRDF pair split.

error

Suspended due to an error.

halt

Hardware suspended.

 

PARTNER

When the -e long option is specified, displays a destination slice name if the slice is the source in the session of the disk unit's copy function, or a source slice name if it is the destination. If there is no session, an asterisk (*) is displayed.

 

RETURNED VALUE

Upon successful completion, a value of 0 is returned.
Otherwise, a non-zero value is returned.

 

USAGE EXAMPLES

Displays all the objects within the current node.

sdxinfo

 

Displays information on all the disks registered with the class called "Class1."

sdxinfo -A -c Class1

 

Use this to check whether an object called "foo" is currently being used.

sdxinfo -o foo

 

CAUTION

Additional information may be displayed in accordance with new functions provided.