How to Configure a SCSI Device
The following procedure uses SCSI disk c1t4d0 as an example of configuring a SCSI device.
Become superuser.
Identify the device to be configured.
# cfgadm -al Ap_Id Type Receptacle Occupant Condition c0 scsi-bus connected configured unknown c0::dsk/c0t0d0 disk connected configured unknown c0::rmt/0 tape connected configured unknown c1 scsi-bus connected configured unknown c1::dsk/c1t3d0 disk connected configured unknown c1::dsk/c1t4d0 unavailable connected unconfigured unknown
Configure the SCSI device.
# cfgadm -c configure c1::dsk/c1t4d0
Verify that the SCSI device is configured.
# cfgadm -al Ap_Id Type Receptacle Occupant Condition c0 scsi-bus connected configured unknown c0::dsk/c0t0d0 disk connected configured unknown c0::rmt/0 tape connected configured unknown c1 scsi-bus connected configured unknown c1::dsk/c1t3d0 disk connected configured unknown c1::dsk/c1t4d0 disk connected configured unknown
How to Disconnect a SCSI Controller
Caution - Disconnecting a SCSI device must be done with caution, particularly
when you are dealing with controllers for disks that contain critical file
systems such as root (/), usr, var, and the swap partition. The dynamic reconfiguration
software cannot detect all cases where a system hang might result. Use this
procedure with caution.
The following procedure uses SCSI controller c1 as an example of disconnecting a SCSI device.
Become superuser.
Verify that the device is connected before you disconnect it.
# cfgadm -al Ap_Id Type Receptacle Occupant Condition c0 scsi-bus connected configured unknown c0::dsk/c0t0d0 disk connected configured unknown c0::rmt/0 tape connected configured unknown c1 scsi-bus connected configured unknown c1::dsk/c1t3d0 disk connected configured unknown c1::dsk/c1t4d0 disk connected configured unknown
Disconnect the SCSI controller.
# cfgadm -c disconnect c1 WARNING: Disconnecting critical partitions may cause system hang. Continue (yes/no)? y
Caution - This command suspends all I/O activity on the SCSI bus until
the cfgadm -c connect command is used. The cfgadm command does some basic checking to prevent critical partitions
from being disconnected, but it cannot detect all cases. Inappropriate use
of this command can result in a system hang and could require a system reboot. Verify that the SCSI bus is disconnected.
# cfgadm -al Ap_Id Type Receptacle Occupant Condition c0 scsi-bus connected configured unknown c0::dsk/c0t0d0 disk connected configured unknown c0::rmt/0 tape connected configured unknown c1 unavailable disconnected configured unknown c1::dsk/c1t10d0 unavailable disconnected configured unknown c1::dsk/c1t4d0 unavailable disconnected configured unknown
The controller and all the devices that are attached to it are disconnected from the system.
How to Connect a SCSI Controller
The following procedure uses SCSI controller c1 as an example of connecting a SCSI controller.
Become superuser.
Verify that the device is disconnected before you connect it.
# cfgadm -al Ap_Id Type Receptacle Occupant Condition c0 scsi-bus connected configured unknown c0::dsk/c0t0d0 disk connected configured unknown c0::rmt/0 tape connected configured unknown c1 unavailable disconnected configured unknown c1::dsk/c1t10d0 unavailable disconnected configured unknown c1::dsk/c1t4d0 unavailable disconnected configured unknown
Connect the SCSI controller.
# cfgadm -c connect c1
Verify that the SCSI controller is connected.
# cfgadm -al Ap_Id Type Receptacle Occupant Condition c0 scsi-bus connected configured unknown c0::dsk/c0t0d0 disk connected configured unknown c0::rmt/0 tape connected configured unknown c1 scsi-bus connected configured unknown c1::dsk/c1t3d0 disk connected configured unknown c1::dsk/c1t4d0 disk connected configured unknown
SPARC: How to Add a SCSI Device to a SCSI Bus
SCSI controller c1 provides an example of how to add a SCSI device to a SCSI bus.
Note - When you add devices, you specify the Ap_Id of the SCSI HBA (controller) to which the device is attached, not the Ap_Id of the device itself.
Become superuser.
Identify the current SCSI configuration.
# cfgadm -al Ap_Id Type Receptacle Occupant Condition c0 scsi-bus connected configured unknown c0::dsk/c0t0d0 disk connected configured unknown c0::rmt/0 tape connected configured unknown c1 scsi-bus connected configured unknown c1::dsk/c1t3d0 disk connected configured unknown
Add the SCSI device to the SCSI bus.
# cfgadm -x insert_device c1 Adding device to SCSI HBA: /devices/sbus@1f,0/SUNW,fas@1,8800000 This operation will suspend activity on SCSI bus: c1
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.
Connect the device and then power it on.
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
Verify that the device has been added.
# cfgadm -al Ap_Id Type Receptacle Occupant Condition c0 scsi-bus connected configured unknown c0::dsk/c0t0d0 disk connected configured unknown c0::rmt/0 tape connected configured unknown c1 scsi-bus connected configured unknown c1::dsk/c1t3d0 disk connected configured unknown c1::dsk/c1t4d0 disk connected configured unknown
A new disk has been added to controller c1.