Files
help365/platform/upgrading-postgresql-standalone-10-to-15.html
koziavin 00717a92fb
All checks were successful
Deploy Static Site / deploy (push) Successful in 6m6s
update
2025-05-29 16:42:45 +04:00

250 lines
22 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html>
<html lang="en">
<head>
<title>Updating standalone PostgreSQL 10 in BRIX</title>
<meta name="generator" content="Help+Manual" />
<meta name="keywords" content="" />
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="When updating PostgreSQL to a major version, the utility &nbsp;is used. It allows updating the data stored in PostgreSQL data files to a later version of PostgreSQL." />
<meta name="picture" content="" />
<meta property="og:type" content="website" />
<meta property="og:title" content="Full documentation for BRIX365 platform. Low-code developer guide. User guide. Admin guide. Developer guide." />
<meta property="og:url" content="https://brix365.com/en/help" />
<meta property="og:image" content="" />
<link rel="icon" href="favicon.png" type="image/png" />
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet" />
<link rel="stylesheet" href="./jquery-ui.min.css" />
<link rel="stylesheet" href="default.css" />
<link rel="stylesheet" href="./search-yandex.css" />
<link rel="stylesheet" href="./article.css" />
<link rel="stylesheet" href="./glossary.css" />
<link rel="stylesheet" href="./theme.css" />
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="helpman_settings.js"></script>
<script type="text/javascript" src="helpman_topicinit.js"></script>
<script type="text/javascript" src="highlight.js"></script>
<script type="text/javascript">
$(document).ready(function(){highlight();});
</script>
</head>
<body>
<script>!function(e,t,c,n,r,a,m){e.ym=e.ym||function(){(e.ym.a=e.ym.a||[]).push(arguments)},e.ym.l=1*new Date;for(var s=0;s<document.scripts.length;s++)if(document.scripts[s].src===n)return;a=t.createElement(c),m=t.getElementsByTagName(c)[0],a.async=1,a.src=n,m.parentNode.insertBefore(a,m)}(window,document,"script","https://mc.yandex.ru/metrika/tag.js"),ym(83179930,"init",{clickmap:!0,trackLinks:!0,accurateTrackBounce:!0,webvisor:!0})</script><noscript><div><img alt=""src=https://mc.yandex.ru/watch/83179930 style=position:absolute;left:-9999px></div></noscript>
<header class="header elma-365">
<div class="container">
<a class="header__logo" href="https://brix365.com/en/help">
<img src="./logo-en.svg" alt="header logo">
</a>
<!-- <div class="hero__search-form" id="search-panel">
<form class="search-form" onsubmit="ym(83180416,'reachGoal','poisk')">
<label class="search-form__label">
<span id="reset-search" class="search__icon"></span>
<input class="search-form__input" type="text">
</label>
<input class="search-form__submit" type="submit" value="Submit">
</form>
</div> -->
<div class="hero__search-form" id="search-panel"> <form class="search-form"> <label class="search-form__label"> <span id="reset-search" class="search__icon"></span> <input class="search-form__input" type="text"> </label> <input class="search-form__submit" type="submit" value="Submit"> </form> </div>
<div class="hero__search">
<a href="#" id="search-icon" class="hero__search-icon">
<img src="search-icon-white.svg" alt="search string">
</a>
<a href="#" id="side-menu-icon" class="hero__side-icon">
<img src="side_menu.svg" alt="side menu">
</a>
</div>
<div class="header__navi">
<ul class="header__list"><li><span class="solution-select"><span class="solution-select__selected"></span><svg width="7" height="4" viewBox="0 0 7 4" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M1 1L3.5 3.5L6 1" stroke="white" stroke-linecap="round" stroke-linejoin="round"/></svg><ul class="solution-select__list"><li><a class="project-link" href="https://brix365.com/en/help/platform/get-trial.html">Platform</a></li><li><a class="project-link" href="https://brix365.com/en/help/ecm/ecm-functions.html">ECM</a></li><li><a class="project-link" href="https://brix365.com/en/help/crm/crm_overview.html">CRM</a></li><li><a class="project-link" href="https://brix365.com/en/help/service/service-functions.html">Service</a></li><li><a class="project-link" href="https://brix365.com/en/help/projects/projects-functions.html">Projects</a></li><li><a class="project-link" href="https://brix365.com/en/help/business_solutions/-elma365-store.html">Business Solutions</a></li></ul></span></li><li><a href="https://api.brix365.com/en/" target="_blank">API</a></li><li><a href="https://tssdk.brix365.com/" target="_blank">SDK</a></li></ul>
</div>
</div>
</header>
<main class="main container">
<aside class="sidebar" id="sidebar">
<div class="sidebar__header">
<a class="header__logo" href="https://brix365.com/en/help">
<img src="./logo-light-en.svg">
</a>
<span class="sidebar__close elma-365-close" id="close"></span>
</div>
<div class="sidebar__wrapper" id="side-menu">
</div>
</aside>
<article class="article" id="article">
<div class="article-inner">
<div class="content">
<header class="article__header">
<div class="article__bread" style="display:flex; gap:10px;">
<span id="subcategory" class="search-res__item-category search-res__item-category_subcategory subcategory article__badge"></span>
<div class="topic__breadcrumbs">
<p><a href="elma365-on-premises.html">BRIX On-Premises</a> &gt; <a href="infrastructure-preparation.html">Prepare infrastructure</a> &gt; Databases &gt; <a href="discontinued-postgresql-support.html">Discontinued PostgreSQL support</a> / Updating standalone PostgreSQL 10 in BRIX</p>
</div>
</div>
<div class="topic__title"><h1 class="p_Heading1"><span class="f_Heading1">Updating standalone PostgreSQL 10 in BRIX</span></h1>
</div>
</header>
<section class="article__content">
<div class="scroll-top-inner">
<a href="#h1-article" class="scroll-top"></a>
</div>
<!-- Placeholder for topic body. -->
<p class="p_Normal">When updating PostgreSQL to a major version, the utility <code><b>pg_upgrade</b></code> is used. It allows updating the data stored in PostgreSQL data files to a later version of PostgreSQL.</p>
<p class="p_Normal">The update of standalone PostgreSQL consists of six steps:</p>
<ol style="list-style-type:decimal">
<li value="1" class="p_Normal"><a href="upgrading-postgresql-standalone-10-to-15.html#database-backup" class="topiclink">Database backup</a>.</li><li value="2" class="p_Normal"><a href="upgrading-postgresql-standalone-10-to-15.html#install-postgresql15" class="topiclink">Installation of PostgreSQL 15</a>.</li><li value="3" class="p_Normal"><a href="upgrading-postgresql-standalone-10-to-15.html#updating-data" class="topiclink">Updating data in the database directory</a>.</li><li value="4" class="p_Normal"><a href="upgrading-postgresql-standalone-10-to-15.html#updating-configuration" class="topiclink">Configuration update</a>.</li><li value="5" class="p_Normal"><a href="upgrading-postgresql-standalone-10-to-15.html#check-after-installing" class="topiclink">Post-installation check</a>.</li></ol>
<h2 class="p_Heading2"><a id="database-backup" class="hmanchor"></a><span class="f_Heading2">Step 1. Database backup</span></h2>
<p class="p_Normal">Before performing any actions related to the update, create a backup of the data and PostgreSQL configuration. Read more about how to do this in <a href="database-backup-and-recovery.html" class="topiclink">Backup and recover databases</a>.</p>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">начало&nbsp;внимание</span></p>
<p class="p_Normal">If there are third-party databases on the PostgreSQL server, their backups also need to be created.</p>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">конец&nbsp;внимание</span></p>
<p class="p_Normal"><a class="dropdown-toggle" style="font-style: normal; font-weight: normal; color: #000000; background-color: transparent; text-decoration: none;" href="javascript:HMToggle('toggle','TOGGLE0186A1')">Backup of the PostgreSQL database without using the elma365-backupper utility:</a></p>
<div id="TOGGLE0186A1" class="dropdown-toggle-body" style="text-align: left; text-indent: 0; line-height: 1.80; padding: 0 0 0 0; margin: 0 0 0 0;"><table style="border:none; border-spacing:0;">
<tr>
<td style="vertical-align:top; padding:0; border:none"><p class="p_Normal">You can create a backup of the <code><b>elma365</b></code> database using the <code><b>pg_dump</b></code>:</p>
<p class="p_Normal">&nbsp;</p>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">sudo&nbsp;-u&nbsp;postgres&nbsp;pg_dump&nbsp;elma365&nbsp;-Fc&nbsp;&gt;&nbsp;path/to/elma365.bak&nbsp;</span></p>
</td>
</tr>
</table>
</div>
<h2 class="p_Heading2"><a id="install-postgresql15" class="hmanchor"></a><span class="f_Heading2">Step 2. Installation of PostgreSQL 15</span></h2>
<p class="p_Normal">Use the package manager of your operating system to install PostgreSQL 15 on the server where version 10 is installed:</p>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">sudo&nbsp;apt&nbsp;install&nbsp;postgresql-15</span></p>
<h2 class="p_Heading2"><a id="updating-data" class="hmanchor"></a><span class="f_Heading2">Step 3. Updating data in the database directory</span></h2>
<ol style="list-style-type:upper-roman">
<li value="1" class="p_Normal">Stop PostgreSQL to keep its data inaccessible during the update:</li></ol>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">sudo&nbsp;systemctl&nbsp;stop&nbsp;postgresql@10&nbsp;postgresql@15</span></p>
<ol style="list-style-type:upper-roman">
<li value="2" class="p_Normal" style="line-height: 1.20;">Ensure that both PostgreSQL 10 and PostgreSQL 15 clusters are stopped:</li></ol>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">pg_lsclusters</span></p>
<ol style="list-style-type:upper-roman">
<li value="3" class="p_Normal" style="line-height: 1.20;">On the server, perform a check for database configuration compatibility:</li></ol>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">sudo&nbsp;-iu&nbsp;postgres&nbsp;/usr/lib/postgresql/15/bin/pg_upgrade&nbsp;\</span><br />
<span class="f_CodeExample">-o&nbsp;&quot;-c&nbsp;config_file=/etc/postgresql/10/main/postgresql.conf&quot;&nbsp;\</span><br />
<span class="f_CodeExample">-O&nbsp;&quot;-c&nbsp;config_file=/etc/postgresql/15/main/postgresql.conf&quot;&nbsp;\</span><br />
<span class="f_CodeExample">--old-datadir=/var/lib/postgresql/10/main/&nbsp;\</span><br />
<span class="f_CodeExample">--new-datadir=/var/lib/postgresql/15/main/&nbsp;\</span><br />
<span class="f_CodeExample">--old-bindir=/usr/lib/postgresql/10/bin&nbsp;\</span><br />
<span class="f_CodeExample">--new-bindir=/usr/lib/postgresql/15/bin&nbsp;--check</span></p>
<p class="p_Normal" style="line-height: 1.20;">where:</p>
<ul style="list-style-type:disc">
<li class="p_Normal"><code><b>/usr/lib/postgresql/10/bin</b></code> and <code><b>/usr/lib/postgresql/15/bin</b></code> are the paths to the binary files of PostgreSQL versions 10 and 15;</li><li class="p_Normal"><code><b>/var/lib/postgresql/10/main</b></code> and <code><b>/var/lib/postgresql/15/main</b></code> are the paths to the data directories.</li></ul>
<ol style="list-style-type:upper-roman">
<li value="4" class="p_Normal" style="line-height: 1.20;">On the server, perform the transfer of data from PostgreSQL 10 to PostgreSQL 15:</li></ol>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">sudo&nbsp;-iu&nbsp;postgres&nbsp;/usr/lib/postgresql/15/bin/pg_upgrade&nbsp;\</span><br />
<span class="f_CodeExample">-o&nbsp;&quot;-c&nbsp;config_file=/etc/postgresql/10/main/postgresql.conf&quot;&nbsp;\</span><br />
<span class="f_CodeExample">-O&nbsp;&quot;-c&nbsp;config_file=/etc/postgresql/15/main/postgresql.conf&quot;&nbsp;\</span><br />
<span class="f_CodeExample">--old-datadir=/var/lib/postgresql/10/main/&nbsp;\</span><br />
<span class="f_CodeExample">--new-datadir=/var/lib/postgresql/15/main/&nbsp;\</span><br />
<span class="f_CodeExample">--old-bindir=/usr/lib/postgresql/10/bin&nbsp;\</span><br />
<span class="f_CodeExample">--new-bindir=/usr/lib/postgresql/15/bin</span></p>
<p class="p_Normal">where:</p>
<ul style="list-style-type:disc">
<li class="p_Normal"><code><b>/usr/lib/postgresql/10/bin</b></code> and <code><b>/usr/lib/postgresql/15/bin</b></code> are the paths to the binary files of PostgreSQL versions 10 and 15;</li><li class="p_Normal"><code><b>/var/lib/postgresql/10/main</b></code> and <code><b>/var/lib/postgresql/15/main</b></code> are the paths to the data directories.</li></ul>
<h2 class="p_Heading2"><a id="updating-configuration" class="hmanchor"></a><span class="f_Heading2">Step 4. Configuration update</span></h2>
<ol style="list-style-type:upper-roman">
<li value="1" class="p_Normal" style="line-height: 1.20;">Update the PostgreSQL 15 configuration settings according to the configuration used in PostgreSQL 10:</li></ol>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">sudo&nbsp;nano&nbsp;/etc/postgresql/15/main/postgresql.conf</span><br />
<span class="f_CodeExample">sudo&nbsp;nano&nbsp;/etc/postgresql/15/main/pg_hba.conf</span></p>
<ol style="list-style-type:upper-roman">
<li value="2" class="p_Normal" style="line-height: 1.20;">Run PostgreSQL 15:</li></ol>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">sudo&nbsp;systemctl&nbsp;start&nbsp;postgresql@15</span></p>
<h2 class="p_Heading2"><a id="check-after-installing" class="hmanchor"></a><span class="f_Heading2">Step 5. Post-installation check</span></h2>
<ol style="list-style-type:upper-roman">
<li value="1" class="p_Normal">Check PostgreSQL database status:</li></ol>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">sudo&nbsp;systemctl&nbsp;status&nbsp;postgresql</span></p>
<ol style="list-style-type:upper-roman">
<li value="2" class="p_Normal" style="line-height: 1.20;">Ensure that PostgreSQL 15 is ready to receive connections from clients: </li></ol>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">sudo&nbsp;pg_isready</span></p>
<div class="bottom-nav">
<a id="prev-link" class="topic__navi_prev" href="discontinued-postgresql-support.html">
<span class="bottom-nav__arrow bottom-nav__arrow--prev"></span> <span
class="bottom-nav__link">discontinued-postgresql-support.html</span>
</a>
<a id="next-link" class="topic__navi_next" href="upgrading-postgresql-cluster-10-to-15.html">
<span class="bottom-nav__link">upgrading-postgresql-cluster-10-to-15.html</span> <span
class="bottom-nav__arrow bottom-nav__arrow--next"></span>
</a>
</div>
<!-- добавляет на страницу строку блок Была ли статья полезной? -->
<div class="feedback" id="feedback"><div class="feedback-help"><span><b>Was this helpful?</b></span><form action="" method="POST" class="feedback-form" id="feedback-form"><div class="feedback__popup feedback__popup-response" id="feedback__popup_thx" style="display: none;">Thanks for your feedback!</div><div class="feedback__popup" id="feedback__popup_why" style="display: none;"><div class="feedback__popup-header">Please specify why:</div><input type="radio" name="category" id="bad_recommendation" value="bad_recommendation"><label for="bad_recommendation">Recommendations did not help me</label><input type="radio" name="category" id="difficult_text" value="difficult_text"><label for="difficult_text">Article is hard to understand</label><input type="radio" name="category" id="no_answer" value="no_answer"><label for="no_answer">Didn`t answer my question</label><input type="radio" name="category" id="bad_header" value="bad_header"><label for="bad_header">Content does not match the topic</label><input type="radio" name="category" id="other_reason" value="other_reason"><label for="other_reason">Other</label></div><div class="feedback__popup" id="feedback__popup-other" style="display: none;"><div class="feedback__popup-header">How we can improve it?</div><textarea class="feedback__textarea" name="other" id=""></textarea><input type="submit" class="feedback__other-btn" value="Submit"></div><div class="feedback-form__btn-group"><input type="radio" name="useful" id="feedback__useful_yes" value="true"><label for="feedback__useful_yes"><img src="like.svg" class="small-img" alt="like"><spanclass="feedback-form__btn-group_yes-btn">Yes</spanclass="feedback-form__btn-group_yes-btn"></label><input type="radio" name="useful" id="feedback__useful_no" value="false"><label for="feedback__useful_no"><img src="dislike.svg" class="small-img" alt="dislike"><spanclass="feedback-form__btn-group_no-btn">No</spanclass="feedback-form__btn-group_no-btn"></label></div><select name="category"><option disabled="">Please specify why</option><option value="bad_recommendation" selected="">Recommendations did not help me</option><option value="difficult_text">Article is hard to understand</option><option value="no_answer">Didn`t answer my question</option><option value="bad_header">Content does not match the topic</option><option value="other_reason">Other</option></select><input type="submit"></form></div><div class="found_typo"><p style="margin: 0px; margin-top: 16px !important;"><span><b>Found a typo?</b></span> Select it and press <i>Ctrl+Enter</i> to send us feedback</p></div></div>
</section>
</div>
<aside class="article__sidebar" style="display:none">
<input type="checkbox" />
<div class="article__arrow"></div>
<div class="table-of-contents elma365-right" id="toc2Content">
<h3 class="h3-toc">In this topic</h3>
<nav id="toc2"></nav>
</div>
</aside>
</div>
</article>
</main>
<footer class="footer">
<div class="footer-container">
<div class="footer-mobile">
<ul class="footer-mobile__list"><li><a href="https://brix365.com/en/" target="_blank">BRIX</a></li><li><a href="https://tssdk.brix365.com/en/latest/" target="_blank">SDK</a></li><li><a href="https://api.brix365.com/en/" target="_blank">API</a></li></ul><ul class="footer-mobile__list"><li><a href="https://brix365.com/en/help/platform/get-trial.html">Platform</a></li><li><a href="https://brix365.com/en/help/ecm/ecm-functions.html">ECM</a></li><li><a href="https://brix365.com/en/help/service/service-functions.html">Service</a></li><li><a href="https://brix365.com/en/help/projects/projects-functions.html">Projects</a></li></ul>
</div>
<div class="footer-wrap">
<div><span class="mobile-question-popup">Send feedback</span><form method="POST" action class="question__popup question-xs" id="question__popup"><div class="question-wrap"><span class="close"></span><span class="title">Ask a question</span><label for="help_question" style="display: none;"></label><textarea name="help_question" id="help_question"></textarea><input type="submit" value="Send"></div></form><div class="hidden fade-in question-success-xs">Sent</div></div>
<div class="footer-flex-b">
<span class="footer-copy">&copy; 2025 BRIX</span>
<ul class="footer-list">
<li class="footer-item">
<a href="#" class="arrow-top" style="display: block;"></a>
</li>
</ul>
</div>
</div>
</div>
</footer>
<iframe name="hmnavigation" style="display:none!important"></iframe>
<script src="./jquery-ui.js"></script>
<!--script src="//cdn.jsdelivr.net/npm/featherlight@1.7.14/release/featherlight.min.js" type="text/javascript" charset="utf-8"></script-->
<script src="./jquery.tocify.min.js"></script>
<script src="./TypoReporter.min.js"></script>
<script src="./google-search.js"></script>
<script src="./main.js"></script>
<script type="text/javascript">
HMInitToggle('TOGGLE0186A1','hm.type','dropdown','hm.state','0');
</script>
</body>
</html>