Software update
storage_stop_software_update
Required Role: Service
Requests the stop of updating the storage software.
When this CLI is executed, a job requesting the stop of updating the storage software is submitted. When the stop request is completed, the state of the job changes to Succeeded, and the state of the storage software update job to be stopped changes to Stopping. Depending on the timing of executing the CLI, it might take time until the state of the target storage software update job changes to Stopping.
When the target storage software update job could be stopped, the state of this job changes to Stopped. However, depending on the timing when the CLI is executed, the target storage software update job might be executed to the end without being stopped.
In this case, the state of the target storage software update job changes to Succeeded (instead of Stopped) when the storage software update is successful or Failed when it is not successful.
The storage software update job to be stopped can be found using the attribute, affectedResources in the response data of the CLI.
hsds [master command option] storage_stop_software_update
None
Normal termination
Abnormal termination
When text is specified for format, it is output in the format described in Output format .
When json is specified for format, HTTP status code is also output. For http status code, see Response definitions.
-
basic authentication
-
session authentication
storage_update_software
Required Role: Service
Updates the storage software.
This CLI can be executed only for the cluster master node (primary). If this CLI is called from other nodes, an error is returned.
hsds [master command option] storage_update_software --mode <str> (required)
--mode Non-disruptive
Specify modes for updating the software:
-
Non-disruptive: I/Os are not stopped.
-
Normal termination
Abnormal termination
When text is specified for format, it is output in the format described in Output format .
When json is specified for format, HTTP status code is also output. For http status code, see Response definitions.
-
basic authentication
-
session authentication
storage_upload_software_update_file
Required Role: Service
Transfers (uploads) the update file of the storage software to the storage cluster.
You can run this CLI only for the cluster master node (primary). If you call this CLI for a node other than the cluster master node (primary), an error is returned.
Make sure that the controller node has at least 4GiB of free memory, and then run the command.
(Virtual machine) The command cannot be executed on the maintenance node.
hsds [master command option] storage_upload_software_update_file --software_update_file <file> (required)
--software_update_file <file>
Specify the update file of the storage software to be transferred to the storage cluster.
Normal termination
None
Abnormal termination
When text is specified for format, it is output in the format described in Output format .
When json is specified for format, HTTP status code is also output. For http status code, see Response definitions.
-
basic authentication
-
session authentication
storage_software_update_file_show
Required Role: Service
Obtains the information of the update file of the storage software which performed transfer (upload) in the storage cluster.
If the update file of the storage software is not transferred to the storage cluster, returns an error.
In the case of the file that an update file of the storage software transferred to the storage cluster is unauthorized, returns an error.
This CLI can be executed only for the cluster master node (primary). If this CLI is called from other nodes, an error is returned.
hsds [master command option] storage_software_update_file_show
None
Normal termination
Abnormal termination
When text is specified for format, it is output in the format described in Output format .
When json is specified for format, HTTP status code is also output. For http status code, see Response definitions.
-
basic authentication
-
session authentication