Go to main content

Managing SAN Devices and Multipathing in Oracle® Solaris 11.3

Exit Print View

Updated: March 2018
 
 

Tuning iSCSI Initiator and Target Parameters

You can modify parameters for both an iSCSI initiator node (globally) and for a iSCSI target device. The following parameters can be modified for an iSCSI initiator:

  • iSCSI initiator node name - If you change an initiator node name, the targets that were discovered by iSNS might be removed from the initiator's target list. The removal of the targets from the target list of the initiator depends on the discovery domain configuration on the iSNS server at the time the name was changed.

  • Header digest - NONE, the default value or CRC32.

  • Data digest - NONE, the default value or CRC32.

  • Authentication and CHAP secret key - For more information about setting up authentication, see How to Configure CHAP Authentication for an iSCSI Initiator.

The iSCSI driver provide default values for an iSCSI initiator and iSCSI target device parameters. If you modify the parameters of an iSCSI initiator, the modified parameters are inherited by the iSCSI target device. If the iSCSI target device already has a different value, it does not inherit the iSCSI initiator parameter values. If you change the initiator node name, the targets that are discovered by iSNS log out and are removed from the target list of the initiator. Also, if the new name does not belong to the same discovery domain as that of the targets, the targets are logged out and removed from the target list of the initiator. But if the targets are in use, they are not removed. For example, if a file is open or a file system is mounted on these targets, the targets are not removed.


Caution

Caution  -  Ensure that the target software supports the parameter to be modified. Otherwise, you might not be able to log in to the iSCSI target device. For more information about the list of supported parameters, see vendor array documentation.


You can modify the iSCSI parameters only when there is no active I/O communication between the initiator and the target. After the parameter is modified by using the iscsiadm modify command, the iSCSI driver reconnects the session.

For more information about all the parameters, see the iscsiadm(1M) man page.