Skip to content
This repository has been archived by the owner on Dec 27, 2023. It is now read-only.

EN:Update Howto

Jump to bottom
Philipp Gampe edited this page Jan 11, 2023 · 15 revisions

General steps

Backup

Before you start, always create a backup of your tine files and your database! Never start without a backup! See Backup and Restore for more information on this topic.

Replacing the files

  • Download the latest version from https://github.com/tine20/tine20/releases (or from https://packages.tine20.org/source/) and unpack it. If you use ActiveSync unpack it to the same folder.

  • Copy the config.inc.php & .htaccess from your working installation to the new folder.

  • If you have additional themes installed, you have to copy them also to the new folder.

  • If there is no vendor folder, make sure to run composer install inside the new folder

  • Set file permissions (owner, rights, etc) to secure your installation. See the Install Howto for more details.

  • Replace the folder with your old tine version with the one containing the new one.

Updating the applications

Notice: During the update, users are not able to login.

There are two ways you can go for updating the application and database. It's up to you, which one you prefer.

Using the GUI

  • Open your browser, call your Tine setup page (http://your_webserver/path_to_tine/setup.php) and login with the setup user account defined in your config.inc.php.

  • You will be automatically brought to the 'Application Manager'. All applications that need to be updates are preselected by default. Just click to the 'update applications' button. This process can take a while, depending on how many applications have to be updated and the amount of your data. After the update is done, setup automatically forwards to the login page.

Using the CLI

  • The process for all applications that need to be updated can be started out of your tine folder by running (if your config file is in a different directory, adjust the parameter)

php setup.php [--config=/etc/tine20] --update

Update third party applications

Some of your installed applications might be out of date. Please check the Download page or the third party repository for newer versions of those applications.

Migration Path

As there are done breaking changes from time to time to the Tine 2.0 core or any applications, it is recommended (and supported) to only update from a given major version (latest minor release) to the next one (again the latest minor release). You can still find the tarball downloads of the last minor releases of older version (not older than 2017) in our download area (see https://packages.tine20.org/source/). Business Edition packages can be found here: https://packages.tine20.com/maintenance/source/

So currently (November 2022) we have the following (possible) update path (beginning 2017):

2017.02.5 2017.08.11 2018.02.7 2018.08.9 2019.02.8 2019.08.4 2019.12.5 2020.03.4 2020.08.8 2021.02.4
2021.12.1 2022.12.1

You could also update to the corresponding Business Edition (XXXX.11 - see download links above)

Another possible way (for example if you have a very old version) is to download/checkout the source (from the repo/release tag) and do the following:

  • run "composer install" (see development setup for more information)
  • run "php setup.php --update"

Johannes also has written an article about the Community Edition migration path:

https://www.nohl.eu/tine-20/legacy-migration-path/

Also see this discussion about more information about checking out a version from git: https://github.com/tine20/tine20/discussions/7405

Clone this wiki locally