Skip to content

Commit 2a24d90

Browse files
authored
Merge pull request #800 from fbsolo-ms1/document-freshness-maintenance
Remove PII from the .PNG files . . .
2 parents 14415c9 + 6b77217 commit 2a24d90

File tree

3 files changed

+15
-17
lines changed

3 files changed

+15
-17
lines changed

articles/machine-learning/data-science-virtual-machine/dsvm-ubuntu-intro.md

Lines changed: 15 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ author: fbsolo-ms1
77
ms.author: franksolomon
88
ms.topic: quickstart
99
ms.reviewer: jeffshep
10-
ms.date: 04/23/2024
10+
ms.date: 10/14/2024
1111
ms.custom: mode-other, linux-related-content
1212
#Customer intent: As a data scientist, I want to learn how to provision the Linux DSVM so that I can move my existing workflow to the cloud.
1313
---
@@ -26,23 +26,23 @@ Azure free accounts don't support GPU-enabled virtual machine (VM) SKUs.
2626

2727
To create an instance of either the Ubuntu 20.04 DSVM or the Azure DSVM for PyTorch:
2828

29-
1. Go to the [Azure portal](https://portal.azure.com). You might get a prompt to sign in to your Azure account if you haven't signed in yet.
29+
1. Go to the [Azure portal](https://portal.azure.com). You might get a prompt to sign in to your Azure account if you didn't yet sign in.
3030
1. Find the VM listing by entering **data science virtual machine**. Then select **Data Science Virtual Machine- Ubuntu 20.04** or **Azure DSVM for PyTorch**.
3131

3232
1. Select **Create**.
3333

3434
1. On the **Create a virtual machine** pane, fill in the **Basics** tab:
3535

36-
* **Subscription**: If you have more than one subscription, select the one on which the machine will be created and billed. You must have resource creation privileges for this subscription.
36+
* **Subscription**: If you have more than one subscription, select the one on which the machine is created and billed. You must have resource creation privileges for this subscription.
3737
* **Resource group**: Create a new group or use an existing one.
3838
* **Virtual machine name**: Enter the name of the VM. This name is used in your Azure portal.
39-
* **Region**: Select the datacenter that's most appropriate. For fastest network access, the datacenter that hosts most of your data or is located closest to your physical location is the best choice. For more information, refer to [Azure regions](https://azure.microsoft.com/global-infrastructure/regions/).
39+
* **Region**: Select the datacenter that's most appropriate. For fastest network access, the datacenter that hosts most of your data or is located closest to your physical location is the best choice. For more information, visit [Azure regions](https://azure.microsoft.com/global-infrastructure/regions/).
4040
* **Image**: Don't change the default value.
41-
* **Size**: This option should autopopulate with a size that's appropriate for general workloads. For more information, refer to [Linux VM sizes in Azure](/azure/virtual-machines/sizes).
41+
* **Size**: This option should autopopulate with an appropriate size for general workloads. For more information, visit [Linux VM sizes in Azure](/azure/virtual-machines/sizes).
4242
* **Authentication type**: For quicker setup, select **Password**.
4343

4444
> [!NOTE]
45-
> If you plan to use JupyterHub, make sure to select **Password** because JupyterHub is *not* configured to use Secure Shell (SSH) Protocol public keys.
45+
> If you plan to use JupyterHub, be sure to select **Password** because JupyterHub is *not* configured to use Secure Shell (SSH) Protocol public keys.
4646
4747
* **Username**: Enter the administrator username. You use this username to sign in to your VM. It doesn't need to match your Azure username. Don't use capital letters.
4848

@@ -69,7 +69,7 @@ You can access the Ubuntu DSVM in one of four ways:
6969

7070
### SSH
7171

72-
If you configured your VM with SSH authentication, you can sign in with the account credentials that you created in the **Basics** section of step 4 for the text shell interface. For more information, refer to [Learn more about connecting to a Linux VM](/azure/virtual-machines/linux-vm-connect).
72+
If you configured your VM with SSH authentication, you can sign in with the account credentials that you created in the **Basics** section of step 4 for the text shell interface. For more information, visit [Learn more about connecting to a Linux VM](/azure/virtual-machines/linux-vm-connect).
7373

7474
### xrdp
7575
The standard tool for accessing Linux graphical sessions is xrdp. While the distribution doesn't include this tool by default, [these instructions](/azure/virtual-machines/linux/use-remote-desktop) explain how to install it.
@@ -78,14 +78,14 @@ The standard tool for accessing Linux graphical sessions is xrdp. While the dist
7878
> [!NOTE]
7979
> In testing, the X2Go client performed better than X11 forwarding. We recommend use of the X2Go client for a graphical desktop interface.
8080
81-
The Linux VM is already provisioned with X2Go Server and is ready to accept client connections. To connect to the Linux VM graphical desktop, complete the following procedure on your client:
81+
The Linux VM is already provisioned with X2Go Server and is ready to accept client connections. To connect to the Linux VM graphical desktop, complete the following procedures on your client:
8282

8383
1. Download and install the X2Go client for your client platform from [X2Go](https://wiki.x2go.org/doku.php/doc:installation:x2goclient).
8484
1. Note the public IP address of the VM. In the Azure portal, open the VM you created to find this information.
8585

8686
:::image type="content" source="./media/dsvm-ubuntu-intro/ubuntu-ip-address.png" alt-text="Screenshot that shows the public IP address of the VM." lightbox= "./media/dsvm-ubuntu-intro/ubuntu-ip-address.png":::
8787

88-
1. Run the X2Go client. If the **New Session** pane doesn't automatically pop up, select **Session** > **New Session**.
88+
1. Run the X2Go client. If the **New Session** pane doesn't automatically open, select **Session** > **New Session**.
8989

9090
1. On the resulting configuration pane, enter these configuration parameters:
9191
* **Session**:
@@ -98,7 +98,7 @@ The Linux VM is already provisioned with X2Go Server and is ready to accept clie
9898

9999
:::image type="content" source="./media/dsvm-ubuntu-intro/x2go-ubuntu.png" alt-text="Screenshot that shows preferences for a new X2Go session." lightbox= "./media/dsvm-ubuntu-intro/x2go-ubuntu.png":::
100100
1. Select **OK**.
101-
1. Select the box in the right pane of the X2Go pane to bring up the sign-in pane for your VM.
101+
1. To bring up the sign-in pane for your VM, select the box in the right pane of the X2Go pane.
102102
1. Enter the password for your VM.
103103
1. Select **OK**.
104104
1. You might need to give X2Go permission to bypass your firewall to finish the connection process.
@@ -115,16 +115,15 @@ The Ubuntu DSVM runs [JupyterHub](https://github.com/jupyterhub/jupyterhub), whi
115115
1. From your local machine, open a web browser and go to `https://your-vm-ip:8000`. Replace **your-vm-ip** with the IP address you noted earlier.
116116
1. Your browser will probably prevent you from opening the pane directly. It might tell you that there's a certificate error. The DSVM provides security with a self-signed certificate. Most browsers will allow you to select through after this warning. Many browsers will continue to provide some kind of visual warning about the certificate throughout your web session.
117117

118-
If you see the `ERR_EMPTY_RESPONSE` error message in your browser, make sure you access the machine by explicit use of the *HTTPS* protocol. *HTTP* or just the web address don't work for this step. If you enter the web address without `https://` in the address line, most browsers will default to `http` and the error will appear.
118+
If you see the `ERR_EMPTY_RESPONSE` error message in your browser, be sure you access the machine by explicit use of the *HTTPS* protocol. *HTTP* or just the web address don't work for this step. If you enter the web address without `https://` in the address line, most browsers default to `http` and the error will appear.
119119

120120
1. Enter the username and password that you used to create the VM and sign in, as shown in this screenshot.
121121

122122
:::image type="content" source="./media/dsvm-ubuntu-intro/jupyter-login.png" alt-text="Screenshot that shows the JupyterHub sign-in pane." lightbox= "./media/dsvm-ubuntu-intro/jupyter-login.png":::
123123

124+
If you receive a **500** error at this stage, you probably used capital letters in your username. This issue is a known interaction between JupyterHub and the PAM authenticator it uses.
124125

125-
If you receive a 500 error at this stage, you probably used capital letters in your username. This issue is a known interaction between JupyterHub and the PAM authenticator it uses.
126-
127-
If you receive a "Can't reach this page" error, it's likely that your network security group (NSG) permissions need adjustment. In the Azure portal, find the NSG resource within your resource group. To access JupyterHub from the public internet, you must have port 8000 open. (The image shows that this VM is configured for just-in-time access, which we highly recommend. For more information, refer to [Secure your management ports with just-in time access](/azure/security-center/security-center-just-in-time).)
126+
If you receive a **Can't reach this page** error, it's likely that your network security group (NSG) permissions need adjustment. In the Azure portal, find the NSG resource within your resource group. To access JupyterHub from the public internet, you must have port 8000 open. (The image shows that this VM is configured for just-in-time access, which we highly recommend. For more information, visit [Secure your management ports with just-in time access](/azure/security-center/security-center-just-in-time).)
128127
>
129128
> :::image type="content" source="./media/dsvm-ubuntu-intro/nsg-permissions.png" alt-text="Screenshot that shows NSG configuration values." lightbox= "./media/dsvm-ubuntu-intro/nsg-permissions.png":::
130129
@@ -140,8 +139,7 @@ c.Spawner.default_url = '/lab'
140139

141140
## Next steps
142141

143-
* See the [Data science on the Data Science Virtual Machine for Linux](linux-dsvm-walkthrough.md) walkthrough to learn how to do several common data science tasks with the Linux DSVM provisioned here.
142+
* Visit the [Data science on the Data Science Virtual Machine for Linux](linux-dsvm-walkthrough.md) walkthrough to learn how to do several common data science tasks with the Linux DSVM provisioned here.
144143
* Try out the tools this article describes to explore the various data science tools on the DSVM. You can also run `dsvm-more-info` on the shell within the VM for a basic introduction and pointers to more information about the tools installed on the VM.
145144
* Learn how to systematically build analytical solutions with the [Team Data Science Process](/azure/architecture/data-science-process/overview).
146-
* See the [Azure AI Gallery](https://gallery.azure.ai/) for machine learning and data analytics samples that use the Azure AI services.
147-
* See the appropriate [reference documentation](./reference-ubuntu-vm.md) for this VM.
145+
* Visit the appropriate [reference documentation](./reference-ubuntu-vm.md) for this VM.
12 KB
Loading
-1.97 KB
Loading

0 commit comments

Comments
 (0)