Skip to content

Troubleshooting iSCSI Mount Issues

If you encounter issues while setting up and mounting the iSCSI disk, follow these steps to troubleshoot and resolve them.


1. Verify the Filesystem

Ensure the partition has the correct filesystem (ext4).

sudo blkid /dev/sdb1
  • Output should include TYPE="ext4".

  • If the filesystem is missing or incorrect, reformat the partition:

sudo mkfs.ext4 /dev/sdb1

2. Verify the /etc/fstab Entry

Check the /etc/fstab file for errors.

sudo vi /etc/fstab

Ensure the entry looks like this:

/dev/sdb1 /docker/ubuntu_remote/ ext4 defaults,_netdev 0 0

3. Reload systemd

Reload systemd to ensure it recognizes any changes made to /etc/fstab.

sudo systemctl daemon-reload

4. Remount All Filesystems

Test the mount by remounting all filesystems.

sudo mount -a

If it fails, proceed to check logs for more information.


5. Check dmesg for Errors

Inspect the kernel log to identify why the mount failed.

dmesg | tail

Look for messages indicating a "bad superblock," incorrect filesystem type, or other issues.


6. Manually Mount for Testing

Attempt a manual mount to verify the configuration and filesystem.

sudo mount -t ext4 /dev/sdb1 /docker/ubuntu_remote/
  • If this works, the issue is likely in /etc/fstab or systemd.

  • If it fails, double-check the filesystem and partitioning.


7. Verify the Disk and Partition

Recheck the disk structure and ensure the partition exists.

sudo fdisk -l

If issues persist after these steps, repeat the relevant setup steps or consult additional documentation for Synology DSM or Ubuntu iSCSI tools.