README.txt
|
# Network Controller Service Fabric Update
Update Service Fabric incrementally to the most recent supported version of Service Fabric. # Requirements - Service Fabric version prior to upgrade must be one of the following: 6.0.240.9494 6.2.301.9494 6.4.664.9590 7.1.409.9590 7.1.510.9590 8.0.536.9590 9.0.1017.9590 9.0.1155.9590 - Operating system must be one of the following: Windows Server 2022, AZ Stack HCI 21H2, AZ Stack HCI 22H2, AZ Stack HCI 23H2 - If the OS is AZ Stack HCI 23H2, Service Fabric will be updated to V9.1.1436.9590. Otherwise it will be updated to V7.1.510.9590. - If Powershell constrained language mode (CLM) is enabled, the script must be invoked from the Network Controller node and the initial Service Fabric version must be at least 7.1.510.9590. # Setup Create a CAB file containing the neccessary Service Fabric CABs. It's assumed the original name of each Service Fabric CAB will be maintained, e.g. MicrosoftServiceFabric.9.1.1436.9590.cab The following table can be used to determine which Service Fabric CABs must be included: | Version | Next Version | |:---------------:|:-------------:| | 6.0.240.9494 | 6.2.301.9494 | | 6.2.301.9494 | 6.4.664.9590 | | 6.4.664.9590 | 7.1.409.9590 | | 7.1.409.9590 | 7.1.510.9590 | | 7.1.510.9590 | 8.0.536.9590 | | 8.0.536.9590 | 9.0.1155.9590 | | 9.0.1155.9590 | 9.1.1436.9590 | Example: If a user's environment is using Service Fabric version 6.0.240.9494 on Windows Server 2022, they will need to create a CAB file that contains: MicrosoftServiceFabric.6.2.301.9494.cab MicrosoftServiceFabric.6.4.664.9590.cab MicrosoftServiceFabric.7.1.409.9590.cab MicrosoftServiceFabric.7.1.510.9590.cab Once the CAB file has been created, copy it to the desired directory on the NetworkController node where the Service Fabric updates will be invoked. # Invocation This script can be run from either the physical host (provided the correct Network Controller node credentials are passed) or from the Network Controller node itself. Depending on the initial version of Service Fabric, this script may take several hours to complete. Example (script invoked from host): Update-NetworkControllerServiceFabric -NodeName qntpf0jl-1 -CabLocation c:\sf.cab -Credential $credential Example (script invoked from NC node): Update-NetworkControllerServiceFabric -CabLocation c:\sf.cab - [string]$NodeName: hostname or IP address of NetworkController node to run Service Fabric updates on. Can be omitted if script is invoked directly on NC node. - [string]$CabLocation: Location of CAB on NetworkController node of $NodeName. - [System.Management.Automation.PsCredential]$Credential: Credentials for NetworkController node of $NodeName. Can be omitted if script is invoked directly on NC node. |