Skip to content

Commit 76c7c7c

Browse files
committed
Adding to documentation for the DSVM File System changes.
1 parent fbcc087 commit 76c7c7c

File tree

3 files changed

+8
-9
lines changed

3 files changed

+8
-9
lines changed

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

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -37,13 +37,13 @@ The **Run** drop-down list on the project dashboard is where you select the comp
3737

3838
![Compute tier drop-down list on the project dashboard](media/project-compute-tier-list.png)
3939

40-
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 images (any operating system) are good choices because they include JupyterHub by default.
40+
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.
4141

4242
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:
4343

4444
![Prompt to collect server information for the Direct Compute option](media/project-compute-tier-direct.png)
4545

46-
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 entering the values obtained from the Azure portal.)
46+
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.)
4747

4848
- You're signed into Azure Notebooks with an account that uses Azure Active Directory (AAD), such as a company account.
4949
- Your account is connected to an Azure subscription.
@@ -53,18 +53,17 @@ If the following conditions are true, the drop-down list also shows [Data Scienc
5353

5454
When you select a DSVM instance, Azure Notebooks may prompt you for the specific machine credentials used when you created the VM.
5555

56-
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. If for other reasons you need to use the Windows or CentOS image, you can use the **Direct Compute** option to connect to the DSVM manually.
56+
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.
5757

58-
> [!IMPORTANT]
59-
> When using Direct Compute or Data Science virtual machines, the notebooks you run on them must be entirely self-contained. At present, Azure Notebooks copies only the *.ipynb* file to the VM but doesn't copy any other files in the project. As a result, notebooks running on other VMs fail to find other project files.
58+
> 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.
6059
>
61-
> You can work around this behavior in two ways:
60+
> If you would like to get the default files back then you will need to shutdown the compute.
6261
>
63-
> 1. Copy project files manually to the VM.
62+
> ![Shutdown compute](media/shutdown.png)
6463
>
65-
> 2. Embed the files within a setup notebook that you run first before the primary notebook. In the setup notebook, create a code cell for each file where the cell contains the file contents. Then at the top of each cell, insert the command `%%writefile <filename>`, where `<filename>` is the name of the file to receive the contents. When you run the notebook, it creates all those files on the VM. For an example, see the [setup.ipynb file in the Microsoft Pet Detector demo](https://github.com/Microsoft/connect-petdetector/blob/master/setup.ipynb) (GitHub).
64+
> Then the default files will reappear if you go to JupyterHub directly.
6665
>
67-
> ![Using a %%writefile command at the beginning of a code cell](media/setup-notebook-writefile-command.png)
66+
> ![Default Azure Notebooks files](media/juptyerhub-files.png)
6867
6968
## Edit project metadata
7069

43.4 KB
Loading

articles/notebooks/media/shutdown.png

2.85 KB
Loading

0 commit comments

Comments
 (0)