Skip to content

Commit

Permalink
Bump pg version
Browse files Browse the repository at this point in the history
  • Loading branch information
jonels-msft committed Oct 18, 2022
1 parent 566f6fd commit f555162
Show file tree
Hide file tree
Showing 5 changed files with 32 additions and 32 deletions.
26 changes: 13 additions & 13 deletions admin_guide/upgrading_citus.rst
Original file line number Diff line number Diff line change
Expand Up @@ -13,22 +13,22 @@ Upgrading the Citus version requires first obtaining the new Citus extension and
Patch Version Upgrade
---------------------

To upgrade a Citus version to its latest patch, issue a standard upgrade command for your package manager. Assuming version 11.1 is currently installed on Postgres 14:
To upgrade a Citus version to its latest patch, issue a standard upgrade command for your package manager. Assuming version 11.1 is currently installed on Postgres 15:

**Ubuntu or Debian**

.. code-block:: bash
sudo apt-get update
sudo apt-get install --only-upgrade postgresql-14-citus-11.1
sudo apt-get install --only-upgrade postgresql-15-citus-11.1
sudo service postgresql restart
**Fedora, CentOS, or Red Hat**

.. code-block:: bash
sudo yum update citus111_14
sudo service postgresql-14 restart
sudo yum update citus111_15
sudo service postgresql-15 restart
.. _major_minor_upgrade:

Expand All @@ -46,23 +46,23 @@ Each major and minor version of Citus is published as a package with a separate
Step 1. Update Citus Package
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

If upgrading both Citus and Postgres, always be sure to upgrade the Citus extension first, and the PostgreSQL version second (see :ref:`upgrading_postgres`). Here is how to do a Citus upgrade from 10.2 to 11.1 on Postgres 13:
If upgrading both Citus and Postgres, always be sure to upgrade the Citus extension first, and the PostgreSQL version second (see :ref:`upgrading_postgres`). Here is how to do a Citus upgrade from 10.2 to 11.1 on Postgres 14:

**Ubuntu or Debian**

.. code-block:: bash
sudo apt-get update
sudo apt-get install postgresql-13-citus-11.1
sudo apt-get install postgresql-14-citus-11.1
sudo service postgresql restart
**Fedora, CentOS, or Red Hat**

.. code-block:: bash
# Fedora, CentOS, or Red Hat
sudo yum swap citus102_13 citus111_13
sudo service postgresql-13 restart
sudo yum swap citus102_14 citus111_14
sudo service postgresql-14 restart
Step 2. Apply Update in DB
~~~~~~~~~~~~~~~~~~~~~~~~~~
Expand Down Expand Up @@ -102,7 +102,7 @@ After installing the new package and restarting the database, run the extension

.. _upgrading_postgres:

Upgrading PostgreSQL version from 13 to 14
Upgrading PostgreSQL version from 14 to 15
##########################################

.. note::
Expand All @@ -115,16 +115,16 @@ Upgrading PostgreSQL version from 13 to 14
Record the following paths before you start (your actual paths may be different than those below):

Existing data directory (e.g. /opt/pgsql/10/data)
:code:`export OLD_PG_DATA=/opt/pgsql/13/data`
:code:`export OLD_PG_DATA=/opt/pgsql/14/data`

Existing PostgreSQL installation path (e.g. /usr/pgsql-10)
:code:`export OLD_PG_PATH=/usr/pgsql-13`
:code:`export OLD_PG_PATH=/usr/pgsql-14`

New data directory after upgrade
:code:`export NEW_PG_DATA=/opt/pgsql/14/data`
:code:`export NEW_PG_DATA=/opt/pgsql/15/data`

New PostgreSQL installation path
:code:`export NEW_PG_PATH=/usr/pgsql-14`
:code:`export NEW_PG_PATH=/usr/pgsql-15`

For Every Node
--------------
Expand Down
10 changes: 5 additions & 5 deletions installation/multi_node_debian.rst
Original file line number Diff line number Diff line change
Expand Up @@ -26,12 +26,12 @@ Steps to be executed on all nodes
::

# install the server and initialize db
sudo apt-get -y install postgresql-14-citus-11.1
sudo apt-get -y install postgresql-15-citus-11.1

# preload citus extension
sudo pg_conftool 14 main set shared_preload_libraries citus
sudo pg_conftool 15 main set shared_preload_libraries citus

This installs centralized configuration in `/etc/postgresql/14/main`, and creates a database in `/var/lib/postgresql/14/main`.
This installs centralized configuration in `/etc/postgresql/15/main`, and creates a database in `/var/lib/postgresql/15/main`.

.. _post_enterprise_deb:

Expand All @@ -41,11 +41,11 @@ Before starting the database let's change its access permissions. By default the

::

sudo pg_conftool 14 main set listen_addresses '*'
sudo pg_conftool 15 main set listen_addresses '*'

::

sudo vi /etc/postgresql/14/main/pg_hba.conf
sudo vi /etc/postgresql/15/main/pg_hba.conf

::

Expand Down
16 changes: 8 additions & 8 deletions installation/multi_node_rhel.rst
Original file line number Diff line number Diff line change
Expand Up @@ -26,13 +26,13 @@ Steps to be executed on all nodes
::

# install PostgreSQL with Citus extension
sudo yum install -y citus111_14
sudo yum install -y citus111_15
# initialize system database (using RHEL 6 vs 7 method as necessary)
sudo service postgresql-14 initdb || sudo /usr/pgsql-14/bin/postgresql-14-setup initdb
sudo service postgresql-15 initdb || sudo /usr/pgsql-15/bin/postgresql-15-setup initdb
# preload citus extension
echo "shared_preload_libraries = 'citus'" | sudo tee -a /var/lib/pgsql/14/data/postgresql.conf
echo "shared_preload_libraries = 'citus'" | sudo tee -a /var/lib/pgsql/15/data/postgresql.conf

PostgreSQL adds version-specific binaries in `/usr/pgsql-14/bin`, but you'll usually just need psql, whose latest version is added to your path, and managing the server itself can be done with the *service* command.
PostgreSQL adds version-specific binaries in `/usr/pgsql-15/bin`, but you'll usually just need psql, whose latest version is added to your path, and managing the server itself can be done with the *service* command.

.. _post_enterprise_rhel:

Expand All @@ -42,7 +42,7 @@ Before starting the database let's change its access permissions. By default the

::

sudo vi /var/lib/pgsql/14/data/postgresql.conf
sudo vi /var/lib/pgsql/15/data/postgresql.conf

::

Expand All @@ -51,7 +51,7 @@ Before starting the database let's change its access permissions. By default the

::

sudo vi /var/lib/pgsql/14/data/pg_hba.conf
sudo vi /var/lib/pgsql/15/data/pg_hba.conf

::

Expand All @@ -71,9 +71,9 @@ Before starting the database let's change its access permissions. By default the
::

# start the db server
sudo service postgresql-14 restart
sudo service postgresql-15 restart
# and make it start automatically when computer does
sudo chkconfig postgresql-14 on
sudo chkconfig postgresql-15 on

You must add the Citus extension to **every database** you would like to use in a cluster. The following example adds the extension to the default database which is named `postgres`.

Expand Down
6 changes: 3 additions & 3 deletions installation/single_node_debian.rst
Original file line number Diff line number Diff line change
Expand Up @@ -7,15 +7,15 @@ Ubuntu or Debian

This section describes the steps needed to set up a single-node Citus cluster on your own Linux machine from deb packages.

**1. Install PostgreSQL 14 and the Citus extension**
**1. Install PostgreSQL 15 and the Citus extension**

.. code-block:: sh
# Add Citus repository for package manager
curl https://install.citusdata.com/community/deb.sh | sudo bash
# install the server and initialize db
sudo apt-get -y install postgresql-14-citus-11.1
sudo apt-get -y install postgresql-15-citus-11.1
.. _post_install:
Expand All @@ -30,7 +30,7 @@ Let's create a new database on disk. For convenience in using PostgreSQL Unix do
sudo su - postgres
# include path to postgres binaries
export PATH=$PATH:/usr/lib/postgresql/14/bin
export PATH=$PATH:/usr/lib/postgresql/15/bin
cd ~
mkdir citus
Expand Down
6 changes: 3 additions & 3 deletions installation/single_node_rhel.rst
Original file line number Diff line number Diff line change
Expand Up @@ -7,15 +7,15 @@ Fedora, CentOS, or Red Hat

This section describes the steps needed to set up a single-node Citus cluster on your own Linux machine from RPM packages.

**1. Install PostgreSQL 14 and the Citus extension**
**1. Install PostgreSQL 15 and the Citus extension**

.. code-block:: sh
# Add Citus repository for package manager
curl https://install.citusdata.com/community/rpm.sh | sudo bash
# install Citus extension
sudo yum install -y citus111_14
sudo yum install -y citus111_15
.. _post_install:

Expand All @@ -29,7 +29,7 @@ Let's create a new database on disk. For convenience in using PostgreSQL Unix do
sudo su - postgres
# include path to postgres binaries
export PATH=$PATH:/usr/pgsql-14/bin
export PATH=$PATH:/usr/pgsql-15/bin
cd ~
mkdir citus
Expand Down

0 comments on commit f555162

Please sign in to comment.