.. Reminder for header structure:
  Parts (H1)          : #################### with overline
  Chapters (H2)       : ******************** with overline
  Sections (H3)       : ====================
  Subsections (H4)    : --------------------
  Subsubsections (H5) : ^^^^^^^^^^^^^^^^^^^^
  Paragraphs (H6)     : """"""""""""""""""""

.. meta::
  :description: Upgrading the WAPT Server
  :keywords: WAPT, upgrade, upgrading, documentation

.. |ok| image:: wapt-resources/icon-ok.png
  :scale: 5%
  :alt: feature available

.. |nok| image:: wapt-resources/icon-nok.png
  :scale: 5%
  :alt: feature not available

.. |date| date::

.. _upgrade-wapt:

.. hint::

  If your WAPT Server is a virtual host, take a snapshot of the VM.
  This way, you will be able to go back easily in the rare case that the update fails.

.. warning::

  After each WAPT Server update, update your :ref:`WAPT Console <installing_the_WAPT_console>`, then :ref:`regenerate <create_WAPT_Agent>` the WAPT Agent.

Before upgrading WAPT Server, please refer to the following upgrading compatibility chart:

.. list-table:: Available WAPT Upgrade paths
  :header-rows: 1
  :stub-columns: 1
  :widths: auto
  :align: center

  * - \
    - To WAPT 2.2
  * - From WAPT 1.8.2
    - |ok|
  * - From WAPT 2.0
    - |ok|
  * - From WAPT 2.1
    - |ok|

.. note::

  For all older versions, please refer to the `2.1 documentation <https://www.wapt.fr/fr/doc-2.1/waptserver-update.html>`_

.. warning::

  If upgrading from a version less than WAPT 2.1, the :ref:`licence activation <licence_activation>` process has changed.

.. _wapt_minor_upgrade:

************************************************************
Switching of WAPT Edition (Community, Discovery, Enterprise)
************************************************************

WAPT Community is not suppported anymore on version WAPT 2.2. If you want to upgrade from WAPT 1.8.2 Community you can upgrade to WAPT 2.2 Discovery. 
Please note that WAPT Discovery is limited to 300 client computers maximum.

To upgrade from a WAPT Community setup to WAPT Discovery or Enterprise follow the standard :ref:`1.8.2 to 2.2 upgrade documentation <wapt_major_upgrade_182_22>`.

The WAPT Server will make the appropriate changes.

To upgrade WAPT Discovery to WAPT Enterprise simply upload a valid :ref:`licence <licence_activation>` to the WAPT Server from the WAPT Console.
 
If your Enteprise licence expire, it will fall back on the Discovery Edition. If you have more that 300 client computers in your server while in Discovery mode, 
the console will be limited and you'll have to delete computer entries in the inventory in order to go below the 300 computers limit.

.. comment ############################################################################################
.. comment # UPGRADE 2.2 TO LATEST
.. comment ############################################################################################

************************************
Upgrading from version 2.2 to latest
************************************

.. _wapt_minor_upgrade_22_22:

Choose your distribution

.. tabs::

  .. tab:: Debian / Ubuntu

    * Update the underlying distribution and upgrade WAPT Server

    .. code-block:: bash

      export DEBIAN_FRONTEND=noninteractive
      apt update && apt upgrade -y
      apt install tis-waptserver tis-waptsetup -y
      unset DEBIAN_FRONTEND

    * Launch the post-configuration step :ref:`post-configuration step <wapt-postconf>`

    * Once completed your WAPT Server is ready.

  .. tab:: RedHat and derivatives

    * Update the underlying distribution and upgrade WAPT Server

    .. code-block:: bash

      yum update -y
      yum install tis-waptserver tis-waptsetup -y

    * Launch the post-configuration step :ref:`post-configuration step <wapt-postconf>`

    * Once completed your WAPT Server is ready.

  .. tab:: Windows

    * Download and execute :download:`waptserversetup.exe <https://wapt.tranquil.it/wapt/releases/wapt-2.2/waptserversetup.exe>`.

    .. attention::

      The installation of the WAPT Server **MUST** be done using a **Local Administrator**
      account on the host

    * Choose the language for the WAPT installer.

    .. image:: wapt-resources/wapt_deploy_choose-language_dialog-box.png
      :align: center
      :alt: Choosing the language for deploying the WAPT installer

    * Click on :guilabel:`OK` to go on to the next step.

    .. image:: wapt-resources/wapt_deploy_accept-license_dialog-box.png
      :align: center
      :alt: Accepting the WAPT license terms

    * Accept the licence terms and click on :guilabel:`Next` to go to next step.

    * Choose additional configuration tasks (leave the default if not sure).

    .. figure:: wapt-resources/wapt_deploy_additional-configuration-server_dialog-box.png
      :align: center
      :alt: Choosing the installer options for deploying the WAPT Serer

      Choosing the installer options for deploying the WAPT Server

    * Do not change the password for the WAPT Server (if not necessary).

    .. image:: wapt-resources/wapt_deploy_choosing-password_dialog-box.png
      :align: center
      :alt: Dialog box for changing the password

    * Click on the :guilabel:`Install` to launch the installation, wait for the installation to complete.

    .. image:: wapt-resources/wapt_deploy_installation-in-progress_dialog-box.png
      :align: center
      :alt: Dialog box showing the WAPT installation in progress

    * Click on :guilabel:`Finish` to close the window.
      
    .. image:: wapt-resources/wapt_deploy_installation-completed_dialog-box.png
      :align: center
      :alt: Installation has finished

    The WAPT Server on your Windows is ready.



.. comment ############################################################################################
.. comment # UPGRADE 2.0 / 2.1 TO LATEST
.. comment ############################################################################################

****************************************
Upgrading from version 2.0 or 2.1 to 2.2
****************************************

.. Note::

  Before upgrading, ensure that :ref:`installation requirements <install_requirements>` are met.

.. _wapt_minor_upgrade_21_22:
.. _wapt_minor_upgrade_20_22:

Choose your distribution

.. tabs::

  .. tab:: Debian / Ubuntu

    * First of all, update the underlying distributionand install the WAPT Server packages.

    .. code-block:: bash

      apt update && apt upgrade -y
      apt install apt-transport-https lsb-release gnupg

    * Then the update the package repository and import the GPG key from the repository.
    
    .. code-block:: bash

      wget -O - https://wapt.tranquil.it/$(lsb_release -is)/tiswapt-pub.gpg  | apt-key add -
      echo "deb https://wapt.tranquil.it/$(lsb_release -is)/wapt-2.2/ $(lsb_release -c -s) main" > /etc/apt/sources.list.d/wapt.list

    * Update the repository and install the packages.

    .. code-block:: bash

      export DEBIAN_FRONTEND=noninteractive
      apt update 
      apt install tis-waptserver tis-waptsetup -y
      unset DEBIAN_FRONTEND

    * Launch the post-configuration step :ref:`post-configuration step <wapt-postconf>`

  .. tab:: RedHat and derivatives


    * First of all, update the underlying distribution and necessary packages.

    .. code-block:: bash
      
      yum update -y
      yum install epel-release redhat-lsb-core -y

    * Then add or update the package repository WAPT packages and import the GPG key from the repository.

    .. code-block:: bash

      cat > /etc/yum.repos.d/wapt.repo <<EOF
      [wapt]
      name=WAPT Server Repo
      baseurl=https://wapt.tranquil.it/centos$(lsb_release -rs | cut -f1 -d.)/wapt-2.2/
      enabled=1
      gpgcheck=1
      EOF

      wget -q -O /tmp/tranquil_it.gpg "https://wapt.tranquil.it/centos$(lsb_release -rs | cut -f1 -d.)/RPM-GPG-KEY-TISWAPT-$(lsb_release -rs | cut -f1 -d.)"; rpm --import /tmp/tranquil_it.gpg

       
    * And finally upgrade the WAPT Server

    .. code-block:: bash

      yum install tis-waptserver tis-waptsetup cabextract -y


  .. tab:: Windows

    * Download and execute :download:`waptserversetup.exe <https://wapt.tranquil.it/wapt/releases/wapt-2.2/waptserversetup.exe>`.

    * Choose the language for the WAPT installer.

    .. image:: wapt-resources/wapt_deploy_choose-language_dialog-box.png
      :align: center
      :alt: Choosing the language for deploying the WAPT installer

    * Click on :guilabel:`OK` to go on to the next step.

    .. image:: wapt-resources/wapt_deploy_accept-license_dialog-box.png
      :align: center
      :alt: Accepting the WAPT license terms

    * Accept the licence terms and click on :guilabel:`Next` to go to next step.

    * If old folder installation found, this message appear.
      Click on :guilabel:`Yes` to go on to the next step.

    .. image:: wapt-resources/wapt_deploy_folder-exist_dialog-box
      :align: center
      :alt: Dialog box warning about the obsolete WAPT destination folder

    * Select additional task if needed.

    .. figure:: wapt-resources/wapt_deploy_additional-configuration-server_dialog-box.png
      :align: center
      :alt: Choosing the installer options for deploying the WAPT Serer

      Choosing the installer options for deploying the WAPT Server

    * Change the WAPT Server password if needed, then press :guilabel:`Next`.

    .. image:: wapt-resources/wapt_deploy_choosing-password_dialog-box.png
      :align: center
      :alt: Dialog box for changing the password

    * Click on the :guilabel:`Install` to launch the installation, wait for the installation to complete.

    .. image:: wapt-resources/wapt_deploy_installation-in-progress_dialog-box.png
      :align: center
      :alt: Dialog box showing the WAPT installation in progress

    * Click on :guilabel:`Finish` to close the window.
      
    .. image:: wapt-resources/wapt_deploy_installation-completed_dialog-box.png
      :align: center
      :alt: Installation has finished

    .. attention::

      **DO NOT** use the WAPT Console on the WAPT Server. **DO NOT** install nor run your WAPT package development tools on the WAPT Server.

    The WAPT Server on your Windows server or workstation is ready.

    .. figure:: wapt-resources/wapt_server_web-interface_browser-window.png
      :align: center
      :alt: The WAPT Server interface in a web browser

      The WAPT Server interface in a web browser

    Your WAPT Server is now ready.
    You may now go to the documentation on :ref:`Installing the WAPT management Console <installing_the_WAPT_console>`.

***********************************
Upgrading from version 1.8.2 to 2.2
***********************************
    
.. _wapt_major_upgrade_182_22:

.. Note::

  Before upgrading, ensure that :ref:`installation requirements <install_requirements>` are met.

.. warning::

  On WAPT 2.1 and upper :ref:`licence activation <licence_activation>` is changed.

Choose your distribution

.. tabs::

  .. tab:: Debian / Ubuntu



    .. Note::

      If you are running on Debian9 Stretch, you have first to upgrade to Debian10 Buster before upgrading to WAPT 2.x.
      **The WAPT Server 2.x is not available for Debian9**.

      It is even recommended to upgrade to Debian 11 Bullseye. In this case, upgrade from Debian 9 => Debian 10 => Debian 11.

    * First of all, update the underlying distribution and install the WAPT Server packages.

    .. code-block:: bash

      apt update && apt upgrade -y
      apt install apt-transport-https lsb-release gnupg

    * Then update the package repository and import the GPG key.
    
    .. code-block:: bash

      wget -O - https://wapt.tranquil.it/$(lsb_release -is)/tiswapt-pub.gpg  | apt-key add -
      echo "deb https://wapt.tranquil.it/$(lsb_release -is)/wapt-2.2/ $(lsb_release -c -s) main" > /etc/apt/sources.list.d/wapt.list

    * Update the repository and install the packages.

    .. code-block:: bash

      export DEBIAN_FRONTEND=noninteractive
      apt update 
      apt install tis-waptserver tis-waptsetup -y
      unset DEBIAN_FRONTEND

    * Launch the post-configuration step :ref:`post-configuration step <wapt-postconf>`

    * Re-sign all your WAPT Packages.

      * :ref:`Using the WAPT Console <re_sign_package_gui>`, or

      * :ref:`Using the command line <re_sign_package_cmd>`.

  .. tab:: RedHat and derivatives

    * First of all, update the underlying distribution and necessary packages.

    .. code-block:: bash
      
      yum update -y
      yum install epel-release redhat-lsb-core -y

    * Then add or update the package repository WAPT packages and import the GPG key from the repository.

    .. code-block:: bash

      cat > /etc/yum.repos.d/wapt.repo <<EOF
      [wapt]
      name=WAPT Server Repo
      baseurl=https://wapt.tranquil.it/centos$(lsb_release -rs | cut -f1 -d.)/wapt-2.2/
      enabled=1
      gpgcheck=1
      EOF

      wget -q -O /tmp/tranquil_it.gpg "https://wapt.tranquil.it/centos7/RPM-GPG-KEY-TISWAPT-7"; rpm --import /tmp/tranquil_it.gpg

       
    * And finally upgrade the WAPT Server

    .. code-block:: bash

      yum install tis-waptserver tis-waptsetup cabextract -y

    * Launch the post-configuration step :ref:`post-configuration step <wapt-postconf>`

    * Re-sign all your WAPT Packages.

      * :ref:`Using the WAPT Console <re_sign_package_gui>`, or

      * :ref:`Using the command line <re_sign_package_cmd>`.


  .. tab:: Windows

    * Download and execute :download:`waptserversetup.exe <https://wapt.tranquil.it/wapt/releases/wapt-2.2/waptserversetup.exe>`.

    * Choose the language for the WAPT installer.

    .. image:: wapt-resources/wapt_deploy_choose-language_dialog-box.png
      :align: center
      :alt: Choosing the language for deploying the WAPT installer

    * Click on :guilabel:`OK` to go on to the next step.

    .. image:: wapt-resources/wapt_deploy_accept-license_dialog-box.png
      :align: center
      :alt: Accepting the WAPT license terms

    * Accept the licence terms and click on :guilabel:`Next` to go to next step.

    * If old folder installation found, this message appear.
      Click on :guilabel:`Yes` to go on to the next step.

    .. image:: wapt-resources/wapt_deploy_folder-exist_dialog-box
      :align: center
      :alt: Dialog box warning about the obsolete WAPT destination folder

    * Select additional task if needed.

    .. figure:: wapt-resources/wapt_deploy_additional-configuration-server_dialog-box.png
      :align: center
      :alt: Choosing the installer options for deploying the WAPT Serer

      Choosing the installer options for deploying the WAPT Server

    * Change the WAPT Server password if needed, then press :guilabel:`Next`.

    .. image:: wapt-resources/wapt_deploy_choosing-password_dialog-box.png
      :align: center
      :alt: Dialog box for changing the password

    * Click on the :guilabel:`Install` to launch the installation, wait for the installation to complete.

    .. image:: wapt-resources/wapt_deploy_installation-in-progress_dialog-box.png
      :align: center
      :alt: Dialog box showing the WAPT installation in progress

    * Click on :guilabel:`Finish` to close the window.
      
    .. image:: wapt-resources/wapt_deploy_installation-completed_dialog-box.png
      :align: center
      :alt: Installation has finished

    .. figure:: wapt-resources/wapt_server_web-interface_browser-window.png
      :align: center
      :alt: The WAPT Server interface in a web browser

      The WAPT Server interface in a web browser

    The WAPT Server on your Windows server or workstation is ready.

    .. attention::

      **DO NOT** use the WAPT Console on the WAPT Server. **DO NOT** install nor run your WAPT package development tools on the WAPT Server.

    Your WAPT Server is now ready.
    You may now go to the documentation on :ref:`Installing the WAPT management Console <installing_the_WAPT_console>`.

    * Re-sign all your WAPT Packages.

      * :ref:`On graphical <re_sign_package_gui>`