Skip Navigation Links | |
Exit Print View | |
System Administration Guide: Devices and File Systems Oracle Solaris 10 8/11 Information Library |
1. Managing Removable Media (Overview)
2. Managing Removable Media (Tasks)
3. Accessing Removable Media (Tasks)
4. Writing CDs and DVDs (Tasks)
5. Managing Devices (Overview/Tasks)
6. Dynamically Configuring Devices (Tasks)
Dynamic Reconfiguration and Hot-Plugging
Detaching PCI or PCIe Adapter Cards
Attaching PCI or PCIe Adapter Cards
PCIe Hot-Plugging With the (hotplug) Command
Troubleshooting PCI Hot Plug Operations (hotplug)
SCSI Hot-Plugging With the cfgadm Command (Task Map)
SCSI Hot-Plugging With the cfgadm Command
How to Display Information About SCSI Devices
How to Unconfigure a SCSI Controller
How to Configure a SCSI Controller
How to Configure a SCSI Device
How to Disconnect a SCSI Controller
SPARC: How to Connect a SCSI Controller
SPARC: How to Add a SCSI Device to a SCSI Bus
SPARC: How to Replace an Identical Device on a SCSI Controller
SPARC: How to Remove a SCSI Device
PCI or PCIe Hot-Plugging With the cfgadm Command (Task Map)
PCI or PCIe Hot-Plugging With the cfgadm Command
How to Display PCI Slot Configuration Information
How to Remove a PCI Adapter Card
Troubleshooting PCI Configuration Problems
Reconfiguration Coordination Manager (RCM) Script Overview
How Does the RCM Script Process Work?
RCM Script Processing Environment
Application Developer RCM Script (Task Map)
System Administrator RCM Script (Task Map)
Installing or Removing an RCM Script
Tape Backup RCM Script Example
What the Tape Backup RCM Script Does
Outcomes of the Tape Backup Reconfiguration Scenarios
Example--Tape Backup RCM Script
7. Using USB Devices (Overview)
9. Using InfiniBand Devices (Overview/Tasks)
11. Administering Disks (Tasks)
12. SPARC: Setting Up Disks (Tasks)
13. x86: Setting Up Disks (Tasks)
14. Configuring Oracle Solaris iSCSI Targets and Initiators (Tasks)
15. The format Utility (Reference)
16. Managing File Systems (Overview)
17. Creating and Mounting File Systems (Tasks)
18. Using The CacheFS File System (Tasks)
19. Configuring Additional Swap Space (Tasks)
20. Checking UFS File System Consistency (Tasks)
21. UFS File System (Reference)
22. Backing Up and Restoring UFS File Systems (Overview)
23. Backing Up UFS Files and File Systems (Tasks)
24. Using UFS Snapshots (Tasks)
25. Restoring UFS Files and File Systems (Tasks)
26. UFS Backup and Restore Commands (Reference)
27. Copying Files and File Systems (Tasks)
This section describes various SCSI hot-plugging procedures that you can perform with the cfgadm command.
Note - The SCSI framework generally supports hot-plugging of SCSI devices. However, you should consult your hardware documentation to confirm whether hot-plugging is supported for your SCSI devices.
These procedures use specific devices as examples to illustrate how to use the cfgadm command to hot-plug SCSI components. The device information that you supply, and that the cfgadm command displays, depends on your system configuration.
The following procedure uses SCSI controllers c0 and c1 and the devices that are attached to them in the examples of the type of device configuration information that you can display with the cfgadm command.
Note - If the SCSI device is not supported by the cfgadm command, the device does not display in the cfgadm command output.
# cfgadm -l Ap_Id Type Receptacle Occupant Condition c0 scsi-bus connected configured unknown c1 scsi-bus connected configured unknown
In this example, c0 and c1 represent two SCSI controllers.
# 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
Note - The cfgadm -l commands displays information about SCSI HBAs but not SCSI devices. Use the cfgadm -al command to display information about SCSI devices such as disk and tapes.
The following procedure uses SCSI controller c1 in the example of unconfiguring a SCSI controller.
# cfgadm -c unconfigure c1
# 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 unconfigured unknown
Notice that the Occupant column for c1 specifies unconfigured, indicating that the SCSI bus has no configured occupants.
If the unconfigure operation fails, see How to Resolve a Failed SCSI Unconfigure Operation.
The following procedure uses SCSI controller c1 in the example of configuring a SCSI controller.
# cfgadm -c configure c1
# 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
The previous unconfigure procedure removed all devices on the SCSI bus. Now all the devices are configured back into the system.
The following procedure uses SCSI disk c1t4d0 in the example of configuring a SCSI device.
# 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
# cfgadm -c configure c1::dsk/c1t4d0
# 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
The following procedure uses SCSI controller c1 in the example of disconnecting a SCSI device.
# 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
# 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. |
# 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/c1t3d0 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.
The following procedure uses SCSI controller c1 in the example of connecting a SCSI controller.
# 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/c1t3d0 unavailable disconnected configured unknown c1::dsk/c1t4d0 unavailable disconnected configured unknown
# cfgadm -c connect c1
# 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
SCSI controller c1 is used in the 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.
# 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
For example:
# 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
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.
Enter y if operation is complete or n to abort (yes/no)? y
# 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.
The following procedure uses SCSI disk c1t4d0 in the example of replacing an identical device on a SCSI controller.
# 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
For example:
# cfgadm -x replace_device c1::dsk/c1t4d0 Replacing SCSI device: /devices/sbus@1f,0/SUNW,fas@1,8800000/sd@4,0 This operation will suspend activity on SCSI bus: c1
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.
The replacement device should be of the same type and at the same address (target and lun) as the device to be removed.
Enter y if operation is complete or n to abort (yes/no)? y
# 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
The following procedure uses SCSI disk c1t4d0 in the example of removing a device on a SCSI controller.
# 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
For example:
# cfgadm -x remove_device c1::dsk/c1t4d0 Removing SCSI device: /devices/sbus@1f,0/SUNW,fas@1,8800000/sd@4,0 This operation will suspend activity on SCSI bus: c1
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.
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.
# 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
This section provides error messages and possible solutions for troubleshooting SCSI configuration problems. For more information on troubleshooting SCSI configuration problems, see cfgadm(1M).
cfgadm: Component system is busy, try again: failed to offline: device-path Resource Information ------------------ -------------------------- /dev/dsk/c1t0d0s0 mounted filesystem "/file-system"
You attempted to remove or replace a device with a mounted file system.
Unmount the file system that is listed in the error message and retry the cfgadm operation.
cfgadm: Component system is busy, try again: failed to offline: device-path Resource Information ------------------ -------------------------- /dev/dsk/device-name swap area
If you use the cfgadm command to remove a system resource, such as a swap device or a dedicated dump device, a similar error message is displayed if the system resource is still active.
Unconfigure the swap areas on the device that is specified and retry the cfgadm operation.
cfgadm: Component system is busy, try again: failed to offline: device-path Resource Information ------------------ -------------------------- /dev/dsk/device-name dump device (swap)
You attempted to remove or replace a dump device that is configured on a swap area.
Unconfigure the dump device that is configured on the swap area and retry the cfgadm operation.
cfgadm: Component system is busy, try again: failed to offline: device-path Resource Information ------------------ -------------------------- /dev/dsk/device-name dump device (dedicated)
You attempted to remove or replace a dedicated dump device.
Unconfigure the dedicate dump device and retry the cfgadm operation.
Use this procedure if one or more target devices are busy and the SCSI unconfigure operation fails. Otherwise, future dynamic reconfiguration operations on this controller and target devices will fail with a dr in progress message.