Skip to content

Commit 62b9d1e

Browse files
committed
[Linux] Content refresh (001)
1 parent 638c08b commit 62b9d1e

39 files changed

Lines changed: 203 additions & 147 deletions

File tree

docs/linux/includes/odbc-sles.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,18 @@
11
---
22
author: rwestMSFT
33
ms.author: randolphwest
4-
ms.date: 06/16/2025
4+
ms.date: 01/02/2026
55
ms.service: sql
66
ms.topic: include
77
ms.custom:
88
- linux-related-content
99
---
1010
<a id="SLES"></a>
1111

12-
Use the following steps to install the **mssql-tools18** on SUSE Linux Enterprise Server.
12+
Use the following steps to install **mssql-tools18** on SUSE Linux Enterprise Server.
13+
14+
> [!NOTE]
15+
> Starting in [!INCLUDE [sssql25-md](../../includes/sssql25-md.md)], SUSE Linux Enterprise Server (SLES) isn't supported.
1316
1417
1. Import the Microsoft package signing key.
1518

@@ -62,7 +65,7 @@ Use the following steps to install the **mssql-tools18** on SUSE Linux Enterpris
6265
source ~/.bash_profile
6366
```
6467

65-
To make **sqlcmd** or **bcp** accessible from the bash shell for interactive/non-login sessions, modify the `PATH` in the `~/.bashrc` file with the following command:
68+
To make **sqlcmd** or **bcp** accessible from the bash shell for interactive and non-login sessions, modify the `PATH` in the `~/.bashrc` file with the following command:
6669

6770
```bash
6871
echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bashrc

docs/linux/includes/roll-back-sql-server.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
author: rwestMSFT
33
ms.author: randolphwest
4-
ms.date: 07/03/2025
4+
ms.date: 01/02/2026
55
ms.service: sql
66
ms.subservice: linux
77
ms.topic: include
@@ -10,13 +10,14 @@ ms.custom:
1010
---
1111
To roll back or downgrade [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] to a previous release, use the following steps:
1212

13-
1. Identify the version number for the [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] package you want to downgrade to. For a list of package numbers, see the release notes:
13+
1. Find the version number for the [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] package you want to downgrade to. For a list of package numbers, see the release notes:
1414

15+
- [Release notes for SQL Server 2025 on Linux](../sql-server-linux-release-notes-2025.md)
1516
- [Release notes for SQL Server 2022 on Linux](../sql-server-linux-release-notes-2022.md)
1617
- [Release notes for SQL Server 2019 on Linux](../sql-server-linux-release-notes-2019.md)
1718
- [Release notes for SQL Server 2017 on Linux](../sql-server-linux-release-notes-2017.md)
1819

19-
1. Downgrade to a previous version of [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)]. In the following commands, replace `<version_number>` with the [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] version number you identified in step 1.
20+
1. Downgrade to a previous version of [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)]. In the following commands, replace `<version_number>` with the [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] version number you found in step 1.
2021

2122
| Platform | Package update commands |
2223
| --- | --- |

docs/linux/new-to-linux-resources.md

Lines changed: 14 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -4,54 +4,58 @@ titleSuffix: SQL Server
44
description: Resources and guidance for SQL Server users who are new to Linux.
55
author: rwestMSFT
66
ms.author: randolphwest
7-
ms.date: 01/21/2025
7+
ms.date: 01/02/2026
88
ms.service: sql
99
ms.subservice: linux
10-
ms.topic: conceptual
10+
ms.topic: article
1111
ms.custom:
1212
- linux-related-content
1313
---
1414
# New to Linux resources for SQL users
1515

1616
[!INCLUDE [SQL Server - Linux](../includes/applies-to-version/sql-linux.md)]
1717

18-
This article is intended to provide a learning path through an introduction of Linux concepts. Use the sections in the article as a guided learning path to familiarize yourself with the Linux environment.
18+
This article provides a learning path through an introduction to Linux concepts. Use the sections in the article as a guided learning path to familiarize yourself with the Linux environment.
1919

20-
This isn't intended to be a comprehensive list but instead provides the bare minimum you need to help you administer and navigate your [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on Linux environment. See the [full list of tutorials](https://www.linux.org/forums/linux-beginner-tutorials.123/) to learn more.
20+
This list isn't comprehensive but instead provides the bare minimum you need to help you administer and navigate your [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on Linux environment. See the [full list of tutorials](https://www.linux.org/forums/linux-beginner-tutorials.123/) to learn more.
2121

2222
## What is Linux?
2323

2424
The [What is Linux](https://www.linux.org/threads/what-is-linux.4106/) module introduces the history of Linux as an operating system. The module explains *the Kernel* and where Linux is today. This tutorial serves as an introduction to Linux, helping you get started.
2525

2626
## Select a distribution
2727

28-
After you know the history of Linux, decide which [distribution of Linux](https://www.linux.org/threads/selecting-a-linux-distribution.4117/) best suits your business needs. [SQL Server is supported](sql-server-linux-release-notes-2019.md#supported-platforms) on various distributions such as Red Hat Enterprise Linux (RHEL), SUSE Linux Enterprise Server (SLES), and Ubuntu.
28+
After you know the history of Linux, decide which [distribution of Linux](https://www.linux.org/threads/selecting-a-linux-distribution.4117/) best suits your business needs.
29+
30+
[!INCLUDE [sssql25-md](../includes/sssql25-md.md)] is [supported](sql-server-linux-release-notes-2025.md#supported-platforms) on Red Hat Enterprise Linux (RHEL) and Ubuntu.
31+
32+
[!INCLUDE [sssql22-md](../includes/sssql22-md.md)] and earlier versions are [also supported](sql-server-linux-release-notes-2022.md#supported-platforms) on SUSE Linux Enterprise Server (SLES).
2933

3034
## Get around directories
3135

32-
After you have chosen the appropriate distribution of Linux, familiarize yourself with [getting around Linux directories](https://www.linux.org/threads/getting-around-in-linux-directories.4120/).
36+
After you choose the appropriate distribution of Linux, familiarize yourself with [getting around Linux directories](https://www.linux.org/threads/getting-around-in-linux-directories.4120/).
3337

34-
This module will help you answer the following questions:
38+
This module helps you answer the following questions:
3539

3640
- How to navigate between different files
3741
- How to identify a file from a directory
3842
- Identify different directories
3943

4044
## Install new software
4145

42-
Next, learn how to [install new software](https://www.linux.org/threads/installing-new-software-debian-red-hat-slackware.4119/) on your new Linux operating system. This module details installing new software to the Debian and Red Hat Linux operating systems.
46+
Next, learn how to [install new software](https://www.linux.org/threads/installing-new-software-debian-red-hat-slackware.4119/) on your new Linux operating system. This module covers installing new software on the Debian and Red Hat Linux operating systems.
4347

4448
## Root versus system user
4549

46-
Understand user permissions, and the difference between a [root user and a system user](https://www.linux.org/threads/when-to-work-as-root-when-to-work-as-a-system-user.4136/). This module helps you decide which user permissions are appropriate to use for which scenario.
50+
Understand user permissions, and the difference between a [root user and a system user](https://www.linux.org/threads/when-to-work-as-root-when-to-work-as-a-system-user.4136/). This module helps you decide which user permissions are appropriate for each scenario.
4751

4852
## File system and permissions
4953

5054
After you're familiar with recognizing different users and groups in Linux, learn how you can change ownership and file permissions on different files in Linux operating systems using the [chown (change ownership)](https://www.linux.org/threads/file-permisions-chown.4125/) and [chmod (change permissions)](https://www.linux.org/threads/file-permissions-chmod.4124) commands.
5155

5256
## Commands for system administration
5357

54-
Introduce yourself to the [frequently used commands](https://www.linux.org/threads/commands-for-system-administration.4126/) system administrators rely on to control their Linux operating systems. These commands include: `df`, `du`, `TOP`, `ps`, `mkdir`, `rmdir`, `rm`, and `mv`.
58+
Introduce yourself to the [frequently used commands](https://www.linux.org/threads/commands-for-system-administration.4126/) that system administrators rely on to control their Linux operating systems. These commands include: `df`, `du`, `TOP`, `ps`, `mkdir`, `rmdir`, `rm`, and `mv`.
5559

5660
## Related content
5761

docs/linux/sample-unattended-install-redhat.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: Use a sample bash script to install SQL Server on Red Hat Enterpris
55
author: rwestMSFT
66
ms.author: randolphwest
77
ms.reviewer: amitkh
8-
ms.date: 05/02/2025
8+
ms.date: 01/02/2026
99
ms.service: sql
1010
ms.subservice: linux
1111
ms.topic: install-set-up-deploy
@@ -21,7 +21,7 @@ ms.custom:
2121
This sample bash script installs [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on Red Hat Enterprise Linux (RHEL) without interactive input. It provides examples of installing the [!INCLUDE [ssde-md](../includes/ssde-md.md)], the SQL Server command-line tools, SQL Server Agent, and performs post-install steps. You can optionally install full-text search and create an administrative user.
2222

2323
> [!TIP]
24-
> If you don't need an unattended installation script, the fastest way to install SQL Server is to follow the [Quickstart: Install SQL Server and create a database on Red Hat](quickstart-install-connect-red-hat.md). For other setup information, see [Installation guidance for SQL Server on Linux](sql-server-linux-setup.md).
24+
> If you don't need an unattended installation script, the fastest way to install SQL Server is to follow the [Quickstart: Install SQL Server and create a database on Red Hat Enterprise Linux](quickstart-install-connect-red-hat.md). For other setup information, see [Installation guidance for SQL Server on Linux](sql-server-linux-setup.md).
2525
2626
## Prerequisites
2727

@@ -166,13 +166,13 @@ To run the script:
166166
> [!CAUTION]
167167
> [!INCLUDE [password-complexity](includes/password-complexity.md)]
168168
169-
1. Mark the script as executable
169+
1. Mark the script as executable:
170170

171171
```bash
172172
chmod +x install_sql.sh
173173
```
174174

175-
1. Run the script
175+
1. Run the script:
176176

177177
```bash
178178
./install_sql.sh

docs/linux/sample-unattended-install-ubuntu.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ titleSuffix: SQL Server
44
description: Learn to use a sample bash script to install SQL Server on Ubuntu Server without interactive input.
55
author: rwestMSFT
66
ms.author: randolphwest
7-
ms.date: 05/02/2025
7+
ms.date: 01/02/2026
88
ms.service: sql
99
ms.subservice: linux
1010
ms.topic: install-set-up-deploy
@@ -170,13 +170,13 @@ To run the script:
170170

171171
1. Customize `MSSQL_SA_PASSWORD`, `MSSQL_PID`, and any of the other variables you'd like to change.
172172

173-
1. Mark the script as executable
173+
1. Mark the script as executable:
174174

175175
```bash
176176
chmod +x install_sql.sh
177177
```
178178

179-
1. Run the script
179+
1. Run the script:
180180

181181
```bash
182182
./install_sql.sh

docs/linux/sql-server-linux-active-directory-authentication.md

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,8 @@ titleSuffix: SQL Server
44
description: This tutorial provides the configuration steps for Active Directory authentication for SQL Server on Linux.
55
author: amitkh-msft
66
ms.author: amitkh
7-
ms.reviewer: vanto, randolphwest
8-
ms.date: 07/03/2025
7+
ms.reviewer: randolphwest
8+
ms.date: 01/02/2026
99
ms.service: sql
1010
ms.subservice: linux
1111
ms.topic: tutorial
@@ -38,10 +38,13 @@ Before you configure Active Directory Authentication, you need to:
3838

3939
- Set up an Active Directory Domain Controller (Windows) on your network
4040
- Install [!INCLUDE [ssNoVersion](../includes/ssnoversion-md.md)]
41-
- [Quickstart: Install SQL Server and create a database on Red Hat](quickstart-install-connect-red-hat.md)
41+
- [Quickstart: Install SQL Server and create a database on Red Hat Enterprise Linux](quickstart-install-connect-red-hat.md)
4242
- [Quickstart: Install SQL Server and create a database on SUSE Linux Enterprise Server](quickstart-install-connect-suse.md)
4343
- [Quickstart: Install SQL Server and create a database on Ubuntu](quickstart-install-connect-ubuntu.md)
4444

45+
> [!NOTE]
46+
> Starting in [!INCLUDE [sssql25-md](../includes/sssql25-md.md)], SUSE Linux Enterprise Server (SLES) isn't supported.
47+
4548
<a id="join"></a>
4649

4750
## Join SQL Server host to Active Directory domain
@@ -77,7 +80,7 @@ Join your [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] Linux host
7780

7881
> [!NOTE]
7982
> If you receive an error, `Insufficient access rights`, check with your domain administrator that you have sufficient permissions to set an SPN on this account. The account that is used to register an SPN will need the `Write servicePrincipalName` permissions. For more information, see [Register a Service Principal Name for Kerberos connections](../database-engine/configure-windows/register-a-service-principal-name-for-kerberos-connections.md).
80-
>
83+
>
8184
> If you change the TCP port in the future, you must run the **setspn** command again with the new port number. You also need to add the new SPN to the [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] service keytab by following the steps in the next section.
8285
8386
For more information, see [Register a Service Principal Name for Kerberos connections](../database-engine/configure-windows/register-a-service-principal-name-for-kerberos-connections.md).
@@ -278,7 +281,7 @@ While it's not recommended, it's possible to use utilities, such as **realmd**,
278281

279282
> [!NOTE]
280283
> [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] login by using an FQDN (for example, `CONTOSO.COM\Username`) isn't supported. Use the `CONTOSO\Username` format.
281-
>
284+
>
282285
> [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] logins from Domain Local groups aren't supported. Use Global Security Domain groups instead.
283286
284287
## Related content

docs/linux/sql-server-linux-active-directory-join-domain.md

Lines changed: 15 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,8 @@ titleSuffix: SQL Server
44
description: This article provides guidance joining a SQL Server Linux host machine to an Active Directory domain. You can use a built-in SSSD package or use third-party Active Directory providers.
55
author: amitkh-msft
66
ms.author: amitkh
7-
ms.reviewer: vanto, randolphwest
8-
ms.date: 07/03/2025
7+
ms.reviewer: randolphwest
8+
ms.date: 01/02/2026
99
ms.service: sql
1010
ms.subservice: linux
1111
ms.topic: how-to
@@ -29,6 +29,9 @@ Before you configure Active Directory authentication, you need to set up an Acti
2929

3030
The sample steps described in this article are for guidance only and refer to Ubuntu 16.04, Red Hat Enterprise Linux (RHEL) 7.x, and SUSE Linux Enterprise Server (SLES) 12 operating systems. Actual steps might slightly differ in your environment depending on how your overall environment is configured and operating system version. For example, Ubuntu 18.04 uses **netplan** while Red Hat Enterprise Linux (RHEL) 8.x uses **nmcli** among other tools to manage and configure network. You should engage your system and domain administrators for your environment for specific tooling, configuration, customization, and any required troubleshooting.
3131

32+
> [!NOTE]
33+
> Starting in [!INCLUDE [sssql25-md](../includes/sssql25-md.md)], SUSE Linux Enterprise Server (SLES) isn't supported.
34+
3235
### Reverse DNS (rDNS)
3336

3437
When you set up a computer running Windows Server as a domain controller, you might not have a rDNS zone by default. Ensure that an applicable rDNS zone exists for both the domain controller and the IP address of the Linux machine that will be running [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)].
@@ -82,7 +85,7 @@ nameserver 10.0.0.4
8285
sudo vi /etc/sysconfig/network-scripts/ifcfg-eth0
8386
```
8487

85-
The contents should look similar to the following example:
88+
The output looks similar to the following example:
8689

8790
```ini
8891
PEERDNS=no
@@ -102,7 +105,7 @@ nameserver 10.0.0.4
102105
sudo vi /etc/resolv.conf
103106
```
104107

105-
The contents should look similar to the following example:
108+
The output looks similar to the following example:
106109

107110
```output
108111
search contoso.com com
@@ -115,7 +118,7 @@ nameserver 10.0.0.4
115118
sudo vi /etc/hosts
116119
```
117120

118-
The contents should look similar to the following example:
121+
The output looks similar to the following example:
119122

120123
```output
121124
<IP address> DC1.CONTOSO.COM CONTOSO.COM CONTOSO
@@ -131,7 +134,7 @@ nameserver 10.0.0.4
131134
sudo vi /etc/sysconfig/network/config
132135
```
133136

134-
The contents should look similar to the following example:
137+
The output looks similar to the following example:
135138

136139
```ini
137140
NETCONFIG_DNS_STATIC_SEARCHLIST=""
@@ -150,7 +153,7 @@ nameserver 10.0.0.4
150153
sudo vi /etc/resolv.conf
151154
```
152155

153-
The contents should look similar to the following example:
156+
The output looks similar to the following example:
154157

155158
```output
156159
search contoso.com com
@@ -167,7 +170,7 @@ nameserver 10.0.0.4
167170
sudo vi /etc/netplan/******.yaml
168171
```
169172

170-
The contents should look similar to the following example:
173+
The output looks similar to the following example:
171174

172175
```yml
173176
network:
@@ -197,7 +200,7 @@ nameserver 10.0.0.4
197200
/etc/resolv.conf
198201
```
199202

200-
The contents should look similar to the following example:
203+
The output looks similar to the following example:
201204

202205
```output
203206
search contoso.com com
@@ -212,7 +215,7 @@ nameserver 10.0.0.4
212215
sudo vi /etc/network/interfaces
213216
```
214217

215-
The contents should look similar to the following example:
218+
The output looks similar to the following example:
216219

217220
```output
218221
# The primary network interface
@@ -237,7 +240,7 @@ nameserver 10.0.0.4
237240
sudo vi /etc/resolv.conf
238241
```
239242

240-
The contents should look similar to the following example:
243+
The output looks similar to the following example:
241244

242245
```output
243246
search contoso.com com
@@ -380,7 +383,7 @@ Verify that your `/etc/krb5.conf` is configured correctly. For most third-party
380383
sudo vi /etc/krb5.conf
381384
```
382385

383-
The contents should look similar to the following example:
386+
The output looks similar to the following example:
384387

385388
```ini
386389
[libdefaults]

docs/linux/sql-server-linux-ad-auth-adutil-tutorial.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,17 +3,16 @@ title: Configure Active Directory Authentication with SQL Server on Linux Using
33
description: Step by step on how to configure Active Directory authentication with SQL Server on Linux using adutil
44
author: amitkh-msft
55
ms.author: amitkh
6-
ms.reviewer: vanto, randolphwest
7-
ms.date: 07/03/2025
6+
ms.reviewer: randolphwest
7+
ms.date: 01/02/2026
88
ms.service: sql
99
ms.subservice: linux
1010
ms.topic: tutorial
11-
monikerRange: ">=sql-server-linux-2017 || >=sql-server-2017 || =sqlallproducts-allversions"
1211
ms.custom:
1312
- linux-related-content
1413
- sfi-image-nochange
14+
monikerRange: ">=sql-server-linux-2017 || >=sql-server-2017 || =sqlallproducts-allversions"
1515
---
16-
1716
# Tutorial: Use adutil to configure Active Directory authentication with SQL Server on Linux
1817

1918
[!INCLUDE [SQL Server - Linux](../includes/applies-to-version/sql-linux.md)]
@@ -170,7 +169,7 @@ Once you [create the user and SPNs](#adutil-spn), you can create the keytab usin
170169
/opt/mssql/bin/mssql-conf validate-ad-config /var/opt/mssql/secrets/mssql.keytab
171170
```
172171

173-
You should see output similar to the following example:
172+
The output looks similar to the following example:
174173

175174
```output
176175
Detected Configuration:

0 commit comments

Comments
 (0)