This section describes how to upgrade in-use instances of the Alteryx® databases for a working deployment of the Designer Cloud Powered by Trifacta platform.
When you upgrade to a new release of the platform, the underlying databases and their structures are automatically migrated to the new format. However, the database releases are not touched.
In this example, Postgres 9.3 is upgraded to Postgres 9.6.
- The installing user must have write permissions to the directory from which the commands are executed.
- The installing user must have sudo privileges.
- Verify that you know the host and port number for each database.
Before you begin, please verify that you have a valid backup of each Alteryx database. See Backup and Recovery.
Acquire Distribution and Port Information
Before you begin, you must:
- Acquire the port information for the current database. Typically, this value is
- Acquire the latest distribution for the database software.
For more information, see Install the Databases.
Upgrade for PostgreSQL
This procedure describes the process for upgrading the PostgreSQL version in use by the Alteryx databases. This procedure assumes the following:
- Source version: PostgreSQL 9.3
- Upgrade version: PostgreSQL 9.6
- All current databases are co-located with the software on the Alteryx node.
- Some downtime of the databases during the upgrade process is ok.
Before You Begin
- If you haven't already, please back up each database and all PostgreSQL configuration files. See Backup and Recovery.
- Login to the node where the databases are hosted.
Upgrade for CentOS/RHEL
- Install the upgraded version. Below, PostgreSQL 9.6 is installed.
For CentOS 6.x:
wget https://download.postgresql.org/pub/repos/yum/9.6/redhat/rhel-6-x86_64/pgdg-centos96-9.6-10.noarch.rpm sudo yum -y install pgdg-centos96-9.6-10.noarch.rpm
For CentOS 7.x:
wget https://download.postgresql.org/pub/repos/yum/9.6/redhat/rhel-7-x86_64/pgdg-centos96-9.6-10.noarch.rpm sudo yum -y install pgdg-centos96-9.6-10.noarch.rpm
For Red Hat Enterprise Linux 6.x:
wget https://download.postgresql.org/pub/repos/yum/9.6/redhat/rhel-6-x86_64/pgdg-centos96-9.6-10.noarch.rpm sudo yum -y install pgdg-redhat96-9.6-10.noarch.rpm
For Red Hat Enterprise Linux 7.x:
wget https://download.postgresql.org/pub/repos/yum/9.6/redhat/rhel-7-x86_64/pgdg-centos96-9.6-10.noarch.rpm sudo yum -y install pgdg-redhat96-9.6-10.noarch.rpm
Create a new data directory for the new database version:
For CentOS 7.x:
sudo /usr/pgsql-9.6/bin/postgresql96-setup initdb
For CentOS 6.x, RHEL 6.x:
sudo service postgresql-9.6 initdb
For RHEL 7.x:
sudo /usr/pgsql-9.6/bin/postgresql96-setup initdb
Use the following commands to verify that the upgrade is possible:
su postgres cd ~ /usr/pgsql-9.6/bin/pg_upgrade --old-bindir=/usr/pgsql-9.3/bin/ --new-bindir=/usr/pgsql-9.6/bin/ --old-datadir=/var/lib/pgsql/9.3/data/ --new-datadir=/var/lib/pgsql/9.6/data/ --check
If all is well, you should see a
Clusters are compatiblemessage.
- Stop the old version of the database service as the root user:
sudo service postgresql-9.3 stop
- Run the upgrade as the
su postgres /usr/pgsql-9.6/bin/pg_upgrade --old-bindir=/usr/pgsql-9.3/bin/ --new-bindir=/usr/pgsql-9.6/bin/ --old-datadir=/var/lib/pgsql/9.3/data/ --new-datadir=/var/lib/pgsql/9.6/data/
Upgrade for Ubuntu
For Ubuntu 14.04 (Trusty)
Stop the platform:
service trifacta stop
Install the upgraded version. Below, PostgreSQL 9.6 is installed.
sudo apt-get install postgresql-9.6 postgresql-server-dev-9.6 postgresql-contrib-9.6 -y
sudo systemctl stop postgresql service stop postgresql service postgresql stop
Upgrade the PostgreSQL 9.3 version to PostgreSQL 9.6, using the newly installed version:NOTE: Below, some values are too long for a single line. Single lines that overflow to additional lines are marked with a
\. The backslash should not be included if the line is used as input.
sudo su - postgres -c '/usr/lib/postgresql/9.6/bin/pg_upgrade \ -b /usr/lib/postgresql/9.3/bin -B /usr/lib/postgresql/9.6/bin \ -d /var/lib/postgresql/9.3/main/ -D /var/lib/postgresql/9.6/main/ \ -O "-c config_file=/etc/postgresql/9.6/main/postgresql.conf" \ -o "-c config_file=/etc/postgresql/9.3/main/postgresql.conf"
Remove the old version of PostgreSQL (9.3):
sudo apt-get remove postgresql-9.3 -y
Review the PostgreSQL configuration file, and make any changes as necessary:
- To apply this configuration change, login as an administrator to the Alteryx node. Then, edit
trifacta-conf.json. For more information, see Platform Configuration Methods.
- Replace all instances of the PostgreSQL port number for the earlier version and replace with the desired port number for the upgrade version.
- By default, PostgreSQL 9.3 uses
- By default, PostgreSQL 9.6 uses
- Make the above changes and save the file.
Restart PostgreSQL and the platform:
service postgresql start service trifacta start
- Verify that you can load datasets and run jobs. See Verify Operations.
For Ubuntu 16.04 (Xenial)
For more information on upgrading PostgreSQL on Ubuntu 16.04 (Xenial), please contact Alteryx Support.
Transfer settings from the configuration files for your old database version to the new one. Please review the old and new versions of these files:
NOTE: It is risky to perform a straight copy of these configuration files. Settings may change. New ones may be introduced. Setting values specific to to the installation may be overwritten in a copy. Please retain a backup of both versions of each file before migrating settings.
Path to PostgreSQL 9.3 file Path to PostgreSQL 9.6 file
- Start the service:
sudo service postgresql-9.6 start
sudo service postgresql start
When the service restarts, you can check the cluster status using the following script:
After you have completed the database installation, you must review the port number of the newly installed database, which may have changed between versions of the database software. That new port number must be applied through the Alteryx software. For more information, see Change Database Port.
- If all is well, restart the platform. See Start and Stop the Platform.
Verify and Cleanup
- Verify operations on all four database:
- Login to the application. See Login.
- Load a dataset from Flow View. See Flow View Page.
- Run a job. See Run Job Page.
- Schedule a job and execute it. See Add Schedule Dialog.
If all of the above tests pass, you can use the following script to delete the old PostgreSQL version and its data directory:
- Restart the Designer Cloud Powered by Trifacta platform. See Start and Stop the Platform.
Upgrade for MySQL
Upgrading the databases for MySQL is not supported in this release. Please start with a clean install of the databases on MySQL.
This page has no comments.