Iscsi-util - ArchWiki

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:

- https://github.com/mijocecr/Iniciador-iSCSI-GUI-Manjaro/releases/tag/iscsi-util-1.0.6

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:

- iSCSI
- Open-iSCSI#Automatic_login

## Troubleshooting

- Ensure the `iscsid` service is running:

    bash

    systemctl status iscsid

- Verify network connectivity to the target.
- Check logs:

    bash

    journalctl -u iscsid

## External links

- Official repository
- AUR package

Categories:

- Network sharing
- System administration

Iscsi-util
Add topic