Skip to content

Commit 6be0547

Browse files
Freshness in progress.
1 parent 332be45 commit 6be0547

6 files changed

+69
-67
lines changed
Lines changed: 32 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -1,47 +1,48 @@
11
---
22
title: Set up a GNS3 networking lab
33
titleSuffix: Azure Lab Services
4-
description: Learn how to set up a lab using Azure Lab Services to teach networking with GNS3.
4+
description: Learn how to set up a lab using Azure Lab Services to teach networking with GNS3. Emulate, configure, test, and toubleshoot networks using GNS3.
55
services: lab-services
66
ms.service: lab-services
77
author: ntrogh
88
ms.author: nicktrog
99
ms.topic: how-to
10-
ms.date: 04/24/2023
10+
ms.date: 03/06/2024
11+
#customer intent: As an instructor, I want to create lab virtual machines with GNS3 so that students can start to learn about networking with GNS3 in a standard configuration.
1112
---
1213

1314
# Set up a lab to teach a networking class with GNS3 in Azure Lab Services
1415

15-
[!INCLUDE [preview note](./includes/lab-services-new-update-focused-article.md)]
16-
17-
This article shows you how to set up a class for emulating, configuring, testing, and troubleshooting networks using [GNS3](https://www.gns3.com/) software.
16+
This article shows you how to set up a class to emulate, configure, test, and troubleshoot networks with GNS3 software in Azure Lab Services.
1817

19-
This article has two main sections. The first section covers how to create the lab. The second section covers how to create the [template machine](./classroom-labs-concepts.md#template-virtual-machine) with nested virtualization enabled and with GNS3 installed and configured.
18+
This article has two sections. The first section covers how to create the lab. The second section covers how to create the template machine with nested virtualization enabled and with GNS3 installed and configured.
2019

2120
## Prerequisites
2221

23-
[!INCLUDE [must have subscription](./includes/lab-services-class-type-subscription.md)]
22+
- [!INCLUDE [must have subscription](./includes/lab-services-class-type-subscription.md)]
2423

25-
[!INCLUDE [must have lab plan](./includes/lab-services-class-type-lab-plan.md)]
24+
- [!INCLUDE [must have lab plan](./includes/lab-services-class-type-lab-plan.md)]
2625

27-
## Lab configuration
26+
## Configure your lab
2827

29-
[!INCLUDE [create lab](./includes/lab-services-class-type-lab.md)] Use the following settings when creating the lab.
28+
[!INCLUDE [create lab](./includes/lab-services-class-type-lab.md)] Use the following settings when creating the lab.
3029

3130
| Lab settings | Value |
3231
| ------------ | ------------------ |
3332
| Virtual machine (VM) size | Medium (Nested Virtualization) |
3433
| VM image | Windows 10 Pro, Version 1909 |
3534

36-
## Template machine configuration
35+
[!INCLUDE [preview note](./includes/lab-services-new-update-focused-article.md)]
36+
37+
## Configure your template virtual machine
3738

3839
[!INCLUDE [configure template vm](./includes/lab-services-class-type-template-vm.md)]
3940

4041
To configure the template VM, complete the following tasks:
4142

4243
1. Prepare the template machine for nested virtualization.
43-
1. Install GNS3.
44-
1. Create nested GNS3 VM in Hyper-V.
44+
1. Install [GNS3](https://www.gns3.com/).
45+
1. Create a nested GNS3 VM in Hyper-V.
4546
1. Configure GNS3 to use Windows Hyper-V VM.
4647
1. Add appropriate appliances.
4748
1. Publish the template.
@@ -50,15 +51,15 @@ To configure the template VM, complete the following tasks:
5051

5152
To prepare the template virtual machine for nested virtualization, follow the detailed steps in [enable nested virtualization](how-to-enable-nested-virtualization-template-vm.md).
5253

53-
If you created a lab template VM with a non-admin account, add the non-admin account to the **Hyper-V Administrators** group. For more information about using nested virtualization with a non-admin account, see [non-admin user best practices](concept-nested-virtualization-template-vm.md#non-admin-user).
54+
If you created a lab template VM with a non-admin account, add that account to the **Hyper-V Administrators** group. For more information about using nested virtualization with a non-admin account, see [these best practices](concept-nested-virtualization-template-vm.md#non-admin-user).
5455

5556
### Install GNS3
5657

57-
1. Connect to the template VM by using remote desktop.
58+
1. Connect to the template VM by using Remote Desktop.
5859

59-
1. Follow the detailed instructions on the GNS3 website, to [install GNS3 on Windows](https://docs.gns3.com/docs/getting-started/installation/windows).
60+
1. To install GNS3 on Windows, follow the detailed instructions on [the GNS3 website]((https://docs.gns3.com/docs/getting-started/installation/windows).
6061

61-
1. Make sure to select **GNS3 VM** in the component dialog:
62+
1. Make sure to select **GNS3 VM** in the **Choose Components** page:
6263

6364
:::image type="content" source="./media/class-type-networking-gns3/gns3-select-vm.png" alt-text="Screenshot that shows the Choose Components page in the GNS3 installation wizard, with the GNS3 VM option selected.":::
6465

@@ -75,13 +76,13 @@ If you created a lab template VM with a non-admin account, add the non-admin acc
7576
7677
### Create GNS3 VM
7778

78-
When the setup finishes, a zip file `GNS3.VM.Hyper-V.2.2.17.zip` is downloaded to the same folder as the installation file. The zip file contains the virtual disks and the PowerShell script to create the Hyper-V virtual machine.
79+
When the setup finishes, a zip file `GNS3.VM.Hyper-V.2.2.x.zip` is downloaded to the same folder as the installation file. The zip file contains the virtual disks and the PowerShell script to create the Hyper-V virtual machine.
7980

8081
To create the GNS 3 VM:
8182

82-
1. Connect to the template VM by using remote desktop.
83+
1. Connect to the template VM by using Remote Desktop.
8384

84-
1. Extract all files in the `GNS3.VM.Hyper-V.2.2.17.zip` file. If the template VM has a non-admin account for lab users, extract the files in a location accessible to the non-admin account.
85+
1. Extract all files in the `GNS3.VM.Hyper-V.2.2.17.zip` file. If the template VM has a non-admin account for lab users, extract the files in a location accessible to the non-admin account.
8586

8687
1. Right-select the `create-vm.ps1` PowerShell script, and then select **Run with PowerShell**.
8788

@@ -95,11 +96,11 @@ To create the GNS 3 VM:
9596

9697
Now that you installed GNS3, and added the GNS3 VM, configure GNS 3 to use the Hyper-V virtual machine.
9798

98-
1. Connect to the template VM by using remote desktop.
99+
1. Connect to the template VM by using Remote Desktop.
99100

100101
1. Start GNS3. The [GNS3 Setup wizard](https://docs.gns3.com/docs/getting-started/setup-wizard-gns3-vm#local-gns3-vm-setup-wizard) starts automatically.
101102

102-
1. Select the **Run appliances from virtual machine** option, and select **Next**.
103+
1. Select the **Run appliances from a virtual machine** option, and select **Next**.
103104

104105
1. Use the default values in the following pages.
105106

@@ -109,36 +110,38 @@ Now that you installed GNS3, and added the GNS3 VM, configure GNS 3 to use the H
109110

110111
1. To complete the connection to the Hyper-V VM, select **Edit** > **Preferences** > **GNS3 VM**.
111112

112-
1. Select **Enable the GNS3 VM**, and then select the **Hyper-V** option.
113+
1. Select **Enable the GNS3 VM**. Then, under **Virtualization engine**, select the **Hyper-V** option.
113114

114115
:::image type="content" source="./media/class-type-networking-gns3/gns3-preference-vm.png" alt-text="Screenshot that shows the GNS3 VM preferences page, showing the GNS3 VM option enabled, and Hyper-V selected.":::
115116

117+
1. Select **OK**.
118+
116119
### Add appropriate appliances
117120

118-
Next, you can add appliances for the class. Follow the detailed steps from the GNS3 documentation to [install appliances from the GNS3 marketplace](https://docs.gns3.com/docs/using-gns3/beginners/install-from-marketplace).
121+
Next, you can add appliances for the class. To install appliances from the GNS3 marketplace, follow the detailed steps from [the GNS3 documentation](https://docs.gns3.com/docs/using-gns3/beginners/install-from-marketplace).
119122

120-
If the template VM has a non-admin account for lab users, install the appliances to a location accessible to the non-admin account. Optionally, you can set the preferences for the admin and non-admin user to look for appliances and projects in a location accessible by both users.
123+
If the template VM has a non-admin account for lab users, install the appliances to a location accessible to the non-admin account. Optionally, you can set the preferences for the admin and non-admin user to look for appliances and projects in a location accessible by both users.
121124

122125
### Prepare to publish template
123126

124127
Now that you set up the template virtual machine, verify the following key points before you publish the template:
125128

126-
- Make sure that the GNS3 VM is shut down or turned off. Publishing while the VM is still running, corrupts the virtual machine.
129+
- Make sure that the GNS3 VM is shut down or turned off. Publishing while the VM is still running, corrupts the virtual machine.
127130
- Stop GNS3. Publishing while GNS3 is running can lead to unintended side effects.
128131
- Clean up any installation files or other unnecessary files from the template VM.
129132

130133
>[!IMPORTANT]
131134
>Publishing while the VM is still running, corrupts the template virtual machine and creates unusable lab virtual machines.
132135
133-
## Cost
136+
## Estimate cost
134137

135138
This section provides a cost estimate for running this class for 25 lab users. There are 20 hours of scheduled class time. Also, each user gets 10 hours quota for homework or assignments outside scheduled class time. The virtual machine size we chose is **Large (Nested Virtualization)**, which is 84 lab units.
136139

137140
- 25 lab users × (20 scheduled hours + 10 quota hours) × 84 lab units
138141

139142
> [!IMPORTANT]
140-
> The cost estimate is for example purposes only. For current pricing information, see [Azure Lab Services pricing](https://azure.microsoft.com/pricing/details/lab-services/).
143+
> The cost estimate is for example purposes only. For current pricing information, see [Azure Lab Services pricing](https://azure.microsoft.com/pricing/details/lab-services/).
141144
142-
## Next steps
145+
## Related content
143146

144147
[!INCLUDE [next steps for class types](./includes/lab-services-class-type-next-steps.md)]

articles/lab-services/connect-virtual-machine-windows-rdp.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ In this article, you learn how to connect to a lab VM in Azure Lab Services from
1616

1717
## Connect to VM from Windows using RDP
1818

19-
You can use RDP to connect to your lab VMs in Azure Lab Services. If the lab VM is a Linux VM, the lab creator must [enable RDP for the lab](how-to-enable-remote-desktop-linux.md) and install GUI packages for a Linux graphical desktop. For Windows-based lab VMs, no additional configuration is needed.
19+
You can use RDP to connect to your lab VMs in Azure Lab Services. If the lab VM is a Linux VM, the lab creator must [enable RDP for the lab](how-to-enable-remote-desktop-linux.md) and install GUI packages for a Linux graphical desktop. For Windows-based lab VMs, no extra configuration is needed.
2020

2121
Typically, the [Remote Desktop client software](/windows-server/remote/remote-desktop-services/clients/remote-desktop-clients) is already present on Windows. To connect to the lab VM, you open the RDP connection file to start the remote session.
2222

@@ -44,7 +44,7 @@ The RDP client software has various settings for optimizing your connection expe
4444

4545
Learn more about the [RDP client's **Experience** settings](/windows-server/administration/performance-tuning/role/remote-desktop/session-hosts#client-experience-settings).
4646

47-
If you're using a Linux lab VM with a graphical desktop and the RDP client, the following settings may help to optimize performance:
47+
If you're using a Linux lab VM with a graphical desktop and the RDP client, the following settings might help to optimize performance:
4848

4949
- On the **Display** tab, set the color depth to **High Color (15 bit)**.
5050

@@ -54,7 +54,7 @@ If you're using a Linux lab VM with a graphical desktop and the RDP client, the
5454

5555
:::image type="content" source="./media/connect-virtual-machine-windows-rdp/rdp-experience-settings.png" alt-text="Screenshot of experience tab of the Windows RDP client, highlighting the connection speed setting.":::
5656

57-
## Next steps
57+
## Related content
5858

5959
- [As an educator, enabled RDP on Linux](how-to-enable-remote-desktop-linux.md)
6060
- [As a student, stop the VM](how-to-use-lab.md#start-or-stop-the-vm)

0 commit comments

Comments
 (0)