SATA Hot-Plugging With the cfgadm Command

SATA controller and port multiplier device ports are represented by attachment points in the device tree. SATA devices that are connected and configured on the system are shown as attachment point name extension. The terms attachment point and SATA port can be used interchangeably.

The cfgadm syntax that is used with SATA devices is slightly different than cfgadm syntax for SCSI or PCI devices.

You can display SATA device information as follows:

% cfgadm -al
Ap_Id                          Type         Receptacle   Occupant     Condition
sata0/0::dsk/c7t0d0            disk         connected    configured   ok
sata0/1::dsk/c7t1d0            disk         connected    configured   ok
sata0/2::dsk/c7t2d0            disk         connected    configured   ok
sata0/3::dsk/c7t3d0            disk         connected    configured   ok
.
.
.

How to Unconfigure a SATA Device

In general, SATA devices must be unconfigured before they can be removed and replaced. If you attempt to unconfigure a device that is part of an active ZFS storage pool, you will see an error message similar to the following:

# cfgadm -c unconfigure sata5/7
Unconfigure the device at: /devices/pci@2,0/pci1022...
This operation will suspend activity on the SATA device
Continue (yes/no)? y
cfgadm: Hardware specific failure: Failed to unconfig device at ap_id: /devices/pci@2,0/pci10...

1. Become an administrator.
2. Identify the device to be unconfigured.

   # cfgadm -al | grep c7t0d0
   sata0/0::dsk/c7t0d0            disk         connected    configured   ok

3. Unconfigure the device.

   # cfgadm -c unconfigure sata0/0

   If you attempt to unconfigure the device by specifying the individual device, you will see a message similar to the following:

   # cfgadm -c unconfigure sata0/0::dsk/c7t0d0
   do_control_ioctl: open failed: errno:2
   cfgadm: Library error: Cannot open ap_id: /devices/pci@0,0/pci10...
   No such file or directory

4. Confirm that the device is unconfigured.

   # cfgadm | grep sata0/0
   sata0/0                        disk         connected    unconfigured ok

How to Configure a SATA Device

After a disk is physically removed or replaced, it can be configured.

1. Become an administrator.
2. Configure the device.

   # cfgadm -c configure sata0/0

3. Confirm that the device is configured.

   # cfgadm | grep sata0/0
   sata0/0::dsk/c7t0d0            disk         connected    configured   ok