Legacy ClickHouse® Altinity Stable® Releases Install Guide

How to install the ClickHouse® Altinity Stable® Releases from packagecloud.io.

ClickHouse® Altinity Stable® Releases are specially vetted upstream builds of ClickHouse that Altinity certifies for production use. We track critical changes and verify against a series of tests to make sure they’re ready for your production environment. We take the steps to verify how to upgrade from previous versions, and what issues you might run into when transitioning your ClickHouse clusters to the next Stable Altinity ClickHouse release.

As of October 12, 2021, Altinity replaced the ClickHouse Altinity Stable Releases with the Altinity Stable Builds, providing longer support and validation. For more information, see Altinity Stable Builds.

Legacy versions of the ClickHouse Altinity Stable Releases are available from the Altinity ClickHouse Stable Release packagecloud.io repository, located at https://packagecloud.io/Altinity/altinity-stable.

The available Altinity ClickHouse Stable Releases from packagecloud.io for ClickHouse server, ClickHouse client and ClickHouse common versions are:

Altinity ClickHouse Stable Release 21.1.10.3
Altinity ClickHouse Stable Release 21.3.13.9
Altinity ClickHouse Stable Release 21.3.15.2
Altinity ClickHouse Stable Release 21.3.15.4

General Installation Instructions

When installing or upgrading from a previous version of legacy ClickHouse Altinity Stable Release, review the Release Notes for the version to install and upgrade to before starting. This will inform you of additional steps or requirements of moving from one version to the next.

Part of the installation procedures recommends you specify the version to install. The Release Notes lists the version numbers available for installation.

There are three main methods for installing the legacy ClickHouse Altinity Stable Releases:

DEB Packages
RPM Packages
Docker images

Altinity ClickHouse Stable Releases are distinguishable from upstream builds when displaying version information. The suffix altinitystable will be displayed after the version number:

select version()

┌─version()─────────────────┐
│ 21.3.15.2.altinitystable │
└───────────────────────────┘

Prerequisites

This guide assumes that the reader is familiar with Linux commands, permissions, and how to install software for their particular Linux distribution. The reader will have to verify they have the correct permissions to install the software in their target systems.

Installation Instructions

Legacy Altinity ClickHouse Stable Release DEB Builds

To install legacy ClickHouse Altinity Stable Release version DEB packages from packagecloud.io:

Update the apt-get repository with the following command:

curl -s https://packagecloud.io/install/repositories/Altinity/altinity-stable/script.deb.sh | sudo bash

ClickHouse can be installed either by specifying a specific version, or automatically going to the most current version. It is recommended to specify a version for maximum compatibility with existing clients.
1. To install a specific version, create a variable specifying the version to install and including it with the install command:
```
version=21.8.8.1.altinitystable
sudo apt-get install clickhouse-client=$version clickhouse-server=$version clickhouse-common-static=$version
```
1. To install the most current version of the legacy ClickHouse Altinity Stable release without specifying a specific version, leave out the version= command.
```
sudo apt-get install clickhouse-client clickhouse-server clickhouse-server-common
```
Restart server.

Installed packages are not applied to the already running server. It makes it convenient to install packages first and restart later when convenient.
```
sudo systemctl restart clickhouse-server
```

Legacy Altinity ClickHouse Stable Release RPM Builds

To install legacy ClickHouse Altinity Stable Release version RPM packages from packagecloud.io:

Update the yum package repository configuration with the following command:

curl -s https://packagecloud.io/install/repositories/Altinity/altinity-stable/script.rpm.sh | sudo bash

ClickHouse can be installed either by specifying a specific version, or automatically going to the most current version. It is recommended to specify a version for maximum compatibility with existing clients.
1. To install a specific version, create a variable specifying the version to install and including it with the install command:
```
version=version=21.8.8.1.altinitystable
sudo yum install clickhouse-client-${version} clickhouse-server-${version} clickhouse-server-common-${version}
```
1. To install the most current version of the legacy ClickHouse Altinity Stable release without specifying a specific version, leave out the version= command.
```
sudo yum install clickhouse-client clickhouse-server clickhouse-server-common
```

Restart the ClickHouse server.

sudo systemctl restart clickhouse-server