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 |
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:
- Enable additional debugging sections in
iscsi_debug.h
- 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