You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/linux/sql-server-linux-configure-mssql-conf.md
+9-1Lines changed: 9 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@ title: Configure SQL Server Settings on Linux
3
3
description: This article describes how to use the mssql-conf tool to configure SQL Server settings on Linux.
4
4
author: rwestMSFT
5
5
ms.author: randolphwest
6
-
ms.date: 11/18/2024
6
+
ms.date: 04/09/2025
7
7
ms.service: sql
8
8
ms.subservice: linux
9
9
ms.topic: install-set-up-deploy
@@ -233,6 +233,13 @@ The following options are used by Microsoft Entra authentication for an instance
233
233
> [!WARNING]
234
234
> Microsoft Entra ID parameters are configured by the Azure extension for [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)], and shouldn't be reconfigured manually. They are listed here for informational purposes.
235
235
236
+
[!INCLUDE [sssql22-md](../includes/sssql22-md.md)] CU 19 introduces an option to set the IPv6 records limit for Microsoft Entra authentication endpoints. If IPv6 is enabled on Linux, and the IPv6 addresses of the Microsoft Entra authentication endpoints aren't reachable, you can set the [network.ipv6dnsrecordslimit](#ipv6dnsrecordslimit) option for Microsoft Entra authentication to work. Setting this option to any value between `0` and `5` guarantees that at least one IPv4 address is tried to reach the Microsoft Entra endpoints.
237
+
238
+
A value of `0` means that no IPv6 endpoint addresses are tried. A value of `5` means that five AAAA addresses are tried.
239
+
240
+
> [!NOTE]
241
+
> This `network.ipv6dnsrecordslimit` setting is configured at the server level, and can affect other services that use IPv6.
242
+
236
243
| Option | Description |
237
244
| --- | --- |
238
245
|`network.aadauthenticationendpoint`| Endpoint for Microsoft Entra authentication |
@@ -870,6 +877,7 @@ The following options are additional network settings configurable using **mssql
870
877
|`network.ipaddress`| IP address for incoming connections. |
871
878
|`network.kerberoscredupdatefrequency`| Time in seconds between checks for kerberos credentials that need to be updated. Value is an integer. |
872
879
|`network.privilegedadaccount`| Privileged Active Directory user to use for Active Directory authentication. Value is `<username>`. For more information, see [Tutorial: Use Active Directory authentication with SQL Server on Linux](sql-server-linux-active-directory-authentication.md#spn) |
880
+
|<a id="ipv6dnsrecordslimit"></a>`network.ipv6dnsrecordslimit`| Set a configurable limit to the number of AAAA records returned by DNS requests. Value is a positive integer between `0` and `5`. This option is guarantees that WinHTTP requests with the default number of retries (6) attempt at least one IPv4 address. |
873
881
|`uncmapping`| Maps UNC path to a local path. For example, `sudo /opt/mssql/bin/mssql-conf set uncmapping //servername/sharename /tmp/folder`. |
874
882
|`ldaphostcanon`| Set whether OpenLDAP should canonicalize hostnames during the bind step. Values can be `true` or `false`. |
0 commit comments