サンプル:Ubuntu 向け SQL Server 無人インストール スクリプト

適用対象: SQL Server - Linux

このサンプル Bash スクリプトでは、対話式の入力を使用せずに Ubuntu に SQL Server をインストールします。 データベース エンジン、SQL Server コマンドライン ツール、SQL Server エージェントのインストール例を示し、インストール後の手順を行います。 必要に応じてフルテキスト検索をインストールして管理ユーザーを作成することができます。

ヒント

無人インストール スクリプトが不要な場合は、SQL Server をインストールする最も簡単な方法は Ubuntu のクイックスタートに従うことです。 その他の設定情報については、SQL Server on Linux のインストール ガイダンスを参照してください。

前提条件

  • SQL Server on Linux を実行するには、少なくとも 2 GB のメモリが必要です。
  • ファイル システムは XFS または EXT4 である必要があります。 BTRFS などの他のファイル システムはサポートされていません。
  • 他のシステム要件については、SQL Server on Linux のシステム要件に関する記事を参照してください。

サンプル スクリプト

この例では、SQL Server 2019 (15.x) を Ubuntu Server 20.04 にインストールします。 別のバージョンの SQL Server または Ubuntu Server をインストールする場合は、それに応じて Microsoft リポジトリのパスを変更します。

サンプル スクリプトをファイルに保存して、カスタマイズします。 スクリプト内の変数の値を変更する必要があります。 スクリプト ファイルから削除するのであれば、スクリプト変数を環境変数として設定することもできます。

SQL Server の起動に時間がかかると、スクリプトが失敗する可能性があります。 これは、スクリプトが 0 以外の状態で終了するためです。 最初の回線の -e スイッチを削除すると、この問題点が解決する可能性があります。

重要

SA_PASSWORD 環境変数は非推奨です。 代わりに 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!

スクリプトを実行する

スクリプトを実行するには、次の手順を実行します。

  1. サンプルを任意のテキスト エディターに貼り付けて、install_sql.sh のように覚えやすい名前で保存します。

  2. MSSQL_SA_PASSWORDMSSQL_PID、その他の変更する他の変数をカスタマイズします。

  3. スクリプトを実行可能としてマークする

    chmod +x install_sql.sh
    
  4. スクリプトを実行する

    ./install_sql.sh
    

スクリプトを理解する

この Bash スクリプトで最初に実行されることは、いくつかの変数の設定です。 これらは、サンプルなどのスクリプト変数、または環境変数です。 変数 MSSQL_SA_PASSWORD は SQL Server のインストールに必要です。 その他はスクリプト用に作成されたカスタム変数です。 サンプル スクリプトは次の手順を行います。

  1. 公開 Microsoft GPG キーをインポートします。

  2. SQL Server とコマンドライン ツール用の Microsoft リポジトリを登録します。

  3. ローカル リポジトリを更新します。

  4. SQL Server をインストールします。

  5. MSSQL_SA_PASSWORD を使用して SQL Server を構成し、エンドユーザー使用許諾契約に自動的に同意します。

  6. SQL Server コマンドライン ツールのエンドユーザー使用許諾契約に自動的に同意し、それらをインストールして、unixodbc-dev パッケージをインストールします。

  7. 使いやすいように SQL Server のコマンドライン ツールをパスに追加します。

  8. 既定でスクリプト変数 SQL_ENABLE_AGENT が設定されている場合は、SQL Server エージェントを有効にします。

  9. 変数 SQL_INSTALL_FULLTEXT が設定されている場合は、必要に応じて SQL Server フルテキスト検索をインストールします。

  10. システム ファイアウォールで、別のシステムから SQL Server に接続するために必要な TCP 用のポート 1433 のブロックを解除します。

  11. 必要に応じて、デッドロック トレースのトレース フラグを設定します (行のコメント解除が必要です)。

  12. SQL Server がインストールされたので、動作するようにプロセスを再起動します。

  13. エラー メッセージを非表示にして、SQL Server が適切にインストールされていることを確認します。

  14. SQL_INSTALL_USERSQL_INSTALL_USER_PASSWORD の両方が設定されている場合は、新しいサーバー管理者ユーザーを作成します。

無人インストール

複数の無人インストールを簡略化し、適切な環境変数を設定するスタンドアロンの Bash スクリプトを作成します。 サンプル スクリプトが使用している変数を削除して、それらを独自の 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>'

次に、Bash スクリプトを次のように実行します。

. ./my_script_name.sh