→ Applies to: SynetoOS 6.0.3 and above

IMPORTANT
Ensure the IQN follows the standard naming convention and is written entirely in lowercase letters.
Ensure Target IQN format follows the standard naming convention "iqn.YYYY-MM.reverse-domain:targetname".

Step 1. Connect to SynetoOS appliance via SSH as admin

ssh admin@<your_ip_address_or_hostname>

Step 2. Get root privileges

sudo su -

Network Connectivity

Connectivity test (replace <IP> with the iSCSI server IP)

ping <IP>

Test iSCSI port (replace <IP> with the iSCSI server IP)

telnet <IP> 3260

Service & Logs

Check initiator IQN

cat /etc/iscsi/initiatorname.iscsi

Enable service

systemctl enable --now iscsid

Check service status

systemctl status iscsid

View iSCSI config file

cat /etc/iscsi/iscsid.conf

Check logs

journalctl -u iscsid -f

Authentication Error

Check auth errors in daemon logs

journalctl -u iscsid | grep -i "auth\|chap\|fail\|error\|reject"

Check kernel messages for authentication failures

dmesg | grep -i "auth\|chap\|fail\|reject"

Discovery

Check available targets (replace <IP> with the iSCSI server IP)

iscsiadm -m discovery -t sendtargets -p <IP>

Check attached disks

iscsiadm -m session -P 3 | grep -i attached

Show all node configs

iscsiadm -m node -o show

Rescan all sessions

iscsiadm -m session --rescan

Check full session details

iscsiadm -m session -P 3

Verify Disks

List and check all iSCSI disks

lsblk -o NAME,TRAN,SIZE,TYPE,MOUNTPOINT | grep iscsi

List iSCSI disks by path

ls -l /dev/disk/by-path/ | grep iscsi

Check recent kernel messages

dmesg | tail -20