Linux/NetworkManager
====================

.. toctree::
   :maxdepth: 1
   :caption: Contents:

.. role:: underline
    :class: underline
    

Installing the VPN client
-------------------------

.. note:: The solution is based on openconnect package and therefore requires proper support for `Global Protect protocol`_ there in. Read :doc:`vpn_linux_command_line` to check if your Linux distribution is known to have problems with the Global Protect protocol implementation.

RHEL/Rocky/AlmaLinux/Fedora
...........................

Open a terminal and type there:

.. code:: python

 sudo dnf install epel-release
 sudo dnf update epel-release
 sudo dnf install NetworkManager-openconnect-gnome

Debian/Ubuntu
.............

Open a terminal and type there:

.. code:: console

 sudo apt install network-manager-openconnect-gnome


Settig up the VPN connection
----------------------------

Click with the mouse on the right upper corner of your GNOME desktop (where the icon for WiFi and Ethernet connectivity is placed). Then in the diplayed menu click on the “Settings” button (see where the red arrow points at in the picture below):

.. image:: _images/vpn_nm_01.png

In the “Settings” window choose “Network” (1) and then press on the “+” sign (2) as it shown below:

.. image:: _images/vpn_nm_02.png

In the selection next choose “Multi-protocol VPN client (openconnect)”:

.. image:: _images/vpn_nm_03.png

Set “Discoverer” as a name of the connection (1), choose “Palo Alto Networks GlobalProtect” from “VPN Protocol” menu (2), enter start.discoverer.bg as “Gateway” (3), and press “Add” to save the configuration (4):

.. image:: _images/vpn_nm_04.png

That will bring back the set-up to “Network” in “Settings”, where the newly created VPN configuration profile will appear in the list of configurations under the name “Discoverer”.


Getting connected
-----------------

Click with the mouse on the right upper corner of your GNOME desktop (where the icon for WiFi and Ethernet connectivity is placed). Then in the diplayed menu click on the “Settings” button (see where the red arrow points at in the picture below):

.. image:: _images/vpn_nm_05.png

Select “Connect”:

.. image:: _images/vpn_nm_06.png

provide your user Discoverer name and password, then click “Login”, and after that click “Login” again:

.. image:: _images/vpn_nm_07.png

.. image:: _images/vpn_nm_08.png


Disconnecting
-------------

.. warning:: You can stop only an established VPN tunnel!

Click with the mouse on the right upper corner of your GNOME desktop (where the icon for WiFi and Ethernet connectivity is placed). If the VPN tunnel is established, you will see its icon and name. Then click on “Discoverer” and in the expanded menu select “Turn Off”:

.. image:: _images/vpn_nm_09.png

.. image:: _images/vpn_nm_10.png


Diagnostics
-----------

If the VPN connection is successfully established (the VPN tunnel is active), a special icon (VPN connectivity indicator) will appear in the tray, as well as the name of the VPN connection “Discoverer” will be displayed in the list of active connections (see the red arrows below):

.. image:: _images/vpn_nm_11.png

Try to ping the login node:

.. code-block:: bash

 ping login.discoverer.bg

to proove that the internal infrastructure of Discoverer HPC is accessible.


Getting help
------------

See :doc:`help`

.. _`Global Protect protocol`: https://www.infradead.org/openconnect/globalprotect.html