Unconfiguring a Fabric Device

Before you unconfigure a fabric device, stop all activity to the device and unmount any file systems on the fabric device. See the administration documentation for the Solaris 10 OS for unmounting instructions. If the device is under any volume manager’s control, see the documentation for your volume manager before unconfiguring the device.

To Unconfigure a Fabric Device

This procedure describes how to unconfigure a fabric device that is attached to the fabric-connected host port c0.

1. Log in as root (su - root)..

2. Identify the device to be unconfigured.

   Only devices on a fabric-connected host port can be unconfigured.

   # cfgadm -al Ap_Id Type Receptacle Occupant Condition c0 fc-fabric connected configured unknown c0::50020f2300006077 disk connected configured unknown c0::50020f23000063a9 disk connected configured unknown c1 fc-private connected configured unknown c1::220203708b69c32b disk connected configured unknown c1::220203708ba7d832 disk connected configured unknown

3. Unconfigure the fabric device.

   # cfgadm -c unconfigure c0::50020f2300006077

4. Verify that the selected fabric device is unconfigured.

   # cfgadm -al Ap_Id Type Receptacle Occupant Condition c0 fc-fabric connected configured unknown c0::50020f2300006077 disk connected unconfigured unknown c0::50020f23000063a9 disk connected configured unknown c1 fc-private connected configured unknown c1::220203708b69c32b disk connected configured unknown c1::220203708ba7d832 disk connected configured unknown

To Unconfigure All Fabric Devices on a Fabric-Connected Host Port

This procedure describes how to unconfigure all configured fabric devices that are attached to a fabric-connected host port.

1. Log in as root (su - root)..

2. Identify the fabric devices to be unconfigured.

   Only devices on a fabric-connected host port can be unconfigured.

   # cfgadm -al Ap_Id Type Receptacle Occupant Condition c0 fc-fabric connected configured unknown c0::50020f2300006077 disk connected configured unknown c0::50020f23000063a9 disk connected configured unknown c1 fc-private connected configured unknown c1::220203708b69c32b disk connected configured unknown c1::220203708ba7d832 disk connected configured unknown

3. Stop all activity to each fabric device on the selected port and unmount any file systems on each fabric device.

   If the device is under any volume manager’s control, see the documentation for your volume manager before unconfiguring the device.

   # cfgadm -c unconfigure c0

4. Unconfigure all of the configured fabric devices on a selected port.

   ---

   Note –

   This operation repeats the unconfigure operation of an individual device for all the devices on c0. This process can be time-consuming if the number of devices on c0 is large.

   ---

5. Verify that all the devices on c0 are unconfigured.

   # cfgadm -al Ap_Id Type Receptacle Occupant Condition c0 fc-fabric connected unconfigured unknown c0::50020f2300006077 disk connected unconfigured unknown c0::50020f23000063a9 disk connected unconfigured unknown c1 fc-private connected configured unknown c1::220203708b69c32b disk connected configured unknown c1::220203708ba7d832 disk connected configured unknown

   Notice that the Occupant column of c0 and all the fabric devices attached to it are displayed as unconfigured.

To Unconfigure a Fabric Device Associated With Sun StorageTek Traffic Manager Multipathing-Enabled Devices

This procedure shows fabric-connected host ports c0 and c2 to illustrate how to unconfigure fabric devices associated with Sun StorageTek Traffic Manager software devices.

1. Log in as root (su - root)..

2. Identify the port WWN of the fabric device to be unconfigured.

   # cfgadm -al Ap_Id Type Receptacle Occupant Condition c0 fc-fabric connected configured unknown c0::50020f2300006077 disk connected configured unknown c0::50020f23000063a9 disk connected configured unknown c1 fc-private connected configured unknown c1::220203708b69c32b disk connected configured unknown c1::220203708ba7d832 disk connected configured unknown c2 fc-fabric connected configured unknown c2::50020f2300005f24 disk connected configured unknown c2::50020f2300006107 disk connected configured unknown

   In this example, the c0::50020f2300006077 and c2::50020f2300006107 Ap_Ids represent different port WWNs for the same device associated with a Sun StorageTek Traffic Manager software device. The c0 and c2 host ports are enabled for use by the Sun StorageTek Traffic Manager software.

3. Stop all device activity to each fabric device on the selected port and unmount any file systems on each fabric device.

   If the device is under any volume manager’s control, see the documentation for your volume manager for maintaining the fabric device.

4. Unconfigure fabric devices associated with the device.

   Only devices on a fabric-connected host port can be unconfigured through the cfgadm -c unconfigure command.

   # cfgadm -c unconfigure c0::50020f2300006077 c2::50020f2300006107

   ---

   Note –

   You can remove a device from up to eight paths individually, as in the example command cfgadm -c unconfigure c0::1111, c1::2222, c3::3333, and so on. As an alternative, you can remove an entire set of paths from the host, as in the example cfgadm -c unconfigure c0.

   ---

5. Verify that the selected devices are unconfigured.

   # cfgadm -al Ap_Id Type Receptacle Occupant Condition c0 fc-fabric connected configured unknown c0::50020f2300006077 disk connected unconfigured unknown c0::50020f23000063a9 disk connected configured unknown c1 fc-private connected configured unknown c1::220203708b69c32b disk connected configured unknown c1::220203708ba7d832 disk connected configured unknown c2 fc-fabric connected configured unknown c2::50020f2300005f24 disk connected configured unknown c2::50020f2300006107 disk connected unconfigured unknown

   Notice that the Ap_Ids c0::50020f2300006077 and c2::50020f2300006107 are unconfigured. The Occupant column of c0 and c2 still displays those ports as configured because they have other configured occupants.

   The Sun StorageTek Traffic Manager software devices associated with the Ap_Ids c0::50020f2300006077 and c2::50020f2300006107 are no longer available to the host using the Solaris 10 OS. The following two devices are removed from the host:

   /dev/rdsk/c6t60020F20000061073AC8B52D000B74A3d0s2

   /dev/rdsk/c6t60020F20000061073AC8B4C50004ED3Ad0s2

To Unconfigure One Path to a Multipathing Device

In contrast to the procedure in the preceding section, this procedure shows how to unconfigure one device associated with c2::50020f2300006107 and leave the other device, 50020f2300006077, configured. Only devices on a fabric-connected host port can be unconfigured through the cfgadm unconfigure command.

1. Log in as root (su - root)..

2. Identify the Ap_Id of the Sun StorageTek Traffic Manager software device to be unconfigured.

   # cfgadm -al Ap_Id Type Receptacle Occupant Condition c0 fc-fabric connected configured unknown c0::50020f2300006077 disk connected configured unknown c0::50020f23000063a9 disk connected configured unknown c1 fc-private connected configured unknown c1::220203708b69c32b disk connected configured unknown c1::220203708ba7d832 disk connected configured unknown c2 fc-fabric connected configured unknown c2::50020f2300005f24 disk connected configured unknown c2::50020f2300006107 disk connected configured unknown

   In this example, c0::50020f2300006077 and c2::50020f2300006107 Ap_Ids represent different port WWNs for the same device.

3. Unconfigure the Ap_Id associated with the device.

   ---

   Note –

   If the Ap_Id represents the last configured path to the device, stop all activity to the path and unmount any file systems on it. If the multipathing device is under any volume manager’s control, see the documentation for your volume manager for maintaining the fabric device.

   ---

   In the example that follows, the path represented as c2::50020f2300006107 is unconfigured, and c0::50020f2300006077 remains configured to show how you can unconfigure just one of multiple paths for a multipathing device.

   # cfgadm -c unconfigure c2::50020f2300006107

4. Verify that the selected path c2::50020f2300006107 is unconfigured.

   # cfgadm-al Ap_Id Type Receptacle Occupant Condition c0 fc-fabric connected configured unknown c0::50020f2300006077 disk connected configured unknown c0::50020f23000063a9 disk connected configured unknown c1 fc-private connected configured unknown c1::220203708b69c32b disk connected configured unknown c1::220203708ba7d832 disk connected configured unknown c2 fc-fabric connected configured unknown c2::50020f2300005f24 disk connected configured unknown c2::50020f2300006107 disk connected unconfigured unknown

   The devices associated with that Ap_Id are still available to a host using the Solaris 10 OS through the other path, represented by c0::50020f2300006077. A device can be connected to multiple Ap_Ids and an Ap_Id can be connected to multiple devices.

   /dev/rdsk/c6t60020F20000061073AC8B52D000B74A3d0s2 and /dev/rdsk/c6t60020F20000061073AC8B4C50004ED3Ad0s2

To Unconfigure All Fabric-Connected Devices With Multipathing Enabled

An Ap_Id on a fabric-connected host port is a path to the Sun StorageTek Traffic Manager software device.

When a Sun StorageTek Traffic Manager software device has multiple Ap_Ids connected to it, the device is still available to the host using the Solaris 10 OS after you unconfigure an Ap_Id. After you unconfigure the last Ap_Id, no additional paths remain and the device is unavailable to the host using the Solaris 10 OS. Only devices on a fabric-connected host port can be unconfigured.

1. Log in as root (su - root)..

2. Identify the devices to be unconfigured.

   # cfgadm -al Ap_Id Type Receptacle Occupant Condition c0 fc-fabric connected configured unknown c0::50020f2300006077 disk connected configured unknown c0::50020f23000063a9 disk connected configured unknown c1 fc-private connected configured unknown c1::220203708b69c32b disk connected configured unknown c1::220203708b9b20b2 disk connected configured unknown c2 fc-fabric connected configured unknown c2::50020f2300005f24 disk connected configured unknown

3. Unconfigure all of the configured devices on the selected port.

   # cfgadm -c unconfigure c2

   ---

   Note –

   This operation repeats the unconfigure command of an individual device for all devices on c2. This process can be time-consuming if the number of devices on c2 is large.

   ---

4. Verify that all devices on c2 are unconfigured.

   # cfgadm -al Ap_Id Type Receptacle Occupant Condition c0 fc-fabric connected configured unknown c0::50020f2300006077 disk connected configured unknown c1 fc-private connected configured unknown c1::220203708b69c32b disk connected configured unknown c1::220203708ba7d832 disk connected configured unknown c2 fc-fabric connected unconfigured unknown c2::50020f2300005f24 disk connected unconfigured unknown c2::50020f2300006107 disk connected unconfigured unknown

   Notice that the Occupant column lists c2 and all the devices attached to c2 as unconfigured.