Sample: script de instalación desatendida de SQL Server para Ubuntu

Artículo
04/19/2023

Se aplica a:SQL Server: Linux

Este script de Bash de ejemplo instala SQL Server en Ubuntu sin la intervención del usuario. Proporciona ejemplos de instalación del motor de base de datos, las herramientas de línea de comandos de SQL Server y el Agente SQL Server, y realiza los pasos posteriores a la instalación. De manera opcional, puede instalar la característica de búsqueda de texto completo y crear un usuario administrativo.

Sugerencia

Si no necesita un script de instalación desatendida, la forma más rápida de instalar SQL Server es seguir la guía de inicio rápido para Ubuntu. Para obtener más información sobre la instalación, vea la guía de instalación de SQL Server en Linux.

Prerrequisitos

Necesita al menos 2 GB de memoria para ejecutar SQL Server en Linux.
El sistema de archivos debe ser XFS o EXT4. No se admiten otros sistemas de archivos, como BTRFS.
Para conocer otros requisitos del sistema, vea Requisitos del sistema para SQL Server en Linux.

Script de ejemplo

En este ejemplo se instala SQL Server 2019 (15.x) en Ubuntu Server 20.04. Si desea instalar una versión diferente de SQL Server o Ubuntu Server, cambie las rutas de acceso del repositorio de Microsoft en consecuencia.

Guarde el script de ejemplo en un archivo y personalícelo. Deberá reemplazar los valores de las variables en el script. También puede establecer cualquiera de las variables de scripting como variables de entorno, siempre que las quite del archivo de script.

Se puede producir un error en el script si SQL Server tarda en iniciarse. Esto se debe a que el script se cerrará con un estado distinto de cero. La eliminación del modificador -e en la primera línea puede resolver este problema.

Importante

La variable de entorno SA_PASSWORD está en desuso. En su lugar, use MSSQL_SA_PASSWORD.

#!/bin/bash -e

# Use the following variables to control your install:

# Password for the SA user (required)
MSSQL_SA_PASSWORD='<YourStrong!Passw0rd>'

# 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='<YourStrong!Passw0rd>'

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!

Ejecute el script.

Para ejecutar el script:

Pegue el ejemplo en el editor de texto que prefiera y guárdelo con un nombre fácil de recordar, como install_sql.sh.
Personalice MSSQL_SA_PASSWORD, MSSQL_PID y cualquiera de las demás variables que quiera cambiar.
Marque el script como ejecutable.
```
chmod +x install_sql.sh
```
Ejecute el script.
```
./install_sql.sh
```

Descripción del script

Lo primero que hace el script de Bash es establecer algunas variables. Pueden ser variables de scripting, como en el ejemplo, o variables de entorno. La variable MSSQL_SA_PASSWORD es necesaria para la instalación de SQL Server; las demás son variables personalizadas creadas para el script. Este script de ejemplo realiza los siguientes pasos:

Importar las claves públicas de Microsoft GPG.
Registrar los repositorios de Microsoft para SQL Server y las herramientas de línea de comandos.
Actualizar los repositorios locales.
Instale SQL Server.
Configurar SQL Server con MSSQL_SA_PASSWORD y aceptar automáticamente el contrato de licencia para el usuario final.
Aceptar automáticamente el contrato de licencia para el usuario final para las herramientas de línea de comandos de SQL Server, instalarlas e instalar el paquete unixodbc-dev.
Agregar las herramientas de línea de comandos de SQL Server a la ruta de acceso para facilitar su uso.
Habilitar el Agente SQL Server si se establece la variable de scripting SQL_ENABLE_AGENT, activada de forma predeterminada.
Opcionalmente, instalar Búsqueda de texto completo de SQL Server, si está establecida la variable SQL_INSTALL_FULLTEXT.
Desbloquear el puerto 1433 para TCP en el firewall del sistema, necesario para conectarse a SQL Server desde otro sistema.
También puede establecer marcas de seguimiento para el seguimiento de interbloqueos (es necesario quitar las marcas de comentario de las líneas).
SQL Server ya está instalado; para que sea operativo, reinicie el proceso.
Compruebe que SQL Server está instalado correctamente y oculte los mensajes de error.
Cree un nuevo usuario de administrador del servidor si están establecidos SQL_INSTALL_USER y SQL_INSTALL_USER_PASSWORD.

Instalación desatendida

Simplifique varias instalaciones desatendidas y cree un script de Bash independiente que establezca las variables de entorno adecuadas. Puede quitar cualquiera de las variables que usa el script de ejemplo y colocarlas en su propio script de Bash.

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

Después, ejecute el script de Bash de la siguiente manera:

. ./my_script_name.sh

Información general sobre SQL Server en Linux

Sample: script de instalación desatendida de SQL Server para Ubuntu

Prerrequisitos

Script de ejemplo

Ejecute el script.

Descripción del script

Instalación desatendida

Comentarios

Comentarios

Recursos adicionales

Sample: script de instalación desatendida de SQL Server para Ubuntu

Prerrequisitos

Script de ejemplo

Ejecute el script.

Descripción del script

Instalación desatendida

Contenido relacionado

Comentarios

Comentarios

Recursos adicionales