====== Task 1 - Installing the GNS3 Webclient Launcher ======
Before you get started with GNS3, install the GNS3 WebLauncher. This programme allows you to open virtual devices from the GNS3 platform directly with a mouse click. These instructions describe how to install the WebLauncher under Windows and Linux.
===== Install GNS3 WebClient Launcher under Windows =====

==== Install the required additional programmes ====
Please install the latest version of the following programmes before you start installing the WebLauncher:
  * Putty((https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html))
  * Wireshark((https://www.wireshark.org/download.html))
  * Cygwin((https://www.cygwin.com/))

==== Installation of the WebLauncher ====

Go to : "https://www.gns3.com/software/download" and then download the relevant Windows package. You will need a GNS account for the download. Log in with your account or create a new one if necessary. The download of GNS 3 will now start. 
the installer. You may need to enter the user name and password of an administrator during the installation. The installer will now start.

You must make a few important changes in the following selection. Please only select the GNS3 WebClient:

{{ausbildung:pasted:20221118-115312.png}}

The following tools should be deselected, as they are obtained and installed from the original sources:
  * Wireshark
  * Solar PuTTY

The following should also be selected ''VirtViewer 11'':

{{ausbildung:pasted:20221121-114101.png}}

Next, the installation routine suggests installing WinPcap and NPcap. Accept these suggestions and install the two programmes.

When the installation is finished it should look like this:

{{team:fabio-pagotto:pasted:20221115-103220.png}}

Now click on "Start GNS3" and then on "Finish". A configuration window will open immediately afterwards. To link the helper programmes, please make the following entries (adjust the paths if necessary if you have installed other versions of the helper programmes):

{{ausbildung:pasted:20221121-134618.png}}

===== Install GNS3 with Weblauncher under Linux =====
To install GNS3 under Linux with the package manager ''apt'' (Ubuntu, Debian, etc.) to install GNS3 with Weblauncher, enter the following commands in the console ein((https://github.com/GNS3/gns3-webclient-pack/blob/master/README.md)):
<code>
sudo su - #root werden
add-apt-repository ppa:gns3/ppa
apt update
apt install gns3-webclient-pack
apt install tigervnc-viewer
dpkg-reconfigure wireshark-common (dann yes) #Wireshark darf dadurch unter der Gruppe 'wireshark' ausgeführt werden
usermod -a -G wireshark $USER #Der User $USER wird der Gruppe 'wireshark' hinzugefügt
init 6</code>


===== Test WebLauncher =====

Now that you have installed the WebLauncher, you will test whether it works properly.

==== Creating the test environment ====
Open a web browser of your choice and enter the address: "http://gns3.rafisa.org/static/web-ui/server/1/projects"
. You will land on the following website.

{{team:fabio-pagotto:pasted:20221116-141321.png?600}}

Click on "Add blank project" in the top right-hand corner and give the project the name "Test".

Now you are here:

{{team:fabio-pagotto:pasted:20221117-114051.png?600}}

Now click on the plus symbol at the top. The following menu will now appear.

{{team:fabio-pagotto:pasted:20221117-115251.png?200}}

Scroll down and drag a VPCS, a Firefox device and an Ethernet switch onto the workspace. Connect the devices with the connector element to the right of the plus sign. 

{{team:fabio-pagotto:pasted:20221117-134903.png}}

Your desktop should then look like this:

{{ausbildung:pasted:20221121-150357.png}}

Now start both Firefox and PC1 by right-clicking on the respective icon. Then select Start from the menu.





==== Testing the consoles ====
=== Test Telnet ===
Now test whether the main thing, the WebLauncher works. To do this, right-click 
on one of the VPCS and click on "Start" in the menu. Repeat this process and click on "Console
click on "Console" this time. You may be asked to open the WebClient.

{{team:fabio-pagotto:pasted:20221117-140321.png}}

Now click on "Open GNS3 WebClient launcher". The following window should now open.

{{team:fabio-pagotto:pasted:20221117-140528.png}}

If this is the case, then the WebLauncher objection for Telnet is working properly.

=== Test VNC console ===
To test the VNC console, it must first be activated in the Firefox system. To do this, right-click on the Firefox system. Then select ''Configure'' and scroll under ''General Settings'' all the way down. In the ''Console type'' select ''vnc'' and confirm with ''Apply'':

{{ausbildung:pasted:20221121-152755.png}}

Then right-click on the Firefox system again and select ''Console''whereupon a connection via VNC should be established.

=== Test Spice console ===
To test the VNC console, it must first be activated in the Firefox system. To do this, right-click on the Firefox system. Then select ''Configure'' and scroll under ''General Settings'' all the way down. In the ''Console type'' select ''spice'' and confirm with ''Apply'':

{{ausbildung:pasted:20221121-153215.png}}
 
Then right-click on the Firefox system again and select ''Console''whereupon a connection should be created via SPICE.

=== Test Packet Capture ===
Right-click on the black line between the switch and PC1.

{{ausbildung:pasted:20221121-151744.png}}

Now click on "Start Capture" in the drop-down menu. A new window opens. Now click on "Link type" and select "Ethernet" from the list. Also click on "Start the capture visualisation program" so that a tick appears to the left of it. Now click on "OK". 

{{ausbildung:pasted:20221121-151836.png}}

When the following message appears, click on "Open GNS3 WebClient Launcher"

{{team:fabio-pagotto:pasted:20221117-140321.png}}

The following window should now open.

{{team:fabio-pagotto:pasted:20221117-144439.png}}

The entire data history between PC1 and the switch is now displayed here.

☛ Do not forget to stop the packet capture in the GNS3 environment as well, otherwise recording will continue.