mirror of
https://github.com/YunoHost-Apps/agendav_ynh.git
synced 2024-09-03 20:36:12 +02:00
74 lines
2.1 KiB
ReStructuredText
74 lines
2.1 KiB
ReStructuredText
.. _upgrading:
|
|
|
|
Upgrading
|
|
=========
|
|
|
|
AgenDAV upgrades can be split into two simple steps.
|
|
|
|
Before starting this process, make sure you have a backup of your current
|
|
AgenDAV directory, specially the ``web/config/`` directory, and dump your
|
|
database schema and contents.
|
|
|
|
Please, do not continue unless you have both backups.
|
|
|
|
Read all the :ref:`releasenotes` from the version you were using
|
|
to current release, because some configuration files may have changed. Apply
|
|
those changes after updating the files from AgenDAV.
|
|
|
|
.. _filesupgrade:
|
|
|
|
Files upgrade
|
|
-------------
|
|
|
|
a) Updating from tar.gz file
|
|
****************************
|
|
|
|
You can replace the whole AgenDAV directory with the new files, but it's
|
|
recommended to keep your old folder with a different name (e.g.
|
|
``agendav_old/``). You'll need it to copy back your configuration files.
|
|
|
|
After downloading the new tar.gz file and uncompressing it, copy your
|
|
configuration files from the old directory::
|
|
|
|
$ cd agendav_old/web/config/
|
|
$ cp -a advanced.php caldav.php config.php database.php \
|
|
/path/to/new/agendav/web/config/
|
|
|
|
|
|
b) Updating from git
|
|
********************
|
|
|
|
If you downloaded AgenDAV from the git repository at GitHub then you can
|
|
checkout latest stable release from the ``master`` branch, or an specific
|
|
version using its tag.
|
|
|
|
Just pull latest changes and checkout the release you want. For example,
|
|
checking out AgenDAV 1.2.5 can be achieved with::
|
|
|
|
$ git pull
|
|
[...]
|
|
$ git checkout 1.2.5
|
|
|
|
.. _dbupgrade:
|
|
|
|
Database upgrade
|
|
----------------
|
|
|
|
.. note::
|
|
|
|
AgenDAV <= 1.2.5.1 have a bug that makes database upgrades to fail,
|
|
complaining about a missing ``migration_lang.php`` file. If you have
|
|
AgenDAV configured to use a language other than English, set
|
|
:confval:`default_language` to ``en`` before running ``agendav dbupdate``
|
|
|
|
The database upgrade process included in AgenDAV since 1.2.5 lets you
|
|
apply the latest schema changes without having to deal with ``.sql`` files
|
|
and with no need to check which files you should apply to your current
|
|
version.
|
|
|
|
Just use the provided ``bin/agendavcli`` script this way::
|
|
|
|
$ ./bin/agendavcli dbupdate
|
|
|
|
|
|
|