Skip to content

Commit 7c67949

Browse files
authored
Update sql-server-linux-configure-mssql-conf.md (#33728)
1 parent 6120b72 commit 7c67949

File tree

1 file changed

+9
-1
lines changed

1 file changed

+9
-1
lines changed

docs/linux/sql-server-linux-configure-mssql-conf.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Configure SQL Server Settings on Linux
33
description: This article describes how to use the mssql-conf tool to configure SQL Server settings on Linux.
44
author: rwestMSFT
55
ms.author: randolphwest
6-
ms.date: 11/18/2024
6+
ms.date: 04/09/2025
77
ms.service: sql
88
ms.subservice: linux
99
ms.topic: install-set-up-deploy
@@ -233,6 +233,13 @@ The following options are used by Microsoft Entra authentication for an instance
233233
> [!WARNING]
234234
> 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.
235235
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+
236243
| Option | Description |
237244
| --- | --- |
238245
| `network.aadauthenticationendpoint` | Endpoint for Microsoft Entra authentication |
@@ -870,6 +877,7 @@ The following options are additional network settings configurable using **mssql
870877
| `network.ipaddress` | IP address for incoming connections. |
871878
| `network.kerberoscredupdatefrequency` | Time in seconds between checks for kerberos credentials that need to be updated. Value is an integer. |
872879
| `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. |
873881
| `uncmapping` | Maps UNC path to a local path. For example, `sudo /opt/mssql/bin/mssql-conf set uncmapping //servername/sharename /tmp/folder`. |
874882
| `ldaphostcanon` | Set whether OpenLDAP should canonicalize hostnames during the bind step. Values can be `true` or `false`. |
875883

0 commit comments

Comments
 (0)