Note
You are not reading the most recent version of this documentation. Go to the latest version of Scylla Manager Documentation.
This document is a complete reference for the sctool CLI. The commands are in alphabetical order.
sctool
is a Command Line Interface (CLI) for the Scylla Manager server.
The server communicates with managed Scylla clusters and performs cluster-wide operations such as automatic repair and backup.
Usage
sctool command [flags] [global flags]
--api-cert-file <path>
- specifies the path to HTTPS client certificate used to access the Scylla Manager server
--api-key-file <path>
- specifies the path to HTTPS client key used to access the Scylla Manager server
--api-url URL
- URL of Scylla Manager server (default “http://localhost:8889/api/v1”)
-c, --cluster <cluster_name>
- Specifies the target cluster name or ID
-h, --help
- Displays help for commands. Use sctool [command] --help
for help about a specific command.
sctool uses the following environment variables:
SCYLLA_MANAGER_CLUSTER - if set, specifies the default value for the -c, --cluster
flag, in commands that support it.
SCYLLA_MANAGER_API_URL - if set, specifies the default value for the --api-url
flag; it can be useful when using sctool with a remote Scylla Manager server.
The environment variables may be saved in your ~/.bashrc
file so that the variables are set after login.
The backup commands allow you to: create a backup (ad-hoc or scheduled), list the contents of a backup, and list the backups of a cluster. A Scylla cluster must be added (cluster add) before management tasks can be initiated.
sctool backup <command> [global flags] [parameters]
Subcommands
Subcommand |
Usage |
---|---|
Schedule a backup (ad-hoc or scheduled). |
|
List contents of a given backup. |
|
List backups of a given cluster. |
|
Deletes one of available snapshots. |
The backup command allows you to schedule or run ad-hoc cluster backup.
Syntax:
sctool backup --cluster <id|name> --location <list of locations> [--dc <list>]
[--dry-run] [--force] [--interval <time-unit>]
[--keyspace <list of glob patterns to find keyspaces>]
[--num-retries <times to rerun a failed task>]
[--rate-limit <list of rate limits>] [--retention <number of backups to store>]
[--show-tables]
[--snapshot-parallel <list of parallelism limits>] [--start-date <date>]
[--upload-parallel <list of parallelism limits>] [global flags]
In addition to the Global flags, backup takes the following parameters:
--dc <list of glob patterns>
A comma-separated list of datacenter glob patterns, e.g. ‘dc1,!otherdc*’ used to specify the DCs to include or exclude from backup, separated by a comma. This can also include glob patterns.
The following syntax is supported:
*
- matches any number of any characters including none
?
- matches any single character
[abc]
- matches one character given in the bracket
[a-z]
- matches one character from the range given in the bracket
Patterns are evaluated from left to right.
If a pattern starts with !
it unselects items that were selected by previous patterns
i.e. a?,!aa
selects ab but not aa.
--dry-run
Validates and prints backup information without actually scheduling a backup.
--force
Forces backup to skip database validation and schedules a backup even if there are no matching keyspaces/tables.
-i, --interval <time-unit>
Scheduled Intervals for backups to repeat every X time, where X can be:
d
- days
h
- hours
m
- minutes
s
- seconds
For example: -i 3d2h10m
Default: 0 - this means the task does not recur.
-K, --keyspace <list of glob patterns to find keyspaces>
A list of glob patterns separated by a comma used to include or exclude keyspaces from the backup. The patterns match keyspaces and tables, when you write the pattern, separate the keyspace name from the table name with a dot (KEYSPACE.TABLE).
The following syntax is supported:
*
- matches any number of any characters including none
?
- matches any single character
[abc]
- matches one character given in the bracket
[a-z]
- matches one character from the range given in the bracket
Patterns are evaluated from left to right.
If a pattern starts with !
it unselects items that were selected by previous patterns
i.e. a?,!aa
selects ab but not aa.
-L, --location <list of backup locations>
Specifies where to place the backup in the format [dc:]<provider>:<name>
ex. s3:my-bucket
.
More than one location can be stated in a comma-separated list.
The <dc>: part is optional and is only needed when different datacenters are being used to upload data to different locations.
name
must be an alphanumeric string and may contain a dash and or a dot, but other characters are forbidden.
The only supported storage provider
at the moment is s3
.
-r, --num-retries <times to rerun a failed task>
The number of times a scheduled task will retry to run before failing.
Default: 3
--rate-limit <list of rate limits>
Limits the upload rate (as expressed in megabytes (MB) per second), which a snapshot file can be uploaded from a Scylla node to its backup destination.
For example, an S3 bucket.
You can set limits for more than one DC using a comma-separated list expressed in the format [<dc>:]<limit>
.
The <dc>: part is optional and is only needed when different datacenters require different upload limits.
Default: 100
--retention <number of backups to store>
The number of backups to store. Once this number is reached, the next backup which comes in from this destination will initiate a purge of the oldest backup.
Default: 3
--show-tables
Prints table names together with keyspace.
--snapshot-parallel <list of parallelism limits>
A comma-separated list of snapshot parallelism limits in the format [<dc>:]<limit>
.
More than one location can be stated in a comma-separated list.
The <dc>: part is optional and allows for specifying different limits in selected datacenters.
If The <dc>: part is not set, the limit is global (e.g. ‘dc1:2,5’). The runs are parallel in n
nodes (2 in dc1 (as shown in the example) and n
nodes in all the other datacenters.
-s, --start-date <date>
Specifies the task start date expressed in the RFC3339 format or now[+duration]
, e.g. now+3d2h10m
, valid units are:
d
- days
h
- hours
m
- minutes
s
- seconds
now
- happens immediately
Default: now
--upload-parallel <list of parallelism limits>
A comma-separated list of upload parallelism limits in the format [<dc>:]<limit>
.
More than one location can be stated in a comma-separated list.
The <dc>: part is optional and allows for specifying different limits in selected datacenters.
If The <dc>: part is not set, the limit is global (e.g. ‘dc1:2,5’). The runs are parallel in n
nodes (2 in dc1 (as shown in the example) and n
nodes in all the other datacenters.
This example backs up the entire cluster named prod-cluster.
The backup begins on December 9, 2019 at 16:05 and will repeat at this time every 24 hours.
The backup is stored in s3 in a directory named my-backups
.
Additional examples are available in Backup Scylla Clusters
sctool backup -c prod-cluster -s '2019-12-09T15:16:05Z' -i 24h -L 's3:my-backups'
backup/3208ff15-6e8f-48b2-875c-d3c73f545410
These commands allow you to list backups of a given cluster.
Syntax:
sctool backup list [--all clusters] [--keyspace <list of glob patterns to find keyspaces>] [--location <list of backup locations>]
[--max-date <date>] [--min-date <date>] [--show-tables][global flags]
In addition to the Global flags, backup list takes the following parameters:
--all-clusters
Shows backups for all clusters
-K, --keyspace <list of glob patterns to find keyspaces>
A list of glob patterns separated by a comma. The patterns match keyspaces and tables, when you write the pattern, separate the keyspace name from the table name with a dot (KEYSPACE.TABLE).
The following syntax is supported:
*
- matches any number of any characters including none
?
- matches any single character
[abc]
- matches one character given in the bracket
[a-z]
- matches one character from the range given in the bracket
Patterns are evaluated from left to right.
If a pattern starts with !
it unselects items that were selected by previous patterns
i.e. a?,!aa
selects ab but not aa.
-L, --location <list of backup locations>
Specifies where to place the backup in the format [<dc>:]<provider>:<name>
.
More than one location can be stated in a comma-separated list.
The <dc>: part is optional and is only needed when different datacenters are being used to upload data to different locations.
name
must be an alphanumeric string and may contain a dash and or a dot, but other characters are forbidden.
The only supported storage provider
is s3.
--max-date <date>
Specifies maximal snapshot date expressed in RFC3339 form or now[+duration]
.
For example: now+3d2h10m
Valid units are:
d
- days
h
- hours
m
- minutes
s
- seconds
now
- happens immediately
--min-date <date>
Specifies minimal snapshot date expressed in RFC3339 form or now[+duration]
.
For example: now+3d2h10m
Valid units are:
d
- days
h
- hours
m
- minutes
s
- seconds
now
- happens immediately
--show-tables
Prints table names together with keyspace.
sctool backup list -c prod-cluster --show-tables
Snapshots:
- sm_20191210145143UTC
- sm_20191210145027UTC
- sm_20191210144833UTC
Keyspaces:
- system_auth (role_members, roles)
- system_distributed (view_build_status)
- system_traces (events, node_slow_log, node_slow_log_time_idx, sessions, sessions_time_idx)
- test_keyspace_dc1_rf2 (void1)
- test_keyspace_dc1_rf3 (void1)
- test_keyspace_dc2_rf2 (void1)
- test_keyspace_dc2_rf3 (void1)
- test_keyspace_rf2 (void1)
- test_keyspace_rf3 (void1)
This command allows you to list the content of a given backup. This command lists files that were uploaded during the backup procedure. It outputs the remote paths of files together with keyspace/table information separated by a delimiter that you provide.
Syntax:
sctool backup files [--all clusters] [--keyspace <list of glob patterns to find keyspaces>]
[--location <list of backup locations>] [global flags]
In addition to the Global flags, backup files add takes the following parameters:
--all-clusters
Shows backups for all clusters
-d, --delimiter <delimiter-character>
Dictates which character will be used as whitespace between remote file path and information about keyspace and table.
Default: ‘t’
-K, --keyspace <list of glob patterns to find keyspaces>
A list of glob patterns separated by a comma. The patterns match keyspaces and tables, when you write the pattern, separate the keyspace name from the table name with a dot (KEYSPACE.TABLE).
The following syntax is supported:
*
- matches any number of any characters including none
?
- matches any single character
[abc]
- matches one character given in the bracket
[a-z]
- matches one character from the range given in the bracket
Patterns are evaluated from left to right.
If a pattern starts with !
it unselects items that were selected by previous patterns
i.e. a?,!aa
selects ab but not aa.
-L, --location <list of backup locations>
Specifies where to place the backup in the format [<dc>:]<provider>:<name>
.
More than one location can be stated in a comma-separated list.
The <dc>: part is optional and is only needed when different datacenters are being used to upload data to different locations.
name
must be an alphanumeric string and may contain a dash and or a dot, but other characters are forbidden.
The only supported storage provider
is s3.
-T, --snapshot-tag <tag>
Snapshot tag as read from the backup listing
sctool backup files --keyspace system_auth
The command output has the following format:
<provider>://<bucket-name>/backup/sst/cluster/<cluster-id>/dc/<dc-id>/
node/<node-id>/keyspace/<keyspace-name>/table/<table-name>/<table-uuid>/
<filename><delimiter><keyspace-name>/<table-name>
Example:
s3://backups/backup/sst/cluster/7d8f190f-c98d-4a06-8bb5-ae96633ee69a/dc/dc2/
node/f3c6386b-6d54-4546-a2e8-627fff62d3af/keyspace/system_sec/table/roles/5bc52802de2535edaeab188eecebb090/
mc-2-big-TOC.txt system_sec/table
From this information we know the following:
Provider - s3
Bucket name - backups
Cluster ID - 7d8f190f-c98d-4a06-8bb5-ae96633ee69a
DC - DC2
Node - f3c6386b-6d54-4546-a2e8-627fff62d3af
Keyspace - system_sec
Table name - roles
Table UUID - 5bc52802de2535edaeab188eecebb090
File name - mc-2-big-TOC.txt
Delimiter - whitespace character (ie ‘ ‘)
Keyspace / table name - system_sec/table
See Restore on information how to use these files to restore a backup.
This command allows you to delete files that were uploaded during the backup procedure. Deduplicated files are persisted unless their reference count drops to zero.
Syntax:
sctool backup delete --snapshot-tag <snapshot tag> [--location <list of backup locations>] [global flags]
In addition to the Global flags, backup delete takes the following parameters:
-L, --location <list of backup locations>
Specifies where to look for the backup in the format [<dc>:]<provider>:<name>
.
More than one location can be stated in a comma-separated list.
The <dc>: part is optional and is only needed when different datacenters are being used to upload data to different locations.
name
must be an alphanumeric string and may contain a dash and or a dot, but other characters are forbidden.
The only supported storage provider
is s3.
-T, --snapshot-tag <tag>
Snapshot tag as read from the backup listing.
sctool backup delete --snapshot-tag sm_20200526115228UTC
The command does not output anything unless an error happens.
The cluster commands allow you to add, delete, list, and update clusters. A Scylla cluster must be added (cluster add) before management tasks can be initiated.
sctool cluster <command> [flags] [global flags]
Subcommands
Subcommand |
Usage |
---|---|
Add a cluster to manager. |
|
Delete a cluster from manager. |
|
Show managed clusters. |
|
Modify a cluster. |
This command adds the specified cluster to the manager. Once a Scylla cluster is added, a weekly repair task is also added.
Before continuing, make sure the cluster that you want to add is prepared for it, see Add a cluster to Scylla Manager for instructions.
Syntax:
sctool cluster add --host <node IP> --auth-token <token>[--name <alias>][--without-repair][global flags]
In addition to the Global flags, cluster add takes the following parameters:
--host <node IP>
Specifies the hostname or IP of the node that will be used to discover other nodes belonging to the cluster. Note that this will be persisted and used every time Scylla Manager starts. You can use either an IPv4 or IPv6 address.
-n, --name <alias>
When a cluster is added, it is assigned a unique identifier.
Use this parameter to identify the cluster by an alias name which is more meaningful.
This alias name can be used with all commands that accept -c, --cluster
parameter.
--auth-token <token>
Specifies the authentication token you identified in /etc/scylla-manager-agent/scylla-manager-agent.yaml
-u, --username <cql username>
Optional CQL username, for security reasons this user should NOT have access to your data. If you specify the CQL username and password, the CQL health check you see in status would try to login and execute a query against system keyspace. Otherwise CQL health check is based on sending CQL OPTIONS frame and does not start a CQL session.
-p, --password <password>
CQL password associated with username.
--without-repair
When cluster is added, Manager schedules repair to repeat every 7 days. To create a cluster without a scheduled repair, use this flag.
This example is only the command that you use to add the cluster to Scylla Manager, not the entire procedure for adding a cluster. The procedure is detailed in Add a cluster to Scylla Manager.
sctool cluster add --host 34.203.122.52 --auth-token "6Es3dm24U72NzAu9ANWmU3C4ALyVZhwwPZZPWtK10eYGHJ24wMoh9SQxRZEluWMc0qDrsWCCshvfhk9uewOimQS2x5yNTYUEoIkO1VpSmTFu5fsFyoDgEkmNrCJpXtfM" --name prod-cluster
c1bbabf3-cad1-4a59-ab8f-84e2a73b623f
__
/ \ Cluster added! You can set it as default, by exporting env variable.
@ @ $ export SCYLLA_MANAGER_CLUSTER=c1bbabf3-cad1-4a59-ab8f-84e2a73b623f
| | $ export SCYLLA_MANAGER_CLUSTER=prod-cluster
|| |/
|| || Now run:
|\_/| $ sctool status -c prod-cluster
\___/ $ sctool task list -c prod-cluster
Example (IPv6):
sctool cluster add --host 2a05:d018:223:f00:971d:14af:6418:fe2d --auth-token "6Es3dm24U72NzAu9ANWmU3C4ALyVZhwwPZZPWtK10eYGHJ24wMoh9SQxRZEluWMc0qDrsWCCshvfhk9uewOimQS2x5yNTYUEoIkO1VpSmTFu5fsFyoDgEkmNrCJpXtfM" --name prod-cluster
This command deletes the specified cluster from the manager. Note that there is no confirmation or warning to confirm. If you deleted the cluster by mistake, you will need to add it again.
Syntax:
sctool cluster delete --cluster <id|name> [global flags]
Note
If you are removing the cluster from Scylla Manager and you are using Scylla Monitoring, remove the target from Prometheus Target list in the prometheus/scylla_manager_servers.yml file.
In addition to Global flags, cluster delete takes the following parameter:
-c
, --cluster
This is the cluster name is the name you assigned when you created the cluster (cluster add). You can see the cluster name and ID by running the command cluster list.
sctool cluster delete -c prod-cluster
Lists the managed clusters.
Syntax:
sctool cluster list [global flags]
cluster list takes the Global flags.
sctool cluster list
╭──────────────────────────────────────┬──────────────╮
│ ID │ Name │
├──────────────────────────────────────┼──────────────┤
│ db7faf98-7cc4-4a08-b707-2bc59d65551e │ prod-cluster │
╰──────────────────────────────────────┴──────────────╯
This command modifies managed cluster parameters.
Syntax:
sctool cluster update --cluster <id|name> [--host <node IP>] [--auth-token <token>] [--name <alias>] [--without-repair] [global flags]
In addition to the Global flags, cluster update takes all the cluster add parameters.
-c
, --cluster
This is the cluster name is the name you assigned when you created the cluster (cluster add). You can see the cluster name and ID by running the command cluster list.
--host <node IP>
Specifies the hostname or IP of the node that will be used to discover other nodes belonging to the cluster. Note that this will be persisted and used every time Scylla Manager starts. You can use either an IPv4 or IPv6 address.
-n, --name <alias>
When a cluster is added, it is assigned a unique identifier.
Use this parameter to identify the cluster by an alias name which is more meaningful.
This alias name can be used with all commands that accept -c, --cluster
parameter.
--auth-token <token>
Specifies the authentication token you identified in /etc/scylla-manager-agent/scylla-manager-agent.yaml
-u, --username <cql username>
Optional CQL username, for security reasons this user should NOT have access to your data. If you specify the CQL username and password, the CQL health check you see in status would try to login and execute a query against system keyspace. Otherwise CQL health check is based on sending CQL OPTIONS frame and does not start a CQL session.
-p, --password <password>
CQL password associated with username.
--without-repair
When cluster is added, Manager schedules repair to repeat every 7 days. To create a cluster without a scheduled repair, use this flag.
In this example, the cluster named cluster
has been renamed to prod-cluster
.
sctool cluster update --prod-cluster cluster --name prod-cluster
The repair commands allow you to schedule repairs for a specified cluster.
sctool repair --cluster <id|name> [--dc <list of glob patterns>] [--dry-run]
[--fail-fast] [--force] [--host <node IP>] [--interval <time between task runs>]
[--intensity <float>]
[--keyspace <list of glob patterns>] [--num-retries <times to rerun a failed task>]
[--start-date <now+duration|RFC3339>]
[--token-ranges <pr|npr|all>] [--with-hosts <list of node IPs>][global flags]
In addition to Global flags, repair takes the following parameters:
-c
, --cluster
This is the cluster name is the name you assigned when you created the cluster (cluster add). You can see the cluster name and ID by running the command cluster list.
--dc <list of glob patterns>
List of data centers to be repaired, separated by a comma. This can also include glob patterns.
The following syntax is supported:
*
- matches any number of any characters including none
?
- matches any single character
[abc]
- matches one character given in the bracket
[a-z]
- matches one character from the range given in the bracket
Patterns are evaluated from left to right.
If a pattern starts with !
it unselects items that were selected by previous patterns
i.e. a?,!aa
selects ab but not aa.
Example
Given the following data centers: us-east-1, us-east-2, us-west-1, us-west-2.
Parameter |
Selects |
---|---|
|
us-east-1, us-west-2 |
|
us-east-1, us-east-2 |
|
us-west-1, us-west-2 |
Default: everything - all data centers
--dry-run
Validates and displays repair information without actually scheduling the repair. This allows you to display what will happen should the repair run with the parameters you set.
Example
Given the following keyspaces:
system_auth
system_distributed
system_traces
test_keyspace_dc1_rf2, test_keyspace_dc1_rf3, and test_keyspace_dc2_rf2
keyspace_dc2_rf3
test_keyspace_rf2 and test_keyspace_rf3
The following command will run a repair on all keyspaces except for test_keyspace_dc1_rf2 in dry-run mode.
sctool repair --dry-run -K '*,!test_keyspace_dc1_rf2'
NOTICE: dry run mode, repair is not scheduled
Data Centers:
- dc1
- dc2
Keyspace: system_auth
(all tables)
Keyspace: system_distributed
(all tables)
Keyspace: system_traces
(all tables)
Keyspace: test_keyspace_dc1_rf3
(all tables)
Keyspace: test_keyspace_dc2_rf2
(all tables)
Keyspace: test_keyspace_dc2_rf3
(all tables)
Keyspace: test_keyspace_rf2
(all tables)
Keyspace: test_keyspace_rf3
(all tables)
Example with error
sctool repair -K 'system*.bla' --dry-run -c bla
NOTICE: dry run mode, repair is not scheduled
Error: API error (status 400)
{
"message": "no matching units found for filters, ks=[system*.*bla*]",
"trace_id": "b_mSOUoOSyqSnDtk9EANyg"
}
--fail-fast
Stops the repair process on the first error.
Default: False
--force
Forces the repair to skip database validation and schedules a repair even if there aren’t any matching keyspaces/tables. This means that if the glob patterns match nothing, a repair will still run.
Default: False
--host <node IP>
Host to repair, you may use that to repair given host with other hosts (–with-hosts), you may also want to specify token ranges to repair (–token-ranges). You can use either an IPv4 or IPv6 address.
--intensity <float>
Repair speed, higher values result in higher speed and may increase cluster load. Values in a range (0-1) result in lower speed and load.
When intensity is below 1, the repair is executed only on the specified fraction of shards at the same time. Please note that this only works with versions that are not row-level-repair enabled.
Default: 0
-K, --keyspace <list of glob patterns>
A list of glob patterns separated by a comma. The patterns match keyspaces and tables, when you write the pattern, separate the keyspace name from the table name with a dot (KEYSPACE.TABLE).
The following syntax is supported:
*
- matches any number of any characters including none
?
- matches any single character
[abc]
- matches one character given in the bracket
[a-z]
- matches one character from the range given in the bracket
Patterns are evaluated from left to right.
If a pattern starts with !
it unselects items that were selected by previous patterns
i.e. a?,!aa
selects ab but not aa.
Example
Given the following tables:
shopping_cart.cart
orders.orders_by_date_2018_11_01
orders.orders_by_date_2018_11_15
orders.orders_by_date_2018_11_29
orders.orders_by_date_2018_12_06
Parameter |
Selects |
---|---|
|
everything - all tables in all keyspaces |
|
shopping_cart.cart |
|
shopping_cart.cart |
|
orders.orders_by_date_2018_11_01 orders.orders_by_date_2018_11_15 orders.orders_by_date_2018_11_29 |
|
orders.orders_by_date_2018_11_29 |
|
orders.orders_by_date_2018_11_01 orders.orders_by_date_2018_11_29 |
Default: everything - all tables in all keyspaces
--token-ranges <pr|npr|all>
Dictates which token range is used for the repair. There are three to choose from:
pr
- restricts the repair to the Primary token Range. This is a token range where the node is the first replica in the ring. It is important that if you choose this option to make sure it runs on every node in the cluster in order to repair the entire ring.
npr
- runs the repair on the non-primary token range.
all
- repairs all ranges, primary and non-primary.
Default: pr
Note
--token-ranges
requires --host
or --with-hosts
to also be used.
--with-hosts <list of node IPs>
List of hosts to repair with separated by a comma.
When the repair runs the repair compares the --host
with the --with-hosts
.
Use caution with this flag. It disables the built-in Scylla mechanism for repair and uses only the IP or hostname you set here. If there is a situation where there is missing data in the –with-host cluster, it will be deleted from the subsequent clusters. You can use either an IPv4 or IPv6 address.
--interval <time between task runs>
Amount of time after which a successfully completed task would be run again. Supported time units include:
d
- days,
h
- hours,
m
- minutes,
s
- seconds.
Default 0 (no interval)
Note
The task run date is aligned with --start date
value. For example, if you select --interval 7d
task would run weekly at the --start-date
time.
-s, --start-date <now+duration|RFC3339>
The date can be expressed relatively to now or as a RFC3339 formatted string.
To run the task in 2 hours use now+2h
, supported units are:
h
- hours,
m
- minutes,
s
- seconds,
ms
- milliseconds.
If you want the task to start at a specified date use RFC3339 formatted string i.e. 2018-01-02T15:04:05-07:00
.
If you want the repair to start immediately, use the value now
or skip this flag.
Default: now (start immediately)
-r, --num-retries <times to rerun a failed task>
Number of times a task reruns following a failure. The task reruns 10 minutes following a failure.
If the task fails after the retry times have been used, it will not retry again until its next run which was scheduled according to the --interval
parameter.
Note
If this is an ad hoc repair, the task will not run again.
Default: 3
Repairs can be scheduled to run on selected keyspaces/tables, nodes, or datacenters. Scheduled repairs run every n days, depending on the frequency you set. A scheduled repair runs at the time you set it to run at. If no time is given, the repair runs immediately. Repairs can run once or can run at a set schedule based on a time interval.
In this example, you create a repair task for a cluster named prod-cluster. The task begins on May 2, 2019 at 3:04 PM. It repeats every week at this time. As there are no datacenters or keyspaces listed, all datacenters and all data in the specified cluster are repaired.
sctool repair -c prod-cluster -s 2019-05-02T15:04:05-07:00 --interval 7d
The system replies with a repair task ID. You can use this ID to change the start time, stop the repair, or cancel the repair.
repair/3208ff15-6e8f-48b2-875c-d3c73f545410
This example repairs all datacenters starting with the name dc-asia-, such as dc-asia-1. The repair begins on September 15, 2018 at 7:00 PM (JST, for example) and runs every week.
sctool repair -c prod-cluster --dc 'asia-*' -s 2018-09-15T19:00:05-07:00 --interval 7d
Using glob patterns gives you additional flexibility in selecting both keyspaces and tables. This example repairs all tables in the orders keyspace starting with 2018_11_ prefix. The repair is scheduled to run on December 4, 2018 at 8:00 AM and will run after that point every week.
sctool repair -c prod-cluster -K 'orders.2018_12_' -s 2018-12-04T08:00:05-07:00 --interval 7d
By listing the host IP address, you run a repair only on the specified host.
The argument --token-ranges all
specifies that the repair will run on all token ranges (primary and secondary).
Example (IPv4):
sctool repair -c prod-cluster --host 198.100.51.11 --token-ranges all
The status command is an extended version of nodetool status
.
It can show status for all the managed clusters.
The first column shows node status in nodetool format.
The CQL column shows the CQL status, SSL indicator if SSL is enabled on a node, and time the check took.
Available statuses are:
UP - Situation normal
DOWN - Failed to connect to host or CQL error
UNAUTHORISED - Wrong username or password - only if username
is specified for cluster
TIMEOUT - Timeout
The REST column shows the status of Scylla Manager Server to Scylla API communication and the time the check took.
Available statuses are:
UP - Situation normal
DOWN - Failed to connect to host
HTTP XXX - HTTP failure and its status code
UNAUTHORISED - Wrong api-key
specified for cluster or in Scylla Manager Agent configuration file
TIMEOUT - Timeout
The status information is also available as a metric in the Scylla Monitoring Manager dashboard. The healthcheck task checks nodes every 15 seconds. The interval can be changed using task update command.
Syntax:
sctool status [global flags]
status takes the Global flags.
sctool status
Cluster: prod-cluster (c1bbabf3-cad1-4a59-ab8f-84e2a73b623f)
Datacenter: eu-west
╭────┬───────────────┬────────────┬──────────────┬──────────────────────────────────────╮
│ │ CQL │ REST │ Host │ Host ID │
├────┼───────────────┼────────────┼──────────────┼──────────────────────────────────────┤
│ UN │ UP SSL (42ms) │ UP (52ms) │ 10.0.114.68 │ 45a7390d-d162-4daa-8bff-6469c9956f8b │
│ UN │ UP SSL (38ms) │ UP (88ms) │ 10.0.138.46 │ 8dad7fc7-5a82-4fbb-8901-f6f60c12342a │
│ UN │ UP SSL (38ms) │ UP (298ms) │ 10.0.196.204 │ 44eebe5b-e0cb-4e45-961f-4ad175592977 │
│ UN │ UP SSL (43ms) │ UP (159ms) │ 10.0.66.115 │ 918a52aa-cc42-43a4-a499-f7b1ccb53b18 │
╰────┴───────────────┴────────────┴──────────────┴──────────────────────────────────────╯
The task command set allows you to schedule, start, stop and modify tasks.
sctool task <command> [flags] [global flags]
Subcommands
Subcommand |
Usage |
---|---|
Delete a task. |
|
Show run history of a task. |
|
Show available tasks and their last run status. |
|
Show the task progress. |
|
Start executing a task. |
|
Stop executing a task. |
|
Modify a task. |
This command deletes a task from the manager. Note that a task can be disabled if you want to temporarily turn it off (see task update).
Syntax:
sctool task delete <task type/id> --cluster <id|name> [global flags]
A task ID with a type (repair, for example) is required for this command.
This is a unique ID which is created when the task was made.
To display the ID, run the command sctool task list
(see task list).
In addition to the Global Flags, task delete takes the following parameter:
-c
, --cluster
This is the cluster name is the name you assigned when you created the cluster (cluster add). You can see the cluster name and ID by running the command cluster list.
This example deletes the repair from the task list.
You need the task ID for this action.
This can be retrieved using the command sctool task list
.
Once the repair is removed, you cannot resume the repair.
You will have to create a new one.
sctool task delete -c prod-cluster repair/143d160f-e53c-4890-a9e7-149561376cfd
This command shows details about task run history for a given task.
Syntax:
sctool task history <task type/id> --cluster <id|name>
[--limit <number of results>] [global flags]
A task ID with a type (repair, for example) is required for this command.
This is a unique ID which is created when the task was made.
To display the ID, run the command sctool task list
(see task list).
In addition to the Global Flags, task history takes the following parameters:
-c
, --cluster
This is the cluster name is the name you assigned when you created the cluster (cluster add). You can see the cluster name and ID by running the command cluster list.
--limit <number of results>
Limits the number of returned results.
Default 10
sctool task history repair/730a134a-4792-4139-bc6c-75d2ba7a1e62 -c prod-cluster
╭──────────────────────────────────────┬────────────────────────┬────────────────────────┬──────────┬────────────────────────────────────────────────╮
│ ID │ Start time │ End time │ Duration │ Status │
├──────────────────────────────────────┼────────────────────────┼────────────────────────┼──────────┼────────────────────────────────────────────────┤
│ f81ba8ad-ad79-11e8-915f-42010af000a9 │ 01 Jan 18 00:00:00 UTC │ 01 Jan 18 00:00:30 UTC │ 30s │ STOPPED │
│ e02d2caf-ad2a-11e8-915e-42010af000a9 │ 31 Feb 18 14:33:05 UTC │ 31 Feb 18 14:34:35 UTC │ 90s │ SUCCESS │
│ 7a8c6fe2-ad29-11e8-915d-42010af000a9 │ 31 Mar 18 14:23:20 UTC │ 31 Mar 18 14:23:20 UTC │ 0s │ ERROR failed to load units … │
│ 08f75324-610d-11e9-9aac-42010af000a9 │ 05 Apr 19 12:33:42 UTC │ 05 Apr 19 12:33:43 UTC │ 1s │ DONE │
│ 000681e1-610d-11e9-9aab-42010af000a9 │ 09 Apr 19 12:33:27 UTC │ 09 Apr 19 12:33:28 UTC │ 1s │ DONE │
│ f715fb82-610c-11e9-9aaa-42010af000a9 │ 11 Apr 19 12:33:12 UTC │ 11 Apr 19 12:33:13 UTC │ 1s │ DONE │
│ ee251fc0-610c-11e9-9aa9-42010af000a9 │ 13 Apr 19 12:32:57 UTC │ 13 Apr 19 12:32:58 UTC │ 1s │ DONE │
│ e5343b52-610c-11e9-9aa8-42010af000a9 │ 15 Apr 19 15:32:42 UTC │ 15 Apr 19 15:32:43 UTC │ 1s │ DONE │
│ dc435562-610c-11e9-9aa7-42010af000a9 │ 17 Apr 19 12:32:27 UTC │ 17 Apr 19 12:32:28 UTC │ 1s │ DONE │
╰──────────────────────────────────────┴────────────────────────┴────────────────────────┴──────────┴────────────────────────────────────────────────╯
This command shows all of the scheduled tasks for the specified cluster. If the cluster is not set, this will output a table for every cluster. Each row contains task type and ID, separated by a slash, task properties, next activation, and last status information. For more information on a task, consult task history and task progress.
Syntax:
sctool task list [--cluster <id|name>] [--all] [--sort <sort-key>]
[--status <status>] [--type <task type>] [global flags]
In addition to the Global Flags, task list takes the following parameters:
-c
, --cluster
This is the cluster name is the name you assigned when you created the cluster (cluster add). You can see the cluster name and ID by running the command cluster list.
--all
Lists all tasks, including those which have been disabled.
Disabled tasks are prefixed with *
.
For example *repair/afe9a610-e4c7-4d05-860e-5a0ddf14d7aa
.
--sort <sort-key>
Returns a list of tasks sorted according to the last run status and sort key which you provide. Accepted sort key values are:
start-time
next-activation
end-time
status
start-time
, next-activation
, and end-time
are sorted in ascending order.
status
is sorted using the following order: “NEW”, “RUNNING”, “STOPPED”, “DONE”, “ERROR”, “ABORTED”.
--status <status>
Filters tasks according to their last run status. Accepted values are NEW, STARTING, RUNNING, STOPPING, STOPPED, DONE, ERROR, ABORTED.
-t, --type <task type>
Display only tasks of a given type.
sctool task list
Cluster: prod-cluster (c1bbabf3-cad1-4a59-ab8f-84e2a73b623f)
╭───────────────────────────────────────────────────────┬──────────────────────────────────────┬───────────────────────────────┬─────────╮
│ Task │ Arguments │ Next run │ Status │
├───────────────────────────────────────────────────────┼──────────────────────────────────────┼───────────────────────────────┼─────────┤
│ healthcheck/ebccaade-4487-4ce9-80ee-d39e295c752e │ │ 02 Apr 20 10:47:48 UTC (+15s) │ DONE │
│ healthcheck_rest/eff03af0-21ee-473a-b674-5e4bedc37b8b │ │ 02 Apr 20 11:02:03 UTC (+1h) │ DONE │
│ backup/2d7df8bb-69bc-4782-a52f-1ec87f9c2c1c │ -L s3:manager-backup-tests-eu-west-1 │ │ RUNNING │
╰───────────────────────────────────────────────────────┴──────────────────────────────────────┴───────────────────────────────┴─────────╯
Setting the --all
flag will also list disabled tasks which are not shown in the regular view.
Disabled tasks are prefixed with a *
.
This command shows details of the latest run (or still running) task.
Syntax:
sctool task progress <task type/id> --cluster <id|name> [--details] [global flags]
A task ID with a type (repair, for example) is required for this command.
This is a unique ID which is created when the task was made.
To display the ID, run the command sctool task list
(see task list).
In addition to the Global flags, repair progress takes the following parameters:
-c
, --cluster
This is the cluster name is the name you assigned when you created the cluster (cluster add). You can see the cluster name and ID by running the command cluster list.
--details
More detailed progress data, depending on task type.
This example displays the progress of a running repair.
sctool task progress repair/dff91fd1-f430-4f98-8932-373644fe647e -c prod-cluster
Status: RUNNING
Start time: 17 Apr 19 12:55:57 UTC
Duration: 46s
Progress: 0.45%
Datacenters:
- dc1
- dc2
╭───────────────────────┬───────╮
│ system_auth │ 3.85% │
│ system_distributed │ 0.00% │
│ system_traces │ 0.00% │
│ test_keyspace_dc1_rf2 │ 0.00% │
│ test_keyspace_dc1_rf3 │ 0.00% │
│ test_keyspace_dc2_rf2 │ 0.00% │
│ test_keyspace_dc2_rf3 │ 0.00% │
│ test_keyspace_rf2 │ 0.00% │
│ test_keyspace_rf3 │ 0.00% │
╰───────────────────────┴───────╯
The --details
flag shows each host’s shard repair progress, with the shards numbered from zero.
sctool task progress repair/dff91fd1-f430-4f98-8932-373644fe647e -c prod-cluster --details
Status: RUNNING
Start time: 17 Apr 19 12:55:57 UTC
Duration: 3m0s
Progress: 1.91%
Datacenters:
- dc1
- dc2
╭───────────────────────┬────────╮
│ system_auth │ 16.30% │
│ system_distributed │ 0.00% │
│ system_traces │ 0.00% │
│ test_keyspace_dc1_rf2 │ 0.00% │
│ test_keyspace_dc1_rf3 │ 0.00% │
│ test_keyspace_dc2_rf2 │ 0.00% │
│ test_keyspace_dc2_rf3 │ 0.00% │
│ test_keyspace_rf2 │ 0.00% │
│ test_keyspace_rf3 │ 0.00% │
╰───────────────────────┴────────╯
╭───────────────────────┬───────┬──────────┬───────────────┬─────────────────┬───────────────╮
│ system_auth │ shard │ progress │ segment_count │ segment_success │ segment_error │
├───────────────────────┼───────┼──────────┼───────────────┼─────────────────┼───────────────┤
│ 192.168.100.11 │ 0 │ 100.00% │ 748 │ 748 │ 0 │
│ 192.168.100.11 │ 1 │ 100.00% │ 757 │ 757 │ 0 │
│ 192.168.100.22 │ 0 │ 2.40% │ 791 │ 19 │ 0 │
│ 192.168.100.22 │ 1 │ 2.35% │ 807 │ 19 │ 0 │
│ 192.168.100.12 │ 0 │ 0.00% │ 740 │ 0 │ 0 │
│ 192.168.100.12 │ 1 │ 0.00% │ 740 │ 0 │ 0 │
│ 192.168.100.13 │ 0 │ 0.00% │ 922 │ 0 │ 0 │
│ 192.168.100.13 │ 1 │ 0.00% │ 930 │ 0 │ 0 │
│ 192.168.100.21 │ 0 │ 0.00% │ 765 │ 0 │ 0 │
│ 192.168.100.21 │ 1 │ 0.00% │ 767 │ 0 │ 0 │
│ 192.168.100.23 │ 0 │ 0.00% │ 752 │ 0 │ 0 │
│ 192.168.100.23 │ 1 │ 0.00% │ 747 │ 0 │ 0 │
├───────────────────────┼───────┼──────────┼───────────────┼─────────────────┼───────────────┤
│ system_distributed │ shard │ progress │ segment_count │ segment_success │ segment_error │
├───────────────────────┼───────┼──────────┼───────────────┼─────────────────┼───────────────┤
│ 192.168.100.11 │ 0 │ 0.00% │ 748 │ 0 │ 0 │
│ 192.168.100.11 │ 1 │ 0.00% │ 757 │ 0 │ 0 │
│ 192.168.100.12 │ 0 │ 0.00% │ 740 │ 0 │ 0 │
│ 192.168.100.12 │ 1 │ 0.00% │ 740 │ 0 │ 0 │
│ 192.168.100.13 │ 0 │ 0.00% │ 922 │ 0 │ 0 │
│ 192.168.100.13 │ 1 │ 0.00% │ 930 │ 0 │ 0 │
│ 192.168.100.21 │ 0 │ 0.00% │ 765 │ 0 │ 0 │
│ 192.168.100.21 │ 1 │ 0.00% │ 767 │ 0 │ 0 │
│ 192.168.100.22 │ 0 │ 0.00% │ 791 │ 0 │ 0 │
├───────────────────────┼───────┼──────────┼───────────────┼─────────────────┼───────────────┤
│ system_traces │ shard │ progress │ segment_count │ segment_success │ segment_error │
├───────────────────────┼───────┼──────────┼───────────────┼─────────────────┼───────────────┤
│ 192.168.100.11 │ 0 │ 0.00% │ 748 │ 0 │ 0 │
│ 192.168.100.11 │ 1 │ 0.00% │ 757 │ 0 │ 0 │
│ 192.168.100.12 │ 0 │ 0.00% │ 740 │ 0 │ 0 │
│ 192.168.100.12 │ 1 │ 0.00% │ 740 │ 0 │ 0 │
│ 192.168.100.13 │ 0 │ 0.00% │ 922 │ 0 │ 0 │
│ 192.168.100.13 │ 1 │ 0.00% │ 930 │ 0 │ 0 │
│ 192.168.100.21 │ 0 │ 0.00% │ 765 │ 0 │ 0 │
│ 192.168.100.21 │ 1 │ 0.00% │ 767 │ 0 │ 0 │
│ 192.168.100.22 │ 0 │ 0.00% │ 791 │ 0 │ 0 │
│ 192.168.100.22 │ 1 │ 0.00% │ 807 │ 0 │ 0 │
│ 192.168.100.23 │ 0 │ 0.00% │ 752 │ 0 │ 0 │
│ 192.168.100.23 │ 1 │ 0.00% │ 747 │ 0 │ 0 │
├───────────────────────┼───────┼──────────┼───────────────┼─────────────────┼───────────────┤
│ test_keyspace_dc1_rf2 │ shard │ progress │ segment_count │ segment_success │ segment_error │
├───────────────────────┼───────┼──────────┼───────────────┼─────────────────┼───────────────┤
│ 192.168.100.11 │ 0 │ 0.00% │ 1339 │ 0 │ 0 │
│ 192.168.100.11 │ 1 │ 0.00% │ 1339 │ 0 │ 0 │
│ 192.168.100.12 │ 0 │ 0.00% │ 1482 │ 0 │ 0 │
│ 192.168.100.12 │ 1 │ 0.00% │ 1480 │ 0 │ 0 │
│ 192.168.100.13 │ 0 │ 0.00% │ 1523 │ 0 │ 0 │
│ 192.168.100.13 │ 1 │ 0.00% │ 1528 │ 0 │ 0 │
├───────────────────────┼───────┼──────────┼───────────────┼─────────────────┼───────────────┤
│ test_keyspace_dc1_rf3 │ shard │ progress │ segment_count │ segment_success │ segment_error │
├───────────────────────┼───────┼──────────┼───────────────┼─────────────────┼───────────────┤
│ 192.168.100.11 │ 0 │ 0.00% │ 1339 │ 0 │ 0 │
│ 192.168.100.11 │ 1 │ 0.00% │ 1339 │ 0 │ 0 │
│ 192.168.100.12 │ 0 │ 0.00% │ 1482 │ 0 │ 0 │
│ 192.168.100.12 │ 1 │ 0.00% │ 1480 │ 0 │ 0 │
│ 192.168.100.13 │ 0 │ 0.00% │ 1523 │ 0 │ 0 │
│ 192.168.100.13 │ 1 │ 0.00% │ 1528 │ 0 │ 0 │
├───────────────────────┼───────┼──────────┼───────────────┼─────────────────┼───────────────┤
│ test_keyspace_dc2_rf2 │ shard │ progress │ segment_count │ segment_success │ segment_error │
├───────────────────────┼───────┼──────────┼───────────────┼─────────────────┼───────────────┤
│ 192.168.100.21 │ 0 │ 0.00% │ 1349 │ 0 │ 0 │
│ 192.168.100.21 │ 1 │ 0.00% │ 1343 │ 0 │ 0 │
│ 192.168.100.22 │ 0 │ 0.00% │ 1550 │ 0 │ 0 │
│ 192.168.100.22 │ 1 │ 0.00% │ 1561 │ 0 │ 0 │
│ 192.168.100.23 │ 0 │ 0.00% │ 1450 │ 0 │ 0 │
│ 192.168.100.23 │ 1 │ 0.00% │ 1465 │ 0 │ 0 │
├───────────────────────┼───────┼──────────┼───────────────┼─────────────────┼───────────────┤
│ test_keyspace_dc2_rf3 │ shard │ progress │ segment_count │ segment_success │ segment_error │
├───────────────────────┼───────┼──────────┼───────────────┼─────────────────┼───────────────┤
│ 192.168.100.21 │ 0 │ 0.00% │ 1349 │ 0 │ 0 │
│ 192.168.100.21 │ 1 │ 0.00% │ 1343 │ 0 │ 0 │
│ 192.168.100.22 │ 0 │ 0.00% │ 1550 │ 0 │ 0 │
│ 192.168.100.22 │ 1 │ 0.00% │ 1561 │ 0 │ 0 │
│ 192.168.100.23 │ 0 │ 0.00% │ 1450 │ 0 │ 0 │
│ 192.168.100.23 │ 1 │ 0.00% │ 1465 │ 0 │ 0 │
├───────────────────────┼───────┼──────────┼───────────────┼─────────────────┼───────────────┤
│ test_keyspace_rf2 │ shard │ progress │ segment_count │ segment_success │ segment_error │
├───────────────────────┼───────┼──────────┼───────────────┼─────────────────┼───────────────┤
│ 192.168.100.21 │ 0 │ 0.00% │ 1349 │ 0 │ 0 │
│ 192.168.100.21 │ 1 │ 0.00% │ 1343 │ 0 │ 0 │
│ 192.168.100.22 │ 0 │ 0.00% │ 1550 │ 0 │ 0 │
│ 192.168.100.22 │ 1 │ 0.00% │ 1561 │ 0 │ 0 │
│ 192.168.100.23 │ 0 │ 0.00% │ 1450 │ 0 │ 0 │
│ 192.168.100.23 │ 1 │ 0.00% │ 1465 │ 0 │ 0 │
├───────────────────────┼───────┼──────────┼───────────────┼─────────────────┼───────────────┤
│ test_keyspace_rf3 │ shard │ progress │ segment_count │ segment_success │ segment_error │
├───────────────────────┼───────┼──────────┼───────────────┼─────────────────┼───────────────┤
│ 192.168.100.11 │ 0 │ 0.00% │ 1339 │ 0 │ 0 │
│ 192.168.100.11 │ 1 │ 0.00% │ 1339 │ 0 │ 0 │
│ 192.168.100.12 │ 0 │ 0.00% │ 1482 │ 0 │ 0 │
│ 192.168.100.12 │ 1 │ 0.00% │ 1480 │ 0 │ 0 │
│ 192.168.100.13 │ 0 │ 0.00% │ 1523 │ 0 │ 0 │
│ 192.168.100.13 │ 1 │ 0.00% │ 1528 │ 0 │ 0 │
╰───────────────────────┴───────┴──────────┴───────────────┴─────────────────┴───────────────╯
Example with a backup task
sctool task progress -c prod-cluster backup/f0642e3e-e1cb-44ba-8447-f8d43672bcfd
Arguments: -L s3:manager-backup-tests-eu-west-1
Status: RUNNING
Start time: 02 Apr 20 10:09:27 UTC
Duration: 40m30s
Progress: 1%
Snapshot Tag: sm_20200402100931UTC
Datacenters:
- eu-west
╭──────────────┬──────────┬───────────┬──────────┬──────────────┬────────╮
│ Host │ Progress │ Size │ Success │ Deduplicated │ Failed │
├──────────────┼──────────┼───────────┼──────────┼──────────────┼────────┤
│ 10.0.114.68 │ 1% │ 952.11GiB │ 13.22GiB │ 538KiB │ 0B │
│ 10.0.138.46 │ 1% │ 938.00GiB │ 13.43GiB │ 830MiB │ 0B │
│ 10.0.196.204 │ 1% │ 934.58GiB │ 13.79GiB │ 206MiB │ 0B │
│ 10.0.66.115 │ 1% │ 897.43GiB │ 12.17GiB │ 523KiB │ 0B │
╰──────────────┴──────────┴───────────┴──────────┴──────────────┴────────╯
This command initiates a task run. Note that if a repair task is already running on a cluster, other repair tasks runs on that cluster will fail.
Syntax:
sctool task start <task type/id> --cluster <id|name> [global flags]
A task ID with a type (repair, for example) is required for this command.
This is a unique ID which is created when the task was made.
To display the ID, run the command sctool task list
(see task list).
In addition to the Global Flags, task start takes the following parameters:
-c
, --cluster
This is the cluster name is the name you assigned when you created the cluster (cluster add). You can see the cluster name and ID by running the command cluster list.
--continue
Try to resume the last run.
Default true
This example resumes running, which was previously stopped.
To start a repair that is scheduled but is currently not running, use the task update
command making sure to set the start time to now
.
See Example: task update.
If you have stopped a repair, you can resume it by running the following command.
You will need the task ID for this action.
This can be retrieved using the command sctool task list
.
sctool task start -c prod-cluster repair/143d160f-e53c-4890-a9e7-149561376cfd
Stops a specified task, stopping an already stopped task has no effect.
Syntax:
sctool task stop <task type/id> --cluster <id|name> [global flags]
A task ID with a type (repair, for example) is required for this command.
This is a unique ID which is created when the task was made.
To display the ID, run the command sctool task list
(see task list).
In addition to the Global flags, task stop takes the following parameter:
-c
, --cluster
This is the cluster name is the name you assigned when you created the cluster (cluster add). You can see the cluster name and ID by running the command cluster list.
This example immediately stops running repair.
The task is not deleted and can be resumed at a later time.
You will need the task ID for this action.
This can be retrieved using the command sctool task list
.
sctool task stop -c prod-cluster repair/143d160f-e53c-4890-a9e7-149561376cfd
This command changes generic task parameters, such as schedule.
Syntax:
sctool task update <task type/id> --cluster <id|name> [--enabled <bool>]
[--name <alias>] [--tags <list of tags>]
[--interval <time between task runs>]
[--start-date <now+duration|RFC3339>]
[--num-retries <times to rerun a failed task>] [global flags]
A task ID with a type (repair, for example) is required for this command.
This is a unique ID which is created when the task was made.
To display the ID, run the command sctool task list
(see task list).
In addition to Global flags, task stop takes the following parameters:
-c
, --cluster
This is the cluster name is the name you assigned when you created the cluster (cluster add). You can see the cluster name and ID by running the command cluster list.
-e, --enabled
Setting enabled to false disables the task.
The disabled task is not executed and hidden from the task list.
To show disabled tasks invoke sctool task list --all
(see task list).
Default true
-n, --name <alias>
Adds a name to a task.
--tags <list of tags>
Allows you to tag the task with a list of text.
--interval <time between task runs>
Amount of time after which a successfully completed task would be run again. Supported time units include:
d
- days,
h
- hours,
m
- minutes,
s
- seconds.
Default 0 (no interval)
Note
The task run date is aligned with --start date
value. For example, if you select --interval 7d
task would run weekly at the --start-date
time.
-s, --start-date <now+duration|RFC3339>
The date can be expressed relatively to now or as a RFC3339 formatted string.
To run the task in 2 hours use now+2h
, supported units are:
h
- hours,
m
- minutes,
s
- seconds,
ms
- milliseconds.
If you want the task to start at a specified date use RFC3339 formatted string i.e. 2018-01-02T15:04:05-07:00
.
If you want the repair to start immediately, use the value now
or skip this flag.
Default: now (start immediately)
-r, --num-retries <times to rerun a failed task>
Number of times a task reruns following a failure. The task reruns 10 minutes following a failure.
If the task fails after the retry times have been used, it will not retry again until its next run which was scheduled according to the --interval
parameter.
Note
If this is an ad hoc repair, the task will not run again.
Default: 3
This example disables the task
sctool task update -c prod-cluster repair/4d79ee63-7721-4105-8c6a-5b98c65c3e21 --enabled false
This example reschedules the repair to run in 3 hours from now instead of whatever time it was supposed to run and sets the repair to run every two days. The new time you set replaces the time which was previously set.
sctool task update -c prod-cluster repair/143d160f-e53c-4890-a9e7-149561376cfd -s now+3h --interval 2d
This command shows the currently installed sctool version and the Scylla Manager server version.
Syntax:
sctool version [flags] [global flags]
version takes the Global flags.
sctool version
Client version: 2.1-0.20200401.ce91f2ad
Server version: 2.1-0.20200401.ce91f2ad