st_device_modify

This job assigns new parameters to a disk. All parameters must be given.
If sector size and/or the number of sectors are different from the current ones,
the disk will be resized and (re)initialized, and all data will be lost.
If the checksum algorithm is modified, the existing checksums are reset in order
to avoid errors on READ operations.

This operation is only allowed if the disk is currently not in use.

Mandatory Parameters

Parameter Name Data Type Description
node integer Node ID
devname string Device name

Optional Parameters

Parameter Name Data Type Description
disk string Disk name
sector_size string Device sector size, including unit. Example: 1 KiB
num_sectors integer Number of device sectors
read_only boolean Device read only (boolean)

Substitute Parameters

There are no substitute parameters.

Allowed Users

There are no defined allowed users.

Allowed Groups

The following groups are allowed to run this job:

  • root
  • exaadm
  • exadbadm

Examples

The following code snippets show how to use this job using both Python (via XML-RPC) and on the command-line using confd_client.

conn.job_exec('st_device_modify', {'params': {'node': 11, 'devname': '/exa/data/storage/dev.1', 'sector_size': '1 KiB'}})
confd_client st_device_modify node: 11 devname: /exa/data/storage/dev.1 sector_size: '1 KiB'