Skip to content

Commit ebe92fb

Browse files
committed
Update GNS3 class type for freshness
1 parent 696b29d commit ebe92fb

File tree

1 file changed

+66
-46
lines changed

1 file changed

+66
-46
lines changed

articles/lab-services/class-type-networking-gns3.md

Lines changed: 66 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,30 @@
11
---
22
title: Set up a networking lab with GNS3
3+
titleSuffix: Azure Lab Services
34
description: Learn how to set up a lab using Azure Lab Services to teach networking with GNS3.
5+
services: lab-services
6+
ms.service: lab-services
7+
author: ntrogh
8+
ms.author: nicktrog
49
ms.topic: how-to
5-
ms.date: 04/19/2022
10+
ms.date: 04/24/2023
611
---
712

813
# Set up a lab to teach a networking class
914

1015
[!INCLUDE [preview note](./includes/lab-services-new-update-focused-article.md)]
1116

12-
This article shows you how to set up a class that focuses on allowing students to emulate, configure, test, and troubleshoot virtual and real networks using [GNS3](https://www.gns3.com/) software.
17+
This article shows you how to set up a class for emulating, configuring, testing, and troubleshooting virtual and real networks using [GNS3](https://www.gns3.com/) software.
1318

14-
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 with nested virtualization enabled and with GNS3 installed and configured.
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.
1520

16-
## Lab configuration
21+
## Prerequisites
1722

1823
[!INCLUDE [must have subscription](./includes/lab-services-class-type-subscription.md)]
1924

2025
[!INCLUDE [must have lab plan](./includes/lab-services-class-type-lab-plan.md)]
2126

22-
### Lab settings
27+
## Lab configuration
2328

2429
[!INCLUDE [create lab](./includes/lab-services-class-type-lab.md)] Use the following settings when creating the lab.
2530

@@ -32,88 +37,103 @@ This article has two main sections. The first section covers how to create the l
3237

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

35-
To configure the template VM, we'll complete the following major tasks.
40+
To configure the template VM, complete the following tasks:
3641

3742
1. Prepare the template machine for nested virtualization.
38-
2. Install GNS3.
39-
3. Create nested GNS3 VM in Hyper-V.
40-
4. Configure GNS3 to use Windows Hyper-V VM.
41-
5. Add appropriate appliances.
42-
6. Publish template.
43+
1. Install GNS3.
44+
1. Create nested GNS3 VM in Hyper-V.
45+
1. Configure GNS3 to use Windows Hyper-V VM.
46+
1. Add appropriate appliances.
47+
1. Publish the template.
4348

4449
### Prepare template machine for nested virtualization
4550

46-
Follow instructions to [enable nested virtualization](how-to-enable-nested-virtualization-template-vm.md) to prepare your template virtual machine for nested virtualization.
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).
4752

4853
### Install GNS3
4954

50-
- Follow the instructions for [installing GNS3 on Windows](https://docs.gns3.com/docs/getting-started/installation/windows). Make sure to include installing the **GNS3 VM** in the component dialog, see below.
55+
1. Connect to the template VM by using remote desktop.
56+
57+
1. Follow the detailed instructions on the GNS3 website, to [install GNS3 on Windows](https://docs.gns3.com/docs/getting-started/installation/windows).
5158

52-
![SelectGNS3vm](./media/class-type-networking-gns3/gns3-select-vm.png)
59+
1. Make sure to select **GNS3 VM** in the component dialog:
5360

54-
Eventually you'll reach the GNS3 VM selection. Make sure to select the **Hyper-V** option.
61+
:::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.":::
5562

56-
![SelectHyperV](./media/class-type-networking-gns3/gns3-vm-hyper-v.png)
63+
1. On the **GNS3 VM** page, select the **Hyper-V** option:
5764

58-
This option will download the PowerShell script and VHD files to create the GNS3 VM in the Hyper-V manager. Continue installation using the default values.
65+
:::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.":::
5966

60-
> [!IMPORTANT]
61-
> Once the setup is complete, don't start GNS3.
67+
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.
68+
69+
1. Continue the installation with the default values.
70+
71+
> [!IMPORTANT]
72+
> After the setup completes, don't start GNS3.
6273
6374
### Create GNS3 VM
6475

65-
Once the setup has completed, a zip file **"GNS3.VM.Hyper-V.2.2.17.zip"** is downloaded to the same folder as the installation file, containing the drives and the PowerShell script to create the Hyper-V vm.
76+
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.
77+
78+
To create the GNS 3 VM:
79+
80+
1. Connect to the template VM by using remote desktop.
81+
82+
1. Extract all files in the `GNS3.VM.Hyper-V.2.2.17.zip` file.
6683

67-
- **Extract all** on the GNS3.VM.Hyper-V.2.2.17.zip. This action will extract out the drives and the PowerShell script to create the VM.
68-
- **Run with PowerShell** on the "create-vm.ps1" PowerShell script by right-clicking on the file.
69-
- An Execution Policy Change request may show up. Enter "Y" to execute the script.
84+
1. Right-select the `create-vm.ps1` PowerShell script, and then select **Run with PowerShell**.
7085

71-
![PSExecutionPolicy](./media/class-type-networking-gns3/powershell-execution-policy-change.png)
86+
1. When the `Execution Policy Change` request shows, enter **Y** to execute the script.
7287

73-
- Once the script has completed, you can confirm the VM "GNS3 VM" has been created in the Hyper-V Manager.
88+
:::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.":::
89+
90+
1. After the script completes, confirm that the **GNS3 VM** virtual machine is available in Hyper-V Manager.
7491

7592
### Configure GNS3 to use Hyper-V VM
7693

77-
Now that GNS3 is installed and the GNS3 VM is added, start up GNS3 to link the two together. The [GNS3 Setup wizard will start automatically.](https://docs.gns3.com/docs/getting-started/setup-wizard-gns3-vm#local-gns3-vm-setup-wizard).
94+
Now that you installed GNS3, and added the GNS3 VM, configure GNS 3 to use the Hyper-V virtual machine.
95+
96+
1. Connect to the template VM by using remote desktop.
97+
98+
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.
99+
100+
1. Select the **Run appliances from virtual machine** option, and select **Next**.
101+
102+
1. Use the default values in the following pages.
78103

79-
- Use the **Run appliances from virtual machine** option. Use the defaults for the rest of the wizard until you hit the **VMware vmrun tool cannot be found** error.
104+
1. When you get the **VMware vmrun tool cannot be found** error, select **Ok**, and then **Cancel** out of the wizard.
80105

81-
![VMWareError](./media/class-type-networking-gns3/gns3-vmware-vmrun-tool-not-found.png)
106+
:::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.":::
82107

83-
- Choose **Ok**, and **Cancel** out of the wizard.
84-
- To complete the connection to the Hyper-V vm, open the **Edit** -> **Preferences** -> **GNS3 VM** and select **Enable the GNS3 VM** and select the **Hyper-V** option.
108+
1. To complete the connection to the Hyper-V VM, select **Edit** > **Preferences** > **GNS3 VM**.
85109

86-
![EnableGNS3VMs](./media/class-type-networking-gns3/gns3-preference-vm.png)
110+
1. Select **Enable the GNS3 VM**, and then select the **Hyper-V** option.
111+
112+
:::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.":::
87113

88114
### Add appropriate appliances
89115

90-
At this point, you'll want to add the appropriate [appliances for the class.](https://docs.gns3.com/docs/using-gns3/beginners/install-from-marketplace)
116+
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).
91117

92118
### Prepare to publish template
93119

94-
Now that the template VM is set up properly, and ready for publishing there are a few key points to check.
120+
Now that you set up the template virtual machine, verify the following key points before you publish the template:
95121

96-
- Make sure that the GNS3 VM is shut down or turned off. Publishing while the VM is still running will corrupt the VM.
97-
- Close down GNS3, publishing while and running can lead to unintended side effects.
98-
- Clean up any installation files or other unnecessary files.
122+
- Make sure that the GNS3 VM is shut down or turned off. Publishing while the VM is still running, corrupts the virtual machine.
123+
- Stop GNS3. Publishing while GNS3 is running can lead to unintended side effects.
124+
- Clean up any installation files or other unnecessary files from the template VM.
99125

100126
>[!IMPORTANT]
101-
>Publishing while the VM is still running will corrupt the template VMs and create unusable lab VMs.
127+
>Publishing while the VM is still running, corrupts the template virtual machine and creates unusable lab virtual machines.
102128
103129
## Cost
104130

105-
If you would like to estimate the cost of this lab, you can use the following example:
106-
107-
For a class of 25 students with 20 hours of scheduled class time and 10 hours of quota for homework or assignments, the price for the lab would be:
131+
This section provides a cost estimate for running this class for 25 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.
108132

109-
25 students \* (20 + 10) hours \* 84 Lab Units \* 0.01 USD per hour = 630 USD.
133+
- 25 students × (20 scheduled hours + 10 quota hours) × 84 lab units
110134

111135
> [!IMPORTANT]
112-
> Cost estimate is for example purposes only. For current details on pricing, see [Azure Lab Services Pricing](https://azure.microsoft.com/pricing/details/lab-services/).
113-
114-
## Conclusion
115-
116-
This article walked you through the steps to create a lab for network configuration using GNS3.
136+
> 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/).
117137
118138
## Next steps
119139

0 commit comments

Comments
 (0)