Skip to content

QUICKSTART.md

Latest commit

 

History

History
110 lines (70 loc) · 2.76 KB

QUICKSTART.md

File metadata and controls

110 lines (70 loc) · 2.76 KB
layout default
title iSCSI on Debian/Ubuntu - Quick Start Guide

iSCSI on Debian/Ubuntu - Quick Start Guide

This guide provides a streamlined path to configure iSCSI storage on Debian/Ubuntu systems.

📘 For detailed explanations, alternative configurations, and troubleshooting: See iSCSI Best Practices

{% include quickstart/disclaimer.md %}

Prerequisites

  • Debian 11+ or Ubuntu 20.04 LTS+
  • iSCSI storage array with portal IPs and target IQN
  • Dedicated storage network interfaces
  • Root or sudo access

{% include quickstart/glossary-link-iscsi.md %}

Step 1: Install Packages

sudo apt update
sudo apt install -y open-iscsi multipath-tools
sudo systemctl enable --now open-iscsi multipathd

Step 2: Configure Network Interfaces

{% include quickstart/network-debian.md %}

{% include quickstart/arp-warning.md %}

Step 3: Configure Firewall

{% include quickstart/firewall-debian.md %}

Alternative: For port filtering options, see Best Practices - Firewall Configuration.

Step 4: Configure iSCSI Initiator

# View/generate initiator name
cat /etc/iscsi/initiatorname.iscsi

# Set automatic startup
sudo sed -i 's/^node.startup = manual/node.startup = automatic/' /etc/iscsi/iscsid.conf
sudo systemctl restart open-iscsi

Register this initiator IQN with your storage array.

Step 5: Create Interface Bindings

{% include quickstart/iscsi-interface-bindings.md %}

Step 6: Discover and Login

{% include quickstart/iscsi-discover-login.md %}

Step 7: Configure Multipath

{% include quickstart/iscsi-multipath-conf.md %}

Step 8: Create LVM Storage

{% include quickstart/iscsi-lvm-storage.md %}

# Format and mount (Debian/Ubuntu: ext4 recommended)
sudo mkfs.ext4 /dev/iscsi-storage/data
sudo mkdir -p /mnt/iscsi-storage
sudo mount /dev/iscsi-storage/data /mnt/iscsi-storage

# Add to fstab
echo '/dev/iscsi-storage/data /mnt/iscsi-storage ext4 defaults,_netdev 0 0' | sudo tee -a /etc/fstab

Step 9: Verify

{% include quickstart/iscsi-verify.md %}

{% include quickstart/iscsi-quick-reference.md %}

Next Steps

For production deployments, see iSCSI Best Practices for:

  • Network design and VLAN configuration
  • Multipath configuration details
  • Security best practices (AppArmor, CHAP, firewall options)
  • Monitoring and troubleshooting
  • High availability considerations

Additional Resources:

  • [Common Network Concepts]({{ site.baseurl }}/common/network-concepts.html)
  • [Multipath Concepts]({{ site.baseurl }}/common/multipath-concepts.html)
  • [Troubleshooting Guide]({{ site.baseurl }}/common/troubleshooting-common.html)
  • [Storage Terminology Glossary]({{ site.baseurl }}/common/glossary.html)