Skip to content

Commit

Permalink
Update instructions for pg 14
Browse files Browse the repository at this point in the history
  • Loading branch information
jonels-msft committed Oct 1, 2021
1 parent f5cc766 commit f4a037f
Show file tree
Hide file tree
Showing 7 changed files with 64 additions and 64 deletions.
16 changes: 8 additions & 8 deletions admin_guide/upgrading_citus.rst
Original file line number Diff line number Diff line change
Expand Up @@ -20,15 +20,15 @@ To upgrade a Citus version to its latest patch, issue a standard upgrade command
.. code-block:: bash
sudo apt-get update
sudo apt-get install --only-upgrade postgresql-13-citus-10.2
sudo apt-get install --only-upgrade postgresql-14-citus-10.2
sudo service postgresql restart
**Fedora, CentOS, or Red Hat**

.. code-block:: bash
sudo yum update citus102_13
sudo service postgresql-13 restart
sudo yum update citus102_14
sudo service postgresql-14 restart
.. _major_minor_upgrade:

Expand Down Expand Up @@ -92,7 +92,7 @@ After installing the new package and restarting the database, run the extension

.. _upgrading_postgres:

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

.. note::
Expand All @@ -102,16 +102,16 @@ Upgrading PostgreSQL version from 12 to 13
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/12/data`
:code:`export OLD_PG_DATA=/opt/pgsql/13/data`

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

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

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

For Every Node
--------------
Expand Down
42 changes: 21 additions & 21 deletions extra/enterprise-ms-sku.rst
Original file line number Diff line number Diff line change
Expand Up @@ -141,9 +141,9 @@ Debian/Ubuntu
.. code:: bash
sudo apt-get update
# Change to postgresql-12-citus-enterprise-10.2 if you want to install Citus for
# PostgreSQL 12
sudo apt-get install -y postgresql-13-citus-enterprise-10.2
# Change to postgresql-13-citus-enterprise-10.2 if you want to install Citus for
# PostgreSQL 13
sudo apt-get install -y postgresql-14-citus-enterprise-10.2
Redhat/CentOS
~~~~~~~~~~~~~
Expand All @@ -153,8 +153,8 @@ remove the old package
.. code:: bash
# Change to citus-enterprise102_12 for PostgreSQL 12)
sudo yum install -y citus-enterprise102_13
# Change to citus-enterprise102_13 for PostgreSQL 13)
sudo yum install -y citus-enterprise102_14
.. _sku_setup:
Expand All @@ -165,17 +165,17 @@ Run the Citus Enterprise setup
This is different from previous Citus Enterprise installation instructions.
Use ``citus-enterprise-pg-12-setup`` when installing for Postgres 12
Use ``citus-enterprise-pg-13-setup`` when installing for Postgres 13
.. code:: bash
sudo citus-enterprise-pg-13-setup
sudo citus-enterprise-pg-14-setup
# Non-interactive version
# IMPORTANT: you accept the license and encryption disclaimer here
sudo CITUS_ACCEPT_LICENSE=YES \
CITUS_ACCEPT_ENCRYPTION_DISCLAIMER=YES \
CITUS_LICENSE_KEY=<INSERT LICENSE KEY HERE> \
citus-enterprise-pg-13-setup
citus-enterprise-pg-14-setup
.. _sku_use:
Expand All @@ -197,7 +197,7 @@ $$$$$$$$$$$$$
.. code:: bash
# preload citus extension
sudo pg_conftool 13 main set shared_preload_libraries citus
sudo pg_conftool 14 main set shared_preload_libraries citus
Continue by following the standard multi-machine Debian/Ubuntu installation.
Start at step 3: :ref:`Configure connection and authentication
Expand All @@ -209,11 +209,11 @@ $$$$$$
.. code:: bash
# initialize system database (using RHEL 6 vs 7 method as necessary)
sudo service postgresql-13 initdb || \
sudo /usr/pgsql-13/bin/postgresql-13-setup initdb
sudo service postgresql-14 initdb || \
sudo /usr/pgsql-14/bin/postgresql-14-setup initdb
# preload citus extension
echo "shared_preload_libraries = 'citus'" | \
sudo tee -a /var/lib/pgsql/13/data/postgresql.conf
sudo tee -a /var/lib/pgsql/14/data/postgresql.conf
Continue by following the standard multi-machine Debian/Ubuntu installation.
Start at step 3: :ref:`Configure connection and authentication
Expand Down Expand Up @@ -241,9 +241,9 @@ first stop the running pg_auto_failover service
.. code:: bash
sudo apt-get update
# Change to postgresql-12-auto-failover-enterprise-1.3 if you want to
# install pg_auto_failover for PostgreSQL 12
sudo apt-get install -y postgresql-13-auto-failover-enterprise-1.3
# Change to postgresql-13-auto-failover-enterprise-1.3 if you want to
# install pg_auto_failover for PostgreSQL 13
sudo apt-get install -y postgresql-14-auto-failover-enterprise-1.3
Redhat/CentOS
~~~~~~~~~~~~~
Expand All @@ -253,8 +253,8 @@ the running pg_auto_failover service and remove the old package
.. code:: bash
# Change to pg-auto-failover-enterprise13_12 for PostgreSQL 12
sudo yum install -y pg-auto-failover-enterprise13_13
# Change to pg-auto-failover-enterprise13_13 for PostgreSQL 13
sudo yum install -y pg-auto-failover-enterprise13_14
.. _sku_failover_setup:
Expand All @@ -266,19 +266,19 @@ Run the pg_auto_failover enterprise setup
This is different from previous pg_auto_failover enterprise installation
instructions.
Use ``pg-auto-failover-enterprise-pg-12-setup`` when installing for
Postgres 12.
Use ``pg-auto-failover-enterprise-pg-13-setup`` when installing for
Postgres 13.
.. code:: bash
sudo pg-auto-failover-enterprise-pg-13-setup
sudo pg-auto-failover-enterprise-pg-14-setup
# Non-interactive version
# IMPORTANT: you accept the license and encryption disclaimer here. The
# encryption disclaimer is specific to pg_auto_failover, so be sure to read
# and understand it even if you have read the one for Citus already.
sudo PGAUTOFAILOVER_ACCEPT_LICENSE=YES \
PGAUTOFAILOVER_ACCEPT_ENCRYPTION_DISCLAIMER=YES \
PGAUTOFAILOVER_LICENSE_KEY=<INSERT LICENSE KEY HERE> \
pg-auto-failover-enterprise-pg-13-setup
pg-auto-failover-enterprise-pg-14-setup
.. _pgautofailover_sku_use:
32 changes: 16 additions & 16 deletions extra/enterprise.rst
Original file line number Diff line number Diff line change
Expand Up @@ -25,10 +25,10 @@ Ubuntu or Debian with Internet Access
sudo CITUS_REPO_TOKEN=XYZ bash
# install the server and initialize db
sudo apt-get install -y postgresql-13-citus-enterprise-10.2
sudo apt-get install -y postgresql-14-citus-enterprise-10.2
# preload citus extension
sudo pg_conftool 13 main set shared_preload_libraries citus
sudo pg_conftool 14 main set shared_preload_libraries citus
3. Continue by following the standard :ref:`multi-machine debian <post_enterprise_deb>` installation steps, **starting at step 3.**

Expand All @@ -46,7 +46,7 @@ Ubuntu or Debian without Internet Access
sudo CITUS_REPO_TOKEN=XYZ bash
sudo apt-get clean
sudo apt-get install -y --download-only postgresql-13-citus-enterprise-10.2
sudo apt-get install -y --download-only postgresql-14-citus-enterprise-10.2
# go to package downloads
cd /var/cache/apt
Expand All @@ -68,7 +68,7 @@ Ubuntu or Debian without Internet Access
sudo dpkg -i -R /tmp/citus
# preload citus extension
sudo pg_conftool 13 main set shared_preload_libraries citus
sudo pg_conftool 14 main set shared_preload_libraries citus
5. Continue by following the standard :ref:`multi-machine debian <post_enterprise_deb>` installation steps, **starting at step 3.**

Expand All @@ -88,14 +88,14 @@ Fedora, CentOS, or Red Hat with Internet Access
sudo CITUS_REPO_TOKEN=XYZ bash
# install PostgreSQL with Citus extension
sudo yum install -y citus-enterprise102_13
sudo yum install -y citus-enterprise102_14
# initialize system database (using RHEL 6 vs 7 method as necessary)
sudo service postgresql-13 initdb || \
sudo /usr/pgsql-13/bin/postgresql-13-setup initdb
sudo service postgresql-14 initdb || \
sudo /usr/pgsql-14/bin/postgresql-14-setup initdb
# preload citus extension
echo "shared_preload_libraries = 'citus'" | \
sudo tee -a /var/lib/pgsql/13/data/postgresql.conf
sudo tee -a /var/lib/pgsql/14/data/postgresql.conf
3. Continue by following the standard :ref:`multi-machine rhel <post_enterprise_rhel>` installation steps, **starting at step 3.**

Expand All @@ -113,7 +113,7 @@ Fedora, CentOS, or Red Hat without Internet Access
sudo CITUS_REPO_TOKEN=XYZ bash
# get package
sudo yum install --downloadonly --downloaddir=. citus-enterprise102_13
sudo yum install --downloadonly --downloaddir=. citus-enterprise102_14
# put them into a tarball
tar czf ~/citus-enterprise.tar.gz *.rpm
Expand All @@ -132,11 +132,11 @@ Fedora, CentOS, or Red Hat without Internet Access
sudo rpm -ivh /tmp/citus/*.rpm
# initialize system database (using RHEL 6 vs 7 method as necessary)
sudo service postgresql-13 initdb || \
sudo /usr/pgsql-13/bin/postgresql-13-setup initdb
sudo service postgresql-14 initdb || \
sudo /usr/pgsql-14/bin/postgresql-14-setup initdb
# preload citus extension
echo "shared_preload_libraries = 'citus'" | \
sudo tee -a /var/lib/pgsql/13/data/postgresql.conf
sudo tee -a /var/lib/pgsql/14/data/postgresql.conf
5. Continue by following the standard :ref:`multi-machine rhel <post_enterprise_rhel>` installation steps, **starting at step 3.**

Expand All @@ -159,7 +159,7 @@ Ubuntu or Debian
sudo CITUS_REPO_TOKEN=XYZ bash
# Install enterprise packages, which will remove community packages
sudo apt-get install -y postgresql-13-citus-enterprise-X.Y
sudo apt-get install -y postgresql-14-citus-enterprise-X.Y
# substitute X.Y with the version currently installed ^^^^^
Expand Down Expand Up @@ -192,17 +192,17 @@ Fedora, CentOS, or Red Hat
# remove community packages
# substitute XY with the version currently installed
sudo yum remove -y citusXY_13
sudo yum remove -y citusXY_14
# Install enterprise packages
# substitute XY with the version previously installed
sudo yum install -y citus-enterpriseXY_13
sudo yum install -y citus-enterpriseXY_14
4. Restart the database.

.. code-block:: bash
sudo service postgresql-13 restart
sudo service postgresql-14 restart
5. Update the Citus extension

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-13-citus-10.2
sudo apt-get -y install postgresql-14-citus-10.2

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

This installs centralized configuration in `/etc/postgresql/13/main`, and creates a database in `/var/lib/postgresql/13/main`.
This installs centralized configuration in `/etc/postgresql/14/main`, and creates a database in `/var/lib/postgresql/14/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 13 main set listen_addresses '*'
sudo pg_conftool 14 main set listen_addresses '*'

::

sudo vi /etc/postgresql/13/main/pg_hba.conf
sudo vi /etc/postgresql/14/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 citus102_13
sudo yum install -y citus102_14
# initialize system database (using RHEL 6 vs 7 method as necessary)
sudo service postgresql-13 initdb || sudo /usr/pgsql-13/bin/postgresql-13-setup initdb
sudo service postgresql-14 initdb || sudo /usr/pgsql-14/bin/postgresql-14-setup initdb
# preload citus extension
echo "shared_preload_libraries = 'citus'" | sudo tee -a /var/lib/pgsql/13/data/postgresql.conf
echo "shared_preload_libraries = 'citus'" | sudo tee -a /var/lib/pgsql/14/data/postgresql.conf

PostgreSQL adds version-specific binaries in `/usr/pgsql-13/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-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.

.. _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/13/data/postgresql.conf
sudo vi /var/lib/pgsql/14/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/13/data/pg_hba.conf
sudo vi /var/lib/pgsql/14/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-13 restart
sudo service postgresql-14 restart
# and make it start automatically when computer does
sudo chkconfig postgresql-13 on
sudo chkconfig postgresql-14 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 13 and the Citus extension**
**1. Install PostgreSQL 14 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-13-citus-10.2
sudo apt-get -y install postgresql-14-citus-10.2
.. _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/13/bin
export PATH=$PATH:/usr/lib/postgresql/14/bin
cd ~
mkdir citus
Expand Down

0 comments on commit f4a037f

Please sign in to comment.