---
name: "ietadm"
section: "8"
platform: "linux"
package: "iscsitarget"
version: "1.4.20.3+svn502-1"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/ietadm"
---

# ietadm(8)

iSCSI Enterprise Target Administration Utility.

## NAME

ietadm - iSCSI Enterprise Target Administration Utility.

## SYNOPSIS

**ietadm --op \[operation\] --tid=\[id\] \[--sid \[id\]\] \[--params \[key=value,...\]\]**

## DESCRIPTION

ietadm is used to monitor and modify in real-time the iSCSI Enterprise Target  targets and volumes.

## USAGE

You'll have to get target ids from /proc/net/iet/volumes and sessions ids from  /proc/net/iet/session. Some usage examples can be :

**ietadm --op show --tid=1**

display status of target 1 (see /proc/net/iet/volumes to get the matching target name)

**ietadm --op new --tid=2**

create dynamically a new target, numbered 2. CAUTION : the target will disappear if you restart ietd, you'll have to edit /etc/ietd.conf to make it permanent!

## ERROR MESSAGES

ietadm misses error messages. Look carefully at the STDERR output : in case of error it will send a 3 number error code, ending with -1, for instance :

ietd\_request 203 3 -1

## OPTIONS

**--op new --tid=\[id\] --params Name=\[name\]**

add a new target with \[id\]. If \[id\] is zero, the lowest free \[id\] is allocated automatically to the new target.

**--op delete --tid=\[id\]**

delete specific target with \[id\]. The target must have no active sessions.

**--op show --tid=\[id\]**

show target parameters of target with \[id\].

**--op show --tid=\[id\] --sid=\[sid\]**

show iSCSI parameters in effect for session \[sid\]. If \[sid\] is "0" (zero), the configured parameters will be displayed.

**--op new --tid=\[id\] --lun=\[lun\] --params Path=\[path\]**

add a new logical unit with \[lun\] to specific target with \[id\]. The logical unit is offered to the initiators. \[path\] must be block device files (including LVM and RAID devices) or regular files.

**--op delete --tid=\[id\] --lun=\[lun\]**

delete specific logical unit with \[lun\] that the target with \[id\] has.

**--op delete --tid=\[id\] --sid=\[sid\] --cid=\[cid\]**

delete specific connection with \[cid\] in a session with \[sid\] that the target with \[id\] has. If the session has no connections after the operation, the session will be deleted automatically.

**--op delete**

stop all activity.

**--op update --tid=\[id\] --params=key1=value1,key2=value2,...**

change iSCSI IET target parameters of specific target with \[id\]. You can use parameters in ietd.conf as a key.

**--op update --tid=\[id\] --redirect=\[destination\]**

set a temporary target redirection for target \[id\]. \[destination\] MUST be in the form \<ip address\>:port where :port is optional and if not specified port 3260 is assumed. IPv6 addresses must be surrounded by square brackets, e.g. \[\<ipv6 address\>\]:port. If the destination is empty then any existing redirection is cleared.

**--op new --tid=\[id\] --user --params=\[user\]=\[name\],Password=\[pass\]**

add a new account with \[pass\] for specific target. \[user\] could be \[IncomingUser\] or \[OutgoingUser\]. If you don't specify a target (omit --tid option), you add a new account for discovery sessions.

**--op show --tid=\[id\] --user**

show a list of CHAP accounts. If --tid is omitted or \[id\] is "0" (zero), discovery accounts are displayed.

**--op show --tid=\[id\] --user --params=\[user\]=\[name\]**

show CHAP account information for the account specified by \[name\]. \[user\] can be \[IncomingUser\] or \[OutgoingUser\]. If --tid is omitted or \[id\] is "0" (zero), \[name\] is supposed to be a discovery account name.

**--op delete --tid=\[id\] --user --params=\[user\]=\[name\]**

delete specific account having \[name\] of specific target. \[user\] could be \[IncomingUser\] or \[OutgoingUser\]. If you don't specify a target (omit --tid option), you delete the account for discovery sessions.

**--version**

display version and exit

**--help**

display a list of available options and exits

## KNOWN ISSUES

- •

  ietdadm doesn't return any human-readable error message, only error codes.

- •

  ietadm doesn't modify or read the /etc/ietd.conf ietd configuration file.

- •

  ietadm can't use target names or aliases, only the tid found in /proc/net/iet/volumes.

- •

  /proc/net/iet/session may list inactive sessions if the initiator doesn't logout properly.

Report bugs to \<iscsitarget-devel@sourceforge.net\>.

## FILES

/proc/net/iet/session, /proc/net/iet/volumes

## SEE ALSO

[*ietd*(8)](/ietd/8.md),[*ietd.conf*(5)](/ietd.conf/5.md)