Modifications pour le document Mettre à jour pgsql sur pgsql-prod

Modifié par Gaetan RETEL le 2025/10/05 00:22

Depuis la version 16.1
modifié par Gaetan RETEL
sur 2025/03/28 20:16
Commentaire de modification : Il n'y a aucun commentaire pour cette version
À la version 10.1
modifié par Gaetan RETEL
sur 2025/03/12 14:06
Commentaire de modification : Il n'y a aucun commentaire pour cette version

Résumé

Détails

Propriétés de la Page
Contenu
... ... @@ -2,6 +2,7 @@
2 2  
3 3  Les commandes listées ci dessous seront celles de la version que j'ai installée.
4 4  
5 +
5 5  {{toc/}}
6 6  
7 7  
... ... @@ -9,7 +9,6 @@
9 9  
10 10  == Précautions à prendre ==
11 11  
12 -
13 13  Avant de toucher à la BDD on va évidemment faire une sauvegarde, pour pouvoir remettre en état en cas de pépin. Pour cela on peut utiliser {{code language="none"}}pg_dumpall{{/code}}. Il va falloir faire deux sauvegarde, une avec le flag {{code language="none"}}--globals-only{{/code}} pour récupérer les users/roles/etc, et une autre pour récupérer les BDDs.
14 14  
15 15  {{warning}}
... ... @@ -53,7 +53,6 @@
53 53  
54 54  == Préparation des nouveaux clusters ==
55 55  
56 -
57 57  pour créer les nouveaux clusters, il faut commencer par regarder comment sont faits les anciens, pour qu'ils soient compatibles entre eux. L'encodage et le collationnement/type de caractères doivent être identiques.
58 58  
59 59  {{info}}
... ... @@ -70,7 +70,7 @@
70 70  )))
71 71  )))
72 72  
73 -Si vous n'avez jamais touché à postgreSQL, la commande pour sortir du terminal est {{code language="none"}}\q{{/code}}
72 +Si vous n'avez jamais touché à postgreSQL, la commande pour sortir du terminal est \q
74 74  
75 75  Ici, l'encodage est UTF-8 et le reste en C. Pour créer un cluster "main" utilisant pgsql 14 la commande est donc
76 76  
... ... @@ -117,12 +117,11 @@
117 117  Si vous voyez une ligne avec une tâche lancée par postgres, il faut l'arrêter. Voilà quelques commandes utiles :
118 118  
119 119  
120 -La commande suivante permet de stopper un cluster spécifique d'une version pgsql donnée : {{code language="none"}}pg_ctlcluster <version> <cluster_name> stop{{/code}}  (% id="cke_bm_63735S" style="display:none" %) (%%)(ou de démarrer avec {{code language="none"}}start{{/code}})
119 +La commande suivante permet de stopper un cluster spécifique d'une version pgsql donnée : {{code language="none"}}pg_ctlcluster 13 main stop{{/code}}  (% id="cke_bm_63735S" style="display:none" %) (%%)(ou de démarrer avec {{code language="none"}}start{{/code}})
121 121  
122 122  S'il y a toujours des tâches liés à postgres/des clusters qui tournent, vous pouvez forcer leur arrêt avec cette commande en indiquant leur PID (dans l'exemple avec root plus tôt, le PID est 5860) : {{code language="none"}}kill -9 <PID>{{/code}}
123 123  
124 124  
125 -
126 126  Une fois les processus stoppés, on peut lancer la commande.
127 127  
128 128  Pour passer de la version x à la version y, il faut le path des dossiers des exécutables et de data des version x et y, ainsi que le path du fichier .conf de postgres de chaque version.
... ... @@ -150,7 +150,6 @@
150 150  
151 151  == Lancer l'upgrade ==
152 152  
153 -
154 154  Si la commande avec le flag {{code language="none"}}--check{{/code}} à réussi, il n'y a plus qu'à la lancer sans. Pour autant, une erreur peut toujours survenir. Vérifiez une nouvelle fois que des tâches n'ont pas été redémarrées comme expliqué dans la précédente section.
155 155  
156 156  Assurez-vous qu'il y ait suffisamment de place sur la VM, toujours avec {{code language="none"}}df -h{{/code}}, les nouveaux clusters de la version 14 ont pris ~~5G.
... ... @@ -170,7 +170,7 @@
170 170  Il va donc falloir upgrader chaque cluster comme fait ci dessus, en remplaçant évidemment par le nom des clusters qui vous concernent.
171 171  
172 172  {{warning}}
173 -Attention, à la fin de l'upgrade d'un cluster, des fichiers vont être générés dans /var/lib/postgresql/, comme vous en informera la sortie de la commande.
170 +Attention, à la fin de l'upgrade d'un cluster, des fichiers vont être générés dans /var/lib/postgresql, comme vous en informera la sortie de la commande.
174 174  Si vous lancez l'upgrade de plusieurs clusters d'affilé, les fichiers du 2è clusters écraseront ceux du premier. Veillez à les récupérer avant, et à noter quel fichier correspond à quel cluster.
175 175  {{/warning}}
176 176  
... ... @@ -183,8 +183,6 @@
183 183  
184 184  == Mise en place des nouveaux clusters ==
185 185  
186 -
187 -
188 188  Une fois les nouveaux clusters terminés et les données migrées, il va falloir terminer la configuration.
189 189  
190 190  Ouvrez le fichier de configuration {{code language="none"}}pg_hba.conf{{/code}} de l'ancienne version, situé dans {{code language="none"}}/etc/postgresql/<old_version>/<cluster_name>/{{/code}}. À la fin du fichier, copiez la partie sur le login pour les BDDs, dont le début est indiqué par la ligne
... ... @@ -233,8 +233,6 @@
233 233  
234 234  == Mises à jour et optimisations ==
235 235  
236 -
237 -
238 238  Un fichier {{code language="none"}}update_extensions.sql{{/code}} a été généré par chaque commande {{code language="none"}}pg_upgrade{{/code}} lancée, on va maintenant pouvoir l'exécuter, ou lancer les commandes à la main. Pourquoi à la main ? Car de toute façon il est également fortement conseillé de ré-indexer les différentes BDDs de chaque clusters, ce qui demande d'accéder à toute les BDDs. Si l'envie vous prend de créer un script et automatiser ça, faites-vous plaisir.
239 239  
240 240  Il va donc falloir se rendre dans chaque cluster :
... ... @@ -259,7 +259,7 @@
259 259  )))
260 260  )))
261 261  
262 -Si pour ce cluster le fichier {{code language="none"}}update_extensions.sql{{/code}} généré par {{code language="none"}}pg_upgrade{{/code}} indiquait une mise à jour d'extension pour la BDD postgres, on peut en même temps copier coller la commande qui pourrait par exemple être :
255 +Si pour ce cluster le fichier {{code language="none"}}update_extensions.sql{{/code}} généré par {{code language="none"}}pg_upgrade{{/code}} pour ce cluster indiquait une mise à jour d'extension, on peut en même temps copier coller la commande qui pourrait par exemple être :
263 263  
264 264  (% class="box" %)
265 265  (((
... ... @@ -271,8 +271,6 @@
271 271  
272 272  == Redémarrer postgreSQL ==
273 273  
274 -
275 -
276 276  Une fois tout cela fait, il ne reste plus qu'à redémarrer postgreSQL :
277 277  
278 278  (% class="box" %)