CLI: Global Parallel Writes

Learn how to use the CLI to configure the number of web service requests for you DryvIQ instance.


Overview

Parallel writes is a configurable feature relating to the number of Web service requests across an instance of DryvIQ, on a given node, that will operate in parallel. Fine-tuning this parameter can improve throughput while preventing bottlenecks and avoiding strain on platforms. This page explains how to use the DryvIQ Command-line Interface (CLI) to configure and optimize parallel writes for efficient data processing. 

SkySync References

The CLI references SkySync. This is expected. 

 

Parameters

Viewing or setting the parallel writes is done using the following two parameters.

Parameter Description

requested

r

The requested number of parallel writes. The requested value cannot be set higher than the max.

max

m

The maximum number of parallel writes allowed.

Updating Values

In most cases, you can update one at a time or both at once. However, if the current max value is less than the desired requested value, you cannot update max and requested simultaneously. For example, if the current values are requested=4 and max=5, you cannot update the values to requested=6 and max=12 in the same call. This will return an error because the call must first retrieve the max value from the licensing server since licensing will override values outside of what is set for the license. When you need to update the values in this scenario, you must first update the max value and then update the requested value.

List Parallel Writes

Command

skysync-cli performance parallel_writes show --output-json

Example result

[
 {
   "parallel_writes": {
     "requested": 2,
     "max": 10
   }
 }
]

Updating Parallel Writes

You can update the requested value, the max value, or both. At least one parameter must be set in the update command for the update to work. An update command without parameters will result in a return message that includes help information for updating the logging information.

Updating the Requested Value

Command

skysync-cli performance parallel_writes update --requested={#}

or

skysync-cli performance parallel_writes update -r {#}

Command With Example Values

skysync-cli performance parallel_writes update --requested=6
skysync-cli performance parallel_writes update -r 6

Updating the Max Value

Command

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

or

skysync-cli performance parallel_writes update -m {#}

Command With Example Values

skysync-cli performance parallel_writes update --max=12
skysync-cli performance parallel_writes update -m 12

Updating Both Parameters

Two commands can be used to update both parameters. Neither option is required, but at least one option must be included.

Command

skysync-cli performance parallel_writes update --requested={#} --max={#}

or

skysync-cli performance parallel_writes update -r {#} -m {#}

Command With Example Values

skysync-cli performance parallel_writes update --requested=6 --max=12
skysync-cli performance parallel_writes update -r 6 -m 12

UI Updates

When parallel writes are set through the CLI, the changes will be reflected on the Performance page in the Settings once the page is refreshed.