+==================================
Upgrade your wallabag installation
==================================
- `from 2.0.x to 2.1.1 <#upgrade-from-2-0-x-to-2-1-1>`_
- `from 1.x to 2.x <#from-wallabag-1-x>`_
+*****************************
Upgrading from 2.1.x to 2.2.x
------------------------------
+*****************************
Upgrade on a dedicated web server
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+=================================
+
+**From 2.1.x:**
+
+::
+
+ make update
+ php bin/console doctrine:migrations:migrate --no-interaction -e=prod
+
+**From 2.2.0:**
::
make update
Explanations about database migrations
-""""""""""""""""""""""""""""""""""""""
+--------------------------------------
During the update, we execute database migrations.
* ``20161122203647``: dropped ``expired`` and ``credentials_expired`` fields on ``user`` table
* ``20161128084725``: added ``list_mode`` field on ``config`` table
* ``20161128131503``: dropped ``locked``, ``credentials_expire_at`` and ``expires_at`` fields on ``user`` table
+* ``20161214094402``: renamed ``uuid`` to ``uid`` on ``entry`` table
* ``20161214094403``: added ``uid`` index on ``entry`` table
+* ``20170127093841``: added ``is_starred`` and ``is_archived`` indexes on ``entry`` table
Upgrade on a shared hosting
-^^^^^^^^^^^^^^^^^^^^^^^^^^^
+===========================
Backup your ``app/config/parameters.yml`` file.
Empty ``var/cache`` folder.
-You must run some SQL queries to upgrade your database. We assume that the table prefix is ``wallabag_`` and the database server is a MySQL one:
+You must run some SQL queries to upgrade your database. We assume that the table prefix is ``wallabag_``. Don't forgete to backup your database before migrating.
-.. code-block:: sql
+You may encounter issues with indexes names: if so, please change queries with the correct index name.
+`You can find all the queries here <http://doc.wallabag.org/en/master/user/query-upgrade-21-22.html>`_.
+***************************
Upgrade from 2.0.x to 2.1.1
----------------------------
+***************************
.. warning::
Before this migration, if you configured the Pocket import by adding your consumer key in Internal settings, please do a backup of it: you'll have to add it into the Config page after the upgrade.
Upgrade on a dedicated web server
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+=================================
::
php bin/console cache:clear --env=prod
Upgrade on a shared hosting
-^^^^^^^^^^^^^^^^^^^^^^^^^^^
+===========================
Backup your ``app/config/parameters.yml`` file.
ALTER TABLE `wallabag_config` ADD `pocket_consumer_key` VARCHAR(255) DEFAULT NULL;
DELETE FROM `wallabag_craue_config_setting` WHERE `name` = 'pocket_consumer_key';
+*****************
From wallabag 1.x
------------------
+*****************
There is no automatic script to update from wallabag 1.x to wallabag 2.x. You need to: