Enterprise customers who use Scylla Manager 1.1.x are encouraged to upgrade to 1.2.x. For new installations please see Scylla Manager - Download and Install. The steps below instruct you how to upgrade the Scylla Manager server while keeping the manager datastore intact. If you are not running Scylla Manager 1.1.x, do not perform this upgrade procedure. This procedure only covers upgrades from Scylla Manager 1.1.x to 1.2.x.
Please contact Scylla Enterprise Support team with any question.
This upgrade brings internal changes incompatible with previous versions of Scylla Manager. We have removed the repair unit concept and replaced it with a repair task that can be tuned using simple glob based pattern matching. The pattern matching that is performed can be applied to filter out multiple keyspaces and tables as well as entire datacenters. A consequence of this is that custom repairs that previously were scheduled are removed during the upgrade and you may need to replace them. A weekly repair task will be scheduled for each existing cluster so repairs will be performed automatically.
The Scylla Manager API is now using HTTPS by default. Their default values have changed to 56443 for HTTPS and 56080 for plain HTTP.
The port can be changed as needed in /etc/scylla-manager/scylla-manager.yaml
Backup the data
Download and install new packages
Validate that the upgrade was successful
Before any major procedure, like an upgrade, it is recommended to backup all the data to an external device. It is recommended to backup the scylla_manager keyspace from Scylla Manager’s backend, following this backup procedure.
Before upgrading, check what version you are currently running now using rpm -q scylla-manager. You should use the same version that you had previously installed in case you want to rollback the upgrade.
To upgrade:
Update the Update the Scylla Manager repo: to 1.2.x
Run:
sudo yum update scylla-manager -y
Reload your shell execute the below command to reload sctool code completion.
source /etc/bash_completion.d/sctool.bash
Confirm that the upgrade changed the Client and Server version. Run sctool version and make sure both are 1.2.x version.
If you get an error from the version check then make sure that Scylla Manager is running with systemctl status scylla-manager.service. Confirm the service is active (running). If not, then start it with systemctl start scylla-manager.service.
Confirm that following the update, that your managed clusters are still present. Run sctool cluster list
Confirm that following the upgrade, there is one repair task in a NEW state for each existing cluster. Run sctool task list to list the repair tasks.
As part of the upgrade procudre, paramaters were changed in /etc/scylla-manager/scylla-manager.yaml. See the new values below. There is no need to update the scylla-manager.yaml file as part of the upgrade.
# Bind REST API to the specified TCP address using HTTP protocol.
# http: 127.0.0.1:56080
# Bind REST API to the specified TCP address using HTTPS protocol.
https: 127.0.0.1:56443
# TLS certificate file to use for HTTPS.
tls_cert_file: /var/lib/scylla-manager/scylla_manager.crt
# TLS key file to use for HTTPS.
tls_key_file: /var/lib/scylla-manager/scylla_manager.key
# Bind prometheus API to the specified TCP address using HTTP protocol.
# By default it binds to all network interfaces but you can restrict it
# by specifying it like this 127:0.0.1:56090 or any other combination
# of ip and port.
prometheus: ':56090'
The following procedure describes a rollback from Scylla Manager 1.2 to 1.1. Apply this procedure if an upgrade from 1.0 to 1.1 failed for any reason.
Warning: note that you may lose the manged clusters after downgrade. Should this happen, you will need to add the managed clusters clusters manually.
Downgrade to previous release
Start Scylla Manager
Valdate Scylla Manager version
Stop Scylla Manager
sudo systemctl stop scylla-manager
Drop the scylla_manager keyspace from the remote datastore
cqlsh -e "DROP KEYSPACE scylla_manager"
Remove Scylla Manager repo
sudo rm -rf /etc/yum.repos.d/scylla-manager.repo
sudo yum clean all
Update the Scylla Manager repo to 1.1.x
Install previous version
sudo yum downgrade scylla-manager scylla-manager-server scylla-manager-client -y
Start Scylla Manager to reinitialize the data base schema.
sudo systemctl start scylla-manager
Stop Scylla Manager to avoid issues while restoring the backup. If you did not perform any backup before upgrading then you are done now and can continue at “Start Scylla Manager”.
sudo systemctl stop scylla-manager
Restore the database backup if you performed a backup by following the instructions in Restore from a Backup. You can skip step 1 since the Scylla Manager has done this for you.
sudo systemctl start scylla-manager
Validate Scylla Manager version:
sctool version
The version should match with the results you had previously.