Enterprise customers who use Scylla Manager 1.2.x are encouraged to upgrade to 1.3.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.2.x, do not perform this upgrade procedure. This procedure only covers upgrades from Scylla Manager 1.2.x to 1.3.x.
Please contact Scylla Enterprise Support team with any questions.
This upgrade brings to sctool a new command: status. This command shows a listing of the individual nodes in the cluster and records the CQL availability on the nodes.
Health Check - This upgrade introduces a new feature where each node is monitored by Scylla Manager. When Scylla Manager detects that a node is down an alert message is sent to Scylla Monitoring. Alternitively, you can use the sctool status` command to show the live cluster status.
Automated health check - When a cluster is added a new health check task is automatically added to the cluster. Following an upgrade, all existing clusters will have an health check task as well.
The sctool argument interval-days has been renamed to interval as it now supports more granular time units. For example: 3d2h10m. The available time units are d, h, m, and s.
The sctool command cluster list no longer displays the host column in the results table. This was removed because it was easy to be mislead that this node was the only node being used. Adding a cluster (cluster add) still takes a --host argument, but when all the available nodes are discovered they are persisted and used for subsequent interactions with ScyllaDB.
Backup the data
Download and install new packages
Validate that the upgrade was successful
Scylla Manager server persists its data to a Scylla cluster (data store). Before upgrading, 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.3.x
Run:
sudo apt-get update
sudo apt-get dist-upgrade scylla-manager*
Restart the service
sudo systemctl restart scylla-manager.service
Reload your shell execute the below command to reload sctool code completion.
source /etc/bash_completion.d/sctool.bash
Check that Scylla Manager service is running with sudo systemctl status scylla-manager.service. Confirm the service is active (running). If not, then start it with systemctl start scylla-manager.service.
Confirm that the upgrade changed the Client and Server version. Run sctool version and make sure both are 1.3.x version. For example:
sctool version
Client version: 1.3.0-0.20181130.03ae248
Server version: 1.3.0-0.20181130.03ae248
Confirm that following the update, that your managed clusters are still present. Run sctool cluster list
sctool cluster list
╭──────────────────────────────────────┬──────────┬───────────────╮
│ cluster id │ name │ssh user │
├──────────────────────────────────────┼──────────┼───────────────┤
│ db7faf98-7cc4-4a08-b707-2bc59d65551e │ cluster │scylla-manager │
╰──────────────────────────────────────┴──────────┴───────────────╯
Confirm that following the upgrade, there is a healtcheck task for each existing cluster. Run sctool task list to list the tasks.
sctool task list -c cluster --all
╭──────────────────────────────────────────────────┬───────────────────────────────┬──────┬────────────┬────────╮
│ task │ next run │ ret. │ properties │ status │
├──────────────────────────────────────────────────┼───────────────────────────────┼──────┼────────────┼────────┤
│ healthcheck/afe9a610-e4c7-4d05-860e-5a0ddf14d7aa │ 10 Dec 18 20:21 UTC (+15s) │ 0 │ │ RUNNING│
│ repair/4d79ee63-7721-4105-8c6a-5b98c65c3e21 │ 12 Dec 18 00:00 UTC (+7d) │ 3 │ │ NEW │
╰──────────────────────────────────────────────────┴───────────────────────────────┴──────┴────────────┴────────╯
The following procedure describes a rollback from Scylla Manager 1.3 to 1.2. Apply this procedure if an upgrade from 1.2 to 1.3 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/apt/sources.list.d/scylla-manager.list
Update the Scylla Manager repo to 1.2.x
Install previous version
sudo apt-get update
sudo apt-get remove scylla-manager\* -y
sudo apt-get install scylla-manager scylla-manager-server scylla-manager-client
sudo systemctl unmask scylla-manager.service
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.