Skip to content

Commit 80a135e

Browse files
authored
Merge pull request #268332 from TimShererWithAquent/us194307c
Freshness Pass 194290 (third PR)
2 parents aa4c24e + 5e3bccb commit 80a135e

8 files changed

+162
-162
lines changed
Lines changed: 48 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -1,144 +1,147 @@
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 troubleshoot networks using GNS3.
55
services: lab-services
66
ms.service: lab-services
7-
author: ntrogh
8-
ms.author: nicktrog
7+
author: RoseHJM
8+
ms.author: rosemalcolm
99
ms.topic: how-to
10-
ms.date: 04/24/2023
10+
ms.date: 03/06/2024
11+
#customer intent: As an educator, I want to create lab virtual machines with GNS3 so that students can 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 configure 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.
4849

4950
### Prepare template machine for nested virtualization
5051

51-
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).
52+
To prepare the template virtual machine for nested virtualization, follow the detailed steps in [Enable Nested Virtualization](how-to-enable-nested-virtualization-template-vm-using-script.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 create a lab template VM with an account without administrator privileges, add that account to the **Hyper-V Administrators** group. For more information about using nested virtualization with such an 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

63-
:::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.":::
64+
:::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." lightbox="./media/class-type-networking-gns3/gns3-select-vm.png":::
6465

6566
1. On the **GNS3 VM** page, select the **Hyper-V** option:
6667

67-
:::image type="content" source="./media/class-type-networking-gns3/gns3-vm-hyper-v.png" alt-text="Screenshot that shows the GNS3 VM page in the GNS3 installation wizard, with the Hyper-V option selected.":::
68+
:::image type="content" source="./media/class-type-networking-gns3/gns3-vm-hyper-v.png" alt-text="Screenshot that shows the GNS3 VM page in the GNS3 installation wizard, with the Hyper-V option selected." lightbox="./media/class-type-networking-gns3/gns3-vm-hyper-v.png":::
6869

6970
When you select the Hyper-V option, the installer downloads the PowerShell script and VHD files to create the GNS3 VM in the Hyper-V manager.
7071

71-
1. Continue the installation with the default values.
72+
1. Continue the installation with the default values.
7273

7374
> [!IMPORTANT]
7475
> After the setup completes, don't start GNS3.
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, you see a zip file *GNS3.VM.Hyper-V.2.2.x.zip* in 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.x.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

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

88-
1. When the `Execution Policy Change` request shows, enter **Y** to execute the script.
89+
1. When the `Execution Policy Change` request appears, enter **Y** to execute the script.
8990

90-
:::image type="content" source="./media/class-type-networking-gns3/powershell-execution-policy-change.png" alt-text="Screenshot that shows the PowerShell command line, asking for an Execution Policy change.":::
91+
:::image type="content" source="./media/class-type-networking-gns3/powershell-execution-policy-change.png" alt-text="Screenshot that shows the PowerShell command line, asking for an Execution Policy change." lightbox="./media/class-type-networking-gns3/powershell-execution-policy-change.png":::
9192

9293
1. After the script completes, confirm that the **GNS3 VM** virtual machine is available in Hyper-V Manager.
9394

9495
### Configure GNS3 to use Hyper-V VM
9596

96-
Now that you installed GNS3, and added the GNS3 VM, configure GNS 3 to use the Hyper-V virtual machine.
97+
After you install GNS3 and add 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

100-
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.
101+
1. Start GNS3. The [GNS3 Setup wizard](https://docs.gns3.com/docs/getting-started/setup-wizard-gns3-vm#local-gns3-vm-setup-wizard) opens.
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

106107
1. When you get the **VMware vmrun tool cannot be found** error, select **Ok**, and then **Cancel** out of the wizard.
107108

108-
:::image type="content" source="./media/class-type-networking-gns3/gns3-vmware-vmrun-tool-not-found.png" alt-text="Screenshot that shows a VMware error message in the GNS3 Setup wizard.":::
109+
:::image type="content" source="./media/class-type-networking-gns3/gns3-vmware-vmrun-tool-not-found.png" alt-text="Screenshot that shows a VMware error message in the GNS3 Setup wizard." lightbox="./media/class-type-networking-gns3/gns3-vmware-vmrun-tool-not-found.png":::
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.
114+
115+
:::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." lightbox="./media/class-type-networking-gns3/gns3-preference-vm.png":::
113116

114-
:::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.":::
117+
1. Select **OK**.
115118

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 account. Optionally, you can set the preferences for the administrator and non-admin user to look for appliances and projects in a location accessible by both users.
121124

122125
### Prepare to publish template
123126

124-
Now that you set up the template virtual machine, verify the following key points before you publish the template:
127+
After 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

130-
>[!IMPORTANT]
131-
>Publishing while the VM is still running, corrupts the template virtual machine and creates unusable lab virtual machines.
133+
> [!IMPORTANT]
134+
> 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: 14 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -4,10 +4,11 @@ titleSuffix: Azure Lab Services
44
description: Learn how to connect using remote desktop (RDP) from Windows to a virtual machine in Azure Lab Services.
55
services: lab-services
66
ms.service: lab-services
7-
author: ntrogh
8-
ms.author: nicktrog
7+
author: RoseHJM
8+
ms.author: rosemalcolm
99
ms.topic: how-to
10-
ms.date: 02/17/2023
10+
ms.date: 03/06/2024
11+
#customer intent: As a student, I want to connect to virtual machines in a lab by using RDP in order to use the lab resources.
1112
---
1213

1314
# Connect to a VM using Remote Desktop Protocol on Windows
@@ -16,7 +17,7 @@ In this article, you learn how to connect to a lab VM in Azure Lab Services from
1617

1718
## Connect to VM from Windows using RDP
1819

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.
20+
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.
2021

2122
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.
2223

@@ -26,13 +27,13 @@ To connect to a lab VM in Azure Lab Services:
2627

2728
1. On the tile for your VM, select the **Connect** icon.
2829

29-
To connect to a lab VM, the vm must be running. Learn how you can [start a VM](how-to-use-lab.md#start-or-stop-the-vm).
30+
To connect to a lab VM, the virtual machine must be running. Learn how you can [start a VM](how-to-use-lab.md#start-or-stop-the-vm).
3031

31-
:::image type="content" source="./media/connect-virtual-machine-windows-rdp/connect-vm.png" alt-text="Screenshot of My virtual machines page for Azure Lab Services, highlighting the connect button on the VM tile.":::
32+
:::image type="content" source="./media/connect-virtual-machine-windows-rdp/connect-vm.png" alt-text="Screenshot of My virtual machines page for Azure Lab Services, highlighting the connect button on the VM tile." lightbox="./media/connect-virtual-machine-windows-rdp/connect-vm.png":::
3233

33-
1. If you’re connecting to a Linux VM, select the **Connect via RDP** option.
34+
1. To connect to a Linux VM, select the **Connect via RDP** option.
3435

35-
:::image type="content" source="./media/connect-virtual-machine-windows-rdp/student-vm-connect-options.png" alt-text="Screenshot that shows VM tile for student, highlighting the connect button and showing the SSH and RDP connection options.":::
36+
:::image type="content" source="./media/connect-virtual-machine-windows-rdp/student-vm-connect-options.png" alt-text="Screenshot that shows VM tile for student, highlighting the connect button and showing the SSH and RDP connection options." lightbox="./media/connect-virtual-machine-windows-rdp/student-vm-connect-options.png":::
3637

3738
1. After the RDP connection file download finishes, open the RDP file to launch the RDP client.
3839

@@ -42,19 +43,19 @@ To connect to a lab VM in Azure Lab Services:
4243

4344
The RDP client software has various settings for optimizing your connection experience. The default settings optimize your experience based on your network connection. Typically, you don't need to change the default settings.
4445

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

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:
48+
If you're using a Linux lab VM with a graphical desktop and the RDP client, the following settings might help to optimize performance:
4849

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

51-
:::image type="content" source="./media/connect-virtual-machine-windows-rdp/rdp-display-settings.png" alt-text="Screenshot of display tab of the Windows R D P client, highlighting the color depth setting.":::
52+
:::image type="content" source="./media/connect-virtual-machine-windows-rdp/rdp-display-settings.png" alt-text="Screenshot of display tab of the Windows R D P client, highlighting the color depth setting." lightbox="./media/connect-virtual-machine-windows-rdp/rdp-display-settings.png":::
5253

5354
- On the **Experience** tab, set the connection speed to **Modem (56 kbps)**.
5455

55-
:::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.":::
56+
:::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." lightbox="./media/connect-virtual-machine-windows-rdp/rdp-experience-settings.png":::
5657

57-
## Next steps
58+
## Related content
5859

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

0 commit comments

Comments
 (0)