| title | Install SQL Server Integration Services on Linux |
|---|---|
| description | This article describes how to install SQL Server Integration Services (SSIS) on Linux. You can install SSIS on Ubuntu and Red Hat Enterprise Linux. |
| author | lrtoyou1223 |
| ms.author | lle |
| ms.reviewer | maghan, randolphwest |
| ms.date | 03/01/2023 |
| ms.service | sql |
| ms.subservice | linux |
| ms.topic | conceptual |
| ms.custom | intro-installation |
[!INCLUDE SQL Server - Linux]
Follow the steps in this article to install SQL Server Integration Services (mssql-server-is) on Linux. For more information about the features that are supported in Integration Services for Linux, see:
- Release notes for SQL Server 2017 on Linux
- Release notes for SQL Server 2019 on Linux
- Release notes for SQL Server 2022 on Linux
You can install SQL Server Integration Services (SSIS) on Red Hat Enterprise Linux (RHEL) and Ubuntu. SUSE Linux Enterprise Server (SLES) isn't supported. Installing SSIS on containers is also not supported.
To install the mssql-server-is package on RHEL, follow these steps:
::: moniker range="= sql-server-linux-2017 || = sql-server-2017"
-
Download the SQL Server Red Hat repository configuration file.
sudo curl -o /etc/yum.repos.d/mssql-server.repo https://packages.microsoft.com/config/rhel/7/mssql-server-2017.repo
-
Run the following command to install SQL Server Integration Services.
sudo yum install -y mssql-server-is
-
After installation, run ssis-conf. For more info, see Configure SSIS on Linux with ssis-conf.
sudo /opt/ssis/bin/ssis-conf setup
-
After the configuration is done, set the
PATHenvironment variable.export PATH=/opt/ssis/bin:$PATH
::: moniker-end
::: moniker range="= sql-server-linux-ver15 || = sql-server-ver15"
-
Download the SQL Server Red Hat repository configuration file.
sudo curl -o /etc/yum.repos.d/mssql-server.repo https://packages.microsoft.com/config/rhel/8/mssql-server-2019.repo
-
Run the following command to install SQL Server Integration Services.
sudo yum install -y mssql-server-is
-
After installation, run ssis-conf. For more info, see Configure SSIS on Linux with ssis-conf.
sudo /opt/ssis/bin/ssis-conf setup
-
After the configuration is done, set the
PATHenvironment variable.export PATH=/opt/ssis/bin:$PATH
::: moniker-end
::: moniker range=">= sql-server-linux-ver16 || >= sql-server-ver16"
-
Download the SQL Server Red Hat repository configuration file.
sudo curl -o /etc/yum.repos.d/mssql-server.repo https://packages.microsoft.com/config/rhel/8/mssql-server-2022.repo
-
Run the following command to install SQL Server Integration Services.
sudo yum install -y mssql-server-is
-
After installation, run ssis-conf. For more info, see Configure SSIS on Linux with ssis-conf.
sudo /opt/ssis/bin/ssis-conf setup
-
After the configuration is done, set the
PATHenvironment variable.export PATH=/opt/ssis/bin:$PATH
::: moniker-end
If you already have mssql-server-is installed, update to the latest version by using the following command:
sudo yum update mssql-server-isTo remove mssql-server-is, run the following command:
sudo yum remove mssql-server-isThe SQL Server Integration Services package (mssql-server-is) is not supported on SUSE Linux Enterprise Server.
To install the mssql-server-is package on Ubuntu, follow these steps:
::: moniker range="= sql-server-linux-2017 || = sql-server-2017"
-
Import the public repository GPG keys.
curl https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add - -
Register the SQL Server Ubuntu repository.
sudo add-apt-repository "$(curl https://packages.microsoft.com/config/ubuntu/18.04/mssql-server-2017.list)" -
Run the following commands to install SQL Server Integration Services.
sudo apt-get update sudo apt-get install -y mssql-server-is
-
After installing Integration Services, run ssis-conf. For more info, see Configure SSIS on Linux with ssis-conf.
sudo /opt/ssis/bin/ssis-conf setup
-
After the configuration is done, set the
PATHenvironment variable.export PATH=/opt/ssis/bin:$PATH
::: moniker-end
::: moniker range="= sql-server-linux-ver15 || = sql-server-ver15"
-
Import the public repository GPG keys.
curl https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add - -
Register the SQL Server Ubuntu repository.
sudo add-apt-repository "$(curl https://packages.microsoft.com/config/ubuntu/20.04/mssql-server-2019.list)" -
Run the following commands to install SQL Server Integration Services.
sudo apt-get update sudo apt-get install -y mssql-server-is
-
After installing Integration Services, run ssis-conf. For more info, see Configure SSIS on Linux with ssis-conf.
sudo /opt/ssis/bin/ssis-conf setup
-
After the configuration is done, set the
PATHenvironment variable.export PATH=/opt/ssis/bin:$PATH
::: moniker-end
::: moniker range=">= sql-server-linux-ver16 || >= sql-server-ver16"
-
Import the public repository GPG keys.
curl https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add - -
Register the SQL Server Ubuntu repository.
sudo add-apt-repository "$(curl https://packages.microsoft.com/config/ubuntu/20.04/mssql-server-2022.list)" -
Run the following commands to install SQL Server Integration Services.
sudo apt-get update sudo apt-get install -y mssql-server-is
-
After installing Integration Services, run ssis-conf. For more info, see Configure SSIS on Linux with ssis-conf.
sudo /opt/ssis/bin/ssis-conf setup
-
After the configuration is done, set the
PATHenvironment variable.export PATH=/opt/ssis/bin:$PATH
::: moniker-end
If you already have mssql-server-is installed, update to the latest version with the following command:
sudo apt-get install mssql-server-isTo remove mssql-server-is, run the following command:
sudo apt-get remove mssql-server-isTo run ssis-conf setup unattended (RHEL and Ubuntu only), do the following steps:
- Specify the
-n(no prompt) option. - Provide required values by setting environment variables.
The following example does these actions:
- Installs SSIS
- Specifies the Developer edition by providing a value for the
SSIS_PIDenvironment variable - Accepts the Microsoft Software License Terms by providing a value for the
ACCEPT_EULAenvironment variable - Runs an unattended setup by specifying the
-n(no prompt) option
sudo SSIS_PID=Developer ACCEPT_EULA=Y /opt/ssis/bin/ssis-conf -n setup| Environment variable | Description |
|---|---|
ACCEPT_EULA |
Accepts the SQL Server license terms when set to any value like Y. |
SSIS_PID |
Sets the SQL Server edition or product key. Here are the possible values: - Evaluation - Developer - Express - Web - Standard - Enterprise - A product key If you specify a product key, it must be in the form #####-#####-#####-#####-#####, where # is a letter or a digit. |