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

Advanced O&M 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, this document describes how to use various commands classified by functionsand how to set the CLI and manage the storage system through these 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).
change service nfs_config

change service nfs_config

Function

The change service nfs_config command is used to modify the NFS common configuration.

Format

change service nfs_config { communication_thread_number=? | work_thread_number=? | max_block_size=? | { permit_listen_ip=? | deny_listen_ip=? } | { permit_client=? | deny_client=? } | communication_thread_priority=? | silent_time=? | fileid_length=? | transcode_switch=? | nsm_query_dns_switch=? | v3_automount_switch=? | v4_automount_switch=? | v41_automount_switch=? | extended_groups_switch=? | extended_groups_limit=? | slow_io_percent=? | nobody_uid=? | { default_win_user=? | clear_default_win_user=? } | flow_control_switch=? | flow_control_percent=? | flow_control_timedelay=? } *

change service nfs_config { communication_thread_number=? | work_thread_number=? | max_block_size=? | { permit_listen_ip=? | deny_listen_ip=? } | { permit_client=? | deny_client=? } | communication_thread_priority=? | silent_time=? | fileid_length=? | transcode_switch=? | nsm_query_dns_switch=? | v3_automount_switch=? | v4_automount_switch=? | v3_iotrace_switch=? | v4_iotrace_switch=? | v41_automount_switch=? | extended_groups_switch=? | extended_groups_limit=? | nfs_thread_pool_mode=? | max_request_number=? | nfs_send_detach_switch=? | slow_io_percent=? | nobody_uid=? | { default_win_user=? | clear_default_win_user=? } | flow_control_switch=? | flow_control_percent=? | flow_control_timedelay=? } *

change service nfs_config { v3_automount_switch=? | v4_automount_switch=? | v41_automount_switch=? | extended_groups_switch=? | extended_groups_limit=? | nobody_uid=? | { default_win_user=? | clear_default_win_user=? } } *

change service nfs_config { v3_automount_switch=? | v4_automount_switch=? | v3_iotrace_switch=? | v4_iotrace_switch=? | v41_automount_switch=? | extended_groups_switch=? | extended_groups_limit=? | nobody_uid=? | { default_win_user=? | clear_default_win_user=? } } *

Parameters

Parameter

Description

Value

communication_thread_number=? Number of NFS-based communication threads.

The value ranges from 1 to 128.

work_thread_number=? Number of NFS-based working threads.

The value ranges from 1 to 128.

max_block_size=? NFS MTU.

The value ranges from 1024 to 1,048,576.

permit_listen_ip=? Whitelist of NFS listening IP addresses.

A maximum of 31 IP addresses can be entered. Separate IP addresses with a comma (,). An asterisk (*) indicates all IP addresses.

deny_listen_ip=? Blacklist of NFS listening IP addresses.

A maximum of 31 IP addresses can be entered. Separate IP addresses with a comma (,). An asterisk (*) indicates all IP addresses.

permit_client=? Whitelist of NFS clients.

You can enter an asterisk (*) to add all clients to the whitelist.

deny_client=? Blacklist of NFS clients.

A maximum of 31 IP addresses can be entered. Separate IP addresses with a comma (,).

communication_thread_priority=? Priority of NFS-based communication threads.

The value format can be "highest", "high", "middle", or "normal".

transcode_switch=? Whether to enable or disable NFS transcoding.

The value can be "enable" or "disable", where:

  • "enable": enables the NFS transcoding function.
  • "disable": disables the NFS transcoding function.
silent_time=? NFS silent period duration.

The value ranges from 30 to 90 seconds.

fileid_length=? NFS file ID length.

The value can be "32" or "64", where:

  • "32": enables the storage array to support clients with 32-bit file IDs.
  • "64": enables the storage array to support clients with 64-bit file IDs.
nsm_query_dns_switch=? Whether to enable or disable the function of NSM to query DNS host names.

The value can be "enable" or "disable", where:

  • "enable": enables the function of NSM to query DNS host names.
  • "disable": disables the function of NSM to query DNS host names.
v3_automount_switch=? Whether to enable or disable the function of automatically mounting directories for NFSv3 (vStore).

The value can be "enable" or "disable", where:

  • "enable": enables the function of automatically mounting directories for NFSv3.
  • "disable": disables the function of automatically mounting directories for NFSv3.
v4_automount_switch=? Whether to enable or disable the function of automatically mounting directories for NFSv4 (vStore).

The value can be "enable" or "disable", where:

  • "enable": enables the function of automatically mounting directories for NFSv4.
  • "disable": disables the function of automatically mounting directories for NFSv4.
v3_iotrace_switch=? Whether to enable or disable the NFSv3 I/O trace function.

The value can be "enable" or "disable", where:

  • "enable": enables the NFSv3 I/O trace function.
  • "disable": disables the NFSv3 I/O trace function.
v4_iotrace_switch=? Whether to enable or disable the NFSv4 I/O trace function.

The value can be "enable" or "disable", where:

  • "enable": enables the NFSv4 I/O trace function.
  • "disable": disables the NFSv4 I/O trace function.
v41_automount_switch=? Whether to enable or disable the function of automatically mounting directories for NFSv4.1 (vStore).

The value can be "enable" or "disable", where:

  • "enable": enables the function of automatically mounting directories for NFSv4.1.
  • "disable": disables the function of automatically mounting directories for NFSv4.1.
extended_groups_switch=? Enables or disables the extended group function (vStore).

The value can be "enable" or "disable", where:

  • "enable": enables the extended group function.
  • "disable": disables the extended group function.
extended_groups_limit=? Number of extended groups (vStore).

The value ranges from 16 to 256.

nfs_thread_pool_mode=? NFS thread pool mode.

The value can be "global" or "percpu", where:

  • "global": Multiple CPUs correspond to one thread pool.
  • "percpu": One CPU corresponds to one thread pool.
max_request_number=? Maximum number of concurrent NFS requests.

The value ranges from 1024 to 2560.

nfs_send_detach_switch=? Whether to separate NFS package receiving and sending.

The value can be "disable" or "enable", where:

  • "disable": NFS package receiving and sending are not separated.
  • "enable": NFS package receiving and sending are separated.
slow_io_percent=? Percentage of slow I/O requests.

The value must be an integer from 1 to 100.

nobody_uid=? ID of the nobody user.

The value must be an integer from 0 to 4294967295.

default_win_user=? Default Windows user of the NFS user mapping.

The value is a string of 1 to 255 characters. The value cannot be "/[]:;|=,+*?<>@, spaces, or control characters, and cannot end with a period (.). The name of an AD domain user must be entered in the format of domain name\\domain user name. This parameter is valid only when the user mapping is enabled.

clear_default_win_user=? Deletes the default Windows user of the NFS user mapping.

The value is "yes".

flow_control_switch=? Switch of NFS I/O flow control.

The value can be "enable" or "disable", where: 1:"enable": enables the CIFS I/O flow control switch. 0:"disable": disables the CIFS I/O flow control switch.

flow_control_percent=? Percentage of the number of NFS slow I/O requests to the total number of requests in flow control.

The value must be an integer from 10 to 100.

flow_control_timedelay=? Delay threshold of NFS I/O flow control.

The value must be an integer from 1 to 360000.

Views

Guest, Developer view, vstore developer view, vstore user view

Usage Guidelines

None

Example

  • Query the NFS common configuration before modification.

    admin:/>show service nfs_config
    Communication Thread Number   : 100
    Work Thread Number       : 100
    Max Block Size         : 10240
    Listen IP            : deny 192.168.1.1
    Client List           : deny 192.168.1.1
    Communication Thread Priority : normal
    Transcode Switch Status    : Enabled
    Silent Time(s)         : 60
    Fileid Length(bit)       : 64
    Nsm Query Dns Switch Status : Enabled
    NFSv3 Automount Switch      : Disabled
    NFSv4 Automount Switch      : Disabled
    NFSv4.1 Automount Switch    : Disabled
    Extended Groups Switch      : Disabled
    Extended Groups Limit       : 32
    Slow I/O Percent(%)         : 50
    Nobody ID                   : 65534
    Default Windows User        : --
    Flow Control Switch         : Disabled
    Flow Control Percent(%)     : 50
    Flow Control Timedelay(ms)  : 200
  • Change the number of NFS-based communication threads.

    admin:/>change service nfs_config communication_thread_number=100
    Command executed successfully.
  • Change the maximum number of working threads allowed in sharing.

    admin:/>change service nfs_config work_thread_number=100
    Command executed successfully.
  • Change the MTU.

    admin:/>change service nfs_config max_block_size=10240
    Command executed successfully.
  • Modify the blacklist of listening IP addresses.

    admin:/>change service nfs_config permit_listen_ip=*
    Command executed successfully.
  • Modify the blacklist of client IP addresses.

    admin:/>change service nfs_config permit_client=*
    Command executed successfully.
  • Change the priority of the NFS-based communication threads.

    admin:/>change service nfs_config communication_thread_priority=high
    Command executed successfully.
  • Change the NFS silent time.

    admin:/>change service nfs_config silent_time=80
    Command executed successfully.
  • Enable NFS to support clients with 32-bit file IDs.

    admin:/>change service nfs_config fileid_length=32
    WARNING: This operation will change the type of NFS clients (with 32-bit or 64-bit file ID) supported by the storage array. After this operation, the NFS client services may be interrupted. 
    Suggestion: Before performing this operation, ensure that this operation is necessary.
    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.
  • Enable or disable NFS transcoding.

    admin:/> change service nfs_config transcode_switch=disable
    Command executed successfully.
  • Enable or disable the function of NSM to query DNS host names.

    admin:/> change service nfs_config nsm_query_dns_switch=disable
    Command executed successfully.
  • Enable or disable the function of automatically mounting directories for NFSv3.

    admin:/>change service nfs_config v3_automount_switch=enable
    WARNING: You are about to enable or disable the function of automatically mounting directories for NFS. This operation may cause service interruption. If services are interrupted, mount shares again.
    Suggestion: Confirm that you want to perform this operation based on the service type.
    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.
  • Enable or disable the function of automatically mounting directories for NFSv4.

    admin:/>change service nfs_config v4_automount_switch=enable
    WARNING: You are about to enable or disable the function of automatically mounting directories for NFS. This operation may cause service interruption. If services are interrupted, mount shares again.
    Suggestion: Confirm that you want to perform this operation based on the service type.
    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.
  • Enable or disable the function of automatically mounting directories for NFSv4.1.

    admin:/>change service nfs_config v41_automount_switch=enable
    WARNING: You are about to enable or disable the function of automatically mounting directories for NFS. This operation may cause service interruption. If services are interrupted, mount shares again.
    Suggestion: Confirm that you want to perform this operation based on the service type.
    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.
  • Enable or disable the extended group function.

    admin:/>change service nfs_config extended_groups_switch=disable
    Command executed successfully.
  • Change the number of extended groups.

    admin:/>change service nfs_config extended_groups_limit=64
    Error: The extended group function is not enabled.
    Suggestion: Enable the extended group function and then try again.
  • Change the default Windows user of the NFS user mapping.

    admin:/>change service nfs_config default_win_user=win_user
    WARNING: You are about to change the default Windows user of the NFS user mapping. If the versions of storage systems at the two active-active ends are different, after the working site switchover, users without the mapping relationship cannot access the NFS share service. 
    Suggestion: If the versions of storage systems at the two active-active ends are different, configure the user mapping before performing this operation.
    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.
  • Enable or disable the NFS I/O flow control switch.

    admin:/>change service nfs_config flow_control_switch=enable
    Command executed successfully.
  • Change the percentage of NFS slow I/O requests in flow control.

    admin:/>change service nfs_config flow_control_percent=20
    Command executed successfully.
  • Change the delay threshold of NFS I/O flow control.

    admin:/>change service nfs_config flow_control_timedelay=100
    Command executed successfully.
  • Query the NFS common configuration after modification.

    admin:/>show service nfs_config
    Communication Thread Number  : 100
    Work Thread Number       : 100
    Max Block Size         : 10240
    Listen IP            : permit *
    Client List           : permit *
    Communication Thread Priority : high
    Transcode Switch Status    : Disabled
    Silent Time(s)         : 80
    Fileid Length(bit)       : 32
    Nsm Query Dns Switch Status : Disabled
    NFSv3 Automount Switch      : Enabled
    NFSv4 Automount Switch      : Enabled
    NFSv4.1 Automount Switch    : Enabled
    Extended Groups Switch      : Disabled
    Extended Groups Limit       : 32
    Nobody UID                  : 65534
    Default Windows User        : win_user
    Flow Control Switch         : Enabled
    Flow Control Percent(%)     : 20
    Flow Control Timedelay(ms)  : 100
  • Enable or disable the function of automatically mounting directories for NFSv3 in a vStore.

    admin@vstore1:/>change service nfs_config v3_automount_switch=enable
    WARNING: You are about to enable or disable the function of automatically mounting directories for NFS. This operation may cause service interruption. If services are interrupted, mount shares again.
    Suggestion: Confirm that you want to perform this operation based on the service type.
    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.
  • Enable or disable the function of automatically mounting directories for NFSv4 in a vStore.

    admin@vstore1:/>change service nfs_config v4_automount_switch=enable
    WARNING: You are about to enable or disable the function of automatically mounting directories for NFS. This operation may cause service interruption. If services are interrupted, mount shares again.
    Suggestion: Confirm that you want to perform this operation based on the service type.
    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.
  • Enable or disable the function of automatically mounting directories for NFSv4.1 in a vStore.

    admin@vstore1:/>change service nfs_config v41_automount_switch=enable
    WARNING: You are about to enable or disable the function of automatically mounting directories for NFS. This operation may cause service interruption. If services are interrupted, mount shares again.
    Suggestion: Confirm that you want to perform this operation based on the service type.
    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.
  • Query NFS configurations in a vStore after modification.

    admin@vstore1:/>show service nfs_config
    NFSv3 Automount Switch   : Enabled
    NFSv4 Automount Switch   : Enabled
    NFSv4.1 Automount Switch : Enabled
    Extended Groups Switch   : Disabled
    Extended Groups Limit    : 32
    Nobody UID               : 65534
    Default Windows User     : --
  • Enable or disable the NFSv3 I/O trace function in the vStore developer view.

    developer@vstore1:/>change service nfs_config v3_iotrace_switch=enable
    WARNING: You are about to enable the NFS I/O trace function. This operation may degrade the NFS service performance.
    Suggestion: Confirm that you want to perform this operation based on the service type.
    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.
  • Enable or disable the NFSv4 I/O trace function in the vStore developer view.

    developer@vstore1:/>change service nfs_config v4_iotrace_switch=enable
    WARNING: You are about to enable the NFS I/O trace function. This operation may degrade the NFS service performance.
    Suggestion: Confirm that you want to perform this operation based on the service type.
    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.
  • Enable or disable the extended group function in a vStore.

    admin@vstore1:/>change service nfs_config extended_groups_switch=enable
    WARNING: You are about to enable the extended group function. This operation may degrade the NFS service performance.
    Suggestion: Confirm that you want to perform this operation.
    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 number of extended groups in a vStore.

    admin@vstore1:/>change service nfs_config extended_groups_limit=64
    Command executed successfully.
  • Query the modified NFS configurations in the vStore developer view.

    developer@vstore1:/>show service nfs_config
    NFSv3 Automount Switch   : Enabled
    NFSv4 Automount Switch   : Enabled
    NFSv3 I/O Trace Switch   : Enabled
    NFSv4 I/O Trace Switch   : Enabled
    NFSv4.1 Automount Switch : Enabled
    Extended Groups Switch   : Enabled
    Extended Groups Limit    : 64
    Nobody UID               : 65534
    Default Windows User     : win_user
  • Change the NFS thread pool mode.

    developer:/>change service nfs_config nfs_thread_pool_mode=global
    CAUTION: You are about to modify the NFS service. The modification does not take effect immediately. You need to restart the NFS service for the modification to take effect.
    Suggestion: Restart the NFS service after the modification.
    Do you wish to continue?(y/n)y
    Command executed successfully.
  • Change the maximum number of concurrent NFS requests.

    developer:/>change service nfs_config max_request_number=1024
    CAUTION: You are about to modify the NFS service. The modification does not take effect immediately. You need to restart the NFS service for the modification to take effect.
    Suggestion: Restart the NFS service after the modification.
    Do you wish to continue?(y/n)y
    Command executed successfully.
  • Enable or disable the function of separating NFS package receiving and sending.

    developer:/>change service nfs_config nfs_send_detach_switch=disable
    CAUTION: You are about to modify the NFS service. The modification does not take effect immediately. You need to restart the NFS service for the modification to take effect.
    Suggestion: Restart the NFS service after the modification.
    Do you wish to continue?(y/n)y
    Command executed successfully.
  • Change the percentage of slow I/O requests.

    admin:/>change service nfs_config slow_io_percent=60
    Command executed successfully.
  • Change the ID of the nobody user.

    admin:/>change service nfs_config nobody_id=65534
    Command executed successfully.

System Response

None

Translation
Download
Updated: 2020-01-17

Document ID: EDOC1000181602

Views: 760000

Downloads: 66

Average rating:
This Document Applies to these Products

Related Version

Related Documents

Share
Previous Next