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/quickstart-install-connect-docker.md
+15-6Lines changed: 15 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -177,9 +177,12 @@ Before starting the following steps, make sure that you've selected your preferr
177
177
```
178
178
::: zone-end
179
179
180
-
You should see output similar to the following screenshot:
180
+
You should see output similar to the following:
181
181
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
+
```
183
186
184
187
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:
185
188
@@ -306,9 +309,12 @@ Before starting the following steps, make sure that you've selected your preferr
306
309
```
307
310
::: zone-end
308
311
309
-
You should see output similar to the following screenshot:
312
+
You should see output similar to the following:
310
313
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
+
```
312
318
313
319
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:
314
320
@@ -435,9 +441,12 @@ Before starting the following steps, make sure that you've selected your preferr
435
441
```
436
442
::: zone-end
437
443
438
-
You should see output similar to the following screenshot:
444
+
You should see output similar to the following:
439
445
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
+
```
441
450
442
451
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:
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:
61
64
62
65
```bash
@@ -72,9 +75,6 @@ For more information, see the following blog on installing `python2` and configu
72
75
73
76
To configure [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on RHEL, run the following commands in a terminal to install the `mssql-server` package:
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
+
120
135
1. Download the [!INCLUDE [sssql19-md](../includes/sssql19-md.md)] Red Hat repository configuration file:
121
136
122
137
```bash
@@ -159,10 +174,14 @@ At this point, [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] is run
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
+
162
181
1. Download the [!INCLUDE [sssql22-md](../includes/sssql22-md.md)] Red Hat repository configuration file:
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.
18
19
19
-
> [!TIP]
20
+
> [!TIP]
20
21
> [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).
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).
[!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).
[!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).
25
33
::: moniker-end
26
34
27
35
## Install
@@ -31,9 +39,16 @@ To get started, install SQL Server on Linux using one of the following quickstar
31
39
-[Install on Red Hat Enterprise Linux](quickstart-install-connect-red-hat.md)
32
40
-[Install on SUSE Linux Enterprise Server](quickstart-install-connect-suse.md)
33
41
-[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)
35
43
-[Provision a SQL VM in Azure](/azure/azure-sql/virtual-machines/linux/sql-vm-create-portal-quickstart?toc=/sql/toc/toc.json)
36
44
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
+
37
52
## Connect
38
53
39
54
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
46
61
47
62
## Explore
48
63
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.
50
65
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:
52
67
53
68
-[SQL Server 2017 release notes](sql-server-linux-release-notes.md)
54
69
-[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)
55
71
56
72
Then look at what's new:
57
73
58
74
-[What's new for SQL Server 2017](sql-server-linux-whats-new.md)
59
75
-[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)
60
77
61
78
> [!TIP]
62
79
> For answers to frequently asked questions, see the [SQL Server on Linux FAQ](sql-server-linux-faq.yml).
0 commit comments