Jump to content

Iscsi-util

From ArchWiki


Introduction

iscsi-util 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-utilAUR:

bash
yay -S iscsi-util

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

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