2. 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 Release notes 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.

2.1. Files upgrade

2.1.1. 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/

2.1.2. 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

2.2. 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 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