Learn more about SQL Server tools


Tutorials          DBA          Dev          BI          Career          Categories          Events          Whitepapers          Today's Tip          Join

Tutorials      DBA      Dev      BI      Categories      Events

DBA    Dev    BI    Categories


Install SQL Server Tools to Establish a Database Connection from an Ubuntu Server

By:   |   Read Comments   |   Related Tips: More > SQL Server on Linux


I explained how to install SQL Server vNext on Ubuntu in my last tip and in this tip we will look at how to install SQL Server tools on the Ubuntu server.


As I discussed in my last couple of articles, SQL Server vNext does not install sqlcmd and BCP utility with the SQL Server installation on Red Hat Linux and Ubuntu servers, but we need the sqlcmd utility to make a database connection from the Linux based servers. We will walk through the steps to install these tools on the Ubuntu server.

SQL Server Tools Installation on Ubuntu Server

Before going forward, you need to have an Ubuntu server with SQL Server vNext installed on that machine. I followed the step by step method of Microsoft's online documentation to understand this installation. Let's start the SQL Server tools installation on Ubuntu.

Step 1: First connect to the target Ubuntu server on which you have installed SQL Server vNext. You can directly connect to the server by logging in to the server to do this exercise or you can use PuTTY, a third party tool, to make a server connection. I used PuTTY to login on this server. I launched PuTTY and entered the IP address of the Ubuntu server and then clicked the open button. A black screen known as the PuTTY terminal will appear asking you to enter the login information to connect to the target server. I entered the login name as manvendra followed by its password to make a successful connection as shown below.

connect using PUTTY

Once you would have established a successful connection, you can see the version of the Ubuntu server as shown in the above screenshot.

Step 2: You can see that I made a successful connection to this Ubuntu server where I installed SQL Server in my last tip. Now let's check and verify the SQL Server installation on this machine. Run the below command to check the mssql-server service.

#check the status of mssql-server service.
systemctl status mssql-server

Check mssql-server service

We can see the service status is showing enabled and active (running) which is highlighted in green. This means SQL Server is installed and running fine on this server.

Step 3: Next we will install the MSSQL tools on this server. The first step of installation is to import the public repository GPG keys as per Microsoft's documentation, so we will run the below command to import the GPG keys. GPG keys also provide cryptographic privacy and authentication.

#import the public repository GPG keys
curl https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add -

You can see that command has been executed successfully in the below screenshot.

curl GPG keys

Step 4: Now we will run a curl command to register the Microsoft Ubuntu repository. This repository will be used to install the MSSQL tools on this machine. The downloaded file will be saved in location /etc/apt/sources.list.d/ as mentioned in the command line.

#Download Ubuntu installation configuration file.
curl https://packages.microsoft.com/config/ubuntu/16.04/prod.list | sudo tee /etc/apt/sources.list.d/msprod.list

We can see the progress, time and details of the downloaded configuration file in the below picture.

run curl cmd to register Ubuntu repository

Now we can check the location /etc/apt/sources.list.d/ to verify whether the above file is saved in this location. Run ls -lrt command to display all of the files present in that folder.

#list all files/folders inside the /etc/apt/sources.list.d/ folder.
ls -lrt /etc/apt/sources.list.d/

ls-lrt /etc/apt/sources.list.d/

You can see our target file msprod.list file is there in this location in the above picture.

Step 5: Now our next step is to install MSSQL tools on this box with the help of this package. But before going ahead, we will run the below command to update the sources list on this Ubuntu server.

#update the sources list
sudo apt-get update 

sudo apt-get update

Once you execute this command, a series of updates will be displayed on your screen. This execution will also display the size of updates for any respective packages.

sudo apt-get update

Step 6: Once the above command executes successfully we will run the below command to install the MSSQL tools on this machine.

#Install MSSQL tools
sudo apt-get install mssql-tools

install SQL Server tools

Once execution starts, it will read the package list followed by checking dependencies. It will display the name of the target packages which will be installed along with this installation. Now it will ask you to choose yes or no to proceed with the installation. Type y to choose yes. Once you press enter after typing y, the download process for all required packages will start as shown in the below picture.

install SQL Server tools

You can see the progress for a particular package which is in process as shown below.

install SQL Server tools

Every package will ask you to enter YES to accept the license terms during installation as shown in the below screenshot. You will get the below screen to accept the license terms. Choose YES and press enter to proceed.

Accept the license terms during installing SQL Server tools

Once you press enter, again execution will be resumed in the PuTTY terminal.

Accept the license terms during installing SQL Server tools

The next window is to accept the license terms for the msodbcsql package similar to the above screenshot.

Accept the license terms during installing SQL Server tools

Again processing, things will resume in the PuTTY terminal as shown in the below picture.

installing SQL Server tools

Let them proceed as shown in the above picture. When done, execution will stop and the MSSQL tools will be installed on your Ubuntu server.

installing SQL Server tools

Step 7: Now we will check and verify whether sqlcmd utility is installed on this machine. Type sqlcmd and press enter to check the details of this utility.

#check sqlcmd utility.

We can see that sqlcmd is recognized by Ubuntu and the output of this command is shows that sqlcmd is installed and ready to use.

sqlcmd validation

Next we will validate sqlcmd by making a database connection from Ubuntu server on the PuTTY terminal. Run the below command to connect to database engine from the Ubuntu server.

#Run sqlcmd to make database connection.
#You need to pass server name/IP address with -S, user name with -U. Enter the password of sa account once you get the Password prompt.
sqlcmd -S192.168.209.129 -Usa

Once you execute the above command, a SQL Server prompt will appear with cursor 1>. I executed "SELECT @@VERSION", the T-SQL command to check the installed version of SQL Server.

#I executed SELECT @@VERSION to get version details of SQL Server. I got below output:
Microsoft SQL Server vNext (CTP1) - (X64)
 Nov 1 2016 23:24:39
 Copyright (c) Microsoft Corporation
 on Linux (Ubuntu 16.04.1 LTS)

run select @@version

Step 8: I created a new database "Manvendra" in my last tip to validate the SQL Server installation on the Ubuntu server, so I will check the database names in the sysdatabases system table by running the following query.

#Check database name in sysdatabases system table.
#Run this command on sqlcmd prompt only.
SELECT name from sysdatabases

We can see we have 5 databases, including database "Manvendra".

check sysdatabases table

Step 9: Now we will create a new database from this prompt on the Ubuntu server and validate it by running the below SQL command.

#Create a new db named MSSQLTIPS and Check database name in sysdatabases system table.
#Run this command on sqlcmd prompt only.
SELECT name from sysdatabases

We can see the commands executed successfully and a new database MSSQLTIPS is showing along with the other databases.

create new db MSSQLTIPS and check sysdatabases table

Now we will validate whether this newly created database is accessible through SSMS on a Windows box. Launch SQL Server Management Studio on your Windows machine and connect to the Ubuntu server using your IP address. You can use the sa login and password to make a database connection. Once you make a database connection, run the below command to check the user details for database MSSQLTIPS.

#check the details of users in MSSQLTIPS db in SSMS.
SELECT name from sysusers where gid=0

check db in ssms

Now we have validated that we can connect to the SQL Server vNext database engine using sqlcmd on the Ubuntu server.

Next Steps
  • Go ahead and make database connections on the Ubuntu server and get more exposure on this new version of SQL Server.
  • Stay tuned for my next tips based on SQL Server on Linux.
  • Explore more knowledge with these SQL Server Database Administration Tips

Last Update:

About the author
MSSQLTips author Manvendra Singh Manvendra Singh has over 5 years of experience with SQL Server and has focused on Database Mirroring, Replication, Log Shipping, etc.

View all my tips
Related Resources


Post a comment or let the author know this tip helped.

All comments are reviewed, so stay on subject or we may delete your comment. Note: your email address is not published. Required fields are marked with an asterisk (*).

*Name    *Email    Notify for updates 

Get free SQL tips:

*Enter Code refresh code     

Learn more about SQL Server tools