How to Install GNS3 2.2 (2.2.33.1) on Kali Linux 2022

In this article, we will examine how to set up and use the GNS3 2.2 network simulator program, which allows you to run IOS images of network devices such as Cisco Router, Switch, or Firewall in the Kali Linux 2022 operating system installed on a desktop or laptop.

How to Install GNS3 2.2 (2.2.33.1) on Kali Linux 2022

How to Set Up GNS3 2.2.33.1 to Prepare for Cisco Exams on Kali Linux 2022.3

GNS3 (Graphical Network Simulator) is a free networking program often preferred by people preparing for Cisco exams. To use this program, you need IOS images of Routers or other network devices.

Unlike the Packet Tracer program, GNS3 software requires IOS images of devices but allows you to make more comprehensive network designs.

You will need Layer 2 and Layer 3 devices when designing network topologies for your Routing or Switching exams. Therefore, instead of Router IOS, you should add the IOS images of these devices to the emulator program.

If you have a computer with Windows 10/11, it may be easier for you to install GNS3. However, installing this program on a Linux distribution such as Kali Linux may be a little more complex than you might think. Because in order for some programs to run smoothly, you need to install additional dependent packages of that program.

After installing this software in Kali Linux distribution without any problems, you can create various network topologies to prepare for Cisco exams and examine how computers in different networks communicate.

How to Install GNS3

In order to run the Cisco network simulator program smoothly on your Kali system, you may need to edit the repo addresses or install the necessary additional dependent packages.

Step 1

First, open the terminal on your Kali computer by pressing CTRL + ALT + T and update the repository package list with the “sudo apt update” command.

sudo apt update

Updating Kali Package List

Step 2

Execute the command below in the terminal to download all the dependent packages for the GNS3 simulator program.

sudo apt install -y python3-pip python3-pyqt5 python3-pyqt5.qtsvg python3-pyqt5.qtwebsockets qemu qemu-kvm qemu-utils libvirt-clients libvirt-daemon-system virtinst wireshark xtightvncviewer apt-transport-https ca-certificates curl gnupg2 software-properties-common

NOTE: If the qemu package cannot be installed from the existing repository during installation, download and install the qemu package manually using the commands below.

wget http://ftp.us.debian.org/debian/pool/main/q/qemu/qemu_3.1+dfsg-8+deb10u8_amd64.deb
sudo dpkg -i qemu_3.1+dfsg-8+deb10u8_amd64.deb

Installing GNS3 Dependencies

Step 3

You can use the pip3 command on Linux to download Python applications. To download the GNS3 GUI and GNS3 Server with pip3, execute the “sudo pip3 install gns3-server gns3-gui” command in the terminal.

sudo pip3 install gns3-server gns3-gui

GNS3 GUI and Server Download

Step 4

Execute the “sudo apt install dynamips” command in the terminal to install Dynamips, which allows you to emulate Cisco Routers on your physical computer via the GNS3 program.

sudo apt install dynamips

Installing Dynamips

Step 5

After installing GNS3, open the start menu type “gns3” in the search box and find the program and run it.

Running the GNS3 Simulator

Step 6

You must choose to run the IOS images that you will add to the GNS3 program on a virtual machine or local server. In the Setup Wizard window, select “Run appliances on my local computer” for the Server setting and click Next.

Run appliances on my local computer

Step 7

In the Local Server Configuration window, check that the Host Binding setting is Localhost and continue without changing the default port number.

Local Server Configuration

Step 8

After configuring the GNS3 server, check the local server authentication and continue.

Local Server Status

Step 9

At the last step of the installation wizard, check the server information in the summary window again and click Finish.

Checking the Local Server Configuration Summary

How to Add a Cisco Router

After installing GNS3 on Kali Linux, the first thing you need to do is to add the IOS image of any Router model. After this process, you can start using the Router devices on your computer to prepare for the Cisco exams.

Step 1

Click Edit / Preferences in the tool menu of the GNS3 software to add the router image.

Adding Cisco Router IOS Image

Step 2

After clicking IOS Routers under Dynamips from the left panel options in the Preferences window, click the New button. Click Browse to add the IOS image in the New IOS Router Template window.

Choosing IOS Image Location

Step 3

Go to the location of the IOS image you downloaded to your Linux computer, select the c7200 file, and click Open.

Choosing the c7200 IOS

Step 4

In the question window that opens, click Yes to decompress the IOS and wait for the image to decompress.

Decompressing IOS Image

Step 5

Click Next after adding the c7200 Router IOS.

Checking IOS Image

Step 6

In the Name and Platform window, leave your Router’s name and platform settings at default.

Name and Platform Selection

Step 7

You should choose an appropriate memory size for the virtual Router according to the RAM capacity of your physical computer. This memory size is selected as 512 MB by default, but you can increase this value so that the Router can work more efficiently.

Configuring Router Memory Size

Step 8

By default, the FastEthernet interface is installed on the Router in the Network Adapters window. If you want to add GigabitEthernet or Serial Interface, you can insert these cards into the empty slots.

Configuring Router Memory Size

Step 9

Idle-PC is a value given so that the Router that will run in GNS3 does not use 100% of your computer’s processor. This value is a value determined by GNS3 based on the performance of your computer.

Click the Idle-PC Finder button to find a suitable Idle-PC value for the c7200 Router.

Finding Idle-PC Value

Step 10

After checking the properties of the Router you added, close the Preferences window.

Closing the IOS Add Wizard

How to Fix the “uBridge is not available” Error in GNS3

After adding a Cisco Router to your network software, you may encounter a uBridge error when you try to cable the Router, Switch, or other devices in the workspace. This issue also occurs on other Linux distributions for Kali distribution only.

To fix the uBridge problem on your Kali computer, you need to install the relevant software on your system.

Step 1

When you try to plug one end of the network cable into the Router’s FastEthernet or other interfaces, you will get the “Error while creating a link: uBridge is not available, the path doesn’t exist, or you just installed GNS3 and need to restart your user session to refresh user permissions.” error as in the image below.

Fix uBridge is not available Error

Step 2

To fix the bridge error in GNS3, first execute the “sudo apt install libpcap-dev” command in the terminal and confirm the installation of new packages.

sudo apt install libpcap-dev

Installing the libpcap-dev Package

Step 3

To clone uBridge from Github to your system, execute the “git clone https://github.com/GNS3/ubridge.git” command in the terminal and then view the contents of the folder.

git clone https://github.com/GNS3/ubridge.git
cd ubridge

Cloning uBridge from Github

Step 4

Execute the “make” command to install uBridge.

make

Building uBridge

Step 5

Finally, execute the “sudo make install” command to copy the uBridge permissions and required files.

sudo make install

Installing uBridge

How to Fix the “No path to a VPCS executable has been set” Error in GNS3

After fixing the uBridge error, you will not get any error when you try to wire the Router and other devices to each other again. However, this time, when you run all devices in the workspace, you will get the error “No path to a VPCS executable has been set.”

Step 1

All you need to do to fix the “No path to a VPCS executable has been set” error is to install VPCS on your Kali system.

Fix No path to a VPCS executable has been set Error

Step 2

To install VPCS on Kali, open the terminal and execute the “sudo apt install vpcs” command.

sudo apt install vpcs

Installing VPCS

How to Fix the “VPCS executable version must be >= 0.6.1 but not a 0.8” Error.

After fixing the VPCS error, when you run all the devices in the workspace again, you will get the error “VPCS executable version must be >= 0.6.1 but not 0.8” this time. This error is related to the VPCS version on some Linux distributions.

Step 1

If you encounter the error “VPCS executable version must be >= 0.6.1 but not a 0.8” in GNS3, you will receive a warning like the image below.

Fixing VPCS executable version must be >= 0.6.1 but not a 0.8 Error

Step 2

To fix the VPCS error, you need to install the appropriate version of VPCS on your Kali system. To install the VPCS 0.8 version on your computer, execute the commands below in order on the terminal.

cd ~/Downloads
git clone https://github.com/TolgaBagci/vpcs_0.8-1_amd64.deb.git
cd vpcs_0.8-1_amd64.deb
sudo dpkg -i vpcs_0.8-1_amd64.deb

Vpcs_0.8-1_amd64.deb

Step 3

When you run the devices in the network environment again, this time you can see that the PCs in the Topology Summary section are working without any problems.

Checking the Availability of All Network Devices

How to Create a New Project

After successfully running the GNS3 simulation program on your Linux system, you can now create new projects and start configuring Cisco devices.

Step 1

Click CTRL + N or the new project icon and open the Project window. Create a project name according to the network topology you will create, configure the location you want to save, and click OK.

Creating a New Project in GNS3

Step 2

Click on the Routers list from the left panel of the GNS3 program and drag and drop the c7200 Router to the workspace.

Adding a Cisco Router to the Workspace

Step 3

Click the All Devices panel and add one Cisco Switch and two VPCS PCs to the workspace.

Adding a Cisco Switch to the Workspace

Step 4

Activate the cabling option and connect one end of the cable to the FastEthernet port of R1 and the other end to the Switch1.

Cabling Network Devices

Step 5

Double-click Router R1 to open the CLI prompt and execute the commands below to assign an IP address to the FastEthernet port.

R1# conf t
R1(config)# interface fastEthernet 0/0
R1(config-if)# ip address 192.168.1.1 255.255.255.0
R1(config-if)# no shutdown

Configuring the Router's FastEthernet Interface

Step 6

To automatically assign IP addresses to all computers in the IP block connected to Router R1, execute the commands below in the terminal to create a DHCP pool.

R1# conf t
R1(config)# ip dhcp pool LAN1
R1(dhcp-config)# network 192.168.1.1 255.255.255.0
R1(dhcp-config)# default-router 192.168.1.1
R1(dhcp-config)# dns-server 192.168.1.1
R1(dhcp-config)# exit
R1(config)# ip dhcp excluded-address 192.168.1.1

Enabling DHCP on Router

Step 7

Execute the “ip dhcp” command at the CLI prompt to assign an IP address from DHCP to the VPCS PC1, and then execute the “show ip” command to check all the information it receives.

PC1> ip dhcp
PC1> show ip

Assigning an IP Address to VPCS1 by DHCP

Step 8

Likewise, execute the “ip dhcp” command to get the address information of VPCS PC2 from DHCP.

PC2> ip dhcp

Assigning an IP Address to VPCS2 by DHCP

Step 9

After configuring all devices in the topology, ping PC1 and PC2 from R1 to test the connection between devices.

R1# ping 192.168.1.2
R1# ping 192.168.1.3

Ping VPCS PCs from Router

Step 10

Test the network connection by pinging R1 and PC2 from PC1.

PC1> ping 192.168.1.1
PC1> ping 192.168.1.3

Ping R1 and PC2 from PC1

Step 11

Finally, test the network connection by pinging PC1 and R1 from PC2.

PC2> ping 192.168.1.1
PC2> ping 192.168.1.2

Ping R1 and PC1 from PC2

How to Uninstall GNS3 from Kali Linux

When you plan to remove the GNS3 networking software from your Linux computer, we recommend that you first back up any network designs you have created and then delete them from your system, including any dependent packages.

Step 1

To uninstall GNS3, execute the “sudo pip3 uninstall gns3-server gns3-gui” command in the terminal, and after checking the directories to be removed, press Y to proceed.

sudo pip3 uninstall gns3-server gns3-gui

Uninstalling GNS3 from Kali

Step 2

To uninstall the virtual PC simulator from GNS3, execute the “sudo apt purge pcs” command on the terminal.

sudo apt purge vpcs

Uninstalling VPCS

Step 3

Execute the “sudo apt purge dynamips” command in the terminal to uninstall the software emulating Cisco Routers in the GNS3 program.

sudo apt purge dynamips

Uninstalling Dynamips

Step 4

Execute the command below in the terminal to remove all dependent packages of the GNS3 software from the system.

sudo apt purge python3-pip python3-pyqt5 python3-pyqt5.qtsvg python3-pyqt5.qtwebsockets qemu qemu-kvm qemu-utils libvirt-clients libvirt-daemon-system virtinst wireshark xtightvncviewer apt-transport-https ca-certificates curl gnupg2 software-properties-common

Removing All GNS3 Dependent Packages

Step 5

Finally, run the command below in the terminal to clean the residual files or additional packages related to GNS3 from your system.

sudo apt autoremove && sudo apt autoclean

Deleting Relic Packages

Step 6

Since you installed the ubridge software manually, you can see the installation directory in the image below. Since you uninstalled GNS3, you don’t need this software anymore, go to the Home directory in the terminal and delete the directory with the “sudo rm -rf ubridge” command.

sudo rm -rf ubridge

Removing uBridge

Step 7

Likewise, delete the Cisco IOS images you added to the program and the GNS3 directory where the projects you made are saved from your system.

sudo rm -rf GNS3

Deleting the GNS3 Folder

Video

Installing Old Versions

GNS3 / Linux Version
YouTube Video
Slide
2.1 / 2018
2.2 / 2022 (NEW)

 

Related Articles

1) How to Run GNS3 on macOS
2) How to Run GNS3 on Linux Mint
3) How to Run GNS3 on Ubuntu
4) How to Run GNS3 on Debian
5) How to Install GNS3 VM

6 Comments

Add a Comment

Your email address will not be published. Required fields are marked *