Skip to content

Commit 2c11e42

Browse files
Update load-balancer-migration-guidelines.md
1 parent d29669b commit 2c11e42

File tree

1 file changed

+47
-44
lines changed

1 file changed

+47
-44
lines changed

articles/hdinsight/load-balancer-migration-guidelines.md

Lines changed: 47 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ This transition is done in line with the announcement of retirement of Azure bas
1616

1717
### Long running clusters (when you don’t create and delete cluster frequently for your use case)
1818

19-
* **Scenario 1:** Existing HDInsight clusters without custom virtual network (No virtual network provided during cluster creation).
19+
* **Scenario 1:** Existing HDInsight clusters without custom virtual network (No virtual network used during cluster creation).
2020

2121
* No immediate disruption until Mar 31, 2025. However, we strongly recommend re-creating the cluster before Mar 31, 2025 to avoid potential disruption.
2222

@@ -26,7 +26,7 @@ This transition is done in line with the announcement of retirement of Azure bas
2626

2727
### New cluster creation
2828

29-
* **Scenario 1:** HDInsight clusters without custom virtual network (No virtual network selected during cluster creation).
29+
* **Scenario 1:** HDInsight clusters without custom virtual network (Creating cluster without any virtual network).
3030

3131
* In this case, no impact. You can recreate the cluster directly.
3232

@@ -65,66 +65,69 @@ This transition is done in line with the announcement of retirement of Azure bas
6565

6666
The most recommended way is to attach a network security group and a NAT gateway to the subnet. Since the existing subnet which has HDInsight clusters with Azure basic load balancers can't be associated with an NAT gateway due to incompatibility with basic load balancer, there are two scenarios:
6767

68-
#### Case 1: Existing subnet has no HDInsight clusters with Azure Basic Load Balancers
68+
* **Case 1:** Existing subnet has no HDInsight clusters with Azure Basic Load Balancers
6969

70-
Follow these steps:
70+
Follow these steps:
7171

72-
1. Create a new NAT gateway and a new Network Security Group(NSG) or use the existing ones.
73-
74-
> [!NOTE]
75-
> You could use an existing NAT gateway and NSG.
72+
1. Create a new NAT gateway and a new Network Security Group(NSG) or use the existing ones.
7673

77-
Follow this document [Quickstart: Create a NAT gateway - Azure portal](/azure/nat-gateway/quickstart-create-nat-gateway-portal), and [Create, change, or delete an Azure network security group](/azure/virtual-network/manage-network-security-group?tabs=network-security-group-portal#create-a-network-security-group) to create a new NAT gateway and a new network security group.
78-
79-
You can refer to this document [Control network traffic in Azure HDInsight](./control-network-traffic.md#hdinsight-with-network-security-groups) to set up correct NSG rules.
80-
81-
82-
1. Associate the NAT gateway with your subnet along with a network security group.
74+
> [!NOTE]
75+
> You could use an existing NAT gateway and NSG.
76+
77+
Follow this document [Quickstart: Create a NAT gateway - Azure portal](/azure/nat-gateway/quickstart-create-nat-gateway-portal), and [Create, change, or delete an Azure network security group](/azure/virtual-network/manage-network-security-group?tabs=network-security-group-portal#create-a-network-security-group) to create a new NAT gateway and a new network security group.
8378

84-
:::image type="content" source="./media/load-balancer-migration-guidelines/associate-gateway.png" alt-text="Screenshot showing how to associate gateway." border="true" lightbox="./media/load-balancer-migration-guidelines/associate-gateway.png":::
79+
You can refer to this document [Control network traffic in Azure HDInsight](./control-network-traffic.md#hdinsight-with-network-security-groups) to set up correct NSG rules.
80+
81+
1. Associate the NAT gateway with your subnet along with a network security group.
8582

86-
1. Create the cluster with the subnet.
87-
88-
:::image type="content" source="./media/load-balancer-migration-guidelines/security-networking.png" alt-text="Screenshot showing security networking tab." border="true" lightbox="./media/load-balancer-migration-guidelines/security-networking.png":::
89-
90-
> [!NOTE]
91-
> If you are unable to find the NAT gateway, see, [FAQ of the NAT gateway (Azure NAT Gateway frequently asked questions)](/azure/nat-gateway/faq#are-basic-sku-resources--basic-load-balancer-and-basic-public-ip-addresses--compatible-with-a-nat-gateway).
83+
:::image type="content" source="./media/load-balancer-migration-guidelines/associate-gateway.png" alt-text="Screenshot showing how to associate gateway." border="true" lightbox="./media/load-balancer-migration-guidelines/associate-gateway.png":::
9284

93-
#### Case 2: Existing subnet has HDInsight clusters with Azure Basic load balancers
94-
95-
Consider one of these methods:
85+
1. Create the cluster with the subnet.
9686

97-
* **Method 1:** The most recommended way is to associate a NAT gateway to the subnet along with network security group.
87+
:::image type="content" source="./media/load-balancer-migration-guidelines/security-networking.png" alt-text="Screenshot showing security networking tab." border="true" lightbox="./media/load-balancer-migration-guidelines/security-networking.png":::
9888

99-
According to [Azure NAT Gateway frequently asked questions](/azure/nat-gateway/faq#are-basic-sku-resources--basic-load-balancer-and-basic-public-ip-addresses--compatible-with-a-nat-gateway), NAT gateway is incompatible with Azure basic load balancer.
89+
> [!NOTE]
90+
> If you are unable to find the NAT gateway, see, [FAQ of the NAT gateway (Azure NAT Gateway frequently asked questions)](/azure/nat-gateway/faq#are-basic-sku-resources--basic-load-balancer-and-basic-public-ip-addresses--compatible-with-a-nat-gateway).
10091
101-
To associate with a NAT Gateway, perform the following steps.
92+
* **Case 2:** Existing subnet has HDInsight clusters with Azure Basic load balancers
93+
94+
Consider one of these methods:
10295

103-
1. Delete all the existing HDInsight clusters with Azure basic load balancers in this subnet.
96+
* **Method 1:** The most recommended way is to associate a NAT gateway to the subnet along with network security group.
10497

105-
1. Create a new NAT gateway and a new Network Security Group(NSG) or use the existing ones.
106-
107-
> [!NOTE]
108-
> You could use an existing NAT gateway and NSG.
98+
According to [Azure NAT Gateway frequently asked questions](/azure/nat-gateway/faq#are-basic-sku-resources--basic-load-balancer-and-basic-public-ip-addresses--compatible-with-a-nat-gateway), NAT gateway is incomaptible with Azure basic load balancer.
99+
100+
To associate with a NAT Gateway, perform the following steps.
101+
102+
1. Delete all the existing HDInsight clusters with Azure basic load balancers in this subnet.
103+
104+
1. Create a new NAT gateway and a new Network Security Group(NSG) or use the existing ones.
109105
110-
Follow this document [Quickstart: Create a NAT gateway - Azure portal](/azure/nat-gateway/quickstart-create-nat-gateway-portal), and [Create, change, or delete an Azure network security group](/azure/virtual-network/manage-network-security-group?tabs=network-security-group-portal#create-a-network-security-group) to create a new NAT gateway and a new network security group.
111-
112-
You can refer to this document [Control network traffic in Azure HDInsight](./control-network-traffic.md#hdinsight-with-network-security-groups) to set up correct NSG rules.
106+
> [!NOTE]
107+
> You could use an existing NAT gateway and NSG.
108+
109+
Follow this document [Quickstart: Create a NAT gateway - Azure portal](/azure/nat-gateway/quickstart-create-nat-gateway-portal), and [Create, change, or delete an Azure network security group](/azure/virtual-network/manage-network-security-group?tabs=network-security-group-portal#create-a-network-security-group) to create a new NAT gateway and a new network security group.
110+
111+
You can refer to this document [Control network traffic in Azure HDInsight](./control-network-traffic.md#hdinsight-with-network-security-groups) to set up correct NSG rules.
113112
114-
1. Associate the subnet with the NAT gateway and network security group.
113+
1. Associate the subnet with the NAT gateway and network security group.
115114

116-
:::image type="content" source="./media/load-balancer-migration-guidelines/add-subnet.png" alt-text="Screenshot showing how to add subnet." border="true" lightbox="./media/load-balancer-migration-guidelines/add-subnet.png":::
115+
:::image type="content" source="./media/load-balancer-migration-guidelines/add-subnet.png" alt-text="Screenshot showing how to add subnet." border="true" lightbox="./media/load-balancer-migration-guidelines/add-subnet.png":::
117116
118-
> [!NOTE]
119-
> If you are unable to find the NAT gateway, see, [FAQ of the NAT gateway (Azure NAT Gateway frequently asked questions](/azure/nat-gateway/faq#are-basic-sku-resources--basic-load-balancer-and-basic-public-ip-addresses--compatible-with-a-nat-gateway).
117+
> [!NOTE]
118+
> If you are unable to find the NAT gateway, see, [FAQ of the NAT gateway (Azure NAT Gateway frequently asked questions](/azure/nat-gateway/faq#are-basic-sku-resources--basic-load-balancer-and-basic-public-ip-addresses--compatible-with-a-nat-gateway).
120119

121-
1. Re-create the clusters with the subnet.
122-
:::image type="content" source="./media/load-balancer-migration-guidelines/virtual-network.png" alt-text="Screenshot showing virtual network." border="true" lightbox="./media/load-balancer-migration-guidelines/virtual-network.png":::
120+
1. Re-create the clusters with the subnet.
121+
122+
:::image type="content" source="./media/load-balancer-migration-guidelines/virtual-network.png" alt-text="Screenshot showing virtual network." border="true" lightbox="./media/load-balancer-migration-guidelines/virtual-network.png":::
123123

124124

125-
* **Method 2:** Select option other than **Associate a NAT gateway to the subnet** provided in [Use Source Network Address Translation (SNAT) for outbound connections](/azure/load-balancer/load-balancer-outbound-connections), and follow the instruction for the selected option.
126-
127-
* **Method 3:** Create a new subnet and then create the cluster with the new subnet.
125+
* **Method 2:** Select option other than **Associate a NAT gateway to the subnet** provided in [Use Source Network Address Translation (SNAT) for outbound connections](/azure/load-balancer/load-balancer-outbound-connections), and follow the instruction for the selected option.
126+
127+
* **Method 3:** Create a new subnet and then create the cluster with the new subnet.
128+
129+
> [!NOTE]
130+
> If you are using an ESP cluster with MFA disabled, ensure to check the MFA status once cluster is recreated using a NAT gateway.
128131
129132
## Next steps
130133

0 commit comments

Comments
 (0)