Adding a new page for data science virtual machines.

Author: getroyer

articles/notebooks/configure-manage-azure-notebooks-projects.md

@@ -33,37 +33,7 @@ Azure Notebooks starts the underlying virtual machine whenever you run a noteboo
 
 ## Compute tier
 
-The **Run** drop-down list on the project dashboard is where you select the compute tier on which the project runs. By default, projects run on the **Free Compute** tier, which is limited to 4GB of memory and 1GB of data to prevent abuse:
-
-![Compute tier drop-down list on the project dashboard](media/project-compute-tier-list.png)
-
-You can bypass these limitations by using a different virtual machine that you've provisioned in an Azure subscription. You must install and run JupyterHub on that virtual machine. The Data Science Virtual Machine for Linux (Ubuntu) image is a good choice because it is supported, it has a compatible JupyterHub by default, and it will be automatically discovered.
-
-Once you have a suitably configured Azure virtual machine, select the **Direct Compute** option in the drop-down list, which prompts you for a name (to show in the list), the VM's IP address and port (typically 8000, the default port to which JupyterHub listens), and the VM credentials:
-
-![Prompt to collect server information for the Direct Compute option](media/project-compute-tier-direct.png)
-
-If the following conditions are true, the drop-down list also shows [Data Science Virtual Machine (DSVM)](/azure/machine-learning/data-science-virtual-machine) instances. (If any of these conditions aren't met, you can still connect to the DSVM using the Direct Compute option and enter the values obtained from the Azure portal.)
-
-- You're signed into Azure Notebooks with an account that uses Azure Active Directory (AAD), such as a company account.
-- Your account is connected to an Azure subscription.
-- You have one or more virtual machines in that subscription, with at least Reader access, that use the Data Science Virtual Machine for Linux (Ubuntu) image.)
-
-![Data Science Virtual Machine instances in the drop-down list on the project dashboard](media/project-compute-tier-dsvm.png)
-
-When you select a DSVM instance, Azure Notebooks may prompt you for the specific machine credentials used when you created the VM.
-
-To create a new DSVM instance, follow the instructions on [Create an Ubuntu Data Science VM](/azure/machine-learning/data-science-virtual-machine/dsvm-ubuntu-intro). Use the **Data Science Virtual Machine for Linux (Ubuntu)** image if you want the DSVM to appear in the drop-down list in Azure Notebooks. 
-
-> When a project is run on a VM the files will be mounted on the root directory of the Jupyter Server replacing the default Azure Notebooks files.
->
-> If you would like to get the default files back then you will need to shutdown the compute.
->
-> ![Shutdown compute](media/shutdown.png)
->
-> Then the default files will reappear if you go to JupyterHub directly.
->
-> ![Default Azure Notebooks files](media/juptyerhub-files.png)
+See [how to use Data Science Virtual Machines](use-data-science-virtual-machine.md).
 
 ## Edit project metadata
 

articles/notebooks/use-data-science-virtual-machine.md

@@ -0,0 +1,65 @@
+---
+title: Use Data Science Virtual Machines
+description: Why use a Data Science Virutal Machine (DSVM). How to connect to a DSVM, and how to access a DSVM from Azure Notebooks.
+services: app-service
+documentationcenter: ''
+author: getroyer
+manager: andneil
+
+ms.assetid: 0ccc2529-e17f-4221-b7c7-9496d6a731cc
+ms.service: azure-notebooks
+ms.workload: na
+ms.tgt_pltfrm: na
+ms.devlang: na
+ms.topic: article
+ms.date: 05/08/2019
+ms.author: getroyer
+---
+
+# Using Data Science Virtual Machines
+
+## Why connect to a Data Science Virtual Machine (DSVM)
+
+By default, projects run on the **Free Compute** tier, which is limited to 4GB of memory and 1GB of data to prevent abuse. You can bypass these limitations by using a different virtual machine that you've provisioned in an Azure subscription. Connecting to a DSVM can increase your compute power.
+
+## How to create a DSVM
+
+|Operating System|Azure Notebooks|
+|:---:|:---:|
+|Linux Ubuntu| Supported|
+|Windows 2016| Not Supported|
+|Windows 2012| Not Supported|
+|Linux CentOS| Not Supported|
+
+To create a new DSVM instance, follow the instructions on [Create an Ubuntu Data Science VM](/azure/machine-learning/data-science-virtual-machine/dsvm-ubuntu-intro). Use the **Data Science Virtual Machine for Linux (Ubuntu)** image if you want the DSVM to appear in the drop-down list in Azure Notebooks.
+
+## Ways to connect to a DSVM
+
+The **Run** drop-down list on the project dashboard is where you select the compute tier on which the project runs. 
+
+![Compute tier drop-down list on the project dashboard](media/project-compute-tier-list.png)
+
+### Discovery
+If the following conditions are true, the drop-down list also shows DSVM instances. (If any of these conditions aren't met, you can still connect to the DSVM using the Direct Compute option and enter the values obtained from the Azure portal.)
+
+- You're signed into Azure Notebooks with an account that uses Azure Active Directory (AAD), such as a company account.
+- Your account is connected to an Azure subscription.
+- You have one or more virtual machines in that subscription, with at least Reader access, that use the Data Science Virtual Machine for Linux (Ubuntu) image.)
+
+![Data Science Virtual Machine instances in the drop-down list on the project dashboard](media/project-compute-tier-dsvm.png)
+
+When you select a DSVM instance, Azure Notebooks may prompt you for the specific machine credentials used when you created the VM.
+
+### Direct Connect
+Once you have a suitably configured Azure virtual machine, select the **Direct Compute** option in the drop-down list, which prompts you for a name (to show in the list), the VM's IP address and port (typically 8000, the default port to which JupyterHub listens), and the VM credentials:
+
+![Prompt to collect server information for the Direct Compute option](media/project-compute-tier-direct.png)
+
+
+## Accessing Azure Notebooks Files from DSVM
+
+To preserve parity of file paths with free compute you are only able to open one project at a time on a DSVM. If you would like to open a new project after opening a project, you will need to shutdown the open project first.
+
+When a project is run on a VM, the files are mounted on the root directory of the Jupyter server (the directory shown in JupyterHub), replacing the default Azure Notebooks files. When you shut down the VM using the **Shutdown** button on the notebook UI, Azure Notebooks restores the default files.
+
+![Shutdown button in Azure Notebooks](media/shutdown.png)