diff options
Diffstat (limited to 'docs/fr/user/upgrade.rst')
-rw-r--r-- | docs/fr/user/upgrade.rst | 82 |
1 files changed, 53 insertions, 29 deletions
diff --git a/docs/fr/user/upgrade.rst b/docs/fr/user/upgrade.rst index 9aaa7782..1a824854 100644 --- a/docs/fr/user/upgrade.rst +++ b/docs/fr/user/upgrade.rst | |||
@@ -3,41 +3,53 @@ Mettre à jour votre installation de wallabag | |||
3 | 3 | ||
4 | Vous trouverez ici différentes manières de mettre à jour wallabag : | 4 | Vous trouverez ici différentes manières de mettre à jour wallabag : |
5 | 5 | ||
6 | - `de la 2.1.x à la 2.2.x <#mettre-a-jour-de-la-2-1-x-a-la-2-2-x>`_ | ||
6 | - `de la 2.0.x à la 2.1.1 <#mettre-a-jour-de-la-2-0-x-a-la-2-1-1>`_ | 7 | - `de la 2.0.x à la 2.1.1 <#mettre-a-jour-de-la-2-0-x-a-la-2-1-1>`_ |
7 | - `de la 2.1.x à la 2.1.y <#mettre-a-jour-de-la-2-1-x-a-la-2-1-y>`_ | ||
8 | - `de la 1.x à la 2.x <#depuis-wallabag-1-x>`_ | 8 | - `de la 1.x à la 2.x <#depuis-wallabag-1-x>`_ |
9 | 9 | ||
10 | Mettre à jour de la 2.0.x à la 2.1.1 | 10 | Mettre à jour de la 2.1.x à la 2.2.x |
11 | ------------------------------------ | 11 | ------------------------------------ |
12 | 12 | ||
13 | .. warning:: | ||
14 | Avant cette migration, si vous aviez configuré l'import depuis Pocket en ajoutant votre consumer key dans les paramètres internes, pensez à effectuer une sauvegarde de celle-ci : vous devrez l'ajouter dans la configuration de wallabag après la mise à jour. | ||
15 | |||
16 | Mise à jour sur un serveur dédié | 13 | Mise à jour sur un serveur dédié |
17 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | 14 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
18 | 15 | ||
19 | :: | 16 | :: |
20 | 17 | ||
21 | rm -rf var/cache/* | 18 | make update |
22 | git fetch origin | 19 | |
23 | git fetch --tags | 20 | Explications à propos des migrations de base de données |
24 | git checkout 2.1.1 --force | 21 | """"""""""""""""""""""""""""""""""""""""""""""""""""""" |
25 | SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist | 22 | |
26 | php bin/console doctrine:migrations:migrate --env=prod | 23 | Durant la mise à jour, nous exécutons des migrations de base de données. |
27 | php bin/console cache:clear --env=prod | 24 | |
25 | Toutes les migrations de base de données sont stockées dans le dossier ``app/DoctrineMigrations``. Vous pouvez exécuter chaque migration individuellement : | ||
26 | ``bin/console doctrine:migrations:migrate 20161001072726 --env=prod``. | ||
27 | |||
28 | Voici la liste des migrations de la 2.1.x à la 2.2.0 : | ||
29 | |||
30 | * ``20161001072726``: ajout de clés étrangères pour la réinitialisation de compte | ||
31 | * ``20161022134138``: conversion de la base de données à l'encodage ``utf8mb4`` (pour MySQL uniquement) | ||
32 | * ``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 | ||
33 | * ``20161031132655``: ajout du paramètre interne pour activer/désactiver le téléchargement des images | ||
34 | * ``20161104073720``: ajout de l'index ``created_at`` sur la table ``entry`` | ||
35 | * ``20161106113822``: ajout du champ ``action_mark_as_read`` sur la table ``config`` | ||
36 | * ``20161117071626``: ajout du paramètre interne pour partager ses articles vers unmark.it | ||
37 | * ``20161118134328``: ajout du champ ``http_status`` sur la table ``entry`` | ||
38 | * ``20161122144743``: ajout du paramètre interne pour activer/désactiver la récupération d'articles derrière un paywall | ||
39 | * ``20161122203647``: suppression des champs ``expired`` et ``credentials_expired`` sur la table ``user`` | ||
28 | 40 | ||
29 | Mise à jour sur un hébergement mutualisé | 41 | Mise à jour sur un hébergement mutualisé |
30 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | 42 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
31 | 43 | ||
32 | Effectuez une sauvegarde du fichier ``app/config/parameters.yml``. | 44 | Effectuez une sauvegarde du fichier ``app/config/parameters.yml``. |
33 | 45 | ||
34 | Téléchargez la version 2.1.1 de wallabag : | 46 | Téléchargez la dernière version de wallabag : |
35 | 47 | ||
36 | .. code-block:: bash | 48 | .. code-block:: bash |
37 | 49 | ||
38 | wget https://framabag.org/wallabag-release-2.1.1.tar.gz && tar xvf wallabag-release-2.1.1.tar.gz | 50 | wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package |
39 | 51 | ||
40 | (hash md5 de l'archive 2.1.1 : ``9584a3b60a2b2a4de87f536548caac93``) | 52 | Vous trouverez `le hash md5 du dernier package sur notre site <https://www.wallabag.org/pages/download-wallabag.html>`_. |
41 | 53 | ||
42 | Décompressez l'archive dans votre répertoire d'installation et remplacez le fichier ``app/config/parameters.yml`` avec le votre. | 54 | Décompressez l'archive dans votre répertoire d'installation et remplacez le fichier ``app/config/parameters.yml`` avec le votre. |
43 | 55 | ||
@@ -51,38 +63,38 @@ Vous allez devoir également exécuter des requêtes SQL pour mettre à jour vot | |||
51 | 63 | ||
52 | .. code-block:: sql | 64 | .. code-block:: sql |
53 | 65 | ||
54 | ALTER TABLE `wallabag_entry` ADD `uuid` LONGTEXT DEFAULT NULL; | ||
55 | INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('share_public', '1', 'entry'); | ||
56 | ALTER TABLE `wallabag_oauth2_clients` ADD name longtext COLLATE 'utf8_unicode_ci' DEFAULT NULL; | ||
57 | INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('import_with_redis', '0', 'import'); | ||
58 | INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('import_with_rabbitmq', '0', 'import'); | ||
59 | ALTER TABLE `wallabag_config` ADD `pocket_consumer_key` VARCHAR(255) DEFAULT NULL; | ||
60 | DELETE FROM `wallabag_craue_config_setting` WHERE `name` = 'pocket_consumer_key'; | ||
61 | 66 | ||
62 | Mettre à jour de la 2.1.x à la 2.1.y | 67 | Mettre à jour de la 2.0.x à la 2.1.1 |
63 | ------------------------------------ | 68 | ------------------------------------ |
64 | 69 | ||
70 | .. warning:: | ||
71 | Avant cette migration, si vous aviez configuré l'import depuis Pocket en ajoutant votre consumer key dans les paramètres internes, pensez à effectuer une sauvegarde de celle-ci : vous devrez l'ajouter dans la configuration de wallabag après la mise à jour. | ||
72 | |||
65 | Mise à jour sur un serveur dédié | 73 | Mise à jour sur un serveur dédié |
66 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | 74 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
67 | 75 | ||
68 | 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 : | ||
69 | |||
70 | :: | 76 | :: |
71 | 77 | ||
72 | make update | 78 | rm -rf var/cache/* |
79 | git fetch origin | ||
80 | git fetch --tags | ||
81 | git checkout 2.1.1 --force | ||
82 | SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist | ||
83 | php bin/console doctrine:migrations:migrate --env=prod | ||
84 | php bin/console cache:clear --env=prod | ||
73 | 85 | ||
74 | Mise à jour sur un hébergement mutualisé | 86 | Mise à jour sur un hébergement mutualisé |
75 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | 87 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
76 | 88 | ||
77 | Effectuez une sauvegarde du fichier ``app/config/parameters.yml``. | 89 | Effectuez une sauvegarde du fichier ``app/config/parameters.yml``. |
78 | 90 | ||
79 | Téléchargez la dernière version de wallabag : | 91 | Téléchargez la version 2.1.1 de wallabag : |
80 | 92 | ||
81 | .. code-block:: bash | 93 | .. code-block:: bash |
82 | 94 | ||
83 | wget https://wllbg.org/latest-v2-package && tar xvf latest-v2-package | 95 | wget http://framabag.org/wallabag-release-2.1.1.tar.gz && tar xvf wallabag-release-2.1.1.tar.gz |
84 | 96 | ||
85 | Vous trouverez `le hash md5 du dernier package sur notre site <https://www.wallabag.org/pages/download-wallabag.html>`_. | 97 | (hash md5 de l'archive 2.1.1 : ``9584a3b60a2b2a4de87f536548caac93``) |
86 | 98 | ||
87 | Décompressez l'archive dans votre répertoire d'installation et remplacez le fichier ``app/config/parameters.yml`` avec le votre. | 99 | Décompressez l'archive dans votre répertoire d'installation et remplacez le fichier ``app/config/parameters.yml`` avec le votre. |
88 | 100 | ||
@@ -92,6 +104,18 @@ Si vous utilisez SQLite, vous devez également conserver le contenu du répertoi | |||
92 | 104 | ||
93 | Videz le répertoire ``var/cache``. | 105 | Videz le répertoire ``var/cache``. |
94 | 106 | ||
107 | 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 : | ||
108 | |||
109 | .. code-block:: sql | ||
110 | |||
111 | ALTER TABLE `wallabag_entry` ADD `uuid` LONGTEXT DEFAULT NULL; | ||
112 | INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('share_public', '1', 'entry'); | ||
113 | ALTER TABLE `wallabag_oauth2_clients` ADD name longtext COLLATE 'utf8_unicode_ci' DEFAULT NULL; | ||
114 | INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('import_with_redis', '0', 'import'); | ||
115 | INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('import_with_rabbitmq', '0', 'import'); | ||
116 | ALTER TABLE `wallabag_config` ADD `pocket_consumer_key` VARCHAR(255) DEFAULT NULL; | ||
117 | DELETE FROM `wallabag_craue_config_setting` WHERE `name` = 'pocket_consumer_key'; | ||
118 | |||
95 | Depuis wallabag 1.x | 119 | Depuis wallabag 1.x |
96 | ------------------- | 120 | ------------------- |
97 | 121 | ||