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 5300 V3, 5500 V3, 5600 V3, 5800 V3, and 6800 V3 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 initiator

change initiator

Function

The change initiator command is used to modify initiator attributes, including the CHAP status, initiator alias, and multipathing mode. This command can also be used to replace initiators.

Format

change initiator initiator_type=? [ wwn=? ] [ iscsi_iqn_name=? ] [ new_wwn=? ] [ new_iscsi_iqn_name=? ] [ alias=? ] [ chap_enabled=? ] [ discovery_chap_type=? ] [ normal_chap_type=? ] [ chap_user=? ] [ chap_target_user=? ] [ multipath_type=? [ failover_mode=? [ special_mode_type=? ] ] [ path_type=? ] ]

Parameters

Parameter

Description

Value

initiator_type=? Type of an initiator.

The value can be "iSCSI" or "FC", where:

  • "iSCSI": indicates Internet Small Computer System Interface (iSCSI) initiators.
  • "FC": indicates Fibre Channel initiators.
wwn=? WWN of a Fibre Channel initiator.

To obtain the value, run "show initiator".

iscsi_iqn_name=? IQN of an iSCSI initiator.

To obtain the value, run "show initiator".

chap_enabled=? iSCSI initiator CHAP switch.

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

  • "yes": CHAP authentication will be enabled.
  • "no": CHAP authentication will be disabled.
discovery_chap_type=? CHAP type at the iSCSI discover phase. When "chap_enabled=?" is set to "yes", this parameter is available.

The value can be:

1."none".

2."single".

3."double".

normal_chap_type=? CHAP type at the iSCSI normal phase. This parameter is available only when "chap_enabled=?" is set to "yes".

The value can be:

1."none".

2."single".

3."double".

chap_user=? CHAP username. This parameter is mandatory when "chap_enabled=?" is set to "yes".

The value contains 4 to 223 characters (32 < ASCII code < 127) and must start with a letter or a digit.

chap_target_user=? CHAP username for the initiator to authenticate the target. This parameter is available only when "chap_enabled=?" is set to "yes".

The value contains 4 to 223 characters (32 < ASCII code < 127) and must start with a letter or a digit.

alias=? Initiator alias.

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

multipath_type=? Multipathing mode.

The value can be "default" or "third-party", where:

  • default: Huawei multipathing software is used.
  • third-party: Third-party multipathing software is used.
The default value is "default".
failover_mode=? Failover mode of the initiator after the update.

The value can be "old_alua", "common_alua", "no_alua", or "special_mode", where:

  • old_alua: ALUA of an earlier version.
  • common_alua: common ALUA.
  • no_alua: ALUA not used.
  • special_mode: special mode ALUA.
The default value is "old_alua".
path_type=? Path type after the update.

The value can be "non-optimized" or "optimized", where:

  • non-optimized: non-optimized path.
  • optimized: optimized path.
The default value is "optimized".
new_wwn=? WWN of the Fibre Channel initiator after the update.

The value is a hexadecimal number that contains 16 characters including letters A to F and digits 0 to 9.

new_iscsi_iqn_name=? IQN of the iSCSI initiator after the update.

The value contains 1 to 223 characters (32 < ASCII code < 127) and must start with a letter or a digit.

special_mode_type=? Special mode type of the initiator.

The value ranges from "mode0" to "mode15". Run the "show tgt_alua_config switch" command to obtain the switch value of the special mode type. If the switch value is "on", the special mode type is valid; otherwise, the special mode type is invalid, press Ctrl+A to view the available list.

noop_in_interval Interval of iSCSI targets sending keepalive packets to initiators.

The value can be "fast", "normal", "middle" or "slow".

Level

Administrator

Usage Guidelines

  • After CHAP authentication is enabled, a host can access the storage system using the corresponding initiator only when the host's CHAP user name and password match those of the storage system.
  • A new initiator will inherit all characteristics and mappings of the replaced initiator. For example, if an initiator has been allocated to a mapping view and added to a specific host, the new initiator will be allocated to the same mapping view and also be added to the host.
  • If "chap_enabled=?" is set to "yes", the system will prompt you to enter CHAP passwords in interaction mode after running this command. The passwords must meet the following requirements:
    • Each password is case sensitive and contains 12 to 16 characters.
    • Each password must be a combination of at least three of the following items:
      • Lowercase letters
      • Uppercase letters
      • Digits
      • Special characters including ` ~ ! @ # $ % ^ & * ( ) - _ = + \ | [ { } ] ; : ' " , < . > / ?
    • Each password must be different from the user name and mirror writing of the user name.
  • The "chap_enable=yes,discovery_chap_type=none,normal_chap_type=none" command cannot be executed.
  • If only unidirectional authentication is enabled, the execution of the command with "chap_target_user" (user name for bidirectional authentication) will fail.
  • If the "discovery_chap_type=none,normal_chap_type=none" command contains "chap_target_user/chap_user", the execution of the command will fail.
  • The failover mode and path type only take effect when the multipathing mode is "Third-party".
  • Parameters of "multipath_type", "failover_mode", "path_type", and "special_mode_type" must be set based on the multipathing type and host operating system version. For recommended configurations in different scenarios, see the description of configuring multipathing in the Huawei SAN Storage Host Connectivity Guide for your desired operating system.

Example

  • Set the attributes of the Fibre Channel initiator whose WWN is "455856585f654578" as follows: Alias to "newfc" Multipathing mode to "Third-party" Failover mode to "common_alua" Path type to "Optimized".

    admin:/>change initiator initiator_type=FC wwn=455856585f654578 alias=newfc multipath_type=Third-party failover_mode=common_alua path_type=Optimized
    Command executed successfully.
  • Enable CHAP authentication and setting the CHAP username to "chapuser" for the iSCSI initiator whose IQN is "iqn.01".

    admin:/>change initiator initiator_type=iSCSI iscsi_iqn_name=iqn.01 chap_enabled=yes chap_user=chapuser
    CHAP user password:*************
    Reenter password:*************
    Command executed successfully.
  • Update the WWN of the Fibre Channel initiator from "10000000c9b7bc72" to "1234567890123456".

    admin:/>change initiator initiator_type=FC wwn=10000000c9b7bc72 new_wwn=1234567890123456
    DANGER: You are going to replace initiator. This operation wills delete the offline initiator which you specified.
    Have you read danger alert message carefully?(y/n)y
    Are you sure you really want to perform the operation?(y/n)y
    Query old initiator.
    Remove old initiator from host.
    Delete old initiator.
    Create or change new initiator.
    Command executed successfully.

System Response

None

Translation
Download
Updated: 2019-07-22

Document ID: EDOC1000084195

Views: 361716

Downloads: 1588

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