→ Applies to: SynetoOS 6.0.3 and above

Step 1. Connect to SynetoOS appliance via SSH as admin

ssh admin@<your_ip_address_or_hostname>

Step 2. Get root privileges

sudo su -

Service Management

Check service status

systemctl status iscsid

Enable and start iSCSI daemon

systemctl enable --now iscsid

Restart iSCSI daemon

systemctl restart iscsid

Initiator Configuration

View your initiator IQN

cat /etc/iscsi/initiatorname.iscsi

Set custom IQN (replace the example with the desired IQN)

echo "InitiatorName=iqn.2025-01.com.example:myhost" \
  > /etc/iscsi/initiatorname.iscsi

Targets Discovery

List all discovered targets

iscsiadm -m discovery -o show

Show all known nodes

iscsiadm -m node -o show

Discover targets from a specific server (replace <IP> with the iSCSI server IP)

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

All discovered targets will be listed on the iSCSI page after running the discover command.

Session Authentication

Login to specific target (replace <iqn> with the target iqn and <IP> with the iSCSI server IP)

iscsiadm -m node -T <iqn> -p <IP> --login

Logout from specific target (replace <iqn> with the target iqn and <IP> with the iSCSI server IP)

iscsiadm -m node -T <iqn> -p <IP> --logout

Login to all target

iscsiadm -m node --loginall=all

Logout from all targets

iscsiadm -m node --logoutall=all

Session Management

List active sessions

iscsiadm -m session

Optional parameters

Parameter	Description
-P 1	Session info (basic)
-P 2	Session info (detailed)
-P 3	Session info (with disk info)

Rescan specific session (replace <session_id> with the correct information)

iscsiadm -m session -r <session_id> --rescan

Rescan all sessions

iscsiadm -m session --rescan

Storage Discovery

List all block devices including iSCSI

lsblk

List iSCSI devices only

lsblk -S

List all disks and partitions

fdisk -l

Show iSCSI disks by path

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

Show multipath devices (if configured)

multipath -ll

Node Login Configuration

Show node settings (replace <iqn> with the target iqn and <IP> with the iSCSI server IP)

iscsiadm -m node -T <iqn> -p <IP> -o show

Set Auto-login on boot (replace <iqn> with the target iqn and <IP> with the iSCSI server IP)

iscsiadm -m node -T <iqn> -p <IP> --op update \
  -n node.startup -v automatic

Set Manual login only (replace <iqn> with the target iqn and <IP> with the iSCSI server IP)

iscsiadm -m node -T <iqn> -p <IP> --op update \
  -n node.startup -v manual