Change IP Address of three head nodes in Service Fabric Cluster

junmin park 81 Reputation points

Hi team.

We are using three head nodes in Service Fabric Cluster with HPC Pack 2016 Update3(5.3.6450).
All management servers(Three Head Nodes, Two Remote Database Server, Two Active Directory Servers) are virtual machine on Hyper-V Host Server and computing nodes are pysical server.
All nodes only on enterprise network(Topology 5).

I trying to change the IP addresses of all servers, is there any problem?
(ex ->
I am concerned if the IP addresses of Head Nodes configured with Server Fabric Clusters changes.
Is there anyting I need to do after changing the IP addresses of all servers?


Azure Service Fabric
Azure Service Fabric
An Azure service that is used to develop microservices and orchestrate containers on Windows and Linux.
213 questions
0 comments No comments
{count} votes

Accepted answer
  1. vipullag-MSFT 19,056 Reputation points Microsoft Employee

    @junmin park

    Welcome to Microsoft Q&A Platform, thanks for posting your query here.

    Upgrading Standalone Clusters:

    On standalone/on-prem clusters the configuration rely on the "ClusterConfig.json" file, upgrades in the FabricSettings under the cluster properties section must be added on it, refer for moew info here.

    Every upgrade starts with the command below and follow by the "ClusterConfig.json" file:

    Start-ServiceFabricClusterConfigurationUpgrade -ClusterConfigPath <Path to Configuration File>    

    For more info refer this document.


    Some configurations can't be upgraded, such as endpoints, cluster name, node IP, etc. The new cluster configuration JSON is tested against the old one and throws errors in the PowerShell window if there's an issue. For more info refer this document.

    As mentioned above, few upgrades on the nodes need to be performed outside the Ring, so for example based on your issue, IP address of the node needs to be upgraded and point to a new one, in such scenario (Can't be upgraded) node needs to be removed from the cluster, then apply the new config and finally add the node back to the cluster.

    So below are the steps to apply the above config (Upgrade IP Address on standalone cluster):

    Before change IP Addresses on the Standalone clusters please note that you should take care of all networking configurations on standalone clusters by yourself, and in any scenario where you are trying to change the IP, the reconfigured node with new IP you add must still be reachable on the network from other nodes in the same cluster (all nodes need to still communicate with all nodes).


    In case you need to change all Cluster Nodes IP's the you have to recreate the cluster:

    • Remove the cluster
    • Create new json file "ClusterConfig.json"
    • Install it back with new IP's

    Also note that you have to make all the needed new DNS entries.

    Hope that helps.
    Please 'Accept as answer' if the provided information is helpful, so that it can help others in the community looking for help on similar topics.

    0 comments No comments

0 additional answers

Sort by: Most helpful