diff --git a/docs/de/user/upgrade.rst b/docs/de/user/upgrade.rst index fbbf29f45..51cdf0554 100644 --- a/docs/de/user/upgrade.rst +++ b/docs/de/user/upgrade.rst @@ -3,10 +3,67 @@ wallabag-Installation aktualisieren Du wirst hier mehrere Wege finden, um deine wallabag zu aktualisieren: +- `von 2.1.x zu 2.2.x <#upgrade-von-2-1-x-zu-2-2-x>`_ - `von 2.0.x zu 2.1.1 <#upgrade-von-2-0-x-zu-2-1-1>`_ -- `von 2.1.x zu 2.1.y <#upgrade-von-2-1-x-zu-2-1-y>`_ - `von 1.x zu 2.x <#upgrade-von-1-x>`_ +Upgrade von 2.1.x zu 2.2.x +-------------------------- + +Upgrade auf einem dedizierten Webserver +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +:: + + make update + +Explanations about database migrations +"""""""""""""""""""""""""""""""""""""" + +During the update, we execute database migrations. + +All the database migrations are stored in ``app/DoctrineMigrations``. You can execute each migration individually: +``bin/console doctrine:migrations:migrate 20161001072726 --env=prod``. + +Here is the migrations list for 2.1.x to 2.2.0 release: + +* ``20161001072726``: added foreign keys for account resetting +* ``20161022134138``: converted database to ``utf8mb4`` encoding (for MySQL only) +* ``20161024212538``: added ``user_id`` column on ``oauth2_clients`` to prevent users to delete API clients from other users +* ``20161031132655``: added the internal setting to enable/disable downloading pictures +* ``20161104073720``: added ``created_at`` index on ``entry`` table +* ``20161106113822``: added ``action_mark_as_read`` field on ``config`` table +* ``20161117071626``: added the internal setting to share articles to unmark.it +* ``20161118134328``: added ``http_status`` field on ``entry`` table +* ``20161122144743``: added the internal setting to enable/disable fetching articles with paywall +* ``20161122203647``: dropped ``expired`` and ``credentials_expired`` fields on ``user`` table + +Upgrade auf einem Shared Hosting +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Sichere deine ``app/config/parameters.yml``-Datei. + +Lade das letzte Release von wallabag herunter: + +.. code-block:: bash + + wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package + +Du findest den `aktuellen MD5-Hash auf unserer Webseite `_. + +Extrahiere das Archiv in deinen wallabag-Ordner und ersetze die ``app/config/parameters.yml`` mit deiner. + +Bitte überprüfe, dass deine ``app/config/parameters.yml`` alle notwendigen Parameter enthält. Eine Dokumentation darüber `findest du hier `_. + +Falls du SQLite nutzt, musst du außerdem deinen ``data/``-Ordner in die neue Installation kopieren. + +Leere den ``var/cache``-Ordner. + +Du musst einige SQL-Abfragen durchführen, um deine Datenbank zu aktualisieren. Wir gehen in diesem Fall davon aus, dass das Tabellenpräfix ``wallabag_`` ist und eine MySQL-Datenbank verwendet wird: + +.. code-block:: sql + + Upgrade von 2.0.x zu 2.1.1 --------------------------- @@ -36,7 +93,7 @@ Lade das 2.1.1-Release von wallabag herunter: .. code-block:: bash - wget https://framabag.org/wallabag-release-2.1.1.tar.gz && tar xvf wallabag-release-2.1.1.tar.gz + wget http://framabag.org/wallabag-release-2.1.1.tar.gz && tar xvf wallabag-release-2.1.1.tar.gz (md5 hash of the 2.1.1 package: ``9584a3b60a2b2a4de87f536548caac93``) @@ -60,39 +117,6 @@ Du musst einige SQL-Abfragen durchführen, um deine Datenbank zu aktualisieren. ALTER TABLE `wallabag_config` ADD `pocket_consumer_key` VARCHAR(255) DEFAULT NULL; DELETE FROM `wallabag_craue_config_setting` WHERE `name` = 'pocket_consumer_key'; -Upgrade von 2.1.x zu 2.1.y ------------------------------ - -Upgrade auf einem dedizierten Webserver -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Um deine wallabag-Installation auf die letzte Version zu aktualisieren, führe den folgenden Befehl in deinem wallabag-Ordner aus: - -:: - - make update - -Upgrade auf einem Shared Hosting -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Sichere deine ``app/config/parameters.yml``-Datei. - -Lade das letzte Release von wallabag herunter: - -.. code-block:: bash - - wget https://wllbg.org/latest-v2-package && tar xvf latest-v2-package - -Du findest den `aktuellen MD5-Hash auf unserer Webseite `_. - -Extrahiere das Archiv in deinen wallabag-Ordner und ersetze die ``app/config/parameters.yml`` mit deiner. - -Bitte überprüfe, dass deine ``app/config/parameters.yml`` alle notwendigen Parameter enthält. Eine Dokumentation darüber `findest du hier `_. - -Falls du SQLite nutzt, musst du außerdem deinen ``data/``-Ordner in die neue Installation kopieren. - -Leere den ``var/cache``-Ordner. - Upgrade von 1.x --------------- @@ -100,4 +124,4 @@ Es gibt kein automatisiertes Skript, um wallabag 1.x auf wallabag 2.x zu aktuali - deine Daten exportieren - wallabag 2.x installieren (Dokumentation `_ ) -- die Daten in die neue Installation importieren (`Dokumentation `_ ) \ No newline at end of file +- die Daten in die neue Installation importieren (`Dokumentation `_ ) diff --git a/docs/en/user/upgrade.rst b/docs/en/user/upgrade.rst index 5d8641398..4def03cbb 100644 --- a/docs/en/user/upgrade.rst +++ b/docs/en/user/upgrade.rst @@ -20,13 +20,14 @@ Upgrade on a dedicated web server Explanations about database migrations """""""""""""""""""""""""""""""""""""" +During the update, we execute database migrations. + All the database migrations are stored in ``app/DoctrineMigrations``. You can execute each migration individually: ``bin/console doctrine:migrations:migrate 20161001072726 --env=prod``. +Here is the migrations list for 2.1.x to 2.2.0 release: -Here are the migrations for 2.1.x to 2.2.0 release: - -* ``20161001072726``: added foreign keys for for account resetting +* ``20161001072726``: added foreign keys for account resetting * ``20161022134138``: converted database to ``utf8mb4`` encoding (for MySQL only) * ``20161024212538``: added ``user_id`` column on ``oauth2_clients`` to prevent users to delete API clients from other users * ``20161031132655``: added the internal setting to enable/disable downloading pictures @@ -62,13 +63,6 @@ You must run some SQL queries to upgrade your database. We assume that the table .. code-block:: sql - ALTER TABLE `wallabag_entry` ADD `uuid` LONGTEXT DEFAULT NULL; - INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('share_public', '1', 'entry'); - ALTER TABLE `wallabag_oauth2_clients` ADD name longtext COLLATE 'utf8_unicode_ci' DEFAULT NULL; - INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('import_with_redis', '0', 'import'); - INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('import_with_rabbitmq', '0', 'import'); - ALTER TABLE `wallabag_config` ADD `pocket_consumer_key` VARCHAR(255) DEFAULT NULL; - DELETE FROM `wallabag_craue_config_setting` WHERE `name` = 'pocket_consumer_key'; Upgrade from 2.0.x to 2.1.1 --------------------------- diff --git a/docs/fr/user/upgrade.rst b/docs/fr/user/upgrade.rst index 9aaa7782b..1a8248543 100644 --- a/docs/fr/user/upgrade.rst +++ b/docs/fr/user/upgrade.rst @@ -3,10 +3,67 @@ Mettre à jour votre installation de wallabag Vous trouverez ici différentes manières de mettre à jour wallabag : +- `de la 2.1.x à la 2.2.x <#mettre-a-jour-de-la-2-1-x-a-la-2-2-x>`_ - `de la 2.0.x à la 2.1.1 <#mettre-a-jour-de-la-2-0-x-a-la-2-1-1>`_ -- `de la 2.1.x à la 2.1.y <#mettre-a-jour-de-la-2-1-x-a-la-2-1-y>`_ - `de la 1.x à la 2.x <#depuis-wallabag-1-x>`_ +Mettre à jour de la 2.1.x à la 2.2.x +------------------------------------ + +Mise à jour sur un serveur dédié +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +:: + + make update + +Explications à propos des migrations de base de données +""""""""""""""""""""""""""""""""""""""""""""""""""""""" + +Durant la mise à jour, nous exécutons des migrations de base de données. + +Toutes les migrations de base de données sont stockées dans le dossier ``app/DoctrineMigrations``. Vous pouvez exécuter chaque migration individuellement : +``bin/console doctrine:migrations:migrate 20161001072726 --env=prod``. + +Voici la liste des migrations de la 2.1.x à la 2.2.0 : + +* ``20161001072726``: ajout de clés étrangères pour la réinitialisation de compte +* ``20161022134138``: conversion de la base de données à l'encodage ``utf8mb4`` (pour MySQL uniquement) +* ``20161024212538``: ajout de la colonne ``user_id`` sur la table ``oauth2_clients`` pour empêcher les utilisateurs de supprimer des clients API d'autres utilisateurs +* ``20161031132655``: ajout du paramètre interne pour activer/désactiver le téléchargement des images +* ``20161104073720``: ajout de l'index ``created_at`` sur la table ``entry`` +* ``20161106113822``: ajout du champ ``action_mark_as_read`` sur la table ``config`` +* ``20161117071626``: ajout du paramètre interne pour partager ses articles vers unmark.it +* ``20161118134328``: ajout du champ ``http_status`` sur la table ``entry`` +* ``20161122144743``: ajout du paramètre interne pour activer/désactiver la récupération d'articles derrière un paywall +* ``20161122203647``: suppression des champs ``expired`` et ``credentials_expired`` sur la table ``user`` + +Mise à jour sur un hébergement mutualisé +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Effectuez une sauvegarde du fichier ``app/config/parameters.yml``. + +Téléchargez la dernière version de wallabag : + +.. code-block:: bash + + wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package + +Vous trouverez `le hash md5 du dernier package sur notre site `_. + +Décompressez l'archive dans votre répertoire d'installation et remplacez le fichier ``app/config/parameters.yml`` avec le votre. + +Merci de vérifier que votre fichier ``app/config/parameters.yml`` contient tous les paramètres requis. Vous trouverez `ici une documentation détaillée concernant les paramètres `_. + +Si vous utilisez SQLite, vous devez également conserver le contenu du répertoire ``data/``. + +Videz le répertoire ``var/cache``. + +Vous allez devoir également exécuter des requêtes SQL pour mettre à jour votre base de données. Nous partons du principe que le préfixe de vos tables est ``wallabag_`` et que le serveur SQL est un serveur MySQL : + +.. code-block:: sql + + Mettre à jour de la 2.0.x à la 2.1.1 ------------------------------------ @@ -35,7 +92,7 @@ Téléchargez la version 2.1.1 de wallabag : .. code-block:: bash - wget https://framabag.org/wallabag-release-2.1.1.tar.gz && tar xvf wallabag-release-2.1.1.tar.gz + wget http://framabag.org/wallabag-release-2.1.1.tar.gz && tar xvf wallabag-release-2.1.1.tar.gz (hash md5 de l'archive 2.1.1 : ``9584a3b60a2b2a4de87f536548caac93``) @@ -59,39 +116,6 @@ Vous allez devoir également exécuter des requêtes SQL pour mettre à jour vot ALTER TABLE `wallabag_config` ADD `pocket_consumer_key` VARCHAR(255) DEFAULT NULL; DELETE FROM `wallabag_craue_config_setting` WHERE `name` = 'pocket_consumer_key'; -Mettre à jour de la 2.1.x à la 2.1.y ------------------------------------- - -Mise à jour sur un serveur dédié -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Pour mettre à jour votre installation de wallabag et récupérer la dernière version, exécutez la commande suivante dans votre répertoire d'installation : - -:: - - make update - -Mise à jour sur un hébergement mutualisé -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Effectuez une sauvegarde du fichier ``app/config/parameters.yml``. - -Téléchargez la dernière version de wallabag : - -.. code-block:: bash - - wget https://wllbg.org/latest-v2-package && tar xvf latest-v2-package - -Vous trouverez `le hash md5 du dernier package sur notre site `_. - -Décompressez l'archive dans votre répertoire d'installation et remplacez le fichier ``app/config/parameters.yml`` avec le votre. - -Merci de vérifier que votre fichier ``app/config/parameters.yml`` contient tous les paramètres requis. Vous trouverez `ici une documentation détaillée concernant les paramètres `_. - -Si vous utilisez SQLite, vous devez également conserver le contenu du répertoire ``data/``. - -Videz le répertoire ``var/cache``. - Depuis wallabag 1.x -------------------