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 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 provided by DeviceManager, 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:

  • "none".
  • "single".
  • "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:

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

host_id=?

Host ID.

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 "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 type of the 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.

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-09-02

Document ID: EDOC1000181601

Views: 320319

Downloads: 41

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