Start-​Service​Fabric​Cluster​Configuration​Upgrade

Upgrades a cluster configuration.

Syntax

Start-ServiceFabricClusterConfigurationUpgrade
     -ClusterConfigPath <String>
     [-HealthCheckRetryTimeoutSec <UInt32>]
     [-HealthCheckStableDurationSec <UInt32>]
     [-HealthCheckWaitDurationSec <UInt32>]
     [-MaxPercentDeltaUnhealthyNodes <Byte>]
     [-MaxPercentUnhealthyApplications <Byte>]
     [-MaxPercentUnhealthyNodes <Byte>]
     [-MaxPercentUpgradeDomainDeltaUnhealthyNodes <Byte>]
     [-TimeoutSec <Int32>]
     [-UpgradeDomainTimeoutSec <UInt32>]
     [-UpgradeTimeoutSec <UInt32>]
     [<CommonParameters>]

Description

The Start-ServiceFabricClusterConfigurationUpgrade cmdlet upgrades a cluster configuration by using a cluster configuration file in JavaScript Object Notation (JSON) format.

Examples

Example 1: Upgrade cluster configuration

PS C:\> Start-ServiceFabricClusterConfigurationUpgrade -ClusterConfigPath "configurationV2.json"

This cmdlet upgrades cluster configuration based on the cluster configuration file.

Required Parameters

-ClusterConfigPath

Specifies the path of the cluster configuration file.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-HealthCheckRetryTimeoutSec

Specifies the duration, in seconds, after which Service Fabric retries the health check if the previous health check fails.

Type:UInt32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-HealthCheckStableDurationSec

Specifies the duration, in seconds, that Service Fabric waits in order to verify that the cluster is stable before moving to the next upgrade domain or completing the upgrade. This wait duration prevents undetected changes of health right after the health check is performed.

Type:UInt32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-HealthCheckWaitDurationSec

Specifies the duration, in seconds, that Service Fabric waits before it performs the initial health check after it finishes the upgrade on the upgrade domain.

Type:UInt32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MaxPercentDeltaUnhealthyNodes

Specifies the maximum tolerated percentage of delta unhealthy nodes that can have aggregated health states of error. If the current unhealthy nodes do not respect the percentage relative to the state at the beginning of the upgrade, the cluster is unhealthy.

Type:Byte
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MaxPercentUnhealthyApplications

Specifies the maximum tolerated percentage of applications that can have aggregated health state of error. If the upgrade exceeds this percentage, the cluster is unhealthy.

Type:Byte
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MaxPercentUnhealthyNodes

Specifies the maximum percentage of nodes that can have aggregated health states of error. If the current unhealthy applications do not respect this percentage, the cluster is considered unhealthy.

Type:Byte
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MaxPercentUpgradeDomainDeltaUnhealthyNodes

Specifies the maximum percentage of upgrade domain delta unhealthy nodes that can have aggregated health states of error. If there is any upgrade domain where the current unhealthy nodes do not respect the percentage relative to the state at the beginning of the upgrade, the cluster is considered unhealthy.

Type:Byte
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-TimeoutSec

Specifies the time-out period, in seconds, for the operation.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UpgradeDomainTimeoutSec

Specifies the maximum time, in seconds, that Service Fabric takes to upgrade a single upgrade domain. After this period, the upgrade fails.

Type:UInt32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UpgradeTimeoutSec

Specifies the maximum time, in seconds, that Service Fabric takes for the whole upgrade. After this period, the upgrade fails.

Type:UInt32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False