CLI: Global Parallel Writes



The CLI references “skysync.” This is expected.

 

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.

Parameters

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

Parameter

Description

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 at the same time. 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

1 skysync-cli performance parallel_writes show --output-json

Example result

1 2 3 4 5 6 7 8 [ { "parallel_writes": { "requested": 2, "max": 10 } } ]

 

Updating Parallel Writes

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

Updating the Requested Value

Command

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

or

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

 

Command with example values

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

 

Updating the Max Value

Command

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

or

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

 

Command with example values

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

 

Updating Both Parameters

There are two commands that can be used to update both parameters. Note that neither option is required, but at least one option must be included.

Command

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

or

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

 

Command with example values

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

 

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.