Skip to content

Commit 94f85fd

Browse files
committed
added note to other fci docs
1 parent 42cdbd0 commit 94f85fd

File tree

2 files changed

+18
-0
lines changed

2 files changed

+18
-0
lines changed

articles/azure-sql/virtual-machines/windows/failover-cluster-instance-premium-file-share-manually-configure.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -117,6 +117,15 @@ After you've configured the failover cluster, you can create the SQL Server FCI.
117117

118118
1. In **Failover Cluster Manager**, make sure that all the core cluster resources are on the first virtual machine. If necessary, move all resources to this virtual machine.
119119

120+
1. If the version of the operating system is Windows Server 2019 and the Windows Cluster was created using the default [**Distributed Network Name (DNN)**](https://blogs.windows.com/windows-insider/2018/08/14/announcing-windows-server-2019-insider-preview-build-17733/), then the FCI installation for SQL Server 2017 and below will fail with the error `The given key was not present in the dictionary`.
121+
122+
During installation, SQL Server setup queries for the existing Virtual Network Name (VNN) and doesn't recognize the Windows Cluster DNN. The issue has been fixed in SQL Server 2019 setup. For SQL Server 2017 and below, follow these steps to avoid the installation error:
123+
124+
- In Failover Cluster Manager, connect to the cluster, right-click **Roles** and select **Create Empty Role**.
125+
- Right-click the newly created empty role, select **Add Resource** and select **Client Access Point**.
126+
- Enter any name and complete the wizard to create the **Client Access Point**.
127+
- After the SQL Server FCI installation completes, the role containing the temporary **Client Access Point** can be deleted.
128+
120129
1. Locate the installation media. If the virtual machine uses one of the Azure Marketplace images, the media is located at `C:\SQLServer_<version number>_Full`.
121130

122131
1. Select **Setup**.

articles/azure-sql/virtual-machines/windows/failover-cluster-instance-storage-spaces-direct-manually-configure.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -144,6 +144,15 @@ After you've configured the failover cluster and all cluster components, includi
144144

145145
1. In **Failover Cluster Manager**, make sure all core cluster resources are on the first virtual machine. If necessary, move all resources to that virtual machine.
146146

147+
1. If the version of the operating system is Windows Server 2019 and the Windows Cluster was created using the default [**Distributed Network Name (DNN)**](https://blogs.windows.com/windows-insider/2018/08/14/announcing-windows-server-2019-insider-preview-build-17733/), then the FCI installation for SQL Server 2017 and below will fail with the error `The given key was not present in the dictionary`.
148+
149+
During installation, SQL Server setup queries for the existing Virtual Network Name (VNN) and doesn't recognize the Windows Cluster DNN. The issue has been fixed in SQL Server 2019 setup. For SQL Server 2017 and below, follow these steps to avoid the installation error:
150+
151+
- In Failover Cluster Manager, connect to the cluster, right-click **Roles** and select **Create Empty Role**.
152+
- Right-click the newly created empty role, select **Add Resource** and select **Client Access Point**.
153+
- Enter any name and complete the wizard to create the **Client Access Point**.
154+
- After the SQL Server FCI installation completes, the role containing the temporary **Client Access Point** can be deleted.
155+
147156
1. Locate the installation media. If the virtual machine uses one of the Azure Marketplace images, the media is located at `C:\SQLServer_<version number>_Full`. Select **Setup**.
148157

149158
1. In **SQL Server Installation Center**, select **Installation**.

0 commit comments

Comments
 (0)