Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
===== Fix iSCSI login errors =====
A few solutions for iSCSI log-in errors are known. They are described in the next sections.  
==== Checking the iSCSI configuration ====
If the iSCSI login was possible before and the configuration was not changed manually, a misconfiguration will not be very likely - especially when the configuration is distributed by Puppet.\\ 
If  Puppet is used and if in doubt, the configuration can be updated like so: 
  root@kvm55:~# puppet agent -t
If a backup of the host was created with the help of rsnapshot, the iSCSI configuration can be compared to older configurations in order to find possible configuration errors.

In such a situation a detection of the configuration with the help of the command
  root@kvm55:~# iscsiadm –m discovery
has to be prevented, because the execution of the command will certainly overwrite the current configuration files thus possibly overwriting passwords stored in the configuration files ultimately.

If in doubt, compare the passwords contained in die iSCSI configuration with those (hopefully) stored in the password databse: 
  root@kvm55:~# find /etc/iscsi/ -name default -print | xargs egrep -h "auth.username|auth.password"
  node.session.auth.username_in = hp3par30
  node.session.auth.password_in = OngunajG8thi7i
  node.session.auth.username = Company_kvm55
  node.session.auth.password = aer2Do8faithiV
  node.session.auth.username_in = hp3par30
  node.session.auth.password_in = OngunajG8thi7i
  node.session.auth.username = Company_kvm55
  node.session.auth.password = aer2Do8faithiV
If the iSCSI configuration has to be adapted and Puppet is in use for the distribution of the configuration, the configuration must not be changed locally as puppet will overwrite it at next execution. In such a case change the configuration that is distributed by puppet. 
==== Restart the iSCSI interfaces ====
A complete restart of all iSCSI connections is possible like so:
  root@kvm55:~# /etc/init.d/open-iscsi stop
  root@kvm55:~# /etc/init.d/iscsi-network-interface restart
  root@kvm55:~# /etc/init.d/open-iscsi start
If the iSCSI sessions don't get connected by ''open-iscsi start'', login to iSCSI manually.
==== Wait before another log-in trial ====
Sometimes it is helpful to wait for 10 to 15 minutes before the next log-in trial. In some cases log-in was possible again after some waiting time. The reason for the time-out is unknown - maybe switches discard the MAC addresses after some time or the account will be locked temporarily after failed login attemtps.
==== When all log-in trials fail ====
In such a case it should be checked whether the log-in ever succeeded before. If this is not the case then maybe a wrong username or a wrong password was transferred to the user. If all else fails, ask the administrator to reset the password on the iSCSI device. Do not forget to update the configuration and the password in the password database afterwards! 
==== Assignment between iscsi LUNs and SCSI devices ====
For further debugging it might be helpful to know the assignment between iSCSI LUNs and physical disks. The assignment can be displayed with the command  ''lsscsi''. Maybe the software package of the same name has to be installed before use:
  root@kvm55:~# apt-get install lsscsi
A display of the SCSI devices can look like so:
  root@kvm55:~# lsscsi
  [4:2:0:0]    disk    LSI      MR9240-4i        2.13  /dev/sda
  [5:0:0:0]    disk    3PARdata VV               3112  /dev/sdc
  [5:0:0:1]    disk    3PARdata VV               3112  /dev/sde
  [5:0:0:254]  enclosu 3PARdata SES              3112  -       
  [6:0:0:0]    disk    3PARdata VV               3112  /dev/sdb
  [6:0:0:1]    disk    3PARdata VV               3112  /dev/sdd
  [6:0:0:254]  enclosu 3PARdata SES              3112  -       
In the code above the device '/dev/sda' is a local disk while '/dev/sdb', '/dev/sdc', '/dev/sdd', and '/dev/sde' are iSCSI LUNs.


[[public:iscsi:relogin|previous chapter]] | [[public:start|contents]] | [[public:iscsi:multipath|next chapter]]