Skip to content

Commit c871e9a

Browse files
committed
resolve merge conflict
2 parents 1e95bb4 + 960a5e1 commit c871e9a

File tree

2 files changed

+46
-25
lines changed

2 files changed

+46
-25
lines changed

azure-local/manage/sdn-express.md

Lines changed: 28 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -3,35 +3,39 @@ title: Deploy an SDN infrastructure using SDN Express
33
description: Learn to deploy an SDN infrastructure using SDN Express
44
author: sethmanheim
55
ms.topic: how-to
6-
ms.date: 11/29/2023
6+
ms.date: 11/07/2024
77
ms.author: sethm
8-
ms.reviewer: JasonGerend
8+
ms.reviewer: anirbanpaul
99
---
1010

1111
# Deploy an SDN infrastructure using SDN Express
1212

1313
> Applies to: Azure Stack HCI, versions 22H2 and 21H2; Windows Server 2022, Windows Server 2019, Windows Server 2016
1414
15+
<<<<<<< HEAD:azure-local/manage/sdn-express.md
1516
[!INCLUDE [azure-local-banner-22h2](../includes/azure-local-banner-22h2.md)]
1617

1718
In this topic, you deploy an end-to-end Software Defined Network (SDN) infrastructure using SDN Express PowerShell scripts. The infrastructure includes a highly available (HA) Network Controller (NC), and optionally, a highly available Software Load Balancer (SLB), and a highly available Gateway (GW). The scripts support a phased deployment, where you can deploy just the Network Controller component to achieve a core set of functionality with minimal network requirements.
19+
=======
20+
This article describes how to deploy an end-to-end Software Defined Network (SDN) infrastructure using SDN Express PowerShell scripts. The infrastructure includes a highly available (HA) Network Controller (NC), and optionally, a highly available Software Load Balancer (SLB), and a highly available Gateway (GW). The scripts support a phased deployment, in which you can deploy just the Network Controller component to achieve a core set of functionality with minimal network requirements.
21+
>>>>>>> main:azure-stack/hci/manage/sdn-express.md
1822
19-
You can also deploy an SDN infrastructure using Windows Admin Center or using System Center Virtual Machine Manager (VMM). For more information, see [Create a cluster - Step 5: SDN](../deploy/create-cluster.md#step-5-sdn-optional) and see [Manage SDN resources in the VMM fabric](/system-center/vmm/network-sdn).
23+
You can also deploy an SDN infrastructure using Windows Admin Center or using System Center Virtual Machine Manager (VMM). For more information, see [Create a cluster - Step 5: SDN](../deploy/create-cluster.md#step-5-sdn-optional) and [Manage SDN resources in the VMM fabric](/system-center/vmm/network-sdn).
2024

2125
> [!IMPORTANT]
2226
> You can't use Microsoft System Center Virtual Machine Manager 2019 to manage clusters running Azure Stack HCI, version 21H2 or Windows Server 2022.
2327
2428
## Before you begin
2529

26-
Before you begin an SDN deployment, plan out and configure your physical and host network infrastructure. Reference the following articles:
30+
Before you begin an SDN deployment, plan out and configure your physical and host network infrastructure. See the following articles:
2731

2832
- [Physical network requirements](../concepts/physical-network-requirements.md)
2933
- [Host network requirements](../concepts/host-network-requirements.md)
3034
- [Create a cluster using Windows Admin Center](../deploy/create-cluster.md)
3135
- [Create a cluster using Windows PowerShell](../deploy/create-cluster-powershell.md)
3236
- [Plan a Software Defined Network infrastructure](../concepts/plan-software-defined-networking-infrastructure.md)
3337

34-
You do not have to deploy all SDN components. See the [Phased deployment](../concepts/plan-software-defined-networking-infrastructure.md#phased-deployment) section of [Plan a Software Defined Network infrastructure](../concepts/plan-software-defined-networking-infrastructure.md) to determine which infrastructure components you need, and then run the scripts accordingly.
38+
You don't have to deploy all SDN components. See the [Phased deployment](../concepts/plan-software-defined-networking-infrastructure.md#phased-deployment) section of [Plan a Software Defined Network infrastructure](../concepts/plan-software-defined-networking-infrastructure.md) to determine which infrastructure components you need, and then run the scripts accordingly.
3539

3640
Make sure all host servers have the Azure Stack HCI operating system installed. See [Deploy the Azure Stack HCI operating system](../deploy/operating-system.md) on how to do this.
3741

@@ -50,28 +54,28 @@ The following requirements must be met for a successful SDN deployment:
5054

5155
[!INCLUDE [download-vhdx](../includes/hci-download-vhdx.md)]
5256

53-
## Download the GitHub repository
57+
> [!NOTE]
58+
> The SDN Express script files are no longer available on GitHub.
5459
55-
The SDN Express script files live in GitHub. The first step is to get the necessary files and folders onto your deployment computer.
60+
## Install the SDN Express PowerShell module
5661

57-
1. Go to the [Microsoft SDN GitHub](https://github.com/microsoft/SDN) repository.
62+
Run the following command to install the latest version of the SDN Express PowerShell module on the machine on which you want to run the SDN installation:
5863

59-
1. In the repository, expand the **Code** drop-down list, and then choose either **Clone** or **Download ZIP** to download the SDN files to your designated deployment computer.
64+
```powershell
65+
Install-Module -Name SDNExpress
66+
```
6067

61-
> [!NOTE]
62-
> The designated deployment computer must be running Windows Server 2016 or later.
63-
64-
1. Extract the ZIP file and copy the `SDNExpress` folder to your deployment computer's `C:\` folder.
68+
The files automatically install in the default PowerShell module directory: **C:\Program Files\WindowsPowerShell\Modules\SdnExpress\**.
6569

6670
## Edit the configuration file
6771

68-
The PowerShell `MultiNodeSampleConfig.psd1` configuration data file contains all the parameters and settings that are needed for the SDN Express script as input for the various parameters and configuration settings. This file has specific information about what needs to be filled out based on whether you are deploying only the network controller component, or the software load balancer and gateway components as well. For detailed information, see [Plan a Software Defined Network infrastructure](../concepts/plan-software-defined-networking-infrastructure.md) topic.
72+
The PowerShell `MultiNodeSampleConfig.psd1` configuration data file (located at the above mentioned install path) contains all the parameters and settings that are needed for the SDN Express script as input for the various parameters and configuration settings. This file has specific information about what needs to be filled out based on whether you are deploying only the network controller component, or the software load balancer and gateway components as well. For detailed information, see [Plan a Software Defined Network infrastructure](../concepts/plan-software-defined-networking-infrastructure.md).
6973

70-
Navigate to the `C:\SDNExpress\scripts` folder and open the `MultiNodeSampleConfig.psd1` file in your favorite text editor. Change specific parameter values to fit your infrastructure and deployment:
74+
Navigate to the **C:\Program Files\WindowsPowerShell\Modules\SdnExpress\** folder and open the **MultiNodeSampleConfig.psd1** file in a text editor. Change specific parameter values to fit your infrastructure and deployment, as described in the next section.
7175

7276
### General settings and parameters
7377

74-
The settings and parameters are used by SDN in general for all deployments. For specific recommendations, see [SDN infrastructure VM role requirements](../concepts/plan-software-defined-networking-infrastructure.md#sdn-infrastructure-vm-role-requirements).
78+
These settings and parameters are used by SDN in general for all deployments. For specific recommendations, see [SDN infrastructure VM role requirements](../concepts/plan-software-defined-networking-infrastructure.md#sdn-infrastructure-vm-role-requirements).
7579

7680
- **VHDPath** - VHD file path used by all SDN infrastructure VMs (NC, SLB, GW)
7781
- **VHDFile** - VHDX file name used by all SDN infrastructure VMs
@@ -96,7 +100,7 @@ The settings and parameters are used by SDN in general for all deployments. For
96100
- **Locale** - if not specified, locale of deployment computer is used
97101
- **TimeZone** - if not specified, local time zone of deployment computer is used
98102

99-
Passwords can be optionally included if stored encrypted as text-encoded secure strings. Passwords will only be used if SDN Express scripts are run on the same computer where passwords were encrypted, otherwise it will prompt for these passwords:
103+
Passwords can be optionally included if stored encrypted as text-encoded secure strings. Passwords are only used if SDN Express scripts are run on the same computer where passwords were encrypted, otherwise it prompts for these passwords:
100104

101105
- **DomainJoinSecurePassword** - for domain account
102106
- **LocalAdminSecurePassword** - for local administrator account
@@ -106,7 +110,7 @@ Passwords can be optionally included if stored encrypted as text-encoded secure
106110

107111
A minimum of three Network Controller VMs are recommended for SDN.
108112

109-
The `NCs = @()` section is used for the Network Controller VMs. Make sure that the MAC address of each NC VM is outside the `SDNMACPool` range listed in the General settings.
113+
The `NCs = @()` section is used for the Network Controller VMs. Make sure that the MAC address of each NC VM is outside the `SDNMACPool` range listed in the general settings.
110114

111115
- **ComputerName** - name of NC VM
112116
- **HostName** - host name of server where the NC VM is located
@@ -117,7 +121,7 @@ The `NCs = @()` section is used for the Network Controller VMs. Make sure that t
117121

118122
A minimum of two Software Load Balancer VMs are recommended for SDN.
119123

120-
The `Muxes = @()` section is used for the SLB VMs. Make sure that the `MACAddress` and `PAMACAddress` parameters of each SLB VM are outside the `SDNMACPool` range listed in the General settings. Ensure that you get the `PAIPAddress` parameter from outside the PA Pool specified in the configuration file, but part of the PASubnet specified in the configuration file.
124+
The `Muxes = @()` section is used for the SLB VMs. Make sure that the `MACAddress` and `PAMACAddress` parameters of each SLB VM are outside the `SDNMACPool` range listed in the general settings. Ensure that you get the `PAIPAddress` parameter from outside the PA Pool specified in the configuration file, but part of the PASubnet specified in the configuration file.
121125

122126
Leave this section empty (`Muxes = @()`) if not deploying the SLB component:
123127

@@ -145,23 +149,24 @@ Leave this section empty (`Gateways = @()`) if not deploying the Gateway compone
145149

146150
### Additional settings for SLB and Gateway
147151

148-
The following additional parameters are used by SLB and Gateway VMs. Leave these values blank if you are not deploying SLB or Gateway VMs:
152+
The following additional parameters are used by SLB and Gateway VMs. Leave these values empty if you are not deploying SLB or Gateway VMs:
149153

150154
- **SDNASN** - Autonomous System Number (ASN) used by SDN to peer with network switches
151155
- **RouterASN** - Gateway router ASN
152156
- **RouterIPAddress** - Gateway router IP address
153157
- **PrivateVIPSubnet** - virtual IP address (VIP) for the private subnet
154158
- **PublicVIPSubnet** - virtual IP address for the public subnet
155159

156-
The following additional parameters are used by Gateway VMs only. Leave these values blank if you are not deploying Gateway VMs:
160+
The following additional parameters are only used by Gateway VMs. Leave these values blank if you are not deploying Gateway VMs:
157161

158162
- **PoolName** - pool name used by all Gateway VMs
159163
- **GRESubnet** - VIP subnet for GRE (if using GRE connections)
160164
- **Capacity** - capacity in Kbps for each Gateway VM in the pool
161165
- **RedundantCount** - number of gateways in redundant mode. The default value is 1. Redundant gateways don't have any active connections. Once an active gateway goes down, the connections from that gateway move to the redundant gateway and the redundant gateway becomes active.
162166

163-
> [!NOTE]
164-
> If you fill in a value for **RedundantCount**, ensure that the total number of gateway VMs is at least one more than the **RedundantCount**. By default, the **RedundantCount** is 1, so you must have at least 2 gateway VMs to ensure that there is at least 1 active gateway to host gateway connections.
167+
> [!NOTE]
168+
> If you fill in a value for **RedundantCount**, ensure that the total number of gateway VMs is at least one more than the **RedundantCount**. By default, the
169+
> **RedundantCount** is 1, so you must have at least 2 gateway VMs to ensure that there is at least 1 active gateway to host gateway connections.
165170
166171
### Settings for tenant overlay networks
167172

azure-stack/operator/known-issues.md

Lines changed: 18 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Azure Stack Hub known issues
33
description: Learn about known issues in Azure Stack Hub releases.
44
author: sethmanheim
55
ms.topic: article
6-
ms.date: 11/07/2024
6+
ms.date: 11/11/2024
77
ms.author: sethm
88
ms.reviewer: rtiberiu
99
ms.lastreviewed: 11/30/2023
@@ -41,7 +41,14 @@ To access known issues for a different version, use the version selector dropdow
4141
- Remediation: If you have more than eight node stamps, you should delay your updates if possible, until a hotfix/inline fix is released.
4242
- Occurrence: Common.
4343

44-
<!-- ## Networking -->
44+
## Networking
45+
46+
### Outbound ICMP to internet is blocked by default for tenant VM
47+
48+
- Applicable: This issue applies to release 2311 and later.
49+
- Cause: The issue is caused by a change in the default ICMP behavior introduced with Windows Server 2022 that diverges from previous behavior, as well as Azure behavior.
50+
- Remediation: You can add an inbound NSG rule to allow outbound ICMP packets to the internet. Microsoft is aware of the issue.
51+
- Occurrence: Common.
4552

4653
## Compute
4754

@@ -165,6 +172,15 @@ To access known issues for a different version, use the version selector dropdow
165172
- Remediation: You can ignore the alert in the Test-AzureStack report. Microsoft is aware of the issue and is working on a fix.
166173
- Occurrence: Common.
167174

175+
## Networking
176+
177+
### Outbound ICMP to internet is blocked by default for tenant VM
178+
179+
- Applicable: This issue applies to release 2311 and later.
180+
- Cause: The issue is caused by a change in the default ICMP behavior introduced with Windows Server 2022 that diverges from previous behavior, as well as Azure behavior.
181+
- Remediation: You can add an inbound NSG rule to allow outbound ICMP packets to the internet. Microsoft is aware of the issue.
182+
- Occurrence: Common.
183+
168184
<!-- ## Alerts -->
169185

170186
## Portal

0 commit comments

Comments
 (0)