Jump to content

Iscsi-util-bin

From ArchWiki


Introduction

iscsi-util-bin is a graphical user interface (GUI) for managing iSCSI sessions on Linux. It is built with the cross‑platform Avalonia framework and provides a simple alternative to using iscsiadm directly. The project offers a portable AppImage as well as an AUR package.

Features

  • Target discovery.
  • Session management (login/logout).
  • CHAP authentication support.
  • Session parameter configuration.
  • Cross‑platform Avalonia-based interface.
  • Portable AppImage with no external dependencies.
  • Integration with open-iscsi.

Installation

From AUR

The package is available as iscsi-util-binAUR: 

bash
yay -S iscsi-util-bin

AppImage

The AppImage can be downloaded from the project’s release page:

Make it executable: 

bash
chmod +x iscsi-util.appimage
./iscsi-util.appimage

Dependencies

  • open-iscsi — required for iSCSI discovery, login, logout and session management.
  • dotnet-runtime-9.0 — required when running the non‑AppImage packaged version.
  • util-linux — provides lsblk, blkid, mount, umount and other essential tools.
  • libnotify — required for desktop notifications.
  • e2fsprogs — ext2/3/4 filesystem support.
  • xfsprogs — XFS filesystem support.
  • btrfs-progs — Btrfs filesystem support.
  • f2fs-tools — F2FS filesystem support.
  • ntfs-3g — NTFS filesystem support.
  • exfatprogs — exFAT filesystem support.

Usage

When launched, the application automatically detects existing configuration under /etc/iscsi. The main operations include:

  • Discovering targets:
bash
iscsiadm -m discovery -t sendtargets -p <IP>
  • Logging in to a target.
  • Logging out.
  • Configuring CHAP authentication.
  • Viewing active sessions.

The application acts as a visual layer on top of these operations.

System integration

iscsi-util can configure iSCSI nodes so that they are automatically logged in at boot using the standard open-iscsi mechanisms. For details on how automatic login works, see:

Troubleshooting

  • Ensure the iscsid service is running:
bash
systemctl status iscsid
  • Verify network connectivity to the target.
  • Check logs:
bash
journalctl -u iscsid