Breyta

Deila með


Offline install SQL Server Machine Learning Services on Windows computers with no internet access

Applies to: SQL Server 2016 (13.x) and later versions

This article describes how to install SQL Server Machine Learning Services on Windows offline on computers with no internet access isolated behind a network firewall.

By default, installers connect to Microsoft download sites to get required and updated components for machine learning on SQL Server. If firewall constraints prevent the installer from reaching these sites, you can use an internet-connected device to download files, transfer files to an offline server, and then run setup.

Note

Feature capabilities and installation options vary between versions of SQL Server. Use the version selector dropdown to choose the appropriate version of SQL Server.

In-database analytics consist of database engine instance, plus additional components for R and Python integration, depending on the version of SQL Server.

SQL Server 2022 offline install

Offline installation of SQL Server 2022 (16.x) is similar to the online installation experience.

  1. Use SQL Setup to install the Machine Learning services feature.

  2. Download any desired runtimes and copy them to the offline installation server. Custom runtimes for SQL Server 2022 (16.x) are customer-installed. CAB files are not used for SQL Server 2022 (16.x).

  3. Download any desired packages and copy them to the offline installation server. Otherwise, refer to instructions for installation from SQL Setup and installation of any desired custom packages:

On an isolated server, machine learning and R/Python language-specific features are added through CAB files.

SQL Server 2019 offline install

To install SQL Server Machine Learning Services (R and Python) on an isolated server, start by downloading the initial release of SQL Server and the corresponding CAB files for R and Python support. Even if you plan to immediately update your server to use the latest cumulative update, an initial release must be installed first.

Note

SQL Server 2019 does not have service packs. The initial release is the only base line, with servicing through cumulative updates only.

1 - Download 2019 CABs

On a computer having an internet connection, download the CAB files providing R and Python features for the initial release and the installation media for SQL Server 2019.

Release Download link
Microsoft R Open SRO_3.5.2.125_1033.cab
Microsoft R Server SRS_9.4.7.25_1033.cab
Microsoft Python Open SPO_4.5.12.120_1033.cab
Microsoft Python Server SPS_9.4.7.25_1033.cab

Note

The Java feature is included with the SQL Server installation media and doesn't need a separate CAB file.

2 - Get SQL Server 2019 installation media

  1. On a computer having an internet connection, launch SQL Server 2019 Setup from your installation media.

  2. Double-click setup and choose the Download Media installation type. With this option, setup creates a local .iso (or .cab) file containing the installation media.

    Choose the download media installation type

On an isolated server, machine learning and R/Python language-specific features are added through CAB files.

SQL Server 2017 offline install

To install SQL Server Machine Learning Services (R and Python) on an isolated server, start by downloading the initial release of SQL Server and the corresponding CAB files for R and Python support. Even if you plan to immediately update your server to use the latest cumulative update, an initial release must be installed first.

Note

SQL Server 2017 does not have service packs. It's the first release of SQL Server to use the initial release as the only base line, with servicing through cumulative updates only.

1 - Download 2017 CABs

On a computer having an internet connection, download the CAB files providing R and Python features for the initial release and the installation media for SQL Server 2017.

Release Download link
Microsoft R Open SRO_3.3.3.24_1033.cab
Microsoft R Server SRS_9.2.0.24_1033.cab
Microsoft Python Open SPO_9.2.0.24_1033.cab
Microsoft Python Server SPS_9.2.0.24_1033.cab

2 - Get SQL Server 2017 installation media

  1. On a computer having an internet connection, launch SQL Server 2017 Setup from your installation media.

  2. Double-click setup and choose the Download Media installation type. With this option, setup creates a local .iso (or .cab) file containing the installation media.

    Choose the download media installation type

On an isolated server, machine learning and R language-specific features are added through CAB files.

SQL Server 2016 offline install

SQL Server 2016 in-database analytics is R-only, with just two CAB files for product packages and Microsoft's distribution of open-source R, respectively. Start by installing any one of these releases: RTM, SP 1, SP 2. Once a base installation is in place, cumulative updates can be applied as a next step.

On a computer having an internet connection, download the CAB files used by setup to install in-database analytics on SQL Server 2016.

1 - Download 2016 CABs

Release Microsoft R Open Microsoft R Server
SQL Server 2016 RTM SRO_3.2.2.803_1033.cab SRS_8.0.3.0_1033.cab
SQL Server 2016 SP 1 SRO_3.2.2.15000_1033.cab SRS_8.0.3.15000_1033.cab
SQL Server 2016 SP 2 SRO_3.2.2.16000_1033.cab SRS_8.0.3.17000_1033.cab

2 - SQL Server 2016 installation media

You can install SQL Server 2016 RTM, SP 1, or SP 2 as your first installation on the target computer. Any of these versions can accept a cumulative update. Locate the SQL Server 2016 Setup application in your installation media.

Transfer files

Copy the SQL Server installation media (.iso or .cab) and in-database analytics CAB files to the target computer. Place the CAB files and installation media file in the same folder on the target machine, such as the setup user's %TEMP% folder.

The %TEMP% folder is required for Python CAB files. For R, you can use %TEMP% or set the myrcachedirectory parameter to the CAB path.

Run Setup

When you run SQL Server Setup on a computer disconnected from the internet, Setup adds an Offline installation page to the wizard so that you can specify the location of the CAB files you copied in the previous step.

  1. To begin installation, double-click the .iso or .cab file to access the installation media. You should see the setup.exe file.

  2. Right-click setup.exe and run as administrator.

  3. When the setup wizard displays the licensing page for open-source R or Python components, click Accept. Acceptance of licensing terms allows you to proceed to the next step.

  4. When you get to the Offline installation page, in Install Path, specify the folder containing the CAB files you copied earlier.

  5. Continue following the on-screen prompts to complete the installation.

Apply cumulative updates

We recommend that you apply the latest cumulative update to both the database engine and machine learning components.

  1. Start with a baseline instance. You can only apply cumulative updates to existing installations of the initial release of SQL Server.

  2. On an internet connected device, go to the cumulative update list for your version of SQL Server. See Determine the version, edition, and update level of SQL Server and its components.

  3. Select the latest cumulative update to download the executable.

  4. Transfer all files to the same folder on the offline computer.

  5. Run SQL Setup. Accept the licensing terms, and on the Feature selection page, review the features for which cumulative updates are applied. You should see every feature installed for the current instance, including machine learning features.

Cumulative updates are installed through the Setup program.

  1. Start with a baseline instance. You can only apply cumulative updates to existing installations of the initial release of SQL Server.

  2. On an internet connected device, go to the cumulative update list for your version of SQL Server. See Determine the version, edition, and update level of SQL Server and its components.

Cumulative updates are installed through the Setup program.

  1. Start with a baseline instance. You can only apply cumulative updates to existing installations of the SQL Server 2016 initial release, SQL Server 2016 SP 1, or SQL Server 2016 SP 2.

  2. On an internet connected device, go to the cumulative update list for your version of SQL Server. See Determine the version, edition, and update level of SQL Server and its components.

  1. Select the latest cumulative update to download the executable.

  2. Get corresponding CAB files for R and Python. For download links, see CAB downloads for cumulative updates on SQL Server in-database analytics instances.

  3. Transfer all files, executable and CAB files, to the same folder on the offline computer.

  4. Run Setup. Accept the licensing terms, and on the Feature selection page, review the features for which cumulative updates are applied. You should see every feature installed for the current instance, including machine learning features.

    Select features from the feature tree

  5. Continue through the wizard, accepting the licensing terms for R and Python distributions. During installation, you are prompted to choose the folder location containing the updated CAB files.

Set environment variables

For R feature integration only, you should set the MKL_CBWR environment variable to ensure consistent output from Intel Math Kernel Library (MKL) calculations.

  1. In Control Panel, click System and Security > System > Advanced System Settings > Environment Variables.

  2. Create a new User or System variable.

    • Set variable name to MKL_CBWR
    • Set the variable value to AUTO

This step requires a server restart. If you are about to enable script execution, you can hold off on the restart until all of the configuration work is done.

Post-install configuration

After installation is finished, restart the service and then configure the server to enable script execution:

An initial offline installation of SQL Server Machine Learning Services requires the same configuration as an online installation:

After installation is finished, restart the service and then configure the server to enable script execution:

An initial offline installation of SQL Server R Services requires the same configuration as an online installation:

Next steps

To use Machine Learning Services to execute Python and R scripts in-database, see: