Skip to content

Commit 6b8139a

Browse files
jeanntjeannt
committed
edits to main command line setup topic
1 parent 7680fb8 commit 6b8139a

1 file changed

Lines changed: 77 additions & 32 deletions

File tree

‎docs/advanced-analytics/r/unattended-installs-of-sql-server-r-services.md‎

Lines changed: 77 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,10 @@
11
---
22
title: "Unattended installation of Machine Learning Services | Microsoft Docs"
33
ms.custom: ""
4-
ms.date: "07/31/2017"
5-
ms.prod: "sql-server-2016"
4+
ms.date: "10/31/2017"
5+
ms.prod:
6+
- "sql-server-2016"
7+
- "sql-server-2017"
68
ms.reviewer: ""
79
ms.suite: ""
810
ms.technology:
@@ -13,61 +15,100 @@ ms.assetid: 77e92b2d-5777-4c31-bf02-f931ed54a247
1315
caps.latest.revision: 18
1416
author: "jeannt"
1517
ms.author: "jeannt"
16-
manager: "jhubbard"
18+
manager: "cgronlund"
1719
ms.workload: "Inactive"
1820
---
1921
# Unattended installation of Machine Learning Services (In-Database)
2022

21-
This topic describes how to use command-line arguments with SQL Server setup to install machine learning in an instance of the database engine, in quiet mode. In an unattended installation, you do not use the interactive features of the setup wizard, and must provide all arguments required to complete installation, including licensing agreements for SQL Server and for machine learning components.
23+
This article describes how to use command-line arguments with SQL Server setup to install the machine learning components.
2224

23-
**Applies to:** SQL Server 2016 R Services, SQL Server 2017 Machine Learning Services (In-Database)
25+
By unattended installation, we mean that you do not use the interactive features of the setup wizard, and instead provide all arguments required to complete installation, including licensing agreements for SQL Server and for machine learning components on a command line or as part of a script, typically in quiet mode.
2426

25-
> [!IMPORTANT]
26-
>
27-
> In both SQL Server 2016 and SQL Server 2017, additional steps are required after setup is finished to enable the feature. These include a reconfiguration and restart of the instance. Be sure to review all steps.
27+
+ [SQL Server 2016 R Services](#bkmk_OldInstall)
28+
+ [SQL Server 2017 Machine Learning Services](#bkmk_NewInstall) with R or Python
29+
+ [Microsoft R Server or Machine Learning Server](../r/install-microsoft-r-server-from-the-command-line.md)
30+
31+
**Applies to: SQL Server 2017 Machine Learning Services (In-Database), SQL Server 2016 R Services**
2832

2933
## Prerequisites
3034

3135
+ You must install the database engine on each instance where you will use machine learning.
3236

33-
+ If the computer does not have Internet access, be sure to install the installers for the machine learning components beforehand. For download locations, see [Installing machine learning components without Internet access](../../advanced-analytics/r/installing-ml-components-without-internet-access.md).
37+
+ If the computer does not have Internet access, be sure to download the installers for the machine learning components beforehand. See [Installing machine learning components without Internet access](../r/installing-ml-components-without-internet-access.md).
3438

35-
+ There are new licensing parameters related to the open source components for R and Python. You must accept the license terms with a separate argument for each language that you install. If you do not include this parameter in your command line, setup will fail.
39+
+ There are separate licensing parameters for each of the open source components for R and Python. SQL Server 2016 supports only R; SQL Server 2017 supports both R and Python. You must accept the license terms for each language that you install. Setup fails if you do not include this parameter in your command line.
3640

3741
+ To complete setup without having to respond to prompts, make sure that you have identified all required arguments, including those for licensing, and for any other features that you might want to install.
3842

39-
> [!NOTE]
40-
> The Mixed security mode that supports SQL logins was required in early releases. However, you might consider enabling Mixed Mode authentication to support solution development by data scientists using a SQL login.
43+
+ The **Mixed** security mode that supports SQL logins was required in early releases. It is no longer reuqired, but you might consider enabling Mixed Mode authentication to support solution development by data scientists who use a SQL login.
4144

42-
## <a name="bkmk_NewInstall"></a> Unattended installation of Machine Learning Services with R
45+
> [!IMPORTANT]
46+
>
47+
> Additional steps are required after setup is finished to enable the feature. These include a reconfiguration and restart of the instance. Be sure to review all items in the section on [post-installation steps] (#bkmk_PostInstall) to determine actions needed after setup completes.
4348
44-
The following example shows the **minimum** required features to specify in the command line when performing a silent, unattended install of SQL Server 2017 Machine Services (In-Database).
49+
## <a name="bkmk_NewInstall"></a> Command-line installation for SQL Server 2017
4550

46-
1. Open an elevated command prompt, and run the following command:
51+
The following examples shows the **minimum** required features.
4752

48-
```
49-
Setup.exe /q /ACTION=/proxy/https/github.com/MicrosoftDocs/sql-docs/commit/Install /FEATURES=SQLENGINE,ADVANCEDANALYTICS, SQL_INST_MR /INSTANCENAME=MSSQLSERVER /SECURITYMODE=SQL /SAPWD="%password%" /SQLSYSADMINACCOUNTS="<username>" /IACCEPTSQLSERVERLICENSETERMS /IACCEPTROPENLICENSETERMS
50-
```
51-
52-
Note the flags required for R in SQL Server 2017: `ADVANCEDANALYTICS`, `SQL_INST_MR`, and `IACCEPTROPENLICENSETERMS`.
53-
2. Restart the server.
54-
3. Perform the post-installation configuration steps as described in [this section](#bkmk_PostInstall). Another restart of the SQL Server services will be required.
53+
> [!IMPORTANT]
54+
> Be sure to run all commands from an elevated command prompt.
55+
>
56+
> After installation is complete, some additional steps are required. See [this section](#bkmk_PostInstall).
57+
> Another restart of the SQL Server services will be required after configuration is complete.
58+
59+
### Install R only
60+
61+
The following example shows the arguments required to perform a silent, unattended install of SQL Server 2017 Machine Services (In-Database) with the R language added.
62+
63+
```
64+
Setup.exe /q /ACTION=/proxy/https/github.com/MicrosoftDocs/sql-docs/commit/Install /FEATURES=SQLENGINE,ADVANCEDANALYTICS, SQL_INST_MR /INSTANCENAME=MSSQLSERVER /SECURITYMODE=SQL /SAPWD="%password%" /SQLSYSADMINACCOUNTS="<username>" /IACCEPTSQLSERVERLICENSETERMS /IACCEPTROPENLICENSETERMS
65+
```
66+
67+
Note the flags required for R in SQL Server 2017:
68+
69+
+ `ADVANCEDANALYTICS`
70+
+ `SQL_INST_MR`
71+
+ `IACCEPTROPENLICENSETERMS`.
72+
73+
### Install Python only
5574

56-
## <a name="OldInstall"></a> Unattended install of R Services (In-Database)
75+
The following example shows the arguments required to perform a silent, unattended install of SQL Server 2017 Machine Services (In-Database) with the Python language added.
76+
77+
```
78+
Setup.exe /q /ACTION=/proxy/https/github.com/MicrosoftDocs/sql-docs/commit/Install /FEATURES=SQLENGINE,ADVANCEDANALYTICS, SQL_INST_MPY /INSTANCENAME=MSSQLSERVER /SECURITYMODE=SQL /SAPWD="%password%" /SQLSYSADMINACCOUNTS="<username>" /IACCEPTSQLSERVERLICENSETERMS /IACCEPTPYTHONOPENLICENSETERMS
79+
```
80+
81+
Note the flags required for Python in SQL Server 2017:
82+
83+
+ `ADVANCEDANALYTICS`
84+
+ `SQL_INST_MPY`
85+
+ `IACCEPTPYTHONOPENLICENSETERMS`
86+
87+
### Install both R and Python on a named instance
88+
89+
The following example shows the arguments required to perform a silent, unattended install of SQL Server 2017 Machine Services (In-Database) on a named instance. Both R and Python languages are added.
90+
91+
```
92+
Setup.exe /q /ACTION=/proxy/https/github.com/MicrosoftDocs/sql-docs/commit/Install /FEATURES=SQLENGINE,ADVANCEDANALYTICS, SQL_INST_MR, SQL_INST_MPY /INSTANCENAME=MSSQLSERVER.ServerName /SECURITYMODE=SQL /SAPWD="%password%" /SQLSYSADMINACCOUNTS="<username>" /IACCEPTSQLSERVERLICENSETERMS /IACCEPTROPENLICENSETERMS /IACCEPTPYTHONOPENLICENSETERMS
93+
```
94+
95+
## <a name="OldInstall"></a> Command-line installation for SQL Server 2016
5796

58-
The following example shows the **minimum** required features to specify in the command line when performing a silent, unattended install of SQL Server 2016 R Services.
97+
The following example shows the arguments required to perform a silent, unattended install of SQL Server 2016 with the R language added.
5998

60-
1. Open an elevated command prompt, and run the following command:
99+
```
100+
Setup.exe /q /ACTION=/proxy/https/github.com/MicrosoftDocs/sql-docs/commit/Install /FEATURES=SQL,ADVANCEDANALYTICS /INSTANCENAME=MSSQLSERVER /SECURITYMODE=SQL /SAPWD="%password%" /SQLSYSADMINACCOUNTS="<username>" /IACCEPTSQLSERVERLICENSETERMS /IACCEPTROPENLICENSETERMS
101+
```
61102

62-
```
63-
Setup.exe /q /ACTION=/proxy/https/github.com/MicrosoftDocs/sql-docs/commit/Install /FEATURES=SQL,ADVANCEDANALYTICS /INSTANCENAME=MSSQLSERVER /SECURITYMODE=SQL /SAPWD="%password%" /SQLSYSADMINACCOUNTS="<username>" /IACCEPTSQLSERVERLICENSETERMS /IACCEPTROPENLICENSETERMS
64-
```
65-
Note the flags required for 2016 R SERVICES: `ADVANCEDANALYTICS` and `IACCEPTROPENLICENSETERMS`.
66-
2. Restart the server.
67-
3. Perform the post-installation configuration steps as described in [this section](#bkmk_PostInstall). Another restart of the SQL Server services will be required.
103+
Note the flags required for 2016 R Services:
104+
105+
+ `ADVANCEDANALYTICS`
106+
+ `IACCEPTROPENLICENSETERMS`
68107

69108
## <a name = "bkmk_PostInstall"></a>Additional steps after setup
70109

110+
You must perform the following steps after SQL Server setup is complete, regardless of which version you installed. machine learning features are not enabled by default and must be explicitly enabled.
111+
71112
1. After installation is complete, open a new **Query** window in [!INCLUDE[ssManStudioFull](../../includes/ssmanstudiofull-md.md)], and run the following command to enable the feature.
72113

73114
```SQL
@@ -80,4 +121,8 @@ The following example shows the **minimum** required features to specify in the
80121

81122
2. Restart the SQL Server service for the reconfigured instance. Doing so will automatically restart the related [!INCLUDE[rsql_launchpad](../../includes/rsql-launchpad-md.md)] service as well.
82123

83-
3. Additional steps might be required if you have a custom security configuration, or if you will be using the SQL Server to support remote compute contexts. For more information, see [Upgrade and Installation FAQ](../../advanced-analytics/r/upgrade-and-installation-faq-sql-server-r-services.md).
124+
> [!IMPORTANT]
125+
>
126+
> Some additional steps might be required if you have a custom security configuration, or if you will be using the SQL Server as a compute context when executing R or Python code from a remote client.
127+
>
128+
> For more information, see [Upgrade and installation FAQ](../../advanced-analytics/r/upgrade-and-installation-faq-sql-server-r-services.md).

0 commit comments

Comments
 (0)