Merge pull request #4396 from MicrosoftDocs/master

12/21 PM Publish

Author: v-alje

docs/advanced-analytics/TOC.md

@@ -122,8 +122,6 @@
 
 ### [Avoid errors with user package libraries for R](r/packages-installed-in-user-libraries.md)
 
-### [Add SQLRUserGroup as a database user](r/add-sqlrusergroup-to-database.md)
-
 ## Data exploration and modeling
 
 ### [R libraries and data types](r/r-libraries-and-data-types.md)
@@ -155,7 +153,10 @@
 ### [Security considerations for the R runtime in SQL Server](r/security-considerations-for-the-r-runtime-in-sql-server.md)
 ### [Modify the user account pool for SQL Server Machine Learning Services](r/modify-the-user-account-pool-for-sql-server-r-services.md)
 
+### [Add SQLRUserGroup as a database user](r/add-sqlrusergroup-to-database.md)
+
 ### [Deploy and consume models using web services](operationalization-with-mrsdeploy.md)
+
 ### [Managing and monitoring machine learning solutions](r/managing-and-monitoring-r-solutions.md)
 ### [Resource governance for Machine Learning Services](r/resource-governance-for-r-services.md)
 ### [Create a resource pool for machine learning](r/how-to-create-a-resource-pool-for-r.md)

docs/advanced-analytics/getting-started-with-machine-learning-services.md

@@ -1,7 +1,7 @@
 ---
 title: "Getting started with machine learning in SQL Server| Microsoft Docs"
 ms.custom: ""
-ms.date: "11/09/2017"
+ms.date: "12/20/2017"
 ms.prod: "machine-learning-services"
 ms.prod_service: "machine-learning-services"
 ms.service: ""
@@ -79,7 +79,7 @@ You can also install [!INCLUDE[rsql-platform-md](../includes/rsql-platform-md.md
 
 + [Machine learning tutorials](../advanced-analytics/tutorials/machine-learning-services-tutorials.md)
 
-  Start here to find a list of all resources for learning about machine learning solutions using [!INCLUDE[sscurrent-md](../includes/sscurrent-md.md)] or [!INCLUDE[sssql15-md](../includes/sssql15-md.md)].
+  Start here to find a list of all resources for learning about machine learning solutions using SQL Server 2016 and SQL Server 2017.
 
 ### R tutorials
 
@@ -91,7 +91,7 @@ You can also install [!INCLUDE[rsql-platform-md](../includes/rsql-platform-md.md
 
 + [Explore R and ScaleR in 25 short functions](https://docs.microsoft.com/r-server/r/tutorial-r-to-revoscaler)
 
-   New to R? Wondering how Microsoft R (or RevoScaleR) compares to standard R? See these quick-starts for R Server.
+   New to R? Wondering how Microsoft R (or RevoScaleR) compares to standard R? See these quick-starts for R Server and Machine Learning Server.
 
 ### Python tutorials
 

docs/advanced-analytics/python/setup-python-machine-learning-services.md

@@ -1,7 +1,7 @@
 ---
 title: "Setup and configuration for Python Machine Learning Services | Microsoft Docs"
 ms.custom: ""
-ms.date: "07/31/2017"
+ms.date: "12/20/2017"
 ms.reviewer: 
 ms.suite: sql
 ms.prod: machine-learning-services
@@ -18,7 +18,7 @@ ms.workload: "On Demand"
 ---
 # Set up Python Machine Learning Services (In-Database)
 
-  You install the components required for Python by running the [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] setup wizard, and following the interactive prompts as described in this topic.
+  This article describes how to install the components required for Python by running the [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] setup wizard, and following the interactive prompts.
 
 ## Machine learning options in SQL Server setup
 
@@ -38,11 +38,12 @@ After the installation is complete, reconfigure the instance to allow execution
   As a workaround, you can use replication to copy necessary tables to a standalone SQL Server instance that uses Python services. Alternatively, you can install machine learning with Python services on a standalone computer that uses the AlwaysOn setting, and is part of an availability group.
 
 + Side-by-side installation with other versions of Python is possible, because the SQL Server instance uses its own copy of the Anaconda distribution. However, running code that uses Python on the SQL Server computer outside SQL Server can lead to various problems:
-    + You use a different library and different executable, and get different results, than you do when you are running in SQL Server.
-    + Python scripts running in external libraries cannot be managed by SQL Server, leading to resource contention.
+    
+    - You use a different library and different executable, and get different results, than you do when you are running in SQL Server.
+    - Python scripts running in external libraries cannot be managed by SQL Server, leading to resource contention.
 
 > [!IMPORTANT]
-> After setup is complete, be sure to complete the additional post-configuration steps described in this topic. These include enabling SQL Server to use external scripts, and adding accounts required for SQL Server to run Python jobs on your behalf.
+> After setup is complete, be sure to complete the additional post-configuration steps described in this article. These steps include enabling SQL Server to use external scripts, and adding accounts required for SQL Server to run Python jobs on your behalf.
 
 ### Unattended installation
 
@@ -102,7 +103,12 @@ To perform an unattended installation, use the command-line options for SQL Serv
 
 ##  <a name="bkmk_enableFeature"></a> Step 2: Enable Python script execution
 
-1. Open [!INCLUDE[ssManStudioFull](../../includes/ssmanstudiofull-md.md)]. If it is not already installed, you can run the SQL Server setup wizard again to open a download link and install it.
+1. Open [!INCLUDE[ssManStudioFull](../../includes/ssmanstudiofull-md.md)]. 
+
+    > [!TIP]
+    > You can download and install the appropriate version from this page: [Download SQL Server Management Studio (SSMS)](https://docs.microsoft.com/sql/ssms/download-sql-server-management-studio-ssms).
+    > 
+    > You can also try out the preview release of [SQL Operations Studio](https://docs.microsoft.com/sql/sql-operations-studio/what-is), which supports administrative tasks and queries against SQL Server.
   
 2. Connect to the instance where you installed Machine Learning Services, and run the following command:
 
@@ -119,7 +125,7 @@ To perform an unattended installation, use the command-line options for SQL Serv
     RECONFIGURE WITH OVERRIDE
     ```
 
-    If you have already enabled the feature for the R language, you don't need to run reconfigure a second time for Python. The underlying extensibility platform supports both languages.
+    If you have already enabled the feature for the R language, don't run reconfigure a second time for Python. The underlying extensibility platform supports both languages.
 
 4. Restart the SQL Server service for the [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] instance. Restarting the SQL Server service also automatically restarts the related [!INCLUDE[rsql_launchpad](../../includes/rsql-launchpad-md.md)] service.
 

docs/advanced-analytics/r/add-sqlrusergroup-to-database.md

@@ -1,7 +1,7 @@
 ---
 title: "Add SQLRUserGroup as a database user | Microsoft Docs"
 ms.custom: ""
-ms.date: "11/13/2017"
+ms.date: "12/21/2017"
 ms.reviewer: 
 ms.suite: sql
 ms.prod: machine-learning-services
@@ -23,11 +23,17 @@ ms.workload: "Active"
 ---
 # Add SQLRUserGroup as a database user
 
-During setup of [!INCLUDE[rsql-productnamenew-md](../../includes/rsql-productnamenew-md.md)] or [!INCLUDE[rsql-productname-md](../../includes/rsql-productname-md.md)], new Windows user accounts are created for running tasks under the security token of the [!INCLUDE[rsql_launchpad_md](../../includes/rsql-launchpad-md.md)] service. When a user sends a machine learning script from an external client, [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] activates an available worker account, maps it to the identity of the calling user, and runs the script on behalf of the user. This new service of the database engine supports the secure execution of external scripts, called *implied authentication*.
+This article explains how to give the group of worker accounts used by machine learning services in SQL Server the permissions required to connect to the database and run R or Python jobs on behalf of the user.
 
-You can view these accounts in the Windows user group **SQLRUserGroup**. By default, 20 worker accounts are created, which is usually more than enough for running R jobs.
+## What is SQLRUserGroup?
 
-However, if you need to run R scripts from a remote data science client and are using Windows authentication, you must grant these worker accounts permission to sign in to the [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] instance on your behalf.
+During setup of [!INCLUDE[rsql-productnamenew-md](../../includes/rsql-productnamenew-md.md)] or [!INCLUDE[rsql-productname-md](../../includes/rsql-productname-md.md)], new Windows user accounts are created to support execution of R or Python script tasks under the security token of the [!INCLUDE[rsql_launchpad_md](../../includes/rsql-launchpad-md.md)] service.
+
+You can view these accounts in the Windows user group **SQLRUserGroup**. By default, 20 worker accounts are created, which is usually more than enough for running machine learning jobs.
+
+When a user sends a machine learning script from an external client, [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] activates an available worker account, maps it to the identity of the calling user, and runs the script on behalf of the user. This new service of the database engine supports the secure execution of external scripts, called *implied authentication*.
+
+However, if you need to run R or Python scripts from a remote data science client, and you are using Windows authentication, you must give these worker accounts permission to sign in to the [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] instance on your behalf.
 
 ## Add SQLRUserGroup as a SQL Server login
 
@@ -51,8 +57,8 @@ However, if you need to run R scripts from a remote data science client and are
 
 5. Scroll through the list of group accounts on the server until you find one beginning with `SQLRUserGroup`.
 
-    + The name of the group that's associated with the Launchpad service for the _default instance_ is always just **SQLRUserGroup**. Select this account only for the default instance.
-    + If you are using a _named instance_, the instance name is appended to the default name `SQLRUserGroup`. Hence, if your instance is named "MLTEST", the default user group name for this instance would be **SQLRUserGroupMLTest**.
+    + The name of the group that's associated with the Launchpad service for the _default instance_ is always **SQLRUserGroup**, regardless of whether you installed R or Python or both. Select this account for the default instance only.
+    + If you are using a _named instance_, the instance name is appended to the name of the default worker group name, `SQLRUserGroup`. Hence, if your instance is named "MLTEST", the default user group name for this instance would be **SQLRUserGroupMLTest**.
 
      ![Example of groups on server](media/implied-auth-login5.png "Example of groups on server")
 
@@ -71,4 +77,4 @@ If you intend to make heavy use of machine learning, you can increase the number
 
 + [Modify the user account pool for machine learning](modify-the-user-account-pool-for-sql-server-r-services.md)
 
-By default, 20 accounts are created, which supports 20 concurrent sessions. Parallelized tasks do not consume additional accounts. For example, if a user runs a scoring task that uses parallel processing, the same worker account is reused for all threads.
+By default, 20 accounts are created, which supports 20 concurrent sessions. Parallelized tasks do not consume additional accounts. For example, if a user runs a scoring task that uses parallel processing, the same worker account is reused for all threads.