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 2800 V3 V300R006

This document is applicable to OceanStor 2800 V3. 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. 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=? ] ] [ vstore_id=? ] [ force_change_vstore=? ]

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=?

World Wide Name (WWN) of a Fibre Channel initiator.

To obtain the value, run "show initiator".

chap_enabled=?

Whether or not to enable the CHAP function for iSCSI initiators.

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

  • "yes": CHAP authentication will be enabled.
  • "no": CHAP authentication will be disabled.

chap_target_user=?

CHAP user name for the initiator to authenticate the target. When "chap_enabled=?" is set to "yes", this parameter is optional.

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

iscsi_iqn_name=?

iSCSI qualified name (IQN) of an iSCSI initiator.

To obtain the value, run "show initiator".

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.

alias=?

Alias of an initiator.

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

chap_user=?

Name of a CHAP user. This parameter is required 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.

normal_chap_type=?

CHAP type during the iSCSI Normal phase. When "chap_enabled=?" is set to "yes", this parameter is optional.

The value can be:

  • "none".
  • "single".
  • "double".

discovery_chap_type=?

CHAP type during the iSCSI Discover phase. When "chap_enabled=?" is set to "yes", this parameter is optional.

The value can be:

  • "none".
  • "single".
  • "double".

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 "common_alua".

path_type=?

Path type after the update.

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

  • optimized: optimized path.
  • non-optimized: non-optimized path.

The default value is "optimized".

special_mode_type=?

Special mode of an initiator.

The value can be "mode0", "mode1", "mode2", and "mode3", where:

  • mode0: special mode 0.
  • mode1: special mode 1.
  • mode2: special mode 2.
  • mode3: special mode 3.

vstore_id=?

ID of the vStore to which an initiator belongs.

The value ranges from 0 to 511.

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.
  • Modify the attributes of an iSCSI initiator, where the IQN of the initiator is "iqn.01", CHAP authentication will be enabled, and the CHAP user name is "chapuser".
    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.
  • Replace the Fibre Channel initiator whose WWN is "10000000c9b7bc72" with another Fibre Channel initiator whose WWN is "1234567890123456".
    admin:/>change initiator initiator_type=FC wwn=10000000c9b7bc72 new_wwn=1234567890123456 
    DANGER: You are about to modify the initiator identifier. This operation will remove and delete the specified offline initiator from the host.  
    Suggestion: Before performing this operation, ensure that you choose the offline initiator that has been added to the host. 
    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.
  • Modify the attributes of an iSCSI initiator, where the IQN of the initiator is "inq.1996-04.de.suse:01:ca9f3bcaf455", CHAP bidirectional authentication will be enabled, the initiator CHAP user name is "chapuser1", and the target CHAP user name is "chapuser2".
    admin:/>change initiator initiator_type=iSCSI iscsi_iqn_name=inq.1996-04.de.suse:01:ca9f3bcaf455 chap_enabled=yes normal_chap_type=double 
    CHAP target user:chapuser1 
    CHAP user password:************* 
    Reenter password:************* 
    CHAP target user:chapuser2 
    CHAP target user password:************* 
    Reenter password:************* 
    Command executed successfully.

System Response

None

Translation
Download
Updated: 2019-07-12

Document ID: EDOC1000138382

Views: 310920

Downloads: 38

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