To Respond to Farm Device Failure

Perform the following procedure on an control plane server if you receive a critical farm device failure message.

If the automatic failover property is set to true, no action needs to be taken.

Steps

1. List the current requests for the farm:

   request -lf farm ID

2. Review the list and obtain the requestID of the blocked replacePhysicalDevices request generated by the segment manager for the farm.

   You can identify the requestID by the replacePhysicalDevice request where state is listed as QUEUED_BLOCKED. The second argument of the replacePhysicalDevices request specifies the IDs of the devices that failed.

3. Verify that the physical device has actually failed and that it is not a spurious error. See Handling a Failed Control Plane Server for details. Temporary network failures can cause spurious errors.

   • If the device has not failed, or you do not want to replace the device, delete the request by typing request -d request ID.

   • If only one device failed, start the device replacement by unblocking the replacePhysicalDevices request typing request -u request-ID.

   • If multiple devices failed, you will see many replacePhysicalDevices requests.

     1. Identify the device ID of each of the failed devices.

     2. Run the replacedevice command with the device IDs of all the devices that you want to replace:

        replacedevice farm-ID failed-device-ID failed-device-ID failed-device-ID

        For example:

        replacedevice 5 19001 37001 2003

4. After replacing failed devices, delete the replacePhysicalDevices requests by typing:

   request -d request-ID