SYNOPSIS
sdxinfo [-ACDGSV] [-c class] [-o object] [-e label,long]
sdxinfo -I [-c class] [IOmonitor]
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. The time to display depends on the configuration of the objects.
The objects are displayed at random order. Even when the objects are created in the same order, the display order may vary.
Do not execute the sdxinfo command multiple times and continuously. Executing it multiple times and continuously may make execution take more time.
PRIMARY OPTIONS
Primary options indicate the type of objects to display or the information of I/O Response Time Assurance Function. If nothing is specified, only information on the pertinent object will be displayed.
Object types (except -I) can be any combination of the following.
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.
Class
Displays all specified objects, and class information of the related objects.
Disk
Displays all specified objects, and disk information of the related objects.
Group
Displays all specified objects, and group information of the related objects.
IOmonitor
Displays the information of I/O Response Time Assurance Function.
When the shutdown class is set with -c option, information will not be displayed.
Slice
Displays all specified objects, and slice information of the related objects.
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.
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.
Add the disk label type and output it to Class information.
Displays detailed object information.
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.
Note
If you want to refer to the copying process status of the proxy volume's slice, do not specify this option.
DISPLAYED INFORMATION
Information displayed in response to the sdxinfo command can be interpreted as follows.
Displays class as an object classification.
Displays the class name.
Displays one of the following values.
root class
local class
shared class
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.
When the -e long option is used, this displays hot spare operation, which can be either of the following.
Enables the hot spare.
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.
Displays the number of spare disks that are not connected to the group.
When the -e long option is specified, one of the following is displayed as the class description.
Class created with the sdxdisk -M command.
Shadow class created with the sdxshadowdisk -M command.
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.
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.
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.
Displays one of the following values to indicate the disk label type of a disk registered with a class when the -e label option is specified. For a root class, an asterisk (*) is displayed.
EFI type
VTOC type (SMI type)
Displays disk as an object classification.
Displays the disk name.
The type attribute value can be any of the following:
Mirror. It is connected to a mirror group.
Stripe. It is connected to a stripe group.
Concatenation. It is connected to a concatenation group.
Switch. It is connected to a switch group.
Keep. When it is registered with a class or connected to a group, the format and data of the disk are retained.
Single. Single volumes can be created on it.
Spare. "spare" is also displayed when it is connected to a group.
Undefined. Its usage is not determined yet.
Displays the class name to which the disk belongs.
Displays the group name to which the disk is connected. If the disk is not connected to any group, an asterisk (*) is displayed.
Displays the physical disk name in either the following formats. If the disk is not connected to the current node, an asterisk (*) is displayed.
cCtTdD (for normal hard disks) cCdD (for virtual disks in Oracle VM environment) 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.
Displays the size of the physical disk. The size is given in blocks (sectors.) If the disk is not connected to the current node, 0 (zero) is displayed.
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.
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.
Disk status can be any of the following:
Available for work.
Not available for work.
Not available for work, but available for disk exchanging.
When -e long option is used, displays error status of disk, which can be any of the following.
I/O error has not occurred on both the current node and the shared node.
I/O error has occurred on either the current node or the shared node.
Displays group as an object classification.
Displays the group name.
Displays the class name to which the group belongs.
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.
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).
The number of free allocatable blocks for a new volume. If the group is a lower level group, an asterisk (*) is displayed.
Displays the number of spare disks that can be connected to the group. Unless it is a mirror group, an asterisk (*) is displayed.
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.
When -e long option is used, displays type attribute value, which can be any of the following.
Mirror group.
Stripe group.
Concatenation group.
Switch group
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.
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.
Displays volume as an object classification.
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.
When the -e long option is used, displays type attribute, which can be any of the following.
Mirror. It belongs to a mirror group.
Stripe. It belongs to a stripe group.
Concatenation. It belongs to a concatenation group.
Switch. It belongs to a switch group.
Single. It belongs to a single disk.
Displays the class name to which the volume belongs.
Displays the highest level group name to which the volume belongs. When it belongs to a single disk, an asterisk (*) is displayed.
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.
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.
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.
The volume is being joined to a master volume.
The volume is being parted from a master volume.
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.
Skip resynchronization.
Execute resynchronization.
Note
This mode is normally off. If Symfoware is used, Symfoware changes the mode. Note that the open interface for setting or changing this option is not available.
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.
JRM is on.
JRM is off.
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.
Read and write mode.
Read only mode.
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.
Read and write mode.
Read only mode.
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.
The volume is locked from activating thereafter.
The volume is not locked from activating thereafter.
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.
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.
Displays the size in blocks (sectors).
Displays the volume status of the current node, which can be any of the following.
Ready for work.
Stopped.
Stopped, and cannot be activated due to problem with data.
Not yet allocated as a volume.
An area reserved for GDS control, so cannot be allocated as a volume.
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.
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 the disk label 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."
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 disk label.
For a shadow volume it always displays off no matter whether the shadow slice is registered with the disk label.
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.
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 parted proxy volume, an asterisk (*) is displayed.
JRM is "on".
JRM is "off".
Displays slice as an object classification.
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.
Displays the class name to which the slice belongs.
Displays the highest level group name to which the slice belongs.
If it is a single slice, an asterisk (*) is displayed.
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.
Displays the volume name to which the slice belongs.
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.
JRM is on.
JRM is off.
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.
Read and write mode.
Read only mode.
Displays the slice status on the current node, which can be any of the following.
Ready for work.
Stopped.
Due to a problem with data, has been temporarily detached from the volume.
Specifies a copy is underway, to maintain data uniformity.
Temporarily detached from volume. Slice is operating in isolation.
Temporarily detached from volume. Slice is stopping in isolation.
Stopped, with no operations possible.
When the -e long option is used, this displays one of the following copying process statuses. When the slice is not in COPY status, an asterisk (*) is displayed.
Copying is underway.
Copying is in process in the background, but you can access valid data.
Copying has been interrupted. Executing the sdxcopy -I command interrupts the copy.
Since many copying processes are in progress, it is waiting to be scheduled.
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.
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 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.
When the -e long option is used, this displays the copy delay time in milliseconds.
When not in COPY status, an asterisk (*) is displayed.
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.
Copying is in process using the soft copy function provided by the GDS sfdsk driver.
Copying is in process using the Equivalent Copy function.
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.
Copying is in process using the Remote Equivalent Copy function.
Copying is in process using Dell EMC TimeFinder.
Copying is in process using Dell EMC SRDF.
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.
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.
Source or target of the Equivalent Copy session.
Source or target of the One Point Copy session.
Source or target of the Remote Equivalent Copy session.
Source or target of a BCV pair with Dell EMC TimeFinder.
Source or target of an SRDF pair with Dell EMC SRDF.
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.
Synchronized.
In process of copying.
EC or REC session suspended.
BCV pair or SRDF pair split.
Suspended due to an error.
Hardware suspended.
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.
Displays the class name.
Displays one of the following as an operation of I/O Response Time Assurance.
Enables I/O Response Time Assurance.
Disables I/O Response Time Assurance.
Displays the I/O Response time (seconds).
Displays the asterisk (*), when the I/O Response Time Assurance is disabled.
Displays one of the following as a system panic mode.
Displays the asterisk (*), when I/O Response Time Assurance is disabled.
Enables system panic mode.
Disables system panic mode.
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 |
Displays the information of I/O Response Time Assurance for all of the class within the local node.
# sdxinfo -I
CLASS MODE TIME PANIC
------- ---- ---- -----
class0001 off * *
class0002 on 23 on |
Displays the information of I/O Response Time Assurance of the class called "class0002."
# sdxinfo -I -c class0002
CLASS MODE TIME PANIC
------- ---- ---- -----
class0002 on 23 on |
CAUTION
Additional information may be displayed in accordance with new functions provided.
