Skip to content

Commit ec3c15a

Browse files
committed
Suggested changes
1 parent 44d80c5 commit ec3c15a

6 files changed

Lines changed: 67 additions & 22 deletions

docs/linux/quickstart-install-connect-docker.md

Lines changed: 15 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -177,9 +177,12 @@ Before starting the following steps, make sure that you've selected your preferr
177177
```
178178
::: zone-end
179179

180-
You should see output similar to the following screenshot:
180+
You should see output similar to the following:
181181

182-
:::image type="content" source="./media/quickstart-install-connect-docker/docker-ps-command.png" alt-text="Screenshot shows the output of the Docker p s command, which has columns for STATUS, PORTS, and other values.":::
182+
```output
183+
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
184+
d4a1999ef83e mcr.microsoft.com/mssql/server:2017-latest "/opt/mssql/bin/perm..." 2 minutes ago Up 2 minutes 0.0.0.0:1433->1433/tcp, :::1433->1433/tcp sql1
185+
```
183186

184187
1. If the `STATUS` column shows a status of `Up`, then [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] is running in the container and listening on the port specified in the `PORTS` column. If the `STATUS` column for your [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] container shows `Exited`, see the [Troubleshooting section of the configuration guide](./sql-server-linux-docker-container-troubleshooting.md). The server is ready for connections once the [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] error logs display the message: `SQL Server is now ready for client connections. This is an informational message; no user action is required`. You can review the [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] error log inside the container using the command:
185188

@@ -306,9 +309,12 @@ Before starting the following steps, make sure that you've selected your preferr
306309
```
307310
::: zone-end
308311

309-
You should see output similar to the following screenshot:
312+
You should see output similar to the following:
310313

311-
:::image type="content" source="./media/quickstart-install-connect-docker/docker-ps-command.png" alt-text="Screenshot shows the output of the Docker p s command, which has columns for STATUS, PORTS, and other values.":::
314+
```output
315+
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
316+
d4a1999ef83e mcr.microsoft.com/mssql/server:2019-latest "/opt/mssql/bin/perm..." 2 minutes ago Up 2 minutes 0.0.0.0:1433->1433/tcp, :::1433->1433/tcp sql1
317+
```
312318

313319
1. If the `STATUS` column shows a status of `Up`, then [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] is running in the container and listening on the port specified in the `PORTS` column. If the `STATUS` column for your [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] container shows `Exited`, see the [Troubleshooting section of the configuration guide](./sql-server-linux-docker-container-troubleshooting.md). The server is ready for connections once the [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] error logs display the message: `SQL Server is now ready for client connections. This is an informational message; no user action is required`. You can review the [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] error log inside the container using the command:
314320

@@ -435,9 +441,12 @@ Before starting the following steps, make sure that you've selected your preferr
435441
```
436442
::: zone-end
437443

438-
You should see output similar to the following screenshot:
444+
You should see output similar to the following:
439445

440-
:::image type="content" source="./media/quickstart-install-connect-docker/docker-ps-command.png" alt-text="Screenshot shows the output of the Docker p s command, which has columns for STATUS, PORTS, and other values.":::
446+
```output
447+
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
448+
d4a1999ef83e mcr.microsoft.com/mssql/server:2022-latest "/opt/mssql/bin/perm..." 2 minutes ago Up 2 minutes 0.0.0.0:1433->1433/tcp, :::1433->1433/tcp sql1
449+
```
441450

442451
1. If the `STATUS` column shows a status of `Up`, then [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] is running in the container and listening on the port specified in the `PORTS` column. If the `STATUS` column for your [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] container shows `Exited`, see the [Troubleshooting section of the configuration guide](./sql-server-linux-docker-container-troubleshooting.md). The server is ready for connections once the [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] error logs display the message: `SQL Server is now ready for client connections. This is an informational message; no user action is required`. You can review the [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] error log inside the container using the command:
443452

docs/linux/quickstart-install-connect-red-hat.md

Lines changed: 23 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -57,6 +57,9 @@ For other system requirements, see [System requirements for SQL Server on Linux]
5757

5858
## <a id="install"></a> Install SQL Server
5959

60+
<!--SQL Server 2017 on Linux-->
61+
::: moniker range="= sql-server-linux-2017 || = sql-server-2017"
62+
6063
The following commands for installing [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] point to the RHEL 8 repository. RHEL 8 doesn't come preinstalled with `python2`, which is required by [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]. Before you begin the [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] install steps, execute the command and verify that `python2` is selected as the interpreter:
6164

6265
```bash
@@ -72,9 +75,6 @@ For more information, see the following blog on installing `python2` and configu
7275

7376
To configure [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on RHEL, run the following commands in a terminal to install the `mssql-server` package:
7477

75-
<!--SQL Server 2017 on Linux-->
76-
::: moniker range="= sql-server-linux-2017 || = sql-server-2017"
77-
7878
1. Download the [!INCLUDE [sssql17-md](../includes/sssql17-md.md)] Red Hat repository configuration file:
7979

8080
```bash
@@ -117,6 +117,21 @@ At this point, [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] is run
117117
<!--SQL Server 2019 on Linux-->
118118
::: moniker range="= sql-server-linux-ver15 || = sql-server-ver15"
119119

120+
The following commands for installing [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] point to the RHEL 8 repository. RHEL 8 doesn't come preinstalled with `python2`, which is required by [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]. Before you begin the [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] install steps, execute the command and verify that `python2` is selected as the interpreter:
121+
122+
```bash
123+
sudo alternatives --config python
124+
# If not configured, install python2 and openssl10 using the following commands:
125+
sudo yum install python2
126+
sudo yum install compat-openssl10
127+
# Configure python2 as the default interpreter using this command:
128+
sudo alternatives --config python
129+
```
130+
131+
For more information, see the following blog on installing `python2` and configuring it as the default interpreter: https://www.redhat.com/en/blog/installing-microsoft-sql-server-red-hat-enterprise-linux-8-beta.
132+
133+
To configure [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on RHEL, run the following commands in a terminal to install the `mssql-server` package:
134+
120135
1. Download the [!INCLUDE [sssql19-md](../includes/sssql19-md.md)] Red Hat repository configuration file:
121136

122137
```bash
@@ -159,10 +174,14 @@ At this point, [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] is run
159174
<!--SQL Server 2022 on Linux-->
160175
::: moniker range=">= sql-server-linux-ver16 || >= sql-server-ver16"
161176

177+
The following commands for installing [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] point to the RHEL 8 repository.
178+
179+
To configure [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on RHEL, run the following commands in a terminal to install the `mssql-server` package:
180+
162181
1. Download the [!INCLUDE [sssql22-md](../includes/sssql22-md.md)] Red Hat repository configuration file:
163182

164183
```bash
165-
sudo curl -o /etc/yum.repos.d/mssql-server.repo https://packages.microsoft.com/config/rhel/8/mssql-server-2022.repo
184+
sudo curl -o /etc/yum.repos.d/mssql-server.repo https://packages.microsoft.com/config/rhel/8/mssql-server-preview.repo
166185
```
167186

168187
> [!TIP]

docs/linux/quickstart-install-connect-ubuntu.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -181,7 +181,7 @@ To configure [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on Ubunt
181181
1. Register the [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] Ubuntu repository:
182182

183183
```bash
184-
sudo add-apt-repository "$(wget -qO- https://packages.microsoft.com/config/ubuntu/20.04/mssql-server-2022.list)"
184+
sudo add-apt-repository "$(wget -qO- https://packages.microsoft.com/config/ubuntu/20.04/mssql-server-preview.list)"
185185
```
186186

187187
> [!TIP]

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -64,9 +64,9 @@ fi
6464

6565
echo Adding Microsoft repositories...
6666
sudo curl https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add -
67-
repoargs="$(curl https://packages.microsoft.com/config/ubuntu/16.04/mssql-server-2017.list)"
67+
repoargs="$(curl https://packages.microsoft.com/config/ubuntu/20.04/mssql-server-2019.list)"
6868
sudo add-apt-repository "${repoargs}"
69-
repoargs="$(curl https://packages.microsoft.com/config/ubuntu/16.04/prod.list)"
69+
repoargs="$(curl https://packages.microsoft.com/config/ubuntu/20.04/prod.list)"
7070
sudo add-apt-repository "${repoargs}"
7171

7272
echo Running apt-get update -y...

docs/linux/sql-server-linux-overview.md

Lines changed: 25 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,8 @@ title: Overview of SQL Server on Linux
33
description: This article describes how SQL Server runs on Linux and provides information on how to learn more.
44
author: VanMSFT
55
ms.author: vanto
6-
ms.date: 03/31/2022
6+
ms.reviewer: randolphwest
7+
ms.date: 06/08/2022
78
ms.topic: conceptual
89
ms.prod: sql
910
ms.technology: linux
@@ -14,14 +15,21 @@ ms.assetid: 9dcc6a90-0add-42c2-815b-862e4e2a21ac
1415
[!INCLUDE [SQL Server - Linux](../includes/applies-to-version/sql-linux.md)]
1516

1617
::: moniker range="= sql-server-2017 || = sql-server-linux-2017"
17-
Starting with SQL Server 2017, SQL Server runs on Linux. It's the same SQL Server database engine, with many similar features and services regardless of your operating system.
18+
Starting with [!INCLUDE [sssql17-md](../includes/sssql17-md.md)], SQL Server runs on Linux. It's the same SQL Server database engine, with many similar features and services regardless of your operating system.
1819

19-
> [!TIP]
20+
> [!TIP]
2021
> [SQL Server 2019](sql-server-linux-overview.md?view=sql-server-ver15&preserve-view=true) is available! To find out what's new for Linux in the latest release, see [What's new in SQL Server 2019 for Linux](sql-server-linux-whats-new-2019.md?view=sql-server-ver15&preserve-view=true).
2122
::: moniker-end
2223

23-
::: moniker range=">= sql-server-ver15 || >= sql-server-linux-ver15"
24-
SQL Server 2019 runs on Linux. It's the same SQL Server database engine, with many similar features and services regardless of your operating system. To find out more about this release, see [What's new in SQL Server 2019 for Linux](sql-server-linux-whats-new-2019.md).
24+
::: moniker range="= sql-server-ver15 || = sql-server-linux-ver15"
25+
[!INCLUDE [sssql19-md](../includes/sssql19-md.md)] runs on Linux. It's the same SQL Server database engine, with many similar features and services regardless of your operating system. To find out more about this release, see [What's new in SQL Server 2019 for Linux](sql-server-linux-whats-new-2019.md).
26+
27+
> [!TIP]
28+
> [SQL Server 2022 Preview](sql-server-linux-overview.md?view=sql-server-ver16&preserve-view=true) is available! To find out what's new for Linux in the latest release, see [What's new in [!INCLUDE[sql-server-2022](../includes/sssql22-md.md)]](../sql-server/what-s-new-in-sql-server-2022.md).
29+
::: moniker-end
30+
31+
::: moniker range=">= sql-server-ver16 || >= sql-server-linux-ver16"
32+
[!INCLUDE [sssql22-md](../includes/sssql22-md.md)] runs on Linux. It's the same SQL Server database engine, with many similar features and services regardless of your operating system. To find out more about this release, see [What's new in [!INCLUDE[sql-server-2022](../includes/sssql22-md.md)]](../sql-server/what-s-new-in-sql-server-2022.md).
2533
::: moniker-end
2634

2735
## Install
@@ -31,9 +39,16 @@ To get started, install SQL Server on Linux using one of the following quickstar
3139
- [Install on Red Hat Enterprise Linux](quickstart-install-connect-red-hat.md)
3240
- [Install on SUSE Linux Enterprise Server](quickstart-install-connect-suse.md)
3341
- [Install on Ubuntu](quickstart-install-connect-ubuntu.md)
34-
- [Run on Docker](quickstart-install-connect-docker.md)
42+
- [Install containers for SQL Server on Linux](quickstart-install-connect-docker.md)
3543
- [Provision a SQL VM in Azure](/azure/azure-sql/virtual-machines/linux/sql-vm-create-portal-quickstart?toc=/sql/toc/toc.json)
3644

45+
### Container images
46+
47+
You can find SQL Server container images on Linux at the following locations, based on the operating system image that was used to create the image.
48+
49+
- For RHEL-based SQL Server container images, see [SQL Server Red Hat Containers](https://catalog.redhat.com/software/containers/mssql/rhel/server/61f2f612f385723914ed60bc).
50+
- For Ubuntu based SQL Server images, see [SQL Server on Docker Hub](https://hub.docker.com/_/microsoft-mssql-server).
51+
3752
## Connect
3853

3954
After installation, connect to the SQL Server instance on your Linux machine. You can connect locally or remotely and with a variety of tools and drivers. The quickstarts demonstrate how to use the [sqlcmd](sql-server-linux-setup-tools.md) command-line tool. Other tools include the following:
@@ -46,17 +61,19 @@ After installation, connect to the SQL Server instance on your Linux machine. Yo
4661

4762
## Explore
4863

49-
SQL Server 2017 and [!INCLUDE[SQL Server 2019](../includes/sssql19-md.md)] have the same underlying database engine on all supported platforms, including Linux. Therefore, many existing features and capabilities operate the same way on Linux. This area of the documentation exposes some of these features from a Linux perspective. It also calls out areas that have unique requirements on Linux.
64+
Starting with [!INCLUDE [sssql17-md](../includes/sssql17-md.md)], [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] has the same underlying database engine on all supported platforms, including Linux and containers. Therefore, many existing features and capabilities operate the same way. This area of the documentation exposes some of these features from a Linux perspective. It also calls out areas that have unique requirements on Linux.
5065

51-
If you are already familiar with SQL Server on Linux, review the release notes for general guidelines and known issues for this release:
66+
If you are already familiar with [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on Linux, review the release notes for general guidelines and known issues for this release:
5267

5368
- [SQL Server 2017 release notes](sql-server-linux-release-notes.md)
5469
- [SQL Server 2019 release notes](sql-server-linux-release-notes-2019.md)
70+
- [SQL Server 2022 Preview release notes](sql-server-linux-release-notes-2022.md)
5571

5672
Then look at what's new:
5773

5874
- [What's new for SQL Server 2017](sql-server-linux-whats-new.md)
5975
- [What's new for SQL Server 2019 on Linux](../sql-server/what-s-new-in-sql-server-2019.md#sql-server-on-linux)
76+
- [What's new in [!INCLUDE[sql-server-2022](../includes/sssql22-md.md)]](../sql-server/what-s-new-in-sql-server-2022.md)
6077

6178
> [!TIP]
6279
> For answers to frequently asked questions, see the [SQL Server on Linux FAQ](sql-server-linux-faq.yml).

docs/toc.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10533,7 +10533,7 @@ items:
1053310533
href: linux/quickstart-install-connect-suse.md
1053410534
- name: Install & Connect - Ubuntu
1053510535
href: linux/quickstart-install-connect-ubuntu.md
10536-
- name: Run & Connect - Docker
10536+
- name: Run & Connect - Container
1053710537
href: linux/quickstart-install-connect-docker.md
1053810538
- name: Deploy SQL Server container - Kubernetes
1053910539
href: linux/quickstart-sql-server-containers-kubernetes.md

0 commit comments

Comments
 (0)