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. Time required for display varies depending 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.
Note
Do not execute the sdxinfo command multiple times and continuously. Executing it multiple times and continuously may make execution take more time.
When the sdxinfo command is executed for the first time after starting the system, among the by-id files (symbolic link files created under the /dev/disk/by-id directory) managed by the udev function of Linux, the by-id files of disks which are not registered in classes may not exist temporarily because OS creates the by-id files again triggered by the GDS processes for obtaining the device information.
When access to the by-id files of disks which are not registered in classes fails, retry access.
Alternatively, when the sdxinfo command is executed for the first time after starting the system, do not access to the by-id files of disks which are not registered in classes.
PRIMARY OPTIONS
Primary options indicate the type of objects or the information of I/O Response Time Assurance Function to be displayed. If nothing is specified, only information on the pertinent object will be displayed.
Object types can be any combination of the following (except -I).
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 shadow 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
For viewing the COPY status of slices in proxy volumes, 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.
GPT type
MSDOS type (MBR 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.
Netmirror. It is connected to a netmirror 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.
sdX (for normal hard disks) mpathX (for mpath devices of DM-MP) emcpowerX (for emcpower disks) vdX (for virtual disks on a KVM guest)
X indicates the device identifier
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.
Note
When an I/O error has occurred in the root class, the E field of the disk information will not display "1" which indicates the I/O error status. Check the I/O error information using system log etc.
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, if it is 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.
Netmirror 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.
Netmirror. It belongs to a netmirror 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 Server(Native) is used, Symfoware Server(Native) 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.
Proxy JRM is "on."
Proxy JRM is "off."
Displays slice as an object classification.
When -e long option is used, this 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, 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, 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 an asterisk (*) is displayed.
Note
When using GDS Snapshot
For differential copy processing with EC
Displays the total number of blocks that have been equivalent status at the start time of copy processing and the blocks that have already been copied.
For copy processing with QuickOPC
When the type of ETERNUS Disk storage system and the firmware version are older than the following; ETERNUS DX90 S2, DX410 S2, DX440 S2, DX8100 S2, DX8700 S2 (Firmware version V10L30), displays the number of blocks that are equivalent to a copy source volume. If the copy source volume or copy destination volume are updated during the copy processing, CURBLKS at the completion time of copy processing is smaller than COPYBLKS for the updated blocks.
For copy processing with TimeFinder or SRDF
Displays an asterisk (*).
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 QuickOPC function.
Copying is in process using the Remote Equivalent Copy function.
Copying is in process with Dell EMC TimeFinder.
Copying is in process with 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 QuickOPC session.
Source or target of the Remote Equivalent Copy session.
Source or target of Dell EMC TimeFinder's BCV pair.
Source or target of Dell EMC SRDF's SRDF pair.
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.
QuickOPC session is on the copy processing and the "tracking" state.
EC or REC session suspended.
BCV pair or SRDF pair split.
QuickOPC session is the "tracking" state.
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 77 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 77 on |
CAUTION
Additional information may be displayed in accordance with new functions provided.
