Skip to content

Commit 67f6999

Browse files
committedJan 21, 2022
Finish lab plan quick start.
1 parent db9b729 commit 67f6999

24 files changed

+192
-289
lines changed
 

‎articles/lab-services/TOC.yml

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,10 @@
88
href: lab-services-whats-new.md
99
- name: Quickstarts
1010
items:
11-
- name: Get started
12-
href: get-started-manage-labs.md
11+
- name: Create a lab plan
12+
items:
13+
- name: Portal
14+
href: quick-create-lab-plan-portal.md
1315
- name: Tutorials
1416
items:
1517
- name: Set up a lab plan
@@ -103,6 +105,8 @@
103105
href: how-to-configure-auto-shutdown-lab-plans.md
104106
- name: Add a lab creator
105107
href: add-lab-creator.md
108+
- name: Manage VM pool
109+
href: how-to-manage-vm-pool.md
106110
- name: Connect to a virtual network
107111
href: how-to-connect-vnet-injection.md
108112
- name: How to create a lab with a shared resource

‎articles/lab-services/classroom-labs-concepts.md

Lines changed: 26 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -2,53 +2,64 @@
22
title: Labs concepts - Azure Lab Services | Microsoft Docs
33
description: Learn the basic concepts of Lab Services, and how it can make it easy to create and manage labs.
44
ms.topic: how-to
5-
ms.date: 11/19/2021
5+
ms.date: 01/21/2022
66
---
77

88
# Labs concepts
99

10-
This article describes key Lab Services concepts and definitions.
10+
This article describes key Azure Lab Services concepts and definitions.
1111

12+
## Schedules
13+
14+
Schedules are the time slots that an educator creates so the student lab VMs are available for class time. Schedules can be one-time or recurring. Any scheduled time doesn't count against extra time students may be given to complete homework. For more information about providing time for students to do their homework, see [Quota](#quota). A lab can use quota time, scheduled time, or a combination of both.
15+
16+
Scheduled time is commonly used when students are following the professor's directions during class hours. For instructions to add scheduled time to a lab, see [Create and manage schedules for labs in Azure Lab Services](how-to-create-schedules.md). All the student VMs are started with schedules. VMs are started even if a student doesn't log in to a VM. See [Configure automatic shutdown of VMs for a lab](how-to-enable-shutdown-disconnect.md) to help reduce likelihood of accruing costs when a VM isn't being used. Unclaimed VMs aren't started when schedules run.
17+
18+
There are two types of schedules: Standard and Stop only.
19+
20+
- **Standard**. This schedule will start all student VMs at the specified start time and shut down all student VMs at the specified stop time.
21+
- **Stop only**. This schedule will stop all student VMs at the specified time, even if the VM was manually started by an instructor or student.
22+
1223
## Quota
1324

14-
Quota is the time limit (in hours) that an educator can set for a student to use a lab VM. It can be set to 0, or a specific number of hours. If the quota is set to 0, a student can only use the virtual machine when a schedule is running or when an educator manually turns on the virtual machine for the student.
25+
Quota is the limited of time (in hours) an educator can allow a student to use their VM outside of scheduled time. For example, quota can be used to allow students time to complete homework using a lab VM. If the quota is set to 0, a student can only use the virtual machine when a schedule is running or when an educator manually turns on the virtual machine for the student.
1526

1627
Quota hours are counted when the student starts the lab VM themselves. If an educator manually starts the lab VM for a student, quota hours aren't used for that student.
1728

18-
## Schedules
29+
A lab can use either quota time, scheduled time, or a combination of both.
1930

20-
Schedules are the time slots that an educator can create for the class so the student VMs are available for class time. Schedules can be one-time or recurring. Quota hours aren't used when a schedule is running. A lab can use either quota time or scheduled time, or a combination of both.
31+
### Automatic shut-down
2132

22-
Scheduled time is commonly used when all the students have their own VMs and are following the professor's directions at a set time during the day (like class hours). See [Create and manage schedules for labs in Azure Lab Services](how-to-create-schedules.md) for instructions to add scheduled time to a lab. The downside is that all the student VMs are started and are accruing costs, even if a student doesn't log in to a VM. See [Configure automatic shutdown of VMs for a lab](how-to-enable-shutdown-disconnect.md) to help reduce likelihood of accruing costs when a VM isn't being used.
33+
Anytime a machine is **Running**, costs are being incurred, even if no one is connected to the VM. You can enable several auto-shutdown cost control features to avoid extra costs when the VMs aren't being used. The are three auto-shutdown policies available in Azure Lab Services.
2334

24-
There are three types of schedules: Standard, Start only and Stop only.
35+
- Disconnect idle virtual machines.
36+
- Shutdown virtual machines when students disconnect from the virtual machine.
37+
- Shutdown virtual machines when students don't connect a recently started virtual machine.
2538

26-
- **Standard**. This schedule will start all student VMs at the specified start time and shutdown all student VMs at the specified stop time.
27-
- **Start only**. This schedule will start all student VMs at the specified time. Student VMs won't be stop until a student stops the their VM through the Azure Lab Services portal or a stop only schedule occurs.
28-
- **Stop only**. This schedule will stop all student VMs at the specified time.
39+
For more information, see [Configure automatic shutdown of VMs for a lab plan](how-to-configure-auto-shutdown-lab-plans.md).
2940

3041
## Template virtual machine
3142

32-
A template virtual machine in a lab is a base virtual machine image from which all users’ virtual machines are created. Trainers/lab creators set up the template virtual machine and configure it with the software that they want to provide to training attendees to do labs. When you publish a template VM, Azure Lab Services creates or updates lab VMs based on the template VM.
43+
A template VM in a lab is a base image from which all users’ VMs are created. Instructors can configure the template VM with the software that they want to provide to lab users. When you publish a template VM, Azure Lab Services creates or updates lab VMs based on the template VM.
3344

3445
With the [January 2022 Update (preview)](lab-services-whats-new.md), labs can now be created from a pre-defined virtual machine image without the need for a template machine.
3546

3647
## User profiles
3748

38-
This article describes different user profiles in Azure Lab Services.
49+
This section describes different user profiles in Azure Lab Services.
3950

4051
### Lab plan owner
4152

42-
The lab plan owner, typically an IT administrator of organization's cloud resources, is the one who owns the Azure subscription and does the following tasks:
53+
The lab plan owner is typically an IT administrator of organization's cloud resources. The lab plan owner is the one who owns the Azure subscription and does the following tasks:
4354

4455
- Creates and organizes resource groups to contain lab plans and labs.
45-
- Sets up a lab plan(s) for your organization.
56+
- Creates lab plan(s) for your organization.
4657
- Manages and configures policies across all labs.
4758
- Gives permissions to people in the organization to create a lab under the lab plan.
4859

4960
### Educator
5061

51-
Typically, users such as a teacher or an online trainer, create labs using a pre-created lab plan. An educator does the following tasks:
62+
Typically, a teacher or an online trainer, create labs using a pre-created lab plan. An educator does the following tasks:
5263

5364
- Creates a lab.
5465
- Creates virtual machines in the lab.

‎articles/lab-services/get-started-manage-labs.md

Lines changed: 0 additions & 132 deletions
This file was deleted.

‎articles/lab-services/how-to-configure-auto-shutdown-lab-plans.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,8 +18,6 @@ The **disconnect idle virtual machines** has two settings. Both settings use a
1818
- **Detect idle based on user absence**. Idle detection examines only mouse/keyboard input (user absence).
1919
- **Detect idle based on user absence and resource usage**. Idle detection examines both mouse/keyboard input (user absence) and disk/CPU usage (resource usage). By selecting resource usage, that is, disk/CPU usage, operations such as long-running queries are accounted for.
2020

21-
With the [January 2022 Updates (preview)](lab-services-whats-new.md), the lab VM will be marked as stopped and billing will discontinue if Azure Lab Services detects that a student has shutdown their VM using the OS shutdown command. [Stopping the VM](how-to-use-lab.md#start-or-stop-the-vm) using the Azure Lab Services portal is the preferred method to stop a lab VM. There is a delay between detection of the VM being turned off and billing being stopped.
22-
2321
Review more details about the auto-shutdown features in the [Maximize cost control with auto-shutdown settings](cost-management-guide.md#automatic-shutdown-settings-for-cost-control) section.
2422

2523
## Enable automatic shutdown

‎articles/lab-services/how-to-create-schedules-within-canvas.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ The scheduled running time of VMs doesn't count against the [quota](classroom-la
2020
Instructors can create, edit, and delete lab schedules within Canvas as in the [Azure Lab Services portal](https://labs.azure.com). For more information on scheduling, see [Creating and managing schedules](how-to-create-schedules-within-canvas.md).
2121

2222
> [!IMPORTANT]
23-
> Schedules will apply at the course level. If you have many sections of a course, consider using [automatic shutdown policies](how-to-configure-auto-shutdown-lab-plans.md) and/or [quota hours](get-started-manage-labs.md#quota-hours).
23+
> Schedules will apply at the course level. If you have many sections of a course, consider using [automatic shutdown policies](how-to-configure-auto-shutdown-lab-plans.md) and/or [quotas hours](how-to-configure-student-usage.md#set-quotas-for-users).
2424
2525
## Next steps
2626

0 commit comments

Comments
 (0)