upgrade guide - Scylla Manager 1.2.x to 1.3.x on Ubuntu 16¶
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.
Upgrade Notes¶
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 tointerval
as it now supports more granular time units. For example:3d2h10m
. The available time units ared
,h
,m
, ands
.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.
Upgrade Procedure¶
Backup the data
Download and install new packages
Validate that the upgrade was successful
Backup the Scylla Manager data¶
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.
Download and install the new release¶
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
Validate¶
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 withsystemctl 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 │
╰──────────────────────────────────────────────────┴───────────────────────────────┴──────┴────────────┴────────╯
Rollback Procedure¶
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
Downgrade to previous release¶
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
Rollback the Scylla Manager database¶
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.
Start Scylla Manager¶
sudo systemctl start scylla-manager
Validate Scylla Manager Version¶
Validate Scylla Manager version:
sctool version
The version should match with the results you had previously.