..  _backup:

Backup/Restore
==============

Backup Tuleap
-------------

This documentation is here to help you to set your backup up. Be careful with this, it's just a guide and you will probably want to backup more things

If you installed Tuleap on a virtual environment and you are able to use snapshots, the simplest backup solution is to suspend tuleap services and then make a snapshot. Otherwise here are some tips to backup your Tuleap infrastructure:

Suspend services
````````````````

Depending on services you use, you will want to stop them before the backup (It should guarantee you a consistent backup):

On CentOS/RHEL 7:

.. code-block:: bash

    $ systemctl stop nginx
    $ systemctl stop httpd
    $ systemctl stop tuleap
    $ su - gitolite -c "gitolite writable @all off 'Backup in progress'"

Don't forget to restart services once the backup is done.

Database backup
```````````````

Tuleap main database is "tuleap", but additionnal databases can be used for plugins. To show them use:

.. code-block:: bash

    $ mysql -u codendiadm -p -e "show databases;"

Use mysqldump to backup all databases. You can also write a script to backup each database independently:

.. code-block:: bash

    $ mysqldump -u codendiadm -p --all-databases > mybackup.sql

Files backup
````````````

You need to save the following directories. **Be careful, you need to preserve the correct rights on files**:

    - /etc/tuleap
    - /var/lib/tuleap
    - /var/lib/gitolite
    - /var/lib/mailman

Some directories might not exists depending on your configurations (plugins installed or not).

Restore Tuleap
--------------

As only data were backed up, you first need a Tuleap server to restore them. It can be your old server or a new server you have just installed following the installation guide. Then you will need to:

    - suspend all services
    - restore databases
    - restore directories
    - run the site-deploy tool ``tuleap-cfg site-deploy``