Skip to content

Commit f381ef9

Browse files
authored
Merge pull request #103860 from spelluru/lab16717127
updated the tutorials
2 parents f8aaa73 + ed24c88 commit f381ef9

36 files changed

+70
-101
lines changed

articles/lab-services/classroom-labs/class-type-deep-learning-natural-processing.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ After you create the lab account, enable following settings in the lab account:
2828

2929
| Lab account setting | Instructions |
3030
| ----------- | ------------ |
31-
| Marketplace images | Enable the Data Science Virtual Machine for Linux (Ubuntu) image for use within your lab account. See the following articles for instructions: [Specify marketplace images available to lab creators](tutorial-setup-lab-account.md#specify-marketplace-images-available-to-lab-creators). |
31+
| Marketplace images | Enable the Data Science Virtual Machine for Linux (Ubuntu) image for use within your lab account. See the following articles for instructions: [Specify marketplace images available to lab creators](how-to-configure-lab-accounts.md#specify-marketplace-images-available-to-lab-creators). |
3232

3333
Follow [this tutorial](tutorial-setup-classroom-lab.md) to create a new lab and apply the following settings:
3434

articles/lab-services/classroom-labs/class-type-jupyter-notebook.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ To set up this lab, you need an Azure subscription and lab account to get starte
2626

2727
### Lab Account Settings
2828

29-
Enable the settings described in the table below for the lab account. For more information about how to enable marketplace images, see [specify marketplace images available to lab creators](tutorial-setup-lab-account.md#specify-marketplace-images-available-to-lab-creators).
29+
Enable the settings described in the table below for the lab account. For more information about how to enable marketplace images, see [specify marketplace images available to lab creators](how-to-configure-lab-accounts.md#specify-marketplace-images-available-to-lab-creators).
3030

3131
| Lab account setting | Instructions |
3232
| ------------------- | ------------ |

articles/lab-services/classroom-labs/class-type-shell-scripting-linux.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ After you create the lab account, enable following settings in the lab account:
2929

3030
| Lab account setting | Instructions |
3131
| ----------- | ------------ |
32-
| Marketplace images | Enable the [Ubuntu Server 18.04 LTS](https://azuremarketplace.microsoft.com/marketplace/apps/canonical.0001-com-ubuntu-server-bionic) image for use within your lab account. For more information, see [Specify Marketplace images available to lab creators](tutorial-setup-lab-account.md#specify-marketplace-images-available-to-lab-creators) |
32+
| Marketplace images | Enable the [Ubuntu Server 18.04 LTS](https://azuremarketplace.microsoft.com/marketplace/apps/canonical.0001-com-ubuntu-server-bionic) image for use within your lab account. For more information, see [Specify Marketplace images available to lab creators](how-to-configure-lab-accounts.md#specify-marketplace-images-available-to-lab-creators) |
3333

3434
Follow [this tutorial](tutorial-setup-classroom-lab.md) to create a new lab and apply the following settings:
3535

articles/lab-services/classroom-labs/tutorial-connect-virtual-machine-classroom-lab.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ ms.tgt_pltfrm: na
1313
ms.devlang: na
1414
ms.topic: tutorial
1515
ms.custom: mvc
16-
ms.date: 10/31/2019
16+
ms.date: 02/10/2020
1717
ms.author: spelluru
1818

1919
---

articles/lab-services/classroom-labs/tutorial-setup-classroom-lab.md

Lines changed: 45 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ ms.tgt_pltfrm: na
1313
ms.devlang: na
1414
ms.topic: tutorial
1515
ms.custom: mvc
16-
ms.date: 01/23/2020
16+
ms.date: 02/10/2020
1717
ms.author: spelluru
1818

1919
---
@@ -29,12 +29,16 @@ In this tutorial, you do the following actions:
2929
> * Send invitation email to students
3030
3131
## Prerequisites
32-
To set up a classroom lab in a lab account, you must be a member of one of these roles in the lab account: Owner, Lab Creator, or Contributor. The account you used to create a lab account is automatically added to the owner role.
32+
In this tutorial, you set up a lab with virtual machines for your class. To set up a classroom lab in a lab account, you must be a member of one of these roles in the lab account: Owner, Lab Creator, or Contributor. The account you used to create a lab account is automatically added to the owner role. So, you can use the user account that you used to create a lab account to create a classroom lab.
3333

34-
A lab owner can add other users to the **Lab Creator** role. For example, a lab owner adds professors to the Lab Creator role. Then, the professors create labs with VMs for their classes. Students use the registration link that they receive from professors to register to the lab. Once they are registered, they can use VMs in the labs to do the class work and home work. For detailed steps for adding users to the Lab Creator role, see [Add a user to the Lab Creator role](tutorial-setup-lab-account.md#add-a-user-to-the-lab-creator-role).
34+
Here is the typical workflow when using Azure Lab Services:
3535

36+
1. A lab account creator adds other users to the **Lab Creator** role. For example, the lab account creator/admin adds professors to the **Lab Creator** role so that they can create labs for their classes.
37+
2. Then, the professors create labs with VMs for their classes and send registration links to students in the class.
38+
3. Students use the registration link that they receive from professors to register to the lab. Once they are registered, they can use VMs in the labs to do the class work and home work.
3639

3740
## Create a classroom lab
41+
In this step, you create a lab for your class in Azure.
3842

3943
1. Navigate to [Azure Lab Services website](https://labs.azure.com). Note that Internet Explorer 11 is not supported yet.
4044
2. Select **Sign in** and enter your credentials. Azure Lab Services supports organizational accounts and Microsoft accounts.
@@ -45,81 +49,55 @@ A lab owner can add other users to the **Lab Creator** role. For example, a lab
4549
1. Specify a **name** for your lab, and select **Next**.
4650

4751
![Create a classroom lab](../media/tutorial-setup-classroom-lab/new-lab-window.png)
48-
49-
If you select a Linux image, you see an option to enable remote desktop connection for it. For details, see [Enable remote desktop connection for Linux](how-to-enable-remote-desktop-linux.md).
5052
2. On the **Virtual machine credentials** page, specify default credentials for all VMs in the lab. Specify the **name** and the **password** for the user, and then select **Next**.
5153

5254
![New lab window](../media/tutorial-setup-classroom-lab/virtual-machine-credentials.png)
5355

5456
> [!IMPORTANT]
5557
> Make a note of user name and password. They won't be shown again.
56-
3. On the **Lab policies** page, enter the number of hours allotted for each user (**quota for each user**) outside the scheduled time for the lab, and then select **Finish**.
58+
3. On the **Lab policies** page, select **Finish**.
5759

5860
![Quota for each user](../media/tutorial-setup-classroom-lab/quota-for-each-user.png)
59-
5. You should see the following screen that shows the status of the template VM creation. The creation of the template in the lab takes up to 20 minutes.
61+
5. You should see the following screen that shows the status of the template VM creation. This operation takes up to 20 minutes.
6062

6163
![Status of the template VM creation](../media/tutorial-setup-classroom-lab/create-template-vm-progress.png)
6264
8. On the **Template** page, do the following steps: These steps are **optional** for the tutorial.
6365

64-
2. Connect to the template VM by selecting **Connect**. If it's a Linux template VM, you choose whether you want to connect using SSH or RDP (if RDP is enabled).
65-
1. Select **Reset password** to reset the password for the VM.
66-
1. Install and configure software on your template VM.
67-
1. **Stop** the VM.
68-
1. Enter a **description** for the template
69-
10. On **Template** page, select **Publish** on the toolbar.
66+
1. Connect to the template VM by selecting **Connect**. If it's a Linux template VM, you choose whether you want to connect using SSH or RDP (if RDP is enabled).
67+
3. Install and configure software required for your class on the template VM.
68+
4. **Stop** the template VM.
69+
70+
## Publish the template VM
71+
In this step, you publish the template VM. The publishing process creates lab VMs that are basically copies of the template VM.
72+
73+
1. On the **Template** page, select **Publish** on the toolbar.
7074

7175
![Publish template button](../media/tutorial-setup-classroom-lab/template-page-publish-button.png)
7276

7377
> [!WARNING]
7478
> Once you publish, you can't unpublish.
75-
8. On the **Publish template** page, enter the number of virtual machines you want to create in the lab, and then select **Publish**.
79+
2. On the **Publish template** page, enter the number of virtual machines you want to create in the lab, and then select **Publish**.
7680

7781
![Publish template - number of VMs](../media/tutorial-setup-classroom-lab/publish-template-number-vms.png)
78-
11. You see the **status of publishing** the template on page. This process can take up to an hour.
82+
3. You see the **status of publishing** the template on page. This process can take up to an hour.
7983

8084
![Publish template - progress](../media/tutorial-setup-classroom-lab/publish-template-progress.png)
81-
4. Switch to the **Virtual machines pool** page by selecting Virtual machines on the left menu or by selecting Virtual machines tile. Confirm that you see virtual machines that are in **Unassigned** state. These VMs are not assigned to students yet. They should be in **Stopped** state. You can start a student VM, connect to the VM, stop the VM, and delete the VM on this page. You can start them in this page or let your students start the VMs.
82-
83-
![Virtual machines in stopped state](../media/tutorial-setup-classroom-lab/virtual-machines-stopped.png)
84-
85-
You do the following tasks on this page (don't do these steps for the tutorial. These steps are for your information only.):
86-
87-
1. To change the lab capacity (number of VMs in the lab), select **Lab capacity** on the toolbar.
88-
2. To start all the VMs at once, select **Start all** on the toolbar.
89-
3. To start a specific VM, select the down arrow in the **Status**, and then select **Start**. You can also start a VM by selecting a VM in the first column, and then by selecting **Start** on the toolbar.
90-
91-
For more information about creating and managing templates, and setting up and managing student virtual machines, see the following articles:
92-
93-
- [Create and manage classroom lab templates](how-to-create-manage-template.md)
94-
- [Set up and manage virtual machine pool](how-to-set-virtual-machine-passwords.md)
95-
96-
## Add users to the lab
85+
4. Wait until the publishing is complete and then switch to the **Virtual machines pool** page by selecting **Virtual machines** on the left menu or by selecting **Virtual machines** tile. Confirm that you see virtual machines that are in **Unassigned** state. These VMs are not assigned to students yet. They should be in **Stopped** state. You can start a student VM, connect to the VM, stop the VM, and delete the VM on this page. You can start them in this page or let your students start the VMs.
9786

98-
1. Select **Users** on the left menu. By default, the **Restrict access** option is enabled. When this setting is on, a user can't register with the lab even if the user has the registration link unless the user is in the list of users. Only users in the list can register with the lab by using the registration link you send. In this procedure, you add users to the list. Alternatively, you can turn off **Restrict access**, which allows users to register with the lab as long as they have the registration link.
99-
2. Select **Add users** on the toolbar, and then select **Add by email addresses**.
100-
101-
![Add users button](../media/how-to-configure-student-usage/add-users-button.png)
102-
1. On the **Add users** page, enter email addresses of users in separate lines or in a single line separated by semicolons.
103-
104-
![Add user email addresses](../media/how-to-configure-student-usage/add-users-email-addresses.png)
105-
4. Select **Save**. You see the email addresses of users and their statuses (registered or not) in the list.
106-
107-
![Users list](../media/how-to-configure-student-usage/users-list-new.png)
87+
![Virtual machines in stopped state](../media/tutorial-setup-classroom-lab/virtual-machines-stopped.png)
10888

109-
You will see names of users in the list after they are registered to the lab.
110-
11189
## Set a schedule for the lab
112-
Create a scheduled event for the lab so that VMs in the lab are automatically started/stopped at specific times. The user quota you specified earlier is the additional time assigned to each user outside this scheduled time.
90+
Create a scheduled event for the lab so that VMs in the lab are automatically started/stopped at specific times. The user quota (default: 10 hours) you specified earlier is the additional time assigned to each user outside this scheduled time.
11391

11492
1. Switch to the **Schedules** page, and select **Add scheduled event** on the toolbar.
11593

11694
![Add schedule button on the Schedules page](../media/how-to-create-schedules/add-schedule-button.png)
11795
2. On the **Add scheduled event** page, do the following steps:
11896
1. Confirm that **Standard** is selected the **Event type**.
119-
2. Specify the **start date** for the class.
120-
4. Specify the **start time** at which you want the VMs to be started.
121-
5. Specify the **stop time** on which the VMs are to be shut down.
122-
6. Specify the **time zone** for the start and stop times you specified.
97+
2. Select the **start date** for the class.
98+
4. Select the **start time** at which you want the VMs to be started.
99+
5. Select the **stop time** at which the VMs are to be shut down.
100+
6. Select the **time zone** for the start and stop times you specified.
123101
3. On the same **Add scheduled event** page, select the current schedule in the **Repeat** section.
124102

125103
![Add schedule button on the Schedules page](../media/how-to-create-schedules/select-current-schedule.png)
@@ -141,12 +119,28 @@ Create a scheduled event for the lab so that VMs in the lab are automatically st
141119

142120
For more information about creating and managing schedules for a class, see [Create and manage schedule for classroom labs](how-to-create-schedules.md).
143121

144-
## Send invitation emails to students
122+
123+
## Add users to the lab
124+
125+
1. Select **Users** on the left menu. By default, the **Restrict access** option is enabled. When this setting is on, a user can't register with the lab even if the user has the registration link unless the user is in the list of users. Only users in the list can register with the lab by using the registration link you send. In this procedure, you add users to the list. Alternatively, you can turn off **Restrict access**, which allows users to register with the lab as long as they have the registration link.
126+
2. Select **Add users** on the toolbar, and then select **Add by email address**.
127+
128+
![Add users button](../media/how-to-configure-student-usage/add-users-button.png)
129+
1. On the **Add users** page, enter email addresses of users in separate lines or in a single line separated by semicolons.
130+
131+
![Add user email addresses](../media/how-to-configure-student-usage/add-users-email-addresses.png)
132+
4. Select **Save**. You see the email addresses of users and their statuses (registered or not) in the list.
133+
134+
![Users list](../media/how-to-configure-student-usage/users-list-new.png)
135+
136+
You will see names of users in the list after they are registered to the lab.
137+
138+
139+
## Send invitation emails to users
145140

146141
1. Switch to the **Users** view if you are not on the page already, and select **Invite all** on the toolbar.
147142

148143
![Select students](../media/tutorial-setup-classroom-lab/invite-all-button.png)
149-
150144
1. On the **Send invitation by email** page, enter an optional message, and then select **Send**. The email automatically includes the registration link. You can get this registration link by selecting **... (ellipsis)** on the toolbar, and **Registration link**.
151145

152146
![Send registration link by email](../media/tutorial-setup-classroom-lab/send-email.png)
@@ -155,7 +149,7 @@ Create a scheduled event for the lab so that VMs in the lab are automatically st
155149
For more information about adding students to a class and managing their usage of the lab, see [How to configure student usage](how-to-configure-student-usage.md).
156150

157151
## Next steps
158-
In this tutorial, you created a classroom lab, and configured the lab. To learn how a student can access a VM in the lab using the registration link, advance to the next tutorial:
152+
In this tutorial, you created a lab for your class in Azure. To learn how a student can access a VM in the lab using the registration link, advance to the next tutorial:
159153

160154
> [!div class="nextstepaction"]
161155
> [Connect to a VM in the classroom lab](tutorial-connect-virtual-machine-classroom-lab.md)

0 commit comments

Comments
 (0)