fcadmin config
[ -? ]
[ -e | -d ]
[ -t {target|initiator|unconfigured} ]
[ <adapter_name> ... ]
fcadmin [link_stats|fcal_stats|device_map] <adapter_name>
The fcadmin config command configures Fibre channel (FC) adapters. When no arguments are given, the fcadmin config command returns configuration information about all of the configurable FC adapter(s) on the node. If no configurable FC adapters exist, the fcadmin config command is not supported and an error is returned.
The fcadmin config command displays the following information:
Adapter:
An adapter name of the form Xy, where X is a number
and y is a letter (for example, 0a or 1b).
Type: The type of adapter: initiator or target. The adapter type is determined by which device driver controls the adapter. When the storage initiator driver is attached, the adapter is an initiator. When the FCP target mode driver is attached, the adapter is a target. A node reboot is required to attach a new driver when the adapter type is changed. The storage initiator driver is attached prior to any configuration changes. The default adapter type is initiator.
Status:
The status of the adapter, online or offline,
reported from the attached driver. Before changing
the adapter type, the status must indicate that the
adapter is offline.
State: The configuration state of the adapter. Use the configuration state to track changes in the type and state of the adapter.
The following configuration states exist:
FAS> fcadmin config Local Adapter Type State Status --------------------------------------------------- 0a initiator CONFIGURED online 0b initiator UNCONFIGURED offline 0c initiator PENDING (target) offline 0d target PENDING (unconfigured) offline
Repair When Data ONTAP is fully initialized and running, configuring an adapter with the fcadmin config utility records the adapter configuration in both the node's boot environment and on-disk, in the node's root volume. Following a console set_defaults operation, a maintenance head swap, or other event that destroys the boot environment state, the initiator driver is attached to all configurable adapters during boot. This ensures that all storage loops are discovered during boot. After the node's root volume comes online, the boot environment configuration is checked against the on-disk configuration information. If a misconfiguration is detected, the boot environment information is restored and the node automatically reboots to attach the correct drivers and restore the original configuration. This provides consistency between maintenance head swaps and other events which destroy the boot environment.
Maintenance Mode Operation
You can use the fcadmin config utility while in
Maintenance Mode. After changing the adapter
configuration in Maintenance Mode, a reboot is
required for the change to take effect. When run
from Maintenance Mode, no on-disk configuration
information can be stored because the node's root
volume is unavailable. To account for this, the
fcadmin config utility indicates that the boot
environment configuration needs to be recorded ondisk
during a subsequent reboot. After changing
the adapter configuration in Maintenance Mode, the
boot environment configuration becomes canonical.
Otherwise, the on-disk configuration is canonical.
New Installations
Following a new installation of Data ONTAP, the ondisk
configuration information is undefined. When
this condition is encountered, then the boot
environment configuration becomes canonical and the
on-disk configuration is programmed to match the
existing boot environment configuration. In this
way the adapter configuration is preserved across
new installations. To modify this behavior you must
perform a console set-defaults operation, and/or
use the fcadmin config utility in Maintenance Mode
to change the configuration, prior to installing
Data ONTAP.
Example output:
dopey(takeover)> partner fcadmin config Warning: The system has been taken over. Adapter configuration is not possible. Partner Adapter Type State Status --------------------------------------------------- 0a initiator CONFIGURED. --- 0b initiator UNCONFIGURED --- 0c target CONFIGURED --- 0d target CONFIGURED --- Maintenance head swaps in a CFO: During a maintenance head swap procedure in a CFO, if the configurable adapters are used for FCP target mode operation in a CFO, the adapter configuration must be changed before doing a giveback to avoid FCP service interruptions. This change will be attempted automatically and will result in a reboot before a giveback can be performed. In the event that the adapters are not automatically reconfigured, boot the new head into Maintenance Mode prior to doing the first giveback and use the fcadmin config utility to restore the adapter configuration. For more information about Maintenance Mode operation, see na_floppyboot(1). EMS MESSAGES fci.config.offline: The fci.config.offline message displays anytime an adapter fails to come online because of a mismatch in the configuration state. _NF_NF_ For example: surf> storage enable adapter 0a Host adapter 0a enable failed Tue Aug 3 16:13:46 EDT [surf: fci.config.offline:notice]: Fibre channel adapter 0a is offline because it is in the PENDING (target) state.
fci.config.state:
The fci.config.state message displays anytime an adapter has changed states:
For example: surf> fcadmin config -t target 0a A reboot is required for the new adapter configuration to take effect. Mon Aug 2 14:53:04 EDT [surf: fci.config.state:notice]: Fibre channel initiator adapter 0a is in the PENDING (target) state.
The fci.config.needsReboot message displays when a service is started while there are adapters in the PENDING state waiting for reconfiguration:
For example: surf> fcp start FCP service is running Thu Aug 5 16:09:27 EDT [surf: fci.config.needsReboot:warning]: Reboot the filer for Fibre channel target adapter(s) 5a 5b to become available.
fci.config.autoReboot:
Under some circumstances, the node automatically reboots to ensure the adapter configuration is correct. The fci.config.autoReboot message displays to notify the user of this condition. This condition is normally only encountered after a maintenance head swap procedure.
fci.config.error:
This message indicates an error has occurred during the Auto-reconfiguration process. The specified adapter(s) will be unavailable until the problem is fixed.
fcp.service.config:
The fcp.service.config message displays anytime the FCP service is started on a platform which supports fc configuration but no target adapters are present.
"platform does not support FC adapter configuration"
"adapter adapter_name is not configurable"
"can't find adapter adapter_name"
"can't configure adapter adapter_name to type type"
"invalid boardType value"
"invalid adapterType value"
"Invalid type argument: type"
"internal error"
"can't determine adapter adapter_name status"
"adapter adapter_name must be offline before changing configuration"
"adapter adapter_name failed to come online"
"adapter adapter_name failed to go offline"
"failed to configure adapter adapter_name to the <offline or online> state"
"adapter adapter_name is in use. Must set adapter offline by storage disable adapter command, or disconnect cable."