-a <attribute>, --attrib=<attribute> <devnum>*
This option reports the value of the specified attribute. If devnum is provided, attribute must be an attribute of the device. If devnum is not provided, attribute is considered a global attribute. For example, cddm --attrib=vendor 1 returns the name of the device vendor of device 1; and cddm --attrib=max_error_rate reports the global value for the maximum error rate health threshold applicable to all devices. See the --show option for sets of available attributes.
This option is used to check the proper connection of device cables and the working order of device lights. It causes the identify light (red LED) of the devices to illuminate in sequence, starting with the first slot and progressing to the last slot in roughly half-second steps. After all lights are on, all lights are turned off in the same order. This behavior repeats until this option is turned off.
This option is used to remove the default output formatting performed by other options. Only options subsequent to this option on the command line are affected.
-I, --interrogate devnum
This option creates a report of events for the specified device. The events in the report may come from one or multiple sources, all of which are identified in the report.
-i [on|off], --identify[=on|off] devnum
Turns on or off the identifying indicator of the specified device. For identify, if on or off is not specified, this option toggles the state. The identification is typically a slow blinking red light (roughly 1-second period) located at the front of the slot associated with the device. The identifying indicator remains on until turned off, or until the device fails, at which time the indicator stays on continuously.
–m devnum, --make_well devnum
Sets a device well again that was previously set sick or removed.
Be careful when using this option, as a sick device that is made well can negatively affect the data.
-r devnum, --remove devnum
Removes the specified device logically prior to being physically removed from the chassis. A logically removed device is dismounted from the file system and then either spun-down (if an HDD) or placed on standby (if an SSD).
When the logical removal process is completed, a notification is posted to the console indicating that the device can now be pulled. After being logically removed but before being pulled, the red identifying indicator on the device displays a fast blink (roughly half-second period or faster).
Note ● It is always best to logically remove a device before pulling it from the chassis. A failed device does not need to be logically removed.
- A logically removed device cannot be place back online until it has been removed from the chassis. All contents of a logically removed device are deleted when it is reinserted into the chassis.
-s value, --show=<set,set,...> <devnum>*
This option is used to show selected sets of global or device information.
Note ● Sets that require a devnum cannot be mixed with sets that do not require a devnum.
- Collection of some device information can negatively affect device performance. To mitigate such impact, this information is automatically cached and updated, usually when the device is idle.
set selects one of the different categories of information defined as follows:
Show all available device information.
Shows device type specific information. This reports various points of information specific to the device technology, and is a function of vendor implementation.
Shows all error counters.
Shows the global settings used to monitor devices.
Displays the location of the given device within the chassis.
Shows information relative to a device’s health
Shows physical information about the device such as make, model, vendor, capacity, serial number, and so on.
Causes some information sets to be reported in raw data format. For example, this option causes the SATA S.M.A.R.T. attributes reported in the dev_spec set to be reported as it is collected from the device, as opposed to interpreting it.
Shows available Self-Monitoring, Analysis and Reporting Technology values. These values are technology specific (SCSI, ATA), and implementation is varied from vendor to vendor.
Show device state information only.
Shows device statistical information.
This suboption is not an information set, but instead, forces a refresh of the device information cache, possibly causing a momentary impact on device performance.
Reports the version of cddm and CDD drivers information.
Reports the version of cddm.
This option disables a policy enforced by cddm. This option must precede all other options on the command line for which a policy is to be violated.
Note Recommended practice is to use this option only for troubleshooting or other temporary purposes.
-X, --unsuspend devnum
Note The -X option applies only to CDE470 systems. Its use with other platforms results in the display of an error message. Do not use this option with COS releases that do not support the CDE470.
This option cancels suspension of a suspended but not-yet-pulled device. (See the suspend option.)
-x [minutes], --suspend[=minutes] devnum
Note The -x option applies only to CDE470 systems. Its use with other platforms results in the display of an error message. Do not use this option with COS releases that do not support the CDE470.
The suspend option prepares a healthy device to be safely removed from the chassis, allowing it to be reinserted later without incurring data loss.
The volume on the suspended device is not dismounted from the file system, but is placed in a quiescent state. The file system does not attempt to access the volume during the suspend period. While a device is suspended, any necessary data on the device is reconstructed from data on other devices.
A device cannot remain suspended indefinitely due to a potential performance impact to the system. The default amount of time that a device may remain suspended is 20 minutes. A suspended and removed device that is reinserted before the suspend period expires is automatically and immediately placed online, and its volume is returned to full operation.
If the suspend period expires before the device is reinserted, the device is considered lost, and its volume is abandoned by the file system. A suspended device reinserted after the suspend period expires is considered a new device, and its current contents are discarded. If a suspended and removed device is replaced with another device, the suspended volume is discarded by the file system. The replacement device is considered new, and its current contents are discarded.
If a suspended device is not pulled from the chassis, it returns to online and normal operation when the suspend period expires. A suspended but not yet removed device can be unsuspended with the unsuspend option.
The minutes parameter may be provided to override the default suspend period. The suspend option with the minute parameter may be used on an already suspended device to modify the current suspend period.