Skip to content

Commit 8582515

Browse files
ktoliverktoliver
authored
public repo edits
1 parent 7324602 commit 8582515

File tree

1 file changed

+37
-33
lines changed

1 file changed

+37
-33
lines changed

‎articles/service-fabric/service-fabric-cluster-windows-server-add-remove-nodes.md

Lines changed: 37 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
---
1+
---
22
title: Add or remove nodes to a standalone Service Fabric cluster | Microsoft Docs
33
description: Learn how to add or remove nodes to an Azure Service Fabric cluster on a physical or virtual machine running Windows Server, which could be on-premises or in any cloud.
44
services: service-fabric
@@ -22,52 +22,56 @@ After you have [created your standalone Service Fabric cluster on Windows Server
2222

2323
## Add nodes to your cluster
2424

25-
1. Prepare the VM/machine you want to add to your cluster by following the steps outlined in [Plan and prepare your Service Fabric cluster deployment](service-fabric-cluster-standalone-deployment-preparation.md)
25+
1. Prepare the VM/machine you want to add to your cluster by following the steps outlined in [Plan and prepare your Service Fabric cluster deployment](service-fabric-cluster-standalone-deployment-preparation.md).
2626

2727
2. Identify which fault domain and upgrade domain you are going to add this VM/machine to.
28-
When using certificates to secure the cluster they are expected to be installed in the local certificate stores in preparation for the node to join the cluster. The analog is applicable when using other forms of security.
2928

30-
3. Remote desktop (RDP) into the VM/machine that you want to add to the cluster
31-
4. Copy or [download the standalone package for Service Fabric for Windows Server](https://go.microsoft.com/fwlink/?LinkId=730690) to the VM/machine and unzip the package
32-
5. Run Powershell with elevated privileges, and navigate to the location of the unzipped package
33-
6. Run the *AddNode.ps1* script with the parameters describing the new node to add. The example below adds a new node called VM5, with type NodeType0 and IP address 182.17.34.52, into UD1 and fd:/dc1/r0. The *ExistingClusterConnectionEndPoint* is a connection endpoint for a node already in the existing cluster, which can be the IP address of *any* node in the cluster.
29+
If you use certificates to secure the cluster, certificates are expected to be installed in the local certificate stores in preparation for the node to join the cluster. The analog is applicable when using other forms of security.
3430

35-
Unsecure (prototyping):
31+
3. Remote desktop (RDP) into the VM/machine that you want to add to the cluster.
3632

37-
```
38-
.\AddNode.ps1 -NodeName VM5 -NodeType NodeType0 -NodeIPAddressorFQDN 182.17.34.52 -ExistingClientConnectionEndpoint 182.17.34.50:19000 -UpgradeDomain UD1 -FaultDomain fd:/dc1/r0 -AcceptEULA
33+
4. Copy or [download the standalone package for Service Fabric for Windows Server](https://go.microsoft.com/fwlink/?LinkId=730690) to the VM/machine and unzip the package.
3934

40-
```
35+
5. Run PowerShell with elevated privileges and go to the location of the unzipped package.
36+
37+
6. Run the *AddNode.ps1* script with the parameters describing the new node to add. The following example adds a new node called VM5, with type NodeType0 and IP address 182.17.34.52, into UD1 and fd:/dc1/r0. `ExistingClusterConnectionEndPoint` is a connection endpoint for a node already in the existing cluster, which can be the IP address of *any* node in the cluster.
38+
39+
Unsecure (prototyping):
4140

42-
Secure (Certificate-based):
41+
```
42+
.\AddNode.ps1 -NodeName VM5 -NodeType NodeType0 -NodeIPAddressorFQDN 182.17.34.52 -ExistingClientConnectionEndpoint 182.17.34.50:19000 -UpgradeDomain UD1 -FaultDomain fd:/dc1/r0 -AcceptEULA
43+
```
4344

44-
```
45-
$CertThumbprint= "***********************"
45+
Secure (certificate-based):
46+
47+
```
48+
$CertThumbprint= "***********************"
4649
47-
.\AddNode.ps1 -NodeName VM5 -NodeType NodeType0 -NodeIPAddressorFQDN 182.17.34.52 -ExistingClientConnectionEndpoint 182.17.34.50:19000 -UpgradeDomain UD1 -FaultDomain fd:/dc1/r0 -X509Credential -ServerCertThumbprint $CertThumbprint -AcceptEULA
50+
.\AddNode.ps1 -NodeName VM5 -NodeType NodeType0 -NodeIPAddressorFQDN 182.17.34.52 -ExistingClientConnectionEndpoint 182.17.34.50:19000 -UpgradeDomain UD1 -FaultDomain fd:/dc1/r0 -X509Credential -ServerCertThumbprint $CertThumbprint -AcceptEULA
4851
49-
```
52+
```
5053

51-
Once the script finishes running, you can check if the new node has been added by running the [Get-ServiceFabricNode](/powershell/module/servicefabric/get-servicefabricnode?view=azureservicefabricps) cmdlet.
54+
When the script finishes running, you can check whether the new node has been added by running the [Get-ServiceFabricNode](/powershell/module/servicefabric/get-servicefabricnode?view=azureservicefabricps) cmdlet.
5255

53-
7. To ensure consistency across different nodes in the cluster, you must initiate a configuration upgrade. Run [Get-ServiceFabricClusterConfiguration](/powershell/module/servicefabric/get-servicefabricclusterconfiguration?view=azureservicefabricps) to get the latest configuration file and add the newly added node to "Nodes" section. It is also recommended to always have the latest cluster configuration available in the case that you need to redeploy a cluster with the same configuration.
56+
7. To ensure consistency across different nodes in the cluster, you must initiate a configuration upgrade. Run [Get-ServiceFabricClusterConfiguration](/powershell/module/servicefabric/get-servicefabricclusterconfiguration?view=azureservicefabricps) to get the latest configuration file and add the newly added node to the "Nodes" section. It is also recommended to always have the latest cluster configuration available in case you need to redeploy a cluster that has the same configuration.
57+
58+
```
59+
{
60+
"nodeName": "vm5",
61+
"iPAddress": "182.17.34.52",
62+
"nodeTypeRef": "NodeType0",
63+
"faultDomain": "fd:/dc1/r0",
64+
"upgradeDomain": "UD1"
65+
}
66+
```
5467

55-
```
56-
{
57-
"nodeName": "vm5",
58-
"iPAddress": "182.17.34.52",
59-
"nodeTypeRef": "NodeType0",
60-
"faultDomain": "fd:/dc1/r0",
61-
"upgradeDomain": "UD1"
62-
}
63-
```
6468
8. Run [Start-ServiceFabricClusterConfigurationUpgrade](/powershell/module/servicefabric/start-servicefabricclusterconfigurationupgrade?view=azureservicefabricps) to begin the upgrade.
6569

66-
```
67-
Start-ServiceFabricClusterConfigurationUpgrade -ClusterConfigPath <Path to Configuration File>
70+
```
71+
Start-ServiceFabricClusterConfigurationUpgrade -ClusterConfigPath <Path to Configuration File>
72+
```
6873

69-
```
70-
You can monitor the progress of the upgrade on Service Fabric Explorer. Alternatively, you can run [Get-​Service​Fabric​Cluster​Upgrade](/powershell/module/servicefabric/get-servicefabricclusterupgrade?view=azureservicefabricps)
74+
You can monitor the progress of the upgrade on Service Fabric Explorer. Alternatively, you can run [Get-ServiceFabricClusterUpgrade](/powershell/module/servicefabric/get-servicefabricclusterupgrade?view=azureservicefabricps).
7175

7276
### Add nodes to clusters configured with Windows Security using gMSA
7377
For clusters configured with Group Managed Service Account(gMSA)(https://technet.microsoft.com/library/hh831782.aspx), a new node can be added using a configuration upgrade:
@@ -87,7 +91,7 @@ For clusters configured with Group Managed Service Account(gMSA)(https://technet
8791
```
8892
Start-ServiceFabricClusterConfigurationUpgrade -ClusterConfigPath <Path to Configuration File>
8993
```
90-
You can monitor the progress of the upgrade on Service Fabric Explorer. Alternatively, you can run [Get-​Service​Fabric​Cluster​Upgrade](/powershell/module/servicefabric/get-servicefabricclusterupgrade?view=azureservicefabricps)
94+
You can monitor the progress of the upgrade on Service Fabric Explorer. Alternatively, you can run [Get-ServiceFabricClusterUpgrade](/powershell/module/servicefabric/get-servicefabricclusterupgrade?view=azureservicefabricps)
9195

9296
### Add node types to your cluster
9397
In order to add a new node type, modify your configuration to include the new node type in "NodeTypes" section under "Properties" and begin a configuration upgrade using [Start-ServiceFabricClusterConfigurationUpgrade](/powershell/module/servicefabric/start-servicefabricclusterconfigurationupgrade?view=azureservicefabricps). Once the upgrade completes, you can add new nodes to your cluster with this node type.
@@ -125,7 +129,7 @@ Add the "NodesToBeRemoved" parameter to "Setup" section inside "FabricSettings"
125129
Start-ServiceFabricClusterConfigurationUpgrade -ClusterConfigPath <Path to Configuration File>
126130

127131
```
128-
You can monitor the progress of the upgrade on Service Fabric Explorer. Alternatively, you can run [Get-​Service​Fabric​Cluster​Upgrade](/powershell/module/servicefabric/get-servicefabricclusterupgrade?view=azureservicefabricps)
132+
You can monitor the progress of the upgrade on Service Fabric Explorer. Alternatively, you can run [Get-ServiceFabricClusterUpgrade](/powershell/module/servicefabric/get-servicefabricclusterupgrade?view=azureservicefabricps).
129133

130134
> [!NOTE]
131135
> Removal of nodes may initiate multiple upgrades. Some nodes are marked with `IsSeedNode=”true”` tag and can be identified by querying the cluster manifest using `Get-ServiceFabricClusterManifest`. Removal of such nodes may take longer than others since the seed nodes will have to be moved around in such scenarios. The cluster must maintain a minimum of 3 primary node type nodes.

0 commit comments

Comments
 (0)