Esempio: script di installazione automatica di SQL Server per Ubuntu

Articolo
11/25/2024

Si applica a: SQL Server - Linux

Questo script bash di esempio installa SQL Server in Ubuntu senza input interattivo. Fornisce esempi di installazione del motore di database, gli strumenti da riga di comando SQL Server e SQL Server Agent ed esegue le operazioni successive all'installazione. Facoltativamente, è possibile installare la ricerca full-text e creare un utente amministratore.

Suggerimento

Se non è necessario uno script di installazione automatica, il modo più rapido per installare SQL Server consiste nel seguire l'avvio rapido per Ubuntu. Per altre informazioni sull'installazione, vedere Linee guida per l'installazione di SQL Server in Linux.

Prerequisiti

Per eseguire SQL Server in Linux sono necessari almeno 2 GB di memoria.
Il file system deve essere XFS o EXT4. Altri file system, come BTRFS, non sono supportati.
Per altri requisiti di sistema, vedere Requisiti di sistema per SQL Server su Linux.

Script di esempio

Questo esempio installa SQL Server 2019 (15.x) in Ubuntu Server 20.04. Se si vuole installare una versione diversa di SQL Server o Ubuntu Server, modificare di conseguenza i percorsi del repository Microsoft.

Salvare lo script di esempio in un file e personalizzarlo. È necessario sostituire i valori delle variabili nello script. È anche possibile impostare qualsiasi variabile di scripting come variabile di ambiente, purché venga rimossa dal file di script.

Lo script potrebbe non riuscire se l'avvio di SQL Server è lento. Questo perché lo script viene chiuso con uno stato diverso da zero. Per risolvere il problema, provare a rimuovere l'opzione -e nella prima riga.

Importante

La variabile di ambiente SA_PASSWORD è deprecata. Utilizzare invece MSSQL_SA_PASSWORD.

La password deve seguire i criteri password predefiniti di SQL Server. Per impostazione predefinita, la password deve essere composta da almeno otto caratteri e contenere caratteri di tre delle quattro categorie seguenti: lettere maiuscole, lettere minuscole, cifre in base 10 e simboli. Le password possono contenere fino a 128 caratteri. Usare password il più possibile lunghe e complesse.

#!/bin/bash -e

# Use the following variables to control your install:

# Password for the SA user (required)
MSSQL_SA_PASSWORD='<password>'

# Product ID of the version of SQL Server you're installing
# Must be evaluation, developer, express, web, standard, enterprise, or your 25 digit product key
# Defaults to developer
MSSQL_PID='evaluation'

# Enable SQL Server Agent (recommended)
SQL_ENABLE_AGENT='y'

# Install SQL Server Full Text Search (optional)
# SQL_INSTALL_FULLTEXT='y'

# Create an additional user with sysadmin privileges (optional)
# SQL_INSTALL_USER='<Username>'
# SQL_INSTALL_USER_PASSWORD='<password>'

if [ -z $MSSQL_SA_PASSWORD ]
then
  echo Environment variable MSSQL_SA_PASSWORD must be set for unattended install
  exit 1
fi

echo Adding Microsoft repositories...
curl https://packages.microsoft.com/keys/microsoft.asc | sudo tee /etc/apt/trusted.gpg.d/microsoft.asc
repoargs="$(curl https://packages.microsoft.com/config/ubuntu/20.04/mssql-server-2019.list)"
sudo add-apt-repository "${repoargs}"
repoargs="$(curl https://packages.microsoft.com/config/ubuntu/20.04/prod.list)"
sudo add-apt-repository "${repoargs}"

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

echo Installing SQL Server...
sudo apt-get install -y mssql-server

echo Running mssql-conf setup...
sudo MSSQL_SA_PASSWORD=$MSSQL_SA_PASSWORD \
     MSSQL_PID=$MSSQL_PID \
     /opt/mssql/bin/mssql-conf -n setup accept-eula

echo Installing mssql-tools and unixODBC developer...
sudo ACCEPT_EULA=Y apt-get install -y mssql-tools unixodbc-dev

# Add SQL Server tools to the path by default:
echo Adding SQL Server tools to your path...
echo PATH="$PATH:/opt/mssql-tools/bin" >> ~/.bash_profile
echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
source ~/.bashrc

# Optional Enable SQL Server Agent:
if [ ! -z $SQL_ENABLE_AGENT ]
then
  echo Enabling SQL Server Agent...
  sudo /opt/mssql/bin/mssql-conf set sqlagent.enabled true
fi

# Optional SQL Server Full Text Search installation:
if [ ! -z $SQL_INSTALL_FULLTEXT ]
then
    echo Installing SQL Server Full-Text Search...
    sudo apt-get install -y mssql-server-fts
fi

# Configure firewall to allow TCP port 1433:
echo Configuring UFW to allow traffic on port 1433...
sudo ufw allow 1433/tcp
sudo ufw reload

# Optional example of post-installation configuration.
# Trace flags 1204 and 1222 are for deadlock tracing.
# echo Setting trace flags...
# sudo /opt/mssql/bin/mssql-conf traceflag 1204 1222 on

# Restart SQL Server after installing:
echo Restarting SQL Server...
sudo systemctl restart mssql-server

# Connect to server and get the version:
counter=1
errstatus=1
while [ $counter -le 5 ] && [ $errstatus = 1 ]
do
  echo Waiting for SQL Server to start...
  sleep 3s
  /opt/mssql-tools/bin/sqlcmd \
    -S localhost \
    -U sa \
    -P $MSSQL_SA_PASSWORD \
    -Q "SELECT @@VERSION" 2>/dev/null
  errstatus=$?
  ((counter++))
done

# Display error if connection failed:
if [ $errstatus = 1 ]
then
  echo Cannot connect to SQL Server, installation aborted
  exit $errstatus
fi

# Optional new user creation:
if [ ! -z $SQL_INSTALL_USER ] && [ ! -z $SQL_INSTALL_USER_PASSWORD ]
then
  echo Creating user $SQL_INSTALL_USER
  /opt/mssql-tools/bin/sqlcmd \
    -S localhost \
    -U sa \
    -P $MSSQL_SA_PASSWORD \
    -Q "CREATE LOGIN [$SQL_INSTALL_USER] WITH PASSWORD=N'$SQL_INSTALL_USER_PASSWORD', DEFAULT_DATABASE=[master], CHECK_EXPIRATION=ON, CHECK_POLICY=ON; ALTER SERVER ROLE [sysadmin] ADD MEMBER [$SQL_INSTALL_USER]"
fi

echo Done!

Eseguire lo script

Per eseguire lo script:

Incollare l'esempio nell'editor di testo preferito e salvarlo con un nome facile da ricordare, ad esempio install_sql.sh.
Personalizzare MSSQL_SA_PASSWORD, MSSQL_PID e tutte le altre variabili che si vuole modificare.
Contrassegnare lo script come eseguibile
```
chmod +x install_sql.sh
```
Eseguire lo script
```
./install_sql.sh
```

Informazioni sullo script

La prima operazione eseguita dallo script Bash è l'impostazione di alcune variabili. Queste possono essere variabili di scripting, come nell'esempio, o variabili di ambiente. La variabile MSSQL_SA_PASSWORD è richiesta dall'installazione di SQL Server. Le altre sono variabili personalizzate create per lo script. Lo script di esempio esegue le operazioni seguenti:

Importare le chiavi di Microsoft GPG pubbliche.
Registrare i repository Microsoft per SQL Server e gli strumenti da riga di comando.
Aggiornare i repository locali.
Installa SQL Server.
Configurare SQL Server con MSSQL_SA_PASSWORD e accettare automaticamente il contratto di licenza con l'utente finale.
Accettare automaticamente il contratto di licenza con l'utente finale per gli strumenti da riga di comando di SQL Server, installarli e installare il pacchetto unixodbc-dev.
Aggiungere gli strumenti da riga di comando di SQL Server al percorso per facilitarne l'uso.
Abilita SQL Server Agent se la variabile di scripting SQL_ENABLE_AGENT è abilitata per impostazione predefinita.
Facoltativamente, installare la ricerca full-text di SQL Server, se la variabile SQL_INSTALL_FULLTEXT è impostata.
Sbloccare la porta 1433 per TCP sul firewall di sistema, necessaria per connettersi a SQL Server da un altro sistema.
Facoltativamente, impostare i flag di traccia per la traccia deadlock (richiede la rimozione del commento delle righe).
SQL Server ora è installato. Per renderlo operativo, riavviare il processo.
Verificare che SQL Server sia installato correttamente, nascondendo eventuali messaggi di errore.
Creare un nuovo utente amministratore del server se SQL_INSTALL_USER e SQL_INSTALL_USER_PASSWORD sono entrambi impostati.

Installazione automatica

Semplificare più installazioni automatiche e creare uno script Bash autonomo che imposta le variabili di ambiente appropriate. È possibile rimuovere le variabili usate dallo script di esempio e inserirle nel proprio script Bash.

#!/bin/bash
export MSSQL_SA_PASSWORD='<password>'
export MSSQL_PID='evaluation'
export SQL_ENABLE_AGENT='y'
export SQL_INSTALL_USER='<Username>'
export SQL_INSTALL_USER_PASSWORD='<password>'

Attenzione

Eseguire quindi lo script Bash come indicato di seguito:

. ./my_script_name.sh

Che cos'è SQL Server in Linux?

Condividi tramite

Esempio: script di installazione automatica di SQL Server per Ubuntu

Prerequisiti

Script di esempio

Eseguire lo script

Informazioni sullo script

Installazione automatica

Commenti e suggerimenti

Risorse aggiuntive

Condividi tramite

Esempio: script di installazione automatica di SQL Server per Ubuntu

Prerequisiti

Script di esempio

Eseguire lo script

Informazioni sullo script

Installazione automatica

Contenuto correlato

Commenti e suggerimenti

Risorse aggiuntive