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

OceanStor 2200 V3 and 2600 V3 Storage System V300R005 Command Reference 06

"Based on the CLI provided by the DeviceManager, this document describes how to use variouscommands classified by functions and how to set the CLI and manage the storage system throughthese commands."
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).
create file_system general

create file_system general

Function

The create file_system general command is used to create a file system. After a storage pool is created, allocate the space in the storage pool to one or multiple file systems so that application servers can use the storage resources properly.

Format

create file_system general name=? pool_id=? [ initial_distribute_policy=? ] [ capacity=? ] [ file_system_id=? ] [ alloc_type=? ] [ number=? ] [ owner_controller=? ] [ io_priority=? ] [ compression_enabled=? ] [ compression=? ] [ dedup_enabled=? ] [ intelligent_dedup_enabled=? ] [ bytecomparison_enabled=? ] [ dedup_metadata_sample_ratio=? ] [ checksum_enabled=? ] [ atime_enabled=? ] [ show_enabled=? ] [ auto_delete_snapshot_enabled=? ] [ timing_snapshot_enabled=? ] [ block_size=? ] [ capacity_threshold=? ] [ snapshot_reserve=? ] [ timing_snapshot_max_number=? ] [ sub_type=? [ worm_type=? ] | auto_delete_enabled=? | auto_lock_enabled=? | default_protect_period=? | default_protect_period_unit=? | min_protect_period=? | min_protect_period_unit=? | max_protect_period=? | max_protect_period_unit=? | auto_lock_time=? | auto_lock_time_unit=? ] [ smart_cache_state=? ]

Parameters

Parameter

Description

Value

name=? Indicates the file system name.
  • The value consists of 1 to 255 ASCII characters including numbers, letters, underscores (_), hyphens (-), and periods (.).
  • 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. The specified name "name=?" can not exceed 251 characters.
pool_id=? Indicates the owning storage pool of the file system.

Run the "show storage_pool general" command to obtain the value.

capacity=? Indicates the capacity of the file system.
  • The value is in the format of "capacity value+unit of capacity". The unit can be MB, GB,TB or Blocks.
  • The value ranges from 1 GB to 16,384 TB.
  • One blocks equals 512 Bytes.
file_system_id=? Indicates the file system ID.

The value is an integer between 0 and 65535. If the value is not specified, the system automatically allocates an ID of the newly created file system.

alloc_type=? Indicates the allocation type of the file system.

The value can be "thick" or "thin", where,

  • "thick": When thick file systems are created, fixed capacity is allocated to them.
  • "thin": Capacity of thin file systems will be automatically expanded when the capacity is about to be used up. The capacity cannot exceed the threshold (specified by the "capacity" parameter).
The default value is "thin".
number=? Indicates the number of file systems that are batch created. If this parameter is specified, the "file_system_id=?" parameter cannot be specified.

The value ranges from 2 to 100. The default value is 1.

owner_controller=? Indicates the owning controller of the file system.

The value is in the format of XA or XB or XC or XD.X can be 0 to 3.

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.
The default value is "Low".
dedup_enabled=? Indicates whether to enable the deduplication function.

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

  • "yes": To enable the deduplication function.
  • "no": Not to enable the deduplication function.
The default value is "no".
intelligent_dedup_enabled=? Indicates whether to enable the intelligent deduplication function.

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

  • "yes": To enable the intelligent deduplication function.
  • "no": Not to enable the intelligent deduplication function.
The default value is "yes".
bytecomparison_enabled=? Indicates whether the byte_by_byte comparison function is enabled.

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 is "no".
dedup_metadata_sample_ratio=? Indicates the deduplication metadata sample 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.

compression_enabled=? Indicates whether to enable the compression function.

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

  • "yes": To enable the compression function.
  • "no": Not to enable the compression function.
The default value is "no".
compression_method=? Indicates the compression algorithm of the file system.

The value can be "fast" or "deep", where

  • "fast": fast compression.
  • "deep": deep compression.
The default value is "fast".
checksum_enabled=? Indicates whether to enable the checksum function.

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

  • "yes": To enable the checksum function.
  • "no": Not to enable the checksum function.
The default value is "yes".
atime_enabled=? Indicates whether to enable the atime function.

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

  • "yes": To enable the atime function.
  • "no": Not to enable the atime function.
show_enabled=? Indicates whether to show the snapshot directory.

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

  • "yes": To show the snapshot directory.
  • "no": Not to show the snapshot directory.
auto_delete_snapshot_enabled=? Indicates whether to enable the function of automatically deleting periodic snapshots.

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

  • "yes": To enable the function of automatically deleting periodic snapshots.
  • "no": Not to enable the function of automatically deleting periodic snapshots.
timing_snapshot_enabled=? Indicates whether to enable the periodic snapshots function.

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

  • "yes": To enable the periodic snapshots function.
  • "no": Not to enable the periodic snapshots function.
block_size=? Indicates the size of the file system block.

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

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. The percentage must be a whole number.
  • The value ranges from 50 to 95.
snapshot_reserve=? Indicates the proportion of reserved snapshots.
  • The value is a percentage. The percentage must be a whole number.
  • The value ranges from 0 to 50.
timing_snapshot_max_number=? Indicates the maximum number of periodic snapshots.

The value ranges from 1 to 2048 with 16 being the default.

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 allocated from the high-performance tier.
  • "performance": The space is allocated from the performance tier.
  • "capacity": The space is allocated from the capacity tier.
The default value is "automatic".
sub_type=? The type of a file system.

The value is "normal", "worm". The default type is "normal".

auto_delete_enabled=? Whether to enable automatic deletion.

The value is "yes" or "no", where:

  • "yes": to enable automatic deletion.
  • "no": not to enable automatic deletion.The default value is "no".
auto_lock_enable=? Whether to enable automatic lock.

The value is "yes" or "no", where:

  • "yes": to enable automatic lock.
  • "no": not to enable automatic lock. The default value is "yes".
auto_lock_time=? Automatical locking wait time.

The value ranges between 2 and 168. The default value is 2. The default unit is hour.

auto_lock_time_unit=? Unit of the automatical locking wait time.

The unit can be hour or day. The default unit is hour.

max_protect_period=? Maximum protection period.

The value ranges between 0 and 70. If the value is not specified, the protection period is eternal. The default value is 70.

max_protect_period_unit=? Unit of the maximum protection period.

The unit can be year, month, or day. The default unit is year.

default_protect_period=? Default protection period.

The value ranges between 0 and 70. If the value is not specified, the protection period is eternal. The default value is 70.

default_protect_period_unit=? Unit of the default protection period.

The unit can be year, month, or day. The default unit is year.

min_protect_period=? Minimum protection period.

The value ranges between 0 and 70. If the value is not specified, the protection period is eternal. The default value is 3.

min_protect_period_unit=? Unit of the minimum protection period.

The unit can be year, month, or day. The default unit is year.

worm_type=? The WORM type of a file system.

The value is "compliance".

smart_cache_state=? Indicates whether to enable the smart cache function.

The value is "on" or "off", where:

  • "off": not to enable smart cache.
  • "on": to enable smart cache. The default value is "off".

Level

Administrator

Usage Guidelines

  • The units of "max_protect_period=?", "default_protect_period=?", and "min_protect_period=?" can be specified only when the parameters are specified.
  • The WORM parameters can be specified only when the "sub_type" is specified to WORM.
  • This command does not support OceanStor 2200 V3 storage system.

Example

  • To create a file system whose name is fs001, storage pool ID is 0, capacity is 10 GB, and allocation type is thick, run the following command.

    admin:/>create file_system general name=fs001 pool_id=0 initial_distribute_policy=automatic capacity=10GB alloc_type=thick
    Command executed successfully.
  • To check the file system you created, run the following command.

    admin:/>show file_system general file_system_id=0
      ID                                   : 0          
      Name                                 : fs001      
      Pool ID                              : 0          
      Smart Cache Partition ID             : --         
      Cache Partition ID                   : --         
      Initial Distribute Policy            : Automatic  
      Health Status                        : Normal     
      Running Status                       : Online     
      Capacity                             : 10.000GB   
      Description                          :            
      Type                                 : Thick      
      Snapshot Reserve(%)                  : 20         
      Owner Controller                     : 0A         
      Work Controller                      : 0A         
      IO Priority                          : Low        
      Block Size                           : 64.000KB   
      Checksum Enabled                     : Yes        
      Atime Enabled                        : No         
      Show Snapshot Directory Enabled      : Yes        
      Available Capacity                   : 7.803GB    
      Capacity Threshold(%)                : 90         
      Auto Delete Snapshot Enabled         : No         
      Snapshot Used Capacity               : 0.000B     
      Timing Snapshot Max Number           : 16         
      Snapshot Reserve Capacity            : --         
      Timing Snapshot Enabled              : No         
      Timing Snapshot Schedule ID          : --         
      Snapshot Background Freeing Capacity : --         
      Used Capacity Ratio(%)               : 2          
      Dedup Enabled                        : No         
      Byte_by_byte Comparison Enabled      : No         
      Compression Enabled                  : No         
      Compression Method                   : Fast       
      Dedup Saved Capacity                 : 0.000B     
      Dedup Saved Ratio(%)                 : 0          
      Compression Saved Capacity           : 0.000B     
      Compression Saved Ratio(%)           : 0          
      Total Saved Capacity                 : 0.000B     
      Total Saved Ratio(%)                 : 0          
      Smart Cache Cached Size              : 0.000B     
      Smart Cache Hit Rage(%)              : 0          
      Sub Type                             : Normal     
      Remote Replication ID(s)             : --         
      Intelligent Dedup Enabled            : Yes        
      Dedup Running Status                 : No         
      Traverse Dir Adapter                 : No         
      Dedup MetaData Sample Ratio          : 1          
  • To create a 2GB WORM file system with its parameters specified, run the following command.

    admin:/>create file_system general name=worm2 pool_id=0 sub_type=worm worm_type=compliance auto_lock_enabled=yes auto_lock_time=10 auto_lock_time_unit=hour auto_delete_enabled=yes min_protect_period=4 min_protect_period_unit=year max_protect_period=70 max_protect_period_unit=year default_protect_period=60 default_protect_period_unit=year capacity=2GB auto_delete_snapshot_enabled=yes
    WARNING: You are about to create the file system. This operation may cause the following issues: 
    1. If the specified file system capacity is less than or equal to 3 GB, value-added services, host services, and switching the working controller of the file system may time out. 
    2. If the value of the file system's "auto_delete_enabled" parameter is set to "yes", this operation deletes outdated files from the file system. 
    3. If the value of the file system's "auto_delete_snapshot_enabled" parameter is set to "yes", this operation deletes read-only snapshots from the file system when the file system space is about to be used up. 
    Suggestion: 
    1. Before performing this operation, select a proper file system space. It is recommended that the file system space be greater than 3 GB. 
    2. Before performing this operation, ensure that you select a correct file system and read-only snapshots under the file system can be deleted.
    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.
     
  • To check the WORM file system you created, run the following command.

    admin:/>show file_system general file_system_id=0
      ID                                   : 0         
      Name                                 : worm2     
      Pool ID                              : 0         
      Smart Cache Partition ID             : --        
      Cache Partition ID                   : --        
      Initial Distribute Policy            : Automatic 
      Health Status                        : Normal    
      Running Status                       : Online    
      Capacity                             : 2.000GB   
      Description                          :           
      Type                                 : Thin      
      Snapshot Reserve(%)                  : 20        
      Owner Controller                     : 0A        
      Work Controller                      : 0A        
      IO Priority                          : Low       
      Block Size                           : 64.000KB  
      Checksum Enabled                     : Yes       
      Atime Enabled                        : No        
      Show Snapshot Directory Enabled      : Yes       
      Available Capacity                   : 1.320GB   
      Capacity Threshold(%)                : 90        
      Auto Delete Snapshot Enabled         : Yes       
      Snapshot Used Capacity               : 0.000B    
      Timing Snapshot Max Number           : 16        
      Snapshot Reserve Capacity            : --        
      Timing Snapshot Enabled              : No        
      Timing Snapshot Schedule ID          : --        
      Snapshot Background Freeing Capacity : --        
      Used Capacity Ratio(%)               : 17        
      Dedup Enabled                        : No        
      Byte_by_byte Comparison Enabled      : No        
      Compression Enabled                  : No        
      Compression Method                   : Fast      
      Dedup Saved Capacity                 : 0.000B    
      Dedup Saved Ratio(%)                 : 0         
      Compression Saved Capacity           : 0.000B    
      Compression Saved Ratio(%)           : 0         
      Total Saved Capacity                 : 0.000B    
      Total Saved Ratio(%)                 : 0         
      Smart Cache Cached Size              : 0.000B                         
      Smart Cache Hit Rage(%)              : 0                              
      Sub Type                             : Worm                           
      Remote Replication ID(s)             : --                             
      Intelligent Dedup Enabled            : Yes                            
      Dedup Running Status                 : No                             
      Traverse Dir Adapter                 : No 
      Dedup MetaData Sample Ratio          : 1                                             

System Response

None

Translation
Download
Updated: 2019-07-22

Document ID: EDOC1000106139

Views: 316747

Downloads: 208

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