Data ONTAP® PowerShell Toolkit

Switch to clustered Data ONTAP documentation.

Cmdlet: Set-NaFcpClusterMode


NAME
Set-NaFcpClusterMode

SYNOPSIS
Set the current cfmode setting for the system.

SYNTAX
Set-NaFcpClusterMode [-Mode] <String> [-Force] [-Controller <NaController>]
[<CommonParameters>]


DESCRIPTION
Set the current cfmode setting for the system. This setting controls how the
cluster behaves during a takeover/giveback. It also controls if the filer s
hould use multiple virtual target adapters per physical target adapter. fcp
service must be stopped before executing this API. If cfmode is set to 'dua
l_fabric' the filer connects to the FC fabric in loop mode and all initiator
s need to have multipathing software. If cfmode is set to 'mixed' the filer
connects to the FC fabric in loop mode and assigns multiple virtual identiti
es to each physical FC target adapter. If cfmode is set to 'partner' the fil
er connects to the FC fabric in ptp mode. The B-port on each FC target adapt
er proxies commands for the partner over the cluster interconnect. If cfmode
is set to 'standby' the B-port is in standby mode and takes over the partne
r WWNN and WWPN during a cluster takeover. A ptp connection is used in this
case. If cfmode is set to 'single_image' the filer connects to the FC fabri
c in ptp mode by default but is configurable, and all luns in the cluster ar
e visible on all FC target ports. In this mode all hosts require multipathin
g software.

On filers with only one FCP target port the valid cfmodes are 'dual_fabric',
and 'single_image'

On filers with more than FCP target port the valid cfmodes are 'mixed', 'par
tner', 'standby' and 'single_image'.

When setting the cfmode to 'single_image' configuration checks are performed
. If these checks fail an EPERM error will be returned. See the 'TestNaLun
Config -CFMode' cmdlet for more information.


PARAMETERS
-Mode <String>
Set current cfmode setting. Possible values: dual_fabric, mixed, partner
, standby, single_image

Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false

-Force
Forcibly change the cfmode, overriding cluster partner checks.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Controller <NaController>
The Data ONTAP controller object, embodied by an NaController object. T
his parameter is returned by the Connect-NaController cmdlet. If not sp
ecified, the value in the global variable CurrentNaController is used.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".

INPUTS



OUTPUTS



NOTES


Category: fcp
API: fcp-set-cfmode

-------------- Example 1 --------------

C:\PS>Set-NaFcpClusterMode single_image


Set the cfmode to 'single_image'.






RELATED LINKS
Get-NaFcpClusterMode







 Data ONTAP® PowerShell Toolkit