iSCSI name must be a valid IQN


Test Description

The iSCSI initiator name must be set to a valid IQN format according to RFC 3721 (


This test case fails if:

The iSCSI name of the host is set to a string that is not using a valid IQN format

This test case passes if:

The iSCSI name of the host is set to a string that is a valid IQN format


How to fix this test

Automatic fix

Host PowerTools seta the iSCSI name of the host to a valid name using an IQN format, according to the operating system conventions.

Manual fix

Configure the operating system iSCSI name to a valid IQN.

In Windows

Open the CMD and run the following command:

iscsicli NodeName '*'
  • This restores the IQN to its default value. 
  • The IQN is visible from the iscsicpl (iSCSI initator UI).

In Linux

For all supported platforms:

  1. Open the terminal and run:


    This generates a new valid IQN according to the iSCSI IQN RFC.

  2. Copy this IQN and paste it to the iqn file with the required prefix.
    1. In most linuxiSCSI initiators the file location is /etc/iscsi/initiatorname.iscsi.
  3. Copy the IQN also to the prefix which is InitiatorName=

    cat /etc/iscsi/initiatorname.iscsi                          

Applies to

  • Linux
  • Windows