No relevant resource is found in the selected language.

This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. Read our privacy policy>Search

Reminder

To have a better experience, please upgrade your IE browser.

upgrade

Command Reference 10

OceanStor 18500 V3 and 18800 V3 Mission Critical Storage System V300R003

"Based on the CLI, this document describes how to use various commands classified by functions and how to set the CLI and manage the storage system through these commands. The document that you browse online matches the latest C version of the product. Click Download to download documents of other C versions."
Rate and give feedback :
Huawei uses machine translation combined with human proofreading to translate this document to different languages in order to help you better understand the content of this document. Note: Even the most advanced machine translation cannot match the quality of professional translators. Huawei shall not bear any responsibility for translation accuracy and it is recommended that you refer to the English document (a link for which has been provided).
change lun

change lun

Function

The change lun command is used to modify the parameters of a LUN. The parameters include name, capacity, and type.

Format

change lun lun_id=? { name=? | relocation_policy=? | write_policy=? | owner_contrller=? | prefetch_policy=? [ prefetch_multiple=? ] [ prefetch_value=? ] | io_priority=? | read_cache_policy=? | write_cache_policy=? | dif_switch=? | thresholds_switch=? | thresholds_percent=? } *

change lun lun_id=? { name=? | relocation_policy=? | write_policy=? | owner_contrller=? | prefetch_policy=? [ prefetch_multiple=? ] [ prefetch_value=? ] | io_priority=? | read_cache_policy=? | write_cache_policy=? | dif_switch=? | thresholds_switch=? | thresholds_percent=? | mirror_policy=? | zero_data_enabled=? | work_controller=? } *

change lun lun_id=? { compression_enabled=? | compression_method=? | dedup_enabled=? | intelligent_dedup_enabled=? | bytecomparison_enabled=? | dedup_metadata_sample_ratio=? } *

change lun { lun_id=? | lun_id_list=? } capacity=?

change lun lun_id_list=? { relocation_policy=? | write_policy=? | owner_contrller=? | prefetch_policy=? [ prefetch_multiple=? ] [ prefetch_value=? ] | io_priority=? | read_cache_policy=? | write_cache_policy=? | dif_switch=? | thresholds_switch=? | thresholds_percent=? } *

change lun lun_id_list=? { relocation_policy=? | write_policy=? | owner_contrller=? | prefetch_policy=? [ prefetch_multiple=? ] [ prefetch_value=? ] | io_priority=? | read_cache_policy=? | write_cache_policy=? | dif_switch=? | thresholds_switch=? | thresholds_percent=? | mirror_policy=? | zero_data_enabled=? | work_controller=? } *

change lun { lun_id=? | lun_id_list=? } replication_enabled=? block_io_time=?

change lun { lun_id=? | lun_id_list=? } { silence_check_period=? | silence_check_count=? | silence_keep_time=? }

Parameters

Parameter

Description

Value

lun_id=? ID of the LUN whose parameters you want to modify.

To obtain the value, run "show lun general".

name=? New name of the LUN.

The value contains 1 to 31 ASCII characters, including digits, letters, underscores (_), hyphens (-), and periods (.).

relocation_policy=? SmartTier policy.

The value can be "none", "automatic", "lowest_available", or "highest_available", where:

  • "none": Data migration will not be performed.
  • "automatic": The system will automatically determine the data migration direction.
  • "lowest_available": Data will be migrated to a lower-performance tier. For example, data is migrated from the performance tier to the capacity tier.
  • "highest-available": Data will be migrated to a higher-performance tier. For example, data is migrated from the capacity tier to the performance tier.
The default value is "automatic".
write_policy=? Cache write policy.

The value can be "write_through" or "write_back", where:

  • "write_through": write-through. The system considers that a data write is successful only after data is written to disks. Disks are accessed in each data write.
  • "write_back": write-back. After data is written to the cache of the local controller, the system considers that a data write is successful. In addition, the data will be written to the cache of the peer controller as a mirror. When certain conditions are met, the caches write data to disks.
The default value is "write_back".
owner_controller=? Owning controller of a LUN.

The value is in the format of "XA", "XB", "XC", or "XD", where the "X" is an integer ranging from 0 to 3.

prefetch_policy=? Cache prefetch policy.

The value can be "none", "constant", "variable", or "intelligent", where:

  • "none": non-prefetch.
  • "constant": constant prefetch.
  • "variable": variable prefetch.
  • "intelligent": intelligent prefetch.
The default value is "intelligent".
prefetch_multiple=? Cache prefetch multiple. This parameter is required when "prefetch_policy=?" is set to "variable".

The value ranges from 0 to 1024.

prefetch_value=? Cache prefetch size. This parameter is required when prefetch_policy=? is set to constant.

The value ranges from 0 to 1024, expressed in KB.

capacity=? New capacity of a LUN.

The value is in the format of capacity+unit, where the unit can be KB, MB, GB, TB, Blocks, or all.

  • The value ranges from 512 KB to 256 TB.2:One block equals 512 Bytes.
  • When the unit is GB or TB, a decimal number can be used. 4:"all" is used to expand the capacity of an eDevLUN.
io_priority=? I/O priority of a LUN.

The value can be "Low", "Middle", or "High".

read_cache_policy=? Cache read policy of a LUN.

The value can be "Resident", "Default", or "Recycle". The default value is "Default".

write_cache_policy=? Cache write policy of a LUN.

The value can be "Resident", "Default", or "Recycle". The default value is "Default".

dif_switch=? Whether or not to enable the DIF function.

The value can be "yes" or "no", where:

  • "yes": The DIF function will be enabled.
  • "no": The DIF function will not be enabled.
compression_enabled=? Whether the compression function is enabled.

The value can be "yes" or "no", where:

  • "yes": The compression function will be enabled.
  • "no": The compression function will not be enabled. The default value is "no".
compression_method=? LUN compression algorithm.

The value can be "fast" or "deep", where 1:"fast": Speed is the priority. 2:"deep": The compression rate is the priority. The default value is "fast".

dedup_enabled=? Whether to enable the deduplication function.

The value can be "yes" or "no", where

  • "yes": The deduplication function will be enabled.
  • "no": The deduplication function will not be enabled. The default value is "no".
intelligent_dedup_enabled=? Whether to enable the intelligent deduplication function.

The value can be "yes" or "no", where:

  • "yes": The intelligent deduplication function will be enabled.
  • "no": The intelligent deduplication function will not be enabled. The default value is "yes".
bytecomparison_enabled=? Whether to enable the byte-by-byte comparison function.

The value can be "yes" or "no", where:

  • "yes": The byte-by-byte comparison function will be enabled.
  • "no": The byte-by-byte comparison function will not be enabled. The default value is "no".
dedup_metadata_sample_ratio=? Deduplication metadata sampling ratio.

The value can be "1", "2", "4", "8", "16", or "32". A larger sample ratio means a smaller impact on performance. However, the ratio of space saved by deduplication may be affected.

thresholds_switch=? Threshold alarm switch of thin LUNs.

The value can be "off" or "on", where:

  • "off": The threshold alarm function will be enabled.
  • "on": The threshold alarm function will not be enabled.
The default value is "off".
thresholds_percent=? Alarm threshold of thin LUNs.

The value ranges from 50% to 99%.

The default value is "90%".

lun_id_list=? ID list of LUNs whose settings you want to modify.

To obtain the value, run "show lun general". Multiple IDs are separated by commas (,),or LUN ID range separated by hyphens(-).

mirror_policy=? Cache mirror policy of a LUN. This parameter is valid only in developer mode. For details about how to go to the developer mode, see the Restricted Command Reference.

The value can be "Enable" or "Disable", where:

  • "Enable": The cache mirror function will be enabled.
  • "Disable": The cache mirror function will not be enabled.
zero_data_enabled=? Zero data check switch. This parameter is valid only in developer mode. For details about how to go to the developer mode, see the Restricted Command Reference.

The value can be "yes" or "no", where:

  • "yes": The switch will be turned on.
  • "no": The switch will be turned off.
work_controller=? Working controller of a LUN. This parameter is valid only in developer mode. For details about how to go to the developer mode, see the Restricted Command Reference.

The value is in the format of "XA", "XB", "XC" or "XD", where the "X" is an integer ranging from 0 to 3.

replication_enabled=? Value-added feature switch of a deduplication and compression LUN. This parameter can be specified only in developer mode. For details about how to go to the developer mode, see the Restricted Command Reference.

The value can be "yes" or "no", where:

  • "yes": The switch will be turned on.
  • "no": The switch will be turned off.
block_io_time I/O block time when turning on the value-added feature switch of a deduplication and compression LUN. For details about how to go to the developer mode, see the Restricted Command Reference.

The value must be an integer from 5 to 30.

The default value is 15.

silence_check_period=? Check period of the working controller switchover of LUNs triggered by UltraPath. This parameter is valid in developer mode only. For details about how to log in to the developer mode, see the Restricted Command Reference.

The value must be an integer from 2 to 60 minutes.

silence_check_count=? Number of switchovers that triggers the silent state within the check period. This parameter is valid in developer mode only. For details about how to log in to the developer mode, see the Restricted Command Reference.

The value must be an integer from 3 to 100.

silence_keep_time=? Duration of the silent period. This parameter is valid in developer mode only. For details about how to log in to the developer mode, see the Restricted Command Reference.

The value must be an integer from 10 to 43200 minutes.

Level

Administrator

Usage Guidelines

  • Before running this command, ensure that the selected LUN is correct. 2:Before running this command, clean up the cache of application servers that have mappings to the selected LUN.

Example

Changing the capacity of LUN "1" to "300MB".

admin:/>change lun lun_id=1 capacity=300MB
CAUTION: You are about to expand LUN. This operation will expand the capacity of the LUN.
Suggestion: Rescan for the LUN on the server after the capacity expansion.
Do you wish to continue?(y/n)y
Command executed successfully.

System Response

None

Translation
Download
Updated: 2019-04-04

Document ID: EDOC1000084078

Views: 274140

Downloads: 249

Average rating:
This Document Applies to these Products
Related Documents
Related Version
Share
Previous Next