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

.. meta::
  :description: Backing up the WAPT Server
  :keywords: backup server, WAPT, PostgreSQL, pg_dumpall, FastCopy, WinSCP, documentation

.. _backup_server:

##########################
Backing up the WAPT Server
##########################

To backup your WAPT Server follow this procedure. **Regular backups are recommended**.

Before starting the migration of the WAPT server, it is highly recommended to **perform a thorough cleanup of the repository**. This will facilitate the migration by **reducing the amount of data to be transferred**, speeding up the process, and minimizing the risks of corruption or errors.


.. white_toggle::
  :titleen: Cleanup Steps of packages in the waptconsole:
  :titlefr: Etapes de nettoyage des paquets de la waptconsole :

    *1- Package Identification:*

    Review all packages present in the repository.
    Identify packages that have multiple versions, such as Firefox and others.

    .. hint::

      In the WAPT Package tab you can select all packages, and do a right-click :guilabel:`Select obsolete packages`.
      **Use with caution and at your own risk.**

    *2- Keeping Current Versions:*

    For each package with multiple versions, keep only the version currently in production.
    Remove old versions and unused versions.

    *3- Comprehensive Verification:*

    Ensure this operation is performed for all packages in the repository.
    Verify that the retained versions are indeed those used in production.


.. _linux_backup_server:

*****
Linux
*****

* Stop WAPT related services on the WAPT Server.

.. code-block:: bash

  systemctl stop wapttasks
  systemctl stop waptserver-uwsgi (if used)
  systemctl stop waptserver
  systemctl stop nginx


* Backup recursively these directories using a backup tool (ex: :program:`rsync`, :program:`WInSCP`, etc..).

.. tabs::

  .. code-tab:: bash Debian and derivatives

    /var/www/wapt/
    /var/www/wapt-host/
    /var/www/waptwua/
    /var/www/wads/
    /opt/wapt/conf/
    /opt/wapt/waptserver/ssl/
    /var/www/*.json

  .. code-tab:: bash RedHat and derivatives

    /var/www/html/wapt/
    /var/www/html/wapt-host/
    /var/www/html/waptwua/
    /var/www/html/wads/
    /opt/wapt/conf/
    /opt/wapt/waptserver/ssl/
    /var/www/html/*.json


.. hint::

  If you use Kerberos to authenticate hosts and users, save the :file:`keytab` file too.
  The :file:`keytab` file is located in the :file:`nginx` folder.

* Backup the PostgreSQL database using the :program:`pg_dumpall` utility (adapt filename with your requirements).

.. code-block:: bash

  sudo -u postgres pg_dumpall > /tmp/backup_wapt.sql

* Restart WAPT related services on the WAPT Server.

.. code-block:: bash

  systemctl start wapttasks
  systemctl start waptserver
  systemctl start nginx

.. _windows_backup_server:

*******
Windows
*******

* Stop WAPT related services on the WAPT Server.

.. code-block:: bash

  net stop WAPTServer
  net stop WAPTService
  net stop WAPTTftpServer

* Backup the WAPT repository folder on a remote backup destination.

.. code-block:: bash

  C:\wapt\conf
  C:\wapt\waptserver\repository\wapt
  C:\wapt\waptserver\repository\wapt-host
  C:\wapt\waptserver\repository\waptwua
  C:\wapt\waptserver\repository\wads
  C:\wapt\waptserver\nginx\ssl

* Backup PostgreSQL Database with :program:`pg_dump.exe`.

.. code-block:: bash

  "C:\wapt\waptserver\pgsql-14\bin\pg_dumpall.exe" -U postgres -f C:\backup_wapt.sql

* Restart WAPT related services on the WAPT Server.

.. code-block:: bash

  net start WAPTPostgresql
  net start WAPTServer
  net start WAPTService
  net start WAPTTftpServer

