There are several common types of failure:
Some drivers do not yet support DR operations. A DR-compatible driver must be suspendable. Use this command to test for suspendable drivers.
# cfgadm -x quiesce-test sysctrl#:slot#
DR may not yet support some types of I/O and CPU/memory boards in Enterprise 3x00, 4x00, 5x00, and 6x00 systems. Use the quiesce test (above) or refer to the latest release notes.
Before you attempt a DR unconfigure operation:
Devices must not be in use by the operating system
Drivers must be detachable or suspendable
If an unconfiguration operation fails because an I/O board has a busy or open device, the board is left only partially unconfigured. The operation sequence stopped at the busy device.
To regain access to the devices which were not unconfigured, the board must be completely unconfigured and then reconfigured.
In such a case, the system will log messages similar to the following:
NOTICE: unconfiguring dual-pci board in slot 7 NOTICE: dual-pci board in slot 7 partially unconfigured reason:sysc iohelp unconfigure: Device busy output from sysctrl unconfigure is:detach failed: /pci@f,4000/SUNW,isptwo@3/sd@2,0 is busy
To continue the unconfigure operation, unmount the device and retry the unconfigure operation. The board must be in the unconfigured state before you try to configure this board.
A configure operation may fail because an I/O board with a device does not currently support hot-plugging. In such a situation, the board is now only partially configured. The operation has stopped at the unsupported hot-plug device. In this situation, the board must be brought back to the unconfigured state before another configure attempt. In such a case the system will log messages similar to the following:
NOTICE: configuring dual-sbus-soc+ board in slot 4 NOTICE: dual-sbus-soc+ board in slot 4 partially configured reason:sysc iohelp configure: Bad address output from sysctrl configure is:attach failed: /sbus@8,0/SUNW,foo@d,10000/bar
To continue the configure operation, either remove the unsupported device's driver or replace it with a new version of the driver that will support hot-plugging.
DR does not automatically terminate use of all network interfaces on the board that is being disconnected. You must manually terminate the use of each interface.
DR does not allow an unconfigure operation on any interface that fits any of the following conditions. In these cases, the unconfigure operation fails and DR displays an error message. The operation fails if:
The interface is the primary network interface for the machine; that is, the interface whose IP address corresponds to the network interface name contained in the file /etc/nodename. Note that bringing down the primary network interface for the machine prevents network information name services from operating, which results in the inability to make network connections to remote hosts using applications such as ftp(1), rsh(1), rcp(1), and rlogin(1). NFS client and server operations are also affected.
The interface is the active alternate for an Alternate Pathing (AP) meta device when the AP meta device is plumbed. Interfaces used by the AP system should not be the active path when the board is being unconfigured. Manually switch the active path to one that is not on the board being unconfigured. If no such path exists, manually execute the ifconfig down and ifconfig unplumb commands on the AP interface. (To manually switch an active path, use the apconfig(1M) command.)
All I/O devices must be closed before they are unconfigured. To see which processes have these devices open, use the fuser(1M) command.
Perform the following tasks for I/O devices.
If the redundancy features of Alternate Pathing or Solstice DiskSuite mirroring are used to access a device connected to the board, reconfigure these subsystems so that the device or network is accessible by way of controllers on other system boards.
Unmount file systems, including Solstice DiskSuite meta-devices that have a board resident partition. (Example: umount/partit)
Remove Solstice DiskSuite or Alternate Pathing databases from board-resident partitions. The location of Solstice DiskSuite or Alternate Pathing databases is explicitly chosen by the user and can be changed.
Remove any private regions used by Sun Volume Manager or Veritas Volume Manager. Volume Manager by default uses a private region on each device that it controls, so such devices must be removed from Volume Manager control before they can be detached.
Any RSM 2000 controllers on the board that is being detached should be taken offline, using the rm6 or rdacutil commands.
Remove disk partitions from the swap configuration.
Either kill any process that directly opens a device or raw partition, or direct it to close the open device on the board.
If a detach-unsafe device is present on the board, close all instances of the device and use modunload(1M) to unload the driver.If a detach-unsafe device is present on the board, close all instances of the device and use modunload(1M) to unload the driver.
Unmounting file systems may affect NFS client systems.
RPC time-outs occur by default after two minutes. Administrators may need to increase this time-out value to avoid time-outs during a DR-induced operating system quiescence, which may take longer than two minutes. These changes affect both the client and server machines.