Install SQL Server Agent on Linux

APPLIES TO: yesSQL Server (Linux only) noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

The SQL Server Agent runs scheduled SQL Server jobs. Starting with SQL Server 2017 CU4, SQL Server Agent is included with the mssql-server package and is disabled by default. For information on the features supported for this release of the SQL Server Agent along with version information, see the Release Notes.

Install/Enable the SQL Server Agent:

For Versions 2017 CU4 and above, Enable the SQL Server Agent

To enable SQL Server Agent, follow the steps below.

sudo /opt/mssql/bin/mssql-conf set sqlagent.enabled true 
sudo systemctl restart mssql-server

Note

If you are upgrading from 2017 CU3 or below with Agent installed, SQL Server Agent will be enabled automatically and previous Agent packages will be uninstalled.

For Versions 2017 CU3 and Below, Install the SQL Server Agent

Note

The install instructions below apply to SQL Server Versions 2017 CU3 and below. Before installing SQL Server Agent, first install SQL Server. This configures the keys and repositories that you use when you install the mssql-server-agent package.

Install the SQL Server Agent for your platform:

Install on RHEL

Use the following steps to install the mssql-server-agent on Red Hat Enterprise Linux.

sudo yum install mssql-server-agent
sudo systemctl restart mssql-server

If you already have mssql-server-agent installed, you can update to the latest version with the following commands:

sudo yum check-update
sudo yum update mssql-server-agent
sudo systemctl restart mssql-server

If you need an offline installation, locate the SQL Server Agent package download in the Release notes. Then use the same offline installation steps described in the article Install SQL Server.

Install on Ubuntu

Use the following steps to install the mssql-server-agent on Ubuntu.

sudo apt-get update 
sudo apt-get install mssql-server-agent
sudo systemctl restart mssql-server

If you already have mssql-server-agent installed, you can update to the latest version with the following commands:

sudo apt-get update 
sudo apt-get install mssql-server-agent
sudo systemctl restart mssql-server

If you need an offline installation, locate the SQL Server Agent package download in the Release notes. Then use the same offline installation steps described in the article Install SQL Server.

Install on SLES

Use the following steps to install the mssql-server-agent on SUSE Linux Enterprise Server.

Install mssql-server-agent

sudo zypper install mssql-server-agent
sudo systemctl restart mssql-server

If you already have mssql-server-agent installed, you can update to the latest version with the following commands:

sudo zypper refresh
sudo zypper update mssql-server-agent
sudo systemctl restart mssql-server

If you need an offline installation, locate the SQL Server Agent package download in the Release notes. Then use the same offline installation steps described in the article Install SQL Server.

Next steps

For more information on how to use SQL Server Agent to create, schedule, and run jobs, see Run a SQL Server Agent job on Linux.