Skip to content
Remote configuration of a LIO-based storage appliance
Python Groff
Find file
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
API.md
LICENSE
README.md
client
targetd
targetd.8

README.md

targetd

Remote configuration of a LIO-based storage appliance

targetd turns Linux into a remotely-configurable storage appliance. It supports an HTTP/jsonrpc-2.0 interface to let a remote administrator allocate volumes from an LVM volume group, and export those volumes over iSCSI.

Current Status

targetd is pre-alpha, and contributions are welcome! It is licensed under the GPLv3. Please use target-devel@vger.kernel.org for discussion. Source repo and bug tracking is at https://github.com/agrover/targetd.

NOTE: targetd is PRE-ALPHA, STORAGE-RELATED software. Do NOT use around valuable data!

Getting Started

targetd has these Python library dependencies:

All of these are available in Fedora Rawhide.

Configuring targetd

A configuration file may be placed at /etc/target/targetd.yaml, and is in YAML format. Here's an example:

pool_name: test
user: "foo" # strings quoted, or not
password: bar
ssl: false
target_name: iqn.2003-01.org.example.mach1:1234

targetd defaults to using the "vg-targetd" volume group, and username 'admin' password 'targetd' for the HTTP jsonrpc interface.

Then, run sudo ./targetd.py.

client.py is a basic testing script, to get started making API calls.

Something went wrong with that request. Please try again.