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

OceanStor 18000 and 18000F V5 Series V500R007

This document is applicable to OceanStor 18500 V5, 18800 V5, 18500F V5, and 18800F V5. Based on the CLI provided by DeviceManager, 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 file_system general

change file_system general

Function

The change file_system general command is used to modify file system parameters such as the name, capacity, block size, and owning controller.

Format

change file_system general file_system_id=? { name=? | capacity=? | owner_controller=? | io_priority=? | block_size=? | application_scenario=? | capacity_threshold=? | timing_snapshot_max_number=? | snapshot_reserve=? | split_speed=? | alloc_type=? | space_self_adjusting_mode=? | autosize_enable=? | auto_shrink_threshold_percent=? | auto_grow_threshold_percent=? | min_autosize=? | max_autosize=? | autosize_increment=? | space_recycle_mode=? | ssd_capacity_upper_limit_of_user_data=? | initial_distribute_policy=? | prefetch_policy=? | long_filename_enabled=? | security_style=? [ prefetch_multiple=? ] [ prefetch_value=? ] } * [ description=? | clear_description=? ]

Parameters

Parameter

Description

Value

name=?

Indicates the file system name.

  • The value consists of 1 to 255 ASCII characters including numbers, letters, and underscores (_).
  • To batch create file systems (when "number=?" is specified), the names will be automatically generated. A four-digit number starting from 0000 will be added to a specified name. For example, if the specified name is "FS", the names of the newly created file systems are "FS0000", "FS0001", and so on.
NOTE:

The specified "name=?" cannot exceed 251 characters.

description

File system description.

The value contains 1 to 255 characters.

capacity=?

Indicates the file system capacity.

  • The value can be "capacity+unit". The unit can be MB, GB, TB, or Blocks.
  • The value ranges from 1 GB to 16,384 TB.
  • One block equals 512 bytes.

file_system_id=?

Indicates the file system ID.

The value is an integer between 0 and 65535.

owner_controller=?

Indicates the owning controller of the file system.

The value is in the format of "XA", "XB", "XC", or "XD", where "X" indicates an integer from "0" to "3", for example, "0A" or "1C".

io_priority=?

Indicates the I/O priority.

The value can be "Low", "Middle", or "High", where:

  • "Low": indicates the low priority.
  • "Middle": indicates the medium priority.
  • "High": indicates the high priority.

block_size=?

Indicates the block size of the file system.

The value can be "4KB", "8KB", "16KB", "32KB", or "64KB" with "64KB" being the default.

application_scenario=?

Application scenario of the file system.

  • This parameter cannot be used together with block_size.
  • The parameter value can be "database" or "virtual_machine".

capacity_threshold=?

Indicates the capacity alarm threshold of the file system. When the consumed capacity in the file system exceeds the threshold, alarms will be reported.

  • The value is a percentage (an integer).
  • The value ranges from 50 to 95.

timing_snapshot_max_number=?

Indicates the maximum number of timing snapshots.

The value ranges from 1 to 2048.

snapshot_reserve=?

Indicates the proportion of the space reserved for snapshots.

  • The value is a percentage. The percentage must be an integer.
  • The value ranges from 0 to 50.

split_speed=?

Split speed.

The value can be "Low", "Medium", "High", or "Highest". The default value is "Medium".

space_self_adjusting_mode=?

Sets the automatic capacity adjustment mode.

The value can be "off", "grow", or "grow_shrink", where:

  • "off": disables the automatic capacity adjustment function.
  • "grow": enables the automatic capacity adjustment function. Only automatic expansion is supported.
  • "grow_shrink": enables the automatic capacity adjustment function. Automatic expansion and reduction are supported. The default value is "off".

autosize_enable=?

Switch of automatic capacity adjustment.

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

  • "no": does not enable automatic capacity adjustment.
  • "yes": enables automatic capacity adjustment.

The default value is "yes".

auto_shrink_threshold_percent=?

Percentage threshold that triggers the automatic reduction.

  • The value is a percentage (an integer).
  • The value ranges from 1 to 99.

The default value is 50.

auto_grow_threshold_percent=?

Percentage threshold that triggers the automatic expansion.

  • The value is a percentage (an integer).
  • The value ranges from 1 to 99.

The default value is 85.

min_autosize=?

Lower limit of the automatic reduction.

  • The value can be "capacity+unit". The unit can be MB, GB, TB, or Blocks.
  • The value ranges from 1 GB to 16384 TB.
  • One block equals 512 bytes.

autosize_increment=?

Capacity change of a single expansion/reduction.

  • The value is "capacity+unit". The unit can be MB or GB.
  • The value ranges from 64 MB to 100 GB.

The default value is 1 GB.

max_autosize=?

Upper limit of the automatic expansion.

  • The value can be "capacity+unit". The unit can be MB, GB, TB, or Blocks.
  • The value ranges from 1 GB to 16384 TB.
  • One block equals 512 bytes.

space_recycle_mode=?

Capacity recycle mode.

The value can be "autosize_first" or "delete_snap_first", where:

  • "autosize_first": Automatic expansion is preferred.
  • "delete_snap_first": Automatic snapshot deletion is preferred.

The default value is "autosize_first".

alloc_type

File system type.

The value can be "thick" or "thin".

clear_description

Clears the description.

The value can be:

"Enable": clears the description.

ssd_capacity_upper_limit_of_user_data

SSD capacity upper limit of user data.

  • The value can be "capacity+unit". The unit can be MB, GB, TB, or Blocks.
  • The value ranges from 1 GB to the total capacity of the file system.
  • One block equals 512 bytes.

initial_distribute_policy=?

Indicates the initial space allocation policy.

The value can be "automatic", "extreme_performance", "performance", or "capacity", where:

  • "automatic": The system allocates space to the file system based on the available space on each storage tier.
  • "extreme_performance": The space is first allocated from the high-performance tier.
  • "performance": The space is first allocated from the performance tier.
  • "capacity": The space is first allocated from the capacity tier.

long_filename_enabled=?

Indicates whether to enable the long file name function.

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

  • "yes": To enable the long file name function.
  • "no": Not to enable the long file name function.

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_value

Cache prefetch value. This parameter is unavailable when parameter "prefetch_policy=?" is set to "none". This parameter is mandatory when parameter "prefetch_policy=?" is set to "constant" or "intelligent".

When the value of "prefetch_policy=?" is "constant", this parameter ranges from 0 to 1024, expressed in KB. When the value is "intelligent", this parameter ranges from 1024 to 16384, expressed in KB. The default value is 4096.

prefetch_multiple

Cache prefetch multiple. This parameter is required when "prefetch_policy=?" is set to "variable".

The value ranges from 0 to 1024.

security_style=?

Security style supported by a file system.

The value can be "Mixed" or "Native", where:

  • "Mixed": mixed security style.
  • "Native": native security style.

Level

Administrator

Usage Guidelines

Before running this command, ensure that the selected file system is exactly the one you want to modify its settings.

Example

  • Modify the file system configuration as follows: Capacity alarm threshold: 50% File system name: fs003 Owning controller: 0B I/O priority: medium Reserved space for snapshots: 20% Maximum number of timing snapshots: 20.
    admin:/>change file_system general file_system_id=0 capacity_threshold=50 name=fs003 owner_controller=0B io_priority=Middle snapshot_reserve=20 timing_snapshot_max_number=20 
    WARNING: You are about to change the priority or the cache prefetch policy of file system. 
    This operation may affect the file system performance. 
    Suggestion:Before performing this operation, ensure that the preceding risk is acceptable and the correct file system is selected. 
    Have you read warning message carefully?(y/n)y 
    Are you sure you really want to perform the operation?(y/n)y 
    Command executed successfully.
  • Change the prefetch policy of file system "1" to "none".
    admin:/>change file_system general file_system_id=1 prefetch_policy=none 
    WARNING: You are about to change the priority or the cache prefetch policy of file system. This operation may affect the file system performance. 
    Suggestion: Before performing this operation, ensure that the preceding risk is acceptable and the correct file system is selected. 
    Have you read warning message carefully?(y/n)y 
    Are you sure you really want to perform the operation?(y/n)y 
    Command executed successfully.

System Response

None

Translation
Download
Updated: 2019-09-02

Document ID: EDOC1000181601

Views: 328775

Downloads: 41

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