My Oracle Support Banner

Steps For Deleting Devices in Unusable or Failing State From cfgadm After LUNs Have Already Been Removed (Doc ID 1639070.1)

Last updated on JULY 07, 2021

Applies to:

Qlogic FC HBA - Version All Versions to All Versions [Release All Releases]
Sun Storage FCoE CNA - Version All Versions to All Versions [Release All Releases]
Sun Storage FC HBA - Version All Versions to All Versions [Release All Releases]
Sun SPARC Enterprise M5000 Server - Version All Versions to All Versions [Release All Releases]
Emulex FC HBA - Version All Versions to All Versions [Release All Releases]
Information in this document applies to any platform.


This document is for Fibre Channel (FC) LUNs not iSCSI or SCSI LUNs, primarily addresses LUNs and Targets that were access via a FC Switch fabric.

For issues clearing device entries of FC LUNs from a Direct Attached Storage (DAS) unit see section "Direct Attached Storage (DAS)"

The procedures outlined here are practical when dealing with a single or small group of LUNs.
If a large number of LUNs have been removed then a reboot would be quickest and cleanest way to clear them.

If you have not yet started removing LUNs and/or Targets from Solaris go to following document first:
Best Practice "Before" Removing LUN(s) and/or Target(s) From a Solaris Server (Doc ID 1639048.1


Before Beginning

Before attempting any of the steps in this document it is "Highly Recommended" that a explorer output be collected so there is a before and after reference. See Explorer section at the end of this document below for instructions on preserving previous explorer outputs, upgrading to latest version of explorer and collecting new explorer with appropriate options.
This document deals with LUNs that have already been "intentionally" removed from Solaris server view, but device references in cfgadm, format, /var/adm/messages, etc. still exist and attempts to clear them using cfgadm command (see section below) have not succeeded.

These issues are primarily due to LUNs device tree entries still being seen or used by one or more applications on the server.

The disk may be seen in format as:

6. c4t500601653XXXXXXXd0 <drive type unknown> /pci@1,700000/SUNW,qlc@0,1/fp@0,0/ssd@w500601653XXXXXXX,0


in the messages files something like this:

Sep 10 10:51:28 server01 scsi: [ID 107833 kern.warning] WARNING: /pci@1,700000/SUNW,qlc@0,1/fp@0,0/ssd@w500601653XXXXXXX,0 (ssd50):
Sep 10 10:51:28 server01 drive offline

Any LUNs or Targets found to be in a NON-Optimal state and were not intentionally removed should be investigated before proceeding.

See doc
SAN Fibre Channel (FC) Storage Connectivity Issues (Doc ID 1502843.1)

Also recommend reviewing "How to Help Avoid These Types of Issues In The Future" section below as well.




cfgadm command

This command is used when a subset (not all) of LUNs under certain Targets have been removed from the storage side.

Normally, when a LUN is removed Solaris will change it to a "failed/failing" state in cfgadm command output then within 30 second it will change to a "unusable" state.

1. If LUNs have not changed to unusable state yet , try running the following command then check again:



To view full details, sign in with your My Oracle Support account.

Don't have a My Oracle Support account? Click to get started!

In this Document

My Oracle Support provides customers with access to over a million knowledge articles and a vibrant support community of peers and Oracle experts.