Iscsi-util
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
- open-iscsi — required for actual session management.
- dotnet-runtime (only for non-AppImage builds).
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
iscsidservice is running:
bash
systemctl status iscsid
- Verify network connectivity to the target.
- Check logs:
bash
journalctl -u iscsid