Overview

The concurrent jobs setting determines the number of transfers that will operate in parallel. The default number of concurrent jobs is 6; the maximum number of concurrent jobs is 20. It is important to note that increasing the number of concurrent jobs does not always equal faster/better transfer performance. There is a long list of concepts that must be considered. This page covers configuration options for setting appropriate concurrency limits.

Parameters

Updating the concurrent jobs setting is done using the following two parameters. At least one of the parameters must be used in the update command, and the values must be greater than 0.

List Concurrent Jobs

Command

skysync-cli performance concurrent_transfers show --output-json

Example Result

[
 {
   "concurrent_jobs": {
     "current": 6,
     "max": 8
   }
 }
]

Updating the Current Value

Command

skysync-cli performance concurrent_transfers update --current={#}

or

skysync-cli performance concurrent_transfers update -c {#}

Command With Examples

skysync-cli performance concurrent_transfers update --current=6

skysync-cli performance concurrent_transfers update -c 6

Updating the Max Value

Command

skysync-cli performance concurrent_transfers update --max={#}

or

skysync-cli performance concurrent_transfers update -m {#}

Command With Examples

skysync-cli performance concurrent_transfers update --max=8

skysync-cli performance concurrent_transfers update -m 8

Updating Both Parameters

Two commands can be used to update both parameters. Neither option is required, but at least one option must be included. The current value cannot be larger than the max value.

Command

skysync-cli performance concurrent_transfers update --current={#} --max={#}

or

skysync-cli performance concurrent_transfers update -c {#} -m {#}

Command with examples

skysync-cli performance concurrent_transfers update --current=6 --max=8

skysync-cli performance concurrent_transfers update -c 6 -m 8