Support

The Linux SCSI Target Wiki

These are the instructions for getting support for the LinuxIO and Core-iSCSI initiator. Please collect and report debugging context and information as described below to help the developers finding and fixing the problem.

Contents 1 Contact 2 LinuxIO 3 Core-iSCSI 3.1 Configuration 3.2 Logs 3.3 Debug output 4 See also 5 External links

Contact

Please post your comments, questions or bug reports here:

• For LinuxIO or targetcli: the target-devel mailing list (post, subscribe, list info, gmane archive)
• For the Initiator: the Core-iSCSI mailing list
• For general SCSI: the linux-scsi mailing list
• For the Linux kernel: the Linux Kernel mailing list (archive)

LinuxIO

For LIO, the debug information needs to be captured manually. Here are the most important pieces.

• Get the versions of the modules and user space code (where applicable).
• Get the information in the configuration files for LIO and the system:
  • /etc/issue
• Get the exact kernel version and system info:

# uname -a

• Get the PCI device info:

# lspci -vvv

• Get the output from /var/log/messages:

# dmesg

• If the system is locking or crashing, get the output from the console via the serial console.
• If the problems are related to iSCSI, collect iSCSI network traffic with Wireshark or Ethereal, where possible.

Core-iSCSI

Configuration

• Get the versions of the modules and user space code (where applicable).
• Get the information in the configuration files for Core-iSCSI & the Core-iSCSI tools:
  • /etc/sysconfig/initiator
  • /etc/sysconfig/iscsi_device_maps
  • /etc/sysconfig/initiator_auth

Logs

• If the system is having non-fatal isses with iSCSI (i.e.: the module can be unloaded), then get the output from /var/log/messages:

# dmesg

• If the system is locking or crashing, get the output from the console via the serial console.
• Where possible, collect iSCSI network traffic with Wireshark or Ethereal.

Debug output

Enable debugging output for Core-iSCSI:

DEBUG_ISCSI = 1 core-iscsi-vx.x.x.x/MCONFIG

If the resulting verbosity is insufficient, recompile Core-iSCSI:

1. Enable additional debugging sections in iscsi_debug.h
2. Compile, shutdown, install and restart to enable the changes

See also

• Using targetcli
• Downloading and installing
• Background on LIO and Core-iSCSI
• CentOS, Debian, Fedora, openSUSE, RHEL, Scientific Linux, SLES, Ubuntu

External links

• Wireshark network protocol analyzer
• Ethereal network protocol analyzer
• Open-iSCSI mailing list
• IET problem report