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 18500 V3 and 18800 V3 Mission Critical 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).
create initiator iscsi

create initiator iscsi

Function

The create initiator iscsi command is used to create an Internet Small Computer System Interface (iSCSI) initiator. You can enable hosts to access storage resources of the storage system using the iSCSI initiator.

Format

create initiator iscsi iscsi_iqn_name=? [ alias=? | chap_enabled=? [ chap_user=? ] [ discovery_chap_type=? normal_chap_type=? ] | host_id=? ] [ multipath_type=? [ failover_mode=? [ special_mode_type=? ] ] [ path_type=? ] ] *

Parameters

Parameter

Description

Value

iscsi_iqn_name=? IQN of an iSCSI initiator.

The value contains 1 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 (-).

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.
The default value is "no".
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.

discovery_chap_type=? CHAP type during the iSCSI discover phase. This parameter is available only when "chap_enabled=?" is set to "yes".

The value can be:

1."none".

2."single".

3."double".

normal_chap_type =? CHAP type during 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".

host_id=? Host ID. Before delivering the host ID parameter in the command of creating an iSCSI initiator, ensure that an initiator is added to the host.

To obtain the value, run "show host general".

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

Level

Administrator

Usage Guidelines

  • 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 characters
      • Uppercase characters
      • Numbers
      • Special characters and the following: ` ~ ! @ # $ % ^ & * ( ) - _ = + \ | [ { } ] ; : ' " , < . > / ?
    • Each password must be different from the user name and mirror writing of the user name.
  • When "chap_enabled=?" is set to "yes" and parameters "discovery_chap_type" and "normal_chap_type" are not configured, "normal_chap_type =?" is set to "single" by default.
  • Running this command with parameters "discovery_chap_type" and "normal_chap_type" not set to "double" and parameter "chap_user" selected will prompt you to type the password for the target to authenticate the initiator in interaction mode.
  • Running this command with parameters "discovery_chap_type" and "normal_chap_type" set to "double" and parameter "chap_user" selected will prompt you to type the user name (the user name setting follows the rules of "chap_user" setting) and password for the initiator to authenticate the target and those for the target to authenticate the initiator in interaction mode.
  • 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

Create an iSCSI initiator whose IQN is "iqn.01".

admin:/>create initiator iscsi iscsi_iqn_name=iqn.01
Command executed successfully.

System Response

None

Translation
Download
Updated: 2019-07-22

Document ID: EDOC1000084078

Views: 304023

Downloads: 253

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