###################
License Management
###################
There are various options for including a license:

* `Option 1`_: Upload a license (e.g. license.txt) through the upload wizard inside the extension
* `Option 2`_: Place a license.txt inside the qgeo directory
* `Option 3`_: Include a license inside the extension properties panel
* `Option 4`_: Upload a license (e.g. license.txt) to Qlik Sense server and place it inside the resources folder

.. _Option 1:

************************************
Option 1: Upload license.txt
************************************
Upload a valid license file (filename must be license.txt) through the upload wizard of the extension. This options only works on QLik Sense Desktop (for QLik Sense Server use `Option 4`_).

.. figure:: ../images/license-upload.jpg
  :alt: QGeo license upload
  :height: 340

.. _Option 2:

************************************
Option 2: Manually Copy license.txt
************************************
Manually copy the license file into the QGeo extension directory (e.g. C:\\Users\\[User]\\Documents\\Qlik\Sense\\Extensions\\qgeo\\license.txt).

.. figure:: ../images/license-directory.jpg
  :alt: QGeo directory

.. _Option 3:

********************************************
Option 3: Add license via properties panel
********************************************
Use the QGeo properties panel to manually add a license as string.

.. figure:: ../images/license-properties.jpg
  :alt: QGeo properties license panel
  :height: 650

.. _Option 4:

*************************************************************************
Option 4: Add license.txt in the Content Library (Server Installation)
*************************************************************************
Inside the Qlik Sense Server switch to QMC and add a new content library "qgeo" where you can upload a license file (filename must be license.txt).

.. figure:: ../images/settings-qmc.jpg
  :alt: QMC Content Library

  Open the Qlik Management Console and select the content libraries tab (http://domain/qmc/)

.. figure:: ../images/settings-qmc-content-libraries-2.png
  :alt: QMC Content Library

  Inside the content libraries tab click on the "Create new" button

.. figure:: ../images/settings-qmc-content-libraries-3.png
  :alt: QMC Content Library

  Create a new content library "qgeo"

.. figure:: ../images/settings-qmc-content-libraries-4.png
  :alt: QMC Content Library

  Upload the license.txt file inside the content tab

.. figure:: ../images/settings-qmc-content-libraries.png
  :alt: QMC Content Library

  Content library qgeo created successfully

More information about the how to create and handle content libraries can be found at `help.qlik.com <https://help.qlik.com/en-US/sense-admin/May2021/Subsystems/DeployAdministerQSE/Content/Sense_DeployAdminister/QSEoW/Administer_QSEoW/Managing_QSEoW/create-content-libraries.htm>`_ and in the tutorial video "Creating Content Libraries in Qlik Sense":

.. raw:: html

    <iframe width="640" height="360" src="https://www.youtube.com/embed/mMyYZgYZ9wY" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

******************
Invalid License
******************
There is a notice if no valid license is found:

.. image:: ../images/unlicensed.JPG