Solaris 11: Administration of SCSI devices using cfgadm

Below are the operations that can be performed on a SCSI device

• Connect a SCSI Controller
• Add a SCSI Device to a SCSI Bus
• Replace an SCSI Disk on a SCSI Controller 
• Remove a SCSI Device 

Connect a SCSI Controller

Step 1: Verify that the device is disconnected before you connect it.

# cfgadm -al
Ap_Id Type Receptacle Occupant Condition
c2 unavailable disconnected configured unknown
c2::dsk/c2t0d0 unavailable disconnected configured unknown
c3 scsi-sas connected configured unknown
c3::dsk/c3t0d0 disk connected configured unknown
c3::dsk/c3t1d0 disk connected configured unknown
c3::dsk/c3t2d0 disk connected configured unknown
c3::dsk/c3t3d0 disk connected configured unknown

Step 2: Connect the SCSI controller.

# cfgadm -c connect c2

Step 3: Verify that the SCSI controller is connected.

# cfgadm -al
Ap_Id Type Receptacle Occupant Condition
c2 scsi-bus connected configured unknown
c2::dsk/c2t0d0 CD-ROM connected configured unknown
c3 scsi-sas connected configured unknown
c3::dsk/c3t0d0 disk connected configured unknown
c3::dsk/c3t1d0 disk connected configured unknown
c3::dsk/c3t2d0 disk connected configured unknown
c3::dsk/c3t3d0 disk connected configured unknown

Add a SCSI Device to a SCSI Bus

Step 1: Identify the current SCSI configuration.

# cfgadm -al
Ap_Id Type Receptacle Occupant Condition
c2 scsi-bus connected configured unknown
c2::dsk/c2t0d0 CD-ROM connected configured unknown
c3 scsi-sas connected configured unknown
c3::dsk/c3t0d0 disk connected configured unknown
c3::dsk/c3t1d0 disk connected configured unknown
c3::dsk/c3t2d0 disk connected configured unknown

Step 2: Add the SCSI device to the SCSI bus.

2a. Type the following cfgadm command.
For example:

# cfgadm -x insert_device c3
Adding device to SCSI HBA: /devices/pci@7c0/pci@0/pci@1/pci@0,2/LSILogic,sas@2
This operation will suspend activity on SCSI bus: c3

2b. Type y at the Continue (yes/no)? prompt to proceed.

Continue (yes/no)? y
SCSI bus quiesced successfully.
It is now safe to proceed with hotplug operation.
I/O activity on the SCSI bus is suspended while the hot-plug operation is in progress.

2c. Connect the device and then power it on.

2d. Type y at the Enter y if operation is complete or n to abort (yes/no)? prompt.
Enter y if operation is complete or n to abort (yes/no)? y

Step 3: Verify that the device has been added.

# cfgadm -al
Ap_Id Type Receptacle Occupant Condition
c2 scsi-bus connected configured unknown
c2::dsk/c2t0d0 CD-ROM connected configured unknown
c3 scsi-sas connected configured unknown
c3::dsk/c3t0d0 disk connected configured unknown
c3::dsk/c3t1d0 disk connected configured unknown
c3::dsk/c3t2d0 disk connected configured unknown
c3::dsk/c3t3d0 disk connected configured unknown
A new disk has been added to controller c3.

Replace an SCSI Disk on a SCSI Controller  


Step 1: Identify the current SCSI configuration.

# cfgadm -al
c2 scsi-bus connected configured unknown
c2::dsk/c2t0d0 CD-ROM connected configured unknown
c3 scsi-sas connected configured unknown
c3::dsk/c3t0d0 disk connected configured unknown
c3::dsk/c3t1d0 disk connected configured unknown
c3::dsk/c3t2d0 disk connected configured unknown
c3::dsk/c3t3d0 disk connected configured unknown

Step 2: Replace a device on the SCSI bus with another device of the same type.
2a. Type the following cfgadm command.
For example:

 # cfgadm -x replace_device c3::dsk/c3t3d0
Replacing SCSI device: /devices/pci@7c0/pci@0/pci@1/pci@0,2/LSILogic,sas@2/sd@3,0
This operation will suspend activity on SCSI bus: c3

2b. Type y at the Continue (yes/no)? prompt to proceed.
I/O activity on the SCSI bus is suspended while the hot-plug operation is in progress.

 Continue (yes/no)? y
SCSI bus quiesced successfully.
It is now safe to proceed with hotplug operation.

2c. Power off the device to be removed and remove it.

2d. Add the replacement device. Then, power it on.
The replacement device should be of the same type and at the same address (target and LUN) as the device to be removed.

2e. Type y at the Enter y if operation is complete or n to abort (yes/no)? prompt.
Enter y if operation is complete or n to abort (yes/no)? y

Step 3 : Verify that the device has been replaced.

# cfgadm -al
Ap_Id Type Receptacle Occupant Condition
c2 scsi-bus connected configured unknown
c2::dsk/c2t0d0 CD-ROM connected configured unknown
c3 scsi-sas connected configured unknown
c3::dsk/c3t0d0 disk connected configured unknown
c3::dsk/c3t1d0 disk connected configured unknown
c3::dsk/c3t2d0 disk connected configured unknown
c3::dsk/c3t3d0 disk connected configured unknown

Remove a SCSI Device 

Step 1: Identify the current SCSI configuration.

# cfgadm -al
Ap_Id Type Receptacle Occupant Condition
c2 scsi-bus connected configured unknown
c2::dsk/c2t0d0 CD-ROM connected configured unknown
c3 scsi-sas connected configured unknown
c3::dsk/c3t0d0 disk connected configured unknown
c3::dsk/c3t1d0 disk connected configured unknown
c3::dsk/c3t2d0 disk connected configured unknown
c3::dsk/c3t3d0 disk connected configured unknown

Step 2: Remove the SCSI device from the system.
2a. Type the following cfgadm command.
For example:

# cfgadm -x remove_device c3::dsk/c3t3d0
Removing SCSI device: /devices/pci@7c0/pci@0/pci@1/pci@0,2/LSILogic,sas@2/sd@3,0
This operation will suspend activity on SCSI bus: c3

2b. Type y at the Continue (yes/no)? prompt to proceed.

Continue (yes/no)? y
SCSI bus quiesced successfully.
It is now safe to proceed with hotplug operation.
I/O activity on the SCSI bus is suspended while the hot-plug operation is in progress.

2c. Power off the device to be removed and remove it.

2d. Type y at the Enter y if operation is complete or n to abort (yes/no)? prompt.
Enter y if operation is complete or n to abort (yes/no)? y
Note – This step must be performed if you are removing a SCSI RAID device from a SCSI RAID array.

Step 3: Verify that the device has been removed from the system.

# cfgadm -al
Ap_Id Type Receptacle Occupant Condition
c2 scsi-bus connected configured unknown
c2::dsk/c2t0d0 CD-ROM connected configured unknown
c3 scsi-sas connected configured unknown
c3::dsk/c3t0d0 disk connected configured unknown
c3::dsk/c3t1d0 disk connected configured unknown
c3::dsk/c3t2d0 disk connected configured unknown